Ausführungsbenachrichtigungen für BigQuery Data Transfer Service

Diese Seite bietet eine Übersicht der Ausführungsbenachrichtigungen für den BigQuery Data Transfer Service.

Übersicht

Sie können für den BigQuery Data Transfer Service zwei Arten von Ausführungsbenachrichtigungen konfigurieren:

  • Pub/Sub-Benachrichtigungen: maschinenlesbare Benachrichtigungen, die bei einer erfolgreichen oder fehlgeschlagenen Übertragung gesendet werden
  • E-Mail-Benachrichtigungen: für Menschen lesbare Benachrichtigungen, die bei einer fehlgeschlagenen Übertragung gesendet werden

Sie können jeden Typ einzeln konfigurieren oder alternativ sowohl Cloud Pub/Sub- als auch E-Mail-Ausführungsbenachrichtigungen verwenden.

Cloud Pub/Sub-Benachrichtigungen

Cloud Pub/Sub-Benachrichtigungen senden Informationen zu Übertragungen an ein Cloud Pub/Sub-Thema. Pub/Sub-Benachrichtigungen werden durch abgeschlossene Übertragungen mit folgendem Status ausgelöst:

  • SUCCEEDED
  • FAILED
  • CANCELLED

Sie können Benachrichtigungen an alle Cloud Pub/Sub-Themen in jedem Projekt senden, für das Sie über ausreichende Berechtigungen verfügen. Nach dem Eingang bei dem jeweiligen Cloud Pub/Sub-Thema kann die Nachricht an eine beliebige Anzahl von Abonnenten dieses Themas weitergeleitet werden.

Vorbereitung

Vor dem Konfigurieren von Cloud Pub/Sub-Ausführungsbenachrichtigungen für Übertragungen sollten Sie Folgendes tun:

  1. Aktivieren Sie die Cloud Pub/Sub API für das Projekt, das die Benachrichtigungen erhalten wird.

    API aktivieren

  2. Achten Sie auf ausreichende Berechtigungen für das Projekt, das die Benachrichtigungen erhalten wird:

    • Wenn Sie der Inhaber des Projekts sind, das die Benachrichtigungen erhalten wird, haben Sie wahrscheinlich die erforderliche Berechtigung.

    • Wenn Sie Themen zum Empfangen von Benachrichtigungen erstellen möchten, benötigen Sie die Berechtigung pubsub.topics.create.

    • Wenn Sie neue oder vorhandene Themen verwenden möchten, benötigen Sie die Berechtigung pubsub.topics.setIamPolicy. Als Ersteller eines Themas haben Sie normalerweise die Berechtigung pubsub.topics.setIamPolicy dafür. Die folgenden vordefinierten IAM-Rollen auf Projektebene umfassen Berechtigungen des Typs pubsub.topics.setIamPolicy:

      • Die vordefinierte Rolle pubsub.admin
      • Die einfache Rolle Owner

      Weitere Informationen finden Sie unter Cloud Pub/Sub-Zugriffssteuerung.

  3. Achten Sie darauf, dass ein bestehendes Cloud Pub/Sub-Thema vorhanden ist, an das Sie Benachrichtigungen senden möchten.

Benachrichtigungsformat

Benachrichtigungen, die an ein Cloud Pub/Sub-Thema gesendet werden, bestehen aus zwei Teilen:

  • Attribute: Eine Reihe von Schlüssel/Wert-Paaren, die das Ereignis beschreiben
  • Nutzlast: Ein String, der die Metadaten des geänderten Objekts enthält

Attribute

Attribute sind Schlüssel/Wert-Paare, die in allen Benachrichtigungen enthalten sind, die vom BigQuery Data Transfer Service an Ihr Cloud Pub/Sub-Thema gesendet werden. Benachrichtigungen enthalten immer die folgenden Schlüssel/Wert-Paare, unabhängig von der Nutzlast der Benachrichtigung:

Attributname Beispiel Beschreibung
eventType TRANSFER_RUN_FINISHED Die Art des Ereignisses, das gerade aufgetreten ist. TRANSFER_RUN_FINISHED ist der einzig mögliche Wert.
payloadFormat JSON_API_V1 Das Format der Objektnutzlast. JSON_API_V1 ist der einzig mögliche Wert.

Nutzlast

Die Nutzlast ist ein String, der die Metadaten der Übertragung enthält. Der Nutzlasttyp ist derzeit nicht konfigurierbar und wird nur für zukünftige Änderungen der API-Version bereitgestellt.

Nutzlasttyp Beschreibung
JSON_API_V1 Die Nutzlast ist ein JSON-serialisierter UTF-8-String, der die Ressourcendarstellung einer Übertragung (TransferRun) enthält.

E-Mail-Benachrichtigungen

E-Mail-Benachrichtigungen senden bei fehlgeschlagenen Übertragungen für Menschen lesbare E-Mail-Nachrichten. Diese Nachrichten werden an den Nutzer gesendet, der die Übertragung eingerichtet hat. Die Nachrichten sind nicht konfigurierbar.

Wenn andere Nutzer E-Mail-Benachrichtigungen zu Übertragungen erhalten sollen, richten Sie E-Mail-Weiterleitungsregeln ein, um die Nachrichten zu verteilen. Bei Verwendung von Gmail können Sie Gmail-Nachrichten automatisch an ein anderes Konto weiterleiten.

Die E-Mail-Benachrichtigung wird vom BigQuery Data Transfer Service gesendet. Sie enthält Details zur Konfiguration und Ausführung der Übertragung sowie einen Link zum Ausführungsverlauf der fehlgeschlagenen Übertragung. Beispiel:

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.

Preise für Ausführungsbenachrichtigungen

Während der Alphaphase berechnet der BigQuery Data Transfer Service keine Gebühren für Ausführungsbenachrichtigungen. Wenn Sie Cloud Pub/Sub-Ausführungsbenachrichtigungen konfigurieren, fallen Gebühren für Cloud Pub/Sub an. Weitere Informationen finden Sie auf der Seite Cloud Pub/Sub-Preise.

Tipp

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...