Zum Inhalt springen

Snowflake Merge-Aktivität in Jitterbit Studio

Einführung

Eine Snowflake Merge-Aktivität verwendet ihre Snowflake-Verbindung und fügt eine CSV-Datei mit Tabellendaten in Snowflake ein oder aktualisiert sie. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Die Snowflake Merge-Aktivität unterstützt das Löschen eines vorhandenen Datensatzes nicht.

Hinweis

Die Snowflake Merge-Aktivität ähnelt einer Upsert-Aktivität, wie sie in anderen Konnektoren verwendet wird.

Erstellen einer Snowflake Merge-Aktivität

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

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

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

Konfigurieren einer Snowflake Merge-Aktivität

Führen Sie diese Schritte aus, um eine Snowflake Merge-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Tabelle auswählen

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

  • Endpunktmenü: Wenn mehrere Endpunkte desselben Konnektortyps konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

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

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

  • Tabelle auswählen: Dieser Bereich zeigt Tabellen an, die im Snowflake-Endpunkt verfügbar sind. Beim erneuten Öffnen einer vorhandenen Aktivitätskonfiguration wird nur die ausgewählte Tabelle angezeigt, anstatt die gesamte Tabellenliste neu zu laden.

    • Ausgewählte Tabelle: Nach der Auswahl einer Tabelle wird sie hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Tabellenliste zu filtern. Bei der Suche wird die Groß- und Kleinschreibung nicht beachtet. Wenn Tabellen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Tabellen vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachfolgend beschrieben.

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

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

    • Name: Der Name einer Tabelle.

    • Typ: Der Typ, bei dem es sich um eine Tabelle handelt.

Tipp

Wenn die Tabelle nicht mit verfügbaren Tabellen 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.

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

Schritt 2: Merge-Schlüssel auswählen

Geben Sie in diesem Schritt die Spalten an, die für Merge-Schlüssel verwendet werden sollen. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Merge-Schlüssel: Wählen Sie die Spalten aus, die als Aktualisierungsschlüssel für den Merge verwendet werden sollen.

  • 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie Änderungen verwerfen möchten.

Schritt 3: Einen Ansatz auswählen

Für das Zusammenführen von Daten mit Snowflake werden verschiedene Ansätze unterstützt. Wählen Sie zwischen Direktes Mapping oder Staging-Datei. Bei Verwendung des Ansatzes Staging-Datei wählen Sie entweder die Optionen Vorhandenes Staging verwenden oder Temporäres Staging verwenden.

Ansatz für direktes Mapping

  • Ansatz: Verwenden Sie das Dropdown-Menü, um Direktes Mapping auszuwählen.

  • Name des temporären Staging: Geben Sie einen Namen ein, der für ein temporäres Staging in Snowflake verwendet werden soll.

  • 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie Änderungen verwerfen möchten.

Ansatz für Staging-Datei (vorhandenes Staging verwenden)

  • Ansatz: Verwenden Sie das Dropdown-Menü, um Staging-Datei auszuwählen.

  • Staging-Typ: Verwenden Sie das Dropdown-Menü, um Vorhandenes Staging verwenden auszuwählen.

  • Staging auswählen: Dieser Bereich zeigt die im Snowflake-Endpunkt verfügbaren Stagings an. Beim erneuten Öffnen einer vorhandenen Aktivitätskonfiguration wird nur das ausgewählte Staging angezeigt, anstatt die gesamte Staging-Liste neu zu laden.

    • Ausgewähltes Staging: Nach der Auswahl eines Staging wird es hier aufgelistet.

    • Suche: Geben Sie einen beliebigen Spaltenwert in das Suchfeld ein, um die Liste der Stagings zu filtern. Bei der Suche wird die Groß- und Kleinschreibung nicht beachtet. Wenn Tabellen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Tabellen 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 Tabellen vom Snowflake-Endpoint neu zu laden. Dies kann hilfreich sein, wenn Sie kürzlich Tabellen zu Snowflake hinzugefügt haben. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Tabellenliste verwendet werden.

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

      • Name: Der Stage-Name aus Snowflake.

      • Typ: Der Stage-Typ aus Snowflake. Informationen zu den Unterschieden zwischen internen und externen Stages finden Sie in der Snowflake-Dokumentation zum Erstellen von Stages.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Stages 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.

  • 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Stage-Datei-Ansatz (Temporäre Stage verwenden)

  • Ansatz: Verwenden Sie das Dropdown-Menü, um Stage-Datei auszuwählen.

  • Stage-Typ: Verwenden Sie das Dropdown-Menü, um Temporäre Stage verwenden auszuwählen.

  • Name der temporären Stage: Geben Sie einen Namen ein, der für eine temporäre Stage in Snowflake verwendet werden soll.

  • 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Datenschemas überprüfen

Die vom Endpoint generierten Request- und Response-Schemas werden angezeigt. Die angezeigten Schemas hängen vom Ansatz ab, der im vorherigen Schritt angegeben wurde.

Diese Unterabschnitte beschreiben die Request- und Response-Strukturen für jeden Ansatz:

Diese Aktionen sind bei jedem Ansatz verfügbar:

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

    Hinweis

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

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

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Endpoint neu zu generieren. Diese Aktion generiert auch das Schema an anderen Stellen im Projekt neu, an denen auf das gleiche 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 die Änderungen verwerfen möchten.

Direkter Zuordnungsansatz

Dies sind die Schemafeldersichtbar im obigen Beispiel-Screenshot:

  • Anfrage

    Anfrageschema-Feld/Knoten Hinweise
    updateRequest Knoten der Merge-Anfrage.
    table Knoten mit dem Tabellennamen NAME.
    item Knoten des Elements.
    column_A Wert für den ersten Spaltennamen COLOR.
    column_B Wert für den zweiten Spaltennamen FLOWER.
    . . . Werte für nachfolgende Tabellenspalten.

  • Antwort

    Antwortschema-Feld/Knoten Hinweise
    mergeResponse Knoten der Merge-Antwort.
    noOfRowsUpdated Anzahl der aktualisierten Zeilen.
    noOfRowsInserted Anzahl der eingefügten Zeilen.
    errors Knoten der Fehler.
    item Knoten der Fehlerelemente.
    errorMessage Fehlermeldung für das Fehlerelement.

Staging-Datei-Ansatz

Dies sind die Schemafelder, die im obigen Beispiel-Screenshot sichtbar sind:

  • Anfrage

    Anfrageschema-Feld/Knoten Hinweise
    mergeRequest Knoten der Merge-Anfrage.
    stageName Pfad oder Präfix, unter dem die Daten auf der Snowflake-Stage hochgeladen werden.
    fileContent Dateiinhalte im CSV-Format, die zum Aktualisieren in der Snowflake-Tabelle bereitgestellt werden.
    destPrefix Zieldateipräfix, das auf der Snowflake-Stage verwendet werden soll.
    destFileName Zieldateiname, der auf der Snowflake-Stage verwendet werden soll.

    Wichtig

    Wenn Vorhandene Stage verwenden ausgewählt ist und der Typ der ausgewählten Stage extern ist, werden stageName und fileContent aus dem Anfrageschema ausgeschlossen.

    Informationen zu den Unterschieden zwischen internen und externen Stages finden Sie in der Snowflake-Dokumentation zum Erstellen von Stages.

  • Antwort

    Antwortschema-Feld/Knoten Hinweise
    mergeResponse Knoten der Merge-Antwort.
    noOfRowsUpdated Anzahl der aktualisierten Zeilen.
    noOfRowsInserted Anzahl der eingefügten Zeilen.
    errors Knoten der Fehler.
    item Knoten der Fehlerelemente.
    errorMessage Fehlermeldung für das Fehlerelement.

Nächste Schritte

Nach der Konfiguration einer Snowflake-Aktivität Merge wird die Konfiguration des Vorgangs durch das Hinzufügen und Konfigurieren weiterer Aktivitäten oder Tools als Vorgangsschritte abgeschlossen. 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 Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktionsmenü für Aktivitäten in Connector-Grundlagen.

Snowflake Merge-Aktivitäten können als Ziel mit diesen Operationsmustern 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 alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.