Workiva Support Center

Mit dem Google® BigQuery® Connector können Sie Befehle in einer Kette verwenden, um mit einem BigQuery-Projekt zu interagieren. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

• Laden und Abfragen von Daten in BigQuery-Tabellen
• Abrufen von Metadaten über BigQuery-Datensätze, Modelle, Routinen und Tabellen
• Auflisten von Datensätzen, Modellen, Routinen und Tabellen in BigQuery

Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Voraussetzungen

Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Die ID des BigQuery-Projekts, mit dem eine Verbindung hergestellt werden soll

  Hinweis: In BigQuery wird die ID des Projekts im Selektor Project angezeigt.

• Ein bestimmtes Projektdienstkonto, das für den Konnektor eingerichtet wurde
• Die JSON-Datei des privaten Schlüssels des Dienstkontos

Erstellen Sie ein Google-Dienstkonto für den Connector

Um die Verbindung zu aktivieren, erstellen Sie ein Dienstkonto im BigQuery-Projekt, das der Connector verwenden soll, und laden Sie seine private Schlüsseldatei herunter:

1. Wählen Sie unter Service Accounts in Google Cloud Platform die Option Select Project und öffnen Sie das BigQuery-Projekt, mit dem Sie sich verbinden möchten.
2. Klicken Sie auf Servicekonto erstellen.
   
3. Geben Sie einen eindeutigen Namen und eine Beschreibung ein, um das Dienstkonto zu identifizieren, und klicken Sie auf Erstellen.
   
4. Wählen Sie unter Rolle, Projekt, Eigentümer, und klicken Sie auf Weiter und dann Fertig.
5. Wählen Sie unter Service Accounts, Actions, Create key für das neue Konto.
   
6. Unter Schlüsseltyp, wählen Sie JSON, und klicken Sie auf Erstellen.

Einrichten des Google BigQuery-Connectors

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Connection, Google BigQuery und den Standard-CloudRunner.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
4. Laden Sie unter Resources die JSON-Datei des privaten Schlüssels für das Dienstkonto des Connectors hoch.
   
5. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   
   

   Eigenschaft	Details
   Projekt-ID	Geben Sie die ID des BigQuery-Projekts ein, mit dem eine Verbindung hergestellt werden soll. Hinweis: In BigQuery wird die Projekt-ID im Selektor Project angezeigt.
   Datei der Anmeldeinformationen	Geben Sie den Namen der JSON-Datei des privaten Schlüssels ein, die unter Resources hochgeladen wurde.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

6. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
7. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Datensätze auflisten des Konnektors aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Wenn die Verbindung zu Google BigQuery fehlschlägt:

• Überprüfen Sie die ID des Projekts. In BigQuery wird die ID im Selektor Project angezeigt.
• Überprüfen Sie den Dateinamen des privaten Schlüssels für das Dienstkonto des Connectors. Erstellen Sie gegebenenfalls ein neues Dienstkonto für den Connector in Google Cloud Platform und verwenden Sie dessen privaten Schlüssel als Anmeldedatei für den Connector.