Notificaciones de ejecución del Servicio de transferencia de datos de BigQuery

Esta página proporciona una descripción general de las notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Descripción general

Hay dos tipos de notificaciones de ejecución que puedes configurar para el Servicio de transferencia de datos de BigQuery:

  • Notificaciones de Cloud Pub/Sub: notificaciones procesables que se envían cuando la ejecución de una transferencia es exitosa o falla
  • Notificaciones por correo electrónico: notificaciones legibles que se envían cuando falla una ejecución de transferencia

Puedes configurar cada tipo individualmente o usar tanto las notificaciones de ejecución de Cloud Pub/Sub como las de correo electrónico.

Notificaciones de Cloud Pub/Sub

Las notificaciones de Cloud Pub/Sub envían información sobre las ejecuciones de transferencia a un tema de Cloud Pub/Sub. Las notificaciones de Cloud Pub/Sub se activan cuando se completan las transferencias en los siguientes estados:

  • EXITOSA
  • CON ERRORES
  • CANCELADA

Puedes enviar notificaciones a cualquier tema de Cloud Pub/Sub en cualquier proyecto para el que tengas los permisos requeridos. Una vez que el tema de Cloud Pub/Sub la recibe, el mensaje resultante se puede enviar a cualquier número de suscriptores del tema.

Antes de comenzar

Antes de configurar las notificaciones de ejecución de transferencias de Cloud Pub/Sub, debes:

  1. Habilitar la API de Cloud Pub/Sub API para el proyecto que recibirá notificaciones.

    Habilitar la API

  2. Tener los permisos requeridos por el proyecto para recibir notificaciones:

    • Si eres el propietario del proyecto que recibirá notificaciones, lo más probable es que tengas los permisos necesarios.

    • Si planeas crear temas para recibir notificaciones, debes contar con los permisos pubsub.topics.create.

    • Ya sea que planees usar temas nuevos o existentes, debes contar con los permisos pubsub.topics.setIamPolicy. Si creas un tema, por lo general tienes los permisos pubsub.topics.setIamPolicy para este. Las siguientes funciones de IAM predefinidas a nivel de proyecto tienen los permisos pubsub.topics.setIamPolicy:

      • La función predeterminada pubsub.admin
      • La función primitiva Owner

      Consulta Control de acceso a Cloud Pub/Sub para obtener más información.

  3. Tener un tema Cloud Pub/Sub existente al que desees enviar notificaciones.

Formato de las notificaciones

Las notificaciones enviadas al tema de Cloud°Pub/Sub constan de dos partes:

  • Atributos: Un conjunto de pares clave-valor que describen el evento.
  • Carga útil: Una string que contiene los metadatos del objeto cambiado.

Atributos

Los atributos son pares clave-valor contenidos en todas las notificaciones que envía el Servicio de transferencia de datos de BigQuery a tu tema de Cloud Pub/Sub. Las notificaciones siempre contienen el siguiente conjunto de pares clave-valor, independientemente de la carga útil de la notificación:

Nombre del atributo Ejemplo Descripción
eventType TRANSFER_RUN_FINISHED El tipo de evento que acaba de ocurrir. TRANSFER_RUN_FINISHED es el único valor posible.
payloadFormat JSON_API_V1 El formato de la carga útil del objeto. JSON_API_V1 es el único valor posible.

Carga útil

La carga útil es una string que contiene los metadatos de la ejecución de transferencia. El tipo de carga útil no se puede configurar en este momento y se proporciona para adaptarse a futuros cambios en la versión de la API.

Tipo de carga útil Descripción
JSON_API_V1 La carga útil será una string UTF-8 serializada en JSON que contiene la representación del recurso de una TransferRun.

Notificaciones por correo electrónico

Las notificaciones por correo electrónico envían mensajes de correo electrónico legibles cuando falla una ejecución de transferencia. Estos mensajes se envían al usuario que configuró la transferencia. Los mensajes no se pueden configurar.

Si otros usuarios deben recibir notificaciones por correo electrónico sobre la ejecución de transferencias, configura las reglas de reenvío de correo electrónico para distribuir los mensajes. Si usas Gmail, puedes reenviar automáticamente mensajes de Gmail a otras cuentas.

La notificación por correo electrónico se envía mediante el Servicio de transferencia de datos de BigQuery y contiene detalles sobre la configuración de la transferencia, la ejecución de la transferencia y un vínculo que va al historial de ejecución de la ejecución fallida. Por ejemplo:

From: bigquery-data-transfer-service-noreply@google.com
To: [USER_WHO_SET_UP_TRANSFER]
Title: BigQuery Data Transfer Service - Transfer Run Failure - [DISPLAY_NAME]

Transfer Configuration
Display Name: [DISPLAY_NAME]
Source: [DATA_SOURCE]
Destination: [PROJECT_ID]

Run Summary
Run: [RUN_NAME]
Schedule Time: [SCHEDULE_TIME]
Run Time: [RUN_TIME]
View Run History

Google LLC 1600 Amphitheatre Parkway, Mountain View, CA 94043

This email was sent because you indicated you are willing to receive Run
Notifications from the BigQuery Data Transfer Service. If you do not wish to
receive such emails in the future, click View Transfer Configuration and
un-check the “Send E-mail Notifications” option.

Precios de las notificaciones de ejecución

Durante la etapa Alpha, el Servicio de transferencia de datos de BigQuery no cobrará por las notificaciones de ejecución. Si configuras las notificaciones de ejecución de Cloud Pub/Sub, incurrirás en cargos de Cloud Pub/Sub. Para obtener más información, consulta Precios de Cloud Pub/Sub.

Próximos pasos

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.