Snowflake Get-Aktivität in Jitterbit Studio

Einführung

Eine Snowflake Get-Aktivität ruft mithilfe ihrer Snowflake-Verbindung eine CSV-Datei mit Tabellen- oder Ansichtsdaten aus Snowflake ab und dient als Quelle zur Bereitstellung von Daten in einem Vorgang.

Erstelle eine Snowflake Get-Aktivität

Eine Instanz einer Snowflake Get-Aktivität wird aus einer Snowflake-Verbindung mit ihrem Get-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 Get-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 Get-Aktivität

Führe diese Schritte aus, um eine Snowflake Get-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, entweder eine Tabelle oder eine Ansicht.

• Schritt 2: Überprüfe die Datenschemas
  Alle aus dem Endpunkt generierten Anfrage- oder Antwortschemas 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.

• Endpunktmenü: 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 Get-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

• Wähle ein Objekt aus: Dieser Bereich zeigt Objekte an, die im Snowflake-Endpunkt verfügbar sind. Wenn du eine vorhandene Aktivitätskonfiguration erneut öffnest, wird nur das ausgewählte Objekt angezeigt, anstatt die gesamte Objektliste neu zu laden.

  • Ausgewähltes Snowflake-Objekt: Nach der Auswahl eines Objekts wird es hier aufgelistet.

• Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht case-sensitiv. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Objekte vom Snowflake-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Objekte zu Snowflake hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der angezeigten Objekte verwendet werden.

• Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die für jedes Objekt verfügbaren Informationen werden vom Snowflake-Endpunkt abgerufen:

  • Name: Der Name eines Objekts, entweder eine Tabelle oder eine Ansicht.

  • Typ: Der Typ des Objekts, entweder eine Tabelle oder eine Ansicht.

• NullIf: Der Wert, der zurückgegeben werden soll, wenn ein Ergebnis NULL ist.

• Field Optionally Enclosed By: Das optionale Zeichen, das zum Einschließen des Felds NullIf verwendet wird.

• Speichern und beenden: Wenn aktiviert, klicken Sie, 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 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 an einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas, die vom Endpunkt generiert werden, werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

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

  Hinweis

  Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

  Die Anfrage- und Antwortdatenschemas bestehen aus diesen Knoten und Feldern:

  • Anfrage

    Anfrageschema-Feld/Knoten	Hinweise
    stageName	Name der internen Snowflake-Phase, die beim Abrufen von Tabellendaten verwendet wird. Hinweis Der stageName ist der Name eines internen Snowflake-Staging-Bereichs, der vor dem Ausführen einer Operation mit dieser Aktivität bereits vorhanden sein muss. Die Datei wird zunächst in den Staging-Bereich kopiert, bevor sie dem Connector zur Verfügung steht.
    fileName	Name der Datei in der internen Snowflake-Phase, die beim Abrufen von Tabellendaten verwendet werden soll.
    compressData	Boolesches Flag, das angibt, ob die Daten vor dem Hochladen in die interne Snowflake-Phase komprimiert werden sollen.
    fileFormat	Knoten des Dateiformats.
    nullIf	Anzeigewert für NULLIF.
    FIELD_OPTIONALLY_ENCLOSED_BY	Trennzeichen zum Einschließen des NULLIF-Eintrags.

  • Antwort

    Antwortschema-Feld/Knoten	Hinweise
    fileName	Name der Datei auf der internen Snowflake-Phase, die beim Abrufen von Tabellendaten verwendet wird (identisch mit Anfrage).
    content	Inhalt der Snowflake-Tabelle im CSV-Format.

  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: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Snowflake-Aktivität Get schließen Sie die Konfiguration des Vorgangs ab, indem Sie andere 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 Get können als Quelle mit diesen Vorgangsmustern verwendet werden:

• Transformationsmuster
• Zwei-Ziel-Archivierungsmuster (nur als erste Quelle)
• Zwei-Ziel-HTTP-Archivierungsmuster (nur als erste Quelle)
• Zwei-Transformationsmuster (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 validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.