Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

Google BigQuery-Abfrageaktivität

Einführung

Eine Google BigQuery Query-Aktivität unter Verwendung ihrer Google BigQuery-Verbindung, fragt eine Tabelle in einem Datensatz in Google BigQuery ab und soll als Quelle in einer Operation verwendet werden.

Erstellen einer Google BigQuery Abfrageaktivität

Eine Instanz einer Google BigQuery Query-Aktivität wird aus einer Google BigQuery-Verbindung erstellt mithilfe des Aktivitätstyps Abfrage.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie ihn und fügen Sie ihn dort ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Google BigQuery Query-Aktivität kann an diesen Stellen bearbeitet werden:

Konfigurieren einer Google BigQuery-Abfrageaktivität

Führen Sie die folgenden Schritte aus, um eine Google BigQuery -Abfrage-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie den Datensatz aus

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie den Datensatz aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Google BigQuery Abfrageaktivitätskonfiguration Schritt 1

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede Google BigQuery Query-Aktivität eindeutig sein und darf keine Schrägstriche enthalten. / oder Doppelpunkte :.

  • Datensatz auswählen: In diesem Abschnitt werden die im Google BigQuery Endpoint verfügbaren Datensätze angezeigt.

    • Ausgewählter Datensatz: Nachdem ein Datensatz ausgewählt wurde, wird er hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Datensätze zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn bereits Datensätze in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Datensätze während der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie anschließend die Tabelle, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Datasets vom Google BigQuery Endpoint neu zu laden. Dies kann nützlich sein, wenn Datasets zu Google BigQuery hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Dataset-Tabelle verwendet wurden.

    • Datensatz auswählen: Klicken Sie in der Tabelle auf eine beliebige Zeile, um einen Datensatz auszuwählen. Es kann nur ein Datensatz ausgewählt werden. Die für jeden Datensatz verfügbaren Informationen werden vom Google BigQuery Endpoint abgerufen:

      • Name: Der Name des Datensatzes.

      • Beschreibung: Die Beschreibung des Datensatzes.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Datensätzen gefüllt wird, wird die Google BigQuery Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Speichern & Beenden: Klicken Sie, falls aktiviert, auf diese Schaltfläche, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf diese Schaltfläche, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Schritt 2: Wählen Sie die Tabelle aus

Wählen Sie in diesem Schritt die Tabelle aus. Die einzelnen Elemente der Benutzeroberfläche werden im Folgenden beschrieben.

Google BigQuery Abfrageaktivitätskonfiguration Schritt 2

  • Tabelle auswählen: In diesem Abschnitt werden die im Google BigQuery Endpoint verfügbaren Tabellen angezeigt.

    • Ausgewählter Datensatz: Der im vorherigen Schritt ausgewählte Datensatz wird hier aufgelistet.

    • Ausgewählte Tabelle: Nachdem eine Tabelle ausgewählt wurde, wird sie hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Tabellenliste zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn bereits Tabellen in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Tabellen während der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie anschließend die Seite, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Tabellen vom Google BigQuery Endpoint neu zu laden. Dies kann nützlich sein, wenn Tabellen zu Google BigQuery hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Tabellentabelle verwendet wurden.

    • Tabelle auswählen: Klicken Sie innerhalb der Tabelle auf eine beliebige Zeile, um eine Tabelle auszuwählen. Es kann nur eine Tabelle ausgewählt werden. Die für jede Tabelle verfügbaren Informationen werden vom Google BigQuery Endpoint abgerufen:

      • Name: Der Name der Tabelle.

      • Beschreibung: Die Beschreibung der Tabelle.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Tabellen gefüllt wird, wird die Google BigQuery Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Schritt 3: Erstellen Sie Ihre Abfrage

In diesem Schritt erstellen Sie eine Abfrage, indem Sie Bedingungen für Objektfelder festlegen und die Seitennummerierung entweder über den Abfrage oder durch manuelle Eingabe einer Abfrage anwenden. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Notiz

Sie können den Abfrage Generator umgehen und eine Abfrage in das Feld Abfragezeichenfolge eingeben.

Google BigQuery Abfrageaktivitätskonfiguration Schritt 3

Tipp

Felder mit einem variablen Symbol Unterstützung bei der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Abzurufende Felder: Verwenden Sie diesen Abschnitt, um eine Abfrage zu erstellen, indem Sie abzurufende Felder auswählen.

    • Suchen: Geben Sie einen beliebigen Teil eines Feldnamens in das Suchfeld ein, um die Liste der Felder für das ausgewählte Objekt zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Die Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Felder des Objekts vom Google BigQuery Endpoint neu zu laden.

    • Alles auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie mit diesem Kontrollkästchen alle sichtbaren Felder auf einmal auswählen.

    • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die in die Abfrage einbezogen werden sollen, damit sie automatisch in die Abfrage in der Abfragezeichenfolge eingefügt werden. Sie können auch alle Felder gleichzeitig auswählen.

  • Paging: Um eine Paging-Klausel (eine Begrenzung der Datensatzanzahl mit optionalem Datensatz-Offset) hinzuzufügen, können Sie die Dropdown-Liste verwenden, um die Paging-Begrenzung festzulegen, und das Feld verwenden, um einen Offset einzugeben. Wenn kein Offset angegeben ist, wird standardmäßig 0 verwendet. Eine einzelne Paging-Klausel wird unterstützt. Wenn keine Paging-Klausel enthalten ist, werden alle Datensätze zurückgegeben.

    • Übernehmen: Klicken Sie hier, um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu erstellen. Die automatisch erstellte Paging-Klausel wird im Textfeld Abfragezeichenfolge angezeigt.

    • Entfernen: Klicken Sie hier, um eine angewendete Paging-Klausel zu entfernen.

  • Bedingungen: Um Bedingungsklauseln hinzuzufügen, verwenden Sie die folgenden Felder als Eingabe, um die Klauseln zu konstruieren, die dann im Textfeld Abfragezeichenfolge angezeigt werden.

    • Feld: Verwenden Sie die Dropdown-Liste, um ein Feld aus dem ausgewählten Objekt auszuwählen.

    • Operator: Verwenden Sie die Dropdown-Liste, um einen Operator auszuwählen, der für den Felddatentyp geeignet ist:

      Operator Bezeichnung Beschreibung
      = Ist gleich
      != Ungleich
      IN (Wert1, Wert2) In In Werteliste.
      IST NULL Ist Null Hat keinen Wert.
      IST NICHT NULL Ist nicht Null Hat einen Wert.
      LIKE 'Zeichenfolge' Gefällt mir Gefällt mir Zeichenfolge.
      LIKE 'string%' Beginnt mit Beginnt mit string.
      LIKE '%string' Endet mit Endet mit string.
      LIKE '%string%' Enthält Enthält string.
      < Kleiner als
      <= Kleiner oder gleich
      > Größer als
      >= Größer oder gleich

    • Wert: Geben Sie den gewünschten Wert ein, der mit den Dropdown-Auswahlen verwendet werden soll.

    • Hinzufügen: Klicken Sie hier, um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu erstellen. Die Bedingungsklausel wird dem Textfeld Abfragezeichenfolge hinzugefügt.

    • Alle entfernen: Klicken Sie hier, um alle eingegebenen Bedingungssätze zu entfernen.

  • Abfragezeichenfolge: Wenn Sie Felder auswählen, Bedingungen festlegen und die Seitennummerierung festlegen, wird die Abfrage in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Seitenbegrenzungen ausgefüllt. Dieses Feld ist editierbar, d. h. Sie können eine Abfrage manuell eingeben oder die automatisch ausgefüllte Anweisung bearbeiten.

    Hinweis

    Die Werte aller globalen Variablen in der Abfragezeichenfolge werden bei Verwendung der Schaltfläche Abfrage testen nicht ausgefüllt, selbst wenn ein Standardwert angegeben ist. Globale Variablenwerte werden zur Laufzeit bei Ausführung der Abfrage abgerufen. Um die Abfrage mit einem Standardvariablenwert zu testen, verwenden Sie eine Projektvariable stattdessen.

  • Testabfrage: Klicken Sie hier, um die Abfrage zu validieren. Bei gültiger Abfrage werden maximal 50 Abfrage in einer Tabelle angezeigt. Ist die Abfrage ungültig, werden entsprechende Fehlermeldungen angezeigt. Wenn Sie die Abfragezeichenfolge manuell bearbeiten, muss die Abfrage gültig sein und über diese Schaltfläche validiert werden, um die Schaltfläche Weiter zu aktivieren.

    Notiz

    Während der Laufzeit wird die Begrenzung auf 50 Datensätze nicht erzwungen, es sei denn, sie ist im Feld Paging (siehe oben) angegeben.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf, um die Konfiguration zu schließen, ohne die Änderungen in einem Schritt zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Schritt 4: Überprüfen der Datenschemata

Alle Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Google BigQuery Abfrageaktivitätskonfiguration Schritt 4

  • Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

    Der Google BigQuery Konnektor verwendet die Google SDK-Version 25.4.0. Informationen zu den Schema und -feldern finden Sie in der SDK-Dokumentation.

    Die Abfrage-Aktivität verwendet JSON in ihrem Schema.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Google BigQuery Endpoint neu zu generieren. Diese Aktion generiert ein Schema auch an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie hier, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf, um die Konfiguration zu schließen, ohne die Änderungen in einem Schritt zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Nächste Schritte

Nachdem Sie eine Google BigQuery Query-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Tools hinzufügen und konfigurieren als Operation. Sie können auch die Operation konfigurieren, darunter die Möglichkeit, Vorgänge im selben oder in verschiedenen Workflows miteinander zu verketten.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktionsmenü“ in Connector-Grundlagen.

Google BigQuery Query-Aktivitäten können mit diesen Operation als Quelle verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten, indem Sie die Operation.