Snowflake Query v2-Aktivität in Jitterbit Studio

Einführung

Eine Snowflake Query v2-Aktivität ruft mithilfe ihrer Snowflake-Verbindung eine CSV-Datei mit Tabellen- oder Ansichtsdaten über mehrere Snowflake-Schemas ab und ist als Quelle gedacht, um Daten in einem Vorgang bereitzustellen.

Erstelle eine Snowflake Query-Aktivität

Eine Instanz einer Snowflake Query v2-Aktivität wird aus einer Snowflake-Verbindung mit ihrem Query v2-Aktivitätstyp erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehe den Aktivitätstyp auf die Design-Canvas oder kopiere den Aktivitätstyp und füge ihn auf der Design-Canvas ein. Weitere Informationen findest du unter Erstelle eine Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Snowflake Query v2-Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).
• Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte Komponenten).

Konfiguriere eine Snowflake Query-Aktivität

Führe diese Schritte aus, um eine Snowflake Query v2-Aktivität zu konfigurieren:

• Schritt 1: Gib einen Namen ein und wähle ein Objekt aus
  Gib einen Namen für die Aktivität ein und wähle ein Objekt aus.

• Schritt 2: Erstelle deine Abfrage
  Lege Bedingungen für eine Abfrage mithilfe der Objektfelder fest und wende Paging auf eine Abfrage an.

• Schritt 3: Überprüfe die Datenschemas
  Alle vom Endpunkt generierten Request- oder Response-Schemas werden angezeigt.

Schritt 1: Gib einen Namen ein und wähle ein Objekt aus

Gib in diesem Schritt einen Namen für die Aktivität ein und wähle eine Tabelle oder Ansicht aus (siehe Snowflakes Übersicht der Ansichten). Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Endpunkt-Menü: Wenn du mehrere Endpunkte desselben Connector-Typs konfiguriert hast, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicke auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen findest du unter Ändere den zugewiesenen Endpunkt in Konfigurationsbildschirme.

  • Endpunkt bearbeiten: Wird angezeigt, wenn du den Mauszeiger über den aktuellen Endpunktnamen bewegst. Klicke, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

• Name: Gib einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Snowflake Query v2-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

• Wähle Tabelle(n)/Ansicht(en) aus: Dieser Bereich zeigt Tabellen und Ansichten an, die im Snowflake-Endpunkt verfügbar sind. Wenn du eine vorhandene Aktivitätskonfiguration erneut öffnest, wird nur die ausgewählte Tabelle oder Ansicht angezeigt, anstatt die gesamte Liste neu zu laden.

  • Filter: Gib einen Filter für den Tabellen- oder Ansichtsnamen ein, um ihn zu laden. Verwende % als SQL-Platzhalter, um eine beliebige Zeichenkette zu vergleichen. Gib beispielsweise INFORMATION_SCHEMA.% ein, um alle Tabellen und Ansichten in INFORMATION_SCHEMA aufzulisten. Klicke auf Aktualisieren, nachdem du einen Filter eingegeben hast, um die entsprechenden Ergebnisse zu laden.

  • Aktualisieren: Klicke auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Tabellen und Ansichten vom Snowflake-Endpunkt mit dem aktuellen Filter zu laden oder neu zu laden. Ein Filter muss eingegeben werden, bevor eine Aktualisierung durchgeführt wird. Dies kann auch nützlich sein, wenn Tabellen oder Ansichten kürzlich zu Snowflake hinzugefügt wurden.

• Tabellen oder Ansichten auswählen: Nach dem Aktualisieren werden übereinstimmende Tabellen und Ansichten in einer Liste auf der linken Seite angezeigt. Klicken Sie auf eine Tabelle oder Ansicht, um sie zur Auswahlltabelle auf der rechten Seite hinzuzufügen. Ausgewählte Elemente sind hervorgehoben. Es können beliebig viele Tabellen und Ansichten ausgewählt werden, um eine Multi-Table-Abfrage mit Joins zu erstellen.

  Tipp

  Wenn die Liste nach Eingabe eines Filters und Aktualisierung nicht mit verfügbaren Tabellen oder Ansichten gefüllt wird, ist die Snowflake-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

• Tabelle für ausgewählte Tabellen und Ansichten: Ausgewählte Tabellen und Ansichten werden in einer Tabelle auf der rechten Seite angezeigt. Jede Spalte wird nachfolgend beschrieben:

  • Tabelle: Der Name der ausgewählten Tabelle oder Ansicht.

  • Übergeordnet: Verwenden Sie für jede untergeordnete Tabelle oder Ansicht, die verknüpft wird, das Dropdown-Menü, um die übergeordnete Tabelle auszuwählen. Die erste ausgewählte Tabelle hat kein übergeordnetes Element und dient als Stamm der Join-Hierarchie. Sobald ein übergeordnetes Element ausgewählt ist, wird ein Link Zuweisen in der Spalte Verknüpfungsschlüssel angezeigt.

  • Join-Typ: Nachdem Verknüpfungsschlüssel für eine untergeordnete Tabelle oder Ansicht zugewiesen wurden, verwenden Sie das Dropdown-Menü, um den Beziehungstyp zwischen dem untergeordneten Element und seinem übergeordneten Element auszuwählen:

    • Ein oder mehr: Jeder übergeordnete Datensatz muss mindestens einen untergeordneten Datensatz haben.

    • Nur einer: Jeder übergeordnete Datensatz muss genau einen untergeordneten Datensatz haben.

    • Null oder mehr: Jeder übergeordnete Datensatz kann null oder mehr untergeordnete Datensätze haben.

    • Null oder einer: Jeder übergeordnete Datensatz kann null oder einen untergeordneten Datensatz haben.

  • Verknüpfungsschlüssel: Klicken Sie für jede untergeordnete Tabelle oder Ansicht mit einem ausgewählten übergeordneten Element auf Zuweisen, um ein separates Fenster zu öffnen, in dem Sie die Schlüsselbeziehungen zwischen dem übergeordneten und dem untergeordneten Element definieren:

    • Übergeordnetes Objekt: Zeigt die übergeordnete Tabelle oder Ansicht und ihre Felder auf der linken Seite an. Verwenden Sie das Suchfeld, um Felder zu filtern.

    • Untergeordnetes Objekt: Zeigt die untergeordnete Tabelle oder Ansicht und ihre Felder auf der rechten Seite an. Verwenden Sie das Suchfeld, um Felder zu filtern.

    • Verknüpfungsschlüssel zuweisen: Ziehen Sie ein Feld vom übergeordneten Element zum entsprechenden Feld im untergeordneten Element (oder umgekehrt), um eine Verknüpfung zu erstellen. Wiederholen Sie den Vorgang, um mehrere Schlüsselpaare zuzuweisen.

    • Verknüpfungsschlüssel aufheben: Klicken Sie auf ein Feld, das bereits verknüpft ist, um die Verknüpfungszuweisung zu entfernen.

    • Neu starten: Klicken Sie, um alle zugewiesenen Verknüpfungsschlüssel zu löschen.

    • Fertig: Klicken Sie, um die Verknüpfungsschlüsselzuweisungen zu speichern und das Fenster zu schließen. Die Anzahl der zugewiesenen Verknüpfungsschlüssel wird in der Spalte Verknüpfungsschlüssel angezeigt und das Dropdown-Menü Join-Typ wird verfügbar.

  Hinweis

  Die Schaltfläche Weiter bleibt deaktiviert, bis alle Tabellen und Ansichten mit einem ausgewählten übergeordneten Element ihre Verknüpfungsschlüssel zugewiesen haben. Eine Warnung wird am unteren Rand des Bildschirms angezeigt, wenn noch Verknüpfungsschlüsselzuweisungen ausstehen.

• Speichern und beenden: Klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen (falls aktiviert).

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

• Änderungen verwerfen: Klicken Sie nach Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Abfrage erstellen

Erstellen Sie in diesem Schritt eine Abfrageanweisung, indem Sie Bedingungen für Objektfelder festlegen und Paging entweder über den Abfrage-Generator oder durch manuelles Eingeben einer Abfrageanweisung anwenden. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Suche: Geben Sie einen beliebigen Teil eines Feldnamens in das Suchfeld ein, um die Feldliste für das ausgewählte Objekt zu filtern. Die Suche ist nicht case-sensitiv. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um die Felder des Objekts vom Snowflake-Endpunkt neu zu laden.

• Alle auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen.

• Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, damit diese automatisch zur Abfrageanweisung in der Abfragezeichenfolge hinzugefügt werden. Sie können auch Alle Felder auf einmal mit dem Kontrollkästchen auswählen.

• Paginierung: Um eine Paginierungsklausel (eine Begrenzung der Anzahl der Datensätze mit optionalem Datensatzoffset) hinzuzufügen, können Sie das Dropdown-Menü verwenden, um das Paginierungslimit und das Feld für die Eingabe eines Offsets festzulegen. Wenn kein Offset angegeben ist, wird standardmäßig 0 verwendet. Es wird eine einzelne Paginierungsklausel unterstützt. Wenn die Paginierungsklausel nicht enthalten ist, werden alle Datensätze zurückgegeben.

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

  • Entfernen: Klicken Sie, um eine angewendete Paginierungsklausel zu entfernen.

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

  • Feld: Verwenden Sie das Dropdown-Menü, um ein Feld aus dem ausgewählten Objekt auszuwählen.

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

    Operator	Bezeichnung	Beschreibung
    =	Gleich
    !=	Ungleich
    IN (value1, value2)	In	In Liste von Werten.
    LIKE 'string'	Wie	Wie string.
    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, um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu erstellen. Die bedingte Klausel wird zum Textfeld Abfragezeichenfolge hinzugefügt.

  • Alle entfernen: Klicken Sie, um alle eingegebenen bedingten Klauseln zu entfernen.

• Abfragezeichenfolge: Wenn Sie Felder auswählen, Bedingungen angeben und die Paginierung festlegen, wird die Abfrageanweisung in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Paginierungslimits gefüllt. Dieses Feld ist bearbeitbar, d. h. Sie können manuell eine Abfrageanweisung eingeben oder die automatisch gefüllte Anweisung bearbeiten.

  Hinweis

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

  Wichtig

  Um eine Abfrageanweisung zu verwenden, die Elemente enthält, die nicht über diese Schnittstelle ausgewählt wurden, müssen Sie auch das Kontrollkästchen Statisches Schema verwenden aktivieren.

• Statisches Schema verwenden: Wählen Sie diese Option, um das Antwortschema auf ein statisches Schema festzulegen, das unabhängig von der Abfrageanweisung ist. Dies ermöglicht die Verwendung von benutzerdefinierten Abfrageanweisungen, die im Textfeld Abfragezeichenfolge eingegeben werden.

• Abfrage testen: Klicken Sie, um die Abfrage zu validieren. Wenn die Abfrage gültig ist, werden maximal 50 Datensätze aus der Abfrage in einer Tabelle angezeigt. Wenn die Abfrage nicht gültig ist, werden relevante Fehlermeldungen angezeigt.

  Hinweis

  Während der Laufzeit wird das Limit von 50 Datensätzen nicht erzwungen, es sei denn, es ist im Feld Paging angegeben (siehe oben). Wenn Sie die Abfragezeichenfolge manuell bearbeiten, muss die Abfrage gültig sein und durch diese Schaltfläche validiert werden, um die Schaltfläche Weiter zu aktivieren.

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

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

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschemas überprüfen

Alle vom Endpunkt generierten Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Transformationszuordnung angezeigt.

  Hinweis

  In einer Transformation bereitgestellte Daten haben Vorrang vor der Aktivitätskonfiguration.

  Die Standard-Request- und Response-Datenschemas bestehen aus diesen Knoten und Feldern:

  • Request

    Request-Schemafeld/-knoten	Hinweise
    queryRequest	Knoten der Abfrageanforderung.
    whereClause	Knoten der WHERE-Klauselanforderung.
    columnName	Spaltenname der WHERE-Klausel.
    condition	Bedingung der WHERE-Klausel.
    value	Wert der WHERE-Klausel.

  • Response

    Response-Schemafeld/-knoten	Hinweise
    table	Knoten mit dem Tabellennamen NAME.
    Entity	Knoten der Entität.
    column_A	Wert für die erste Spalte, COLOR.
    column_B	Wert für die zweite Spalte, FLOWER.
    . . .	Werte für die nachfolgenden Tabellenspalten.

  Wenn Statische Schemas verwenden ausgewählt ist, besteht das Response-Datenschema aus diesen Knoten und Feldern:

  • Response

    Response-Schemafeld/-knoten	Hinweise
    queryResponse	Knoten der Abfrageantwort.
    row	Knoten der Antwortzeile.
    item	Knoten des Antwortelements.
    columnName	Spaltenname des Antwortelements.
    columnValue	Spaltenwert des Antwortelements.

  Weitere Informationen finden Sie in den Snowflake SQL-Befehlen und der Snowflake API-Referenz.

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

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

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

• Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Snowflake-Aktivität Query v2 schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Snowflake-Aktivitäten Query v2 können als Quelle mit diesen Vorgangsmustern verwendet werden:

• Transformationsmuster
• Muster für zwei Ziele mit Archivierung (nur als erste Quelle)
• Muster für zwei Ziele mit HTTP-Archivierung (nur als erste Quelle)
• Muster für zwei Transformationen (als erste oder zweite Quelle)

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, stellen Sie den Vorgang bereit und führen Sie ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle kontrollieren.