Zum Inhalt springen

Snowflake Invoke Stored Procedure-Aktivität in Jitterbit Studio

Einführung

Eine Snowflake Invoke Stored Procedure-Aktivität verwendet ihre Snowflake-Verbindung zum Aufrufen einer in Snowflake erstellten gespeicherten Prozedur und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Informationen zu Snowflake-Speicherprozeduren finden Sie bei Snowflake unter Stored Procedures und Stored Procedure Management.

Erstellen einer Snowflake Invoke Stored Procedure-Aktivität

Eine Instanz einer Snowflake Invoke Stored Procedure-Aktivität wird aus einer Snowflake-Verbindung mit dem Aktivitätstyp Invoke Stored Procedure 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 Invoke Stored Procedure-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Snowflake Invoke Stored Procedure-Aktivität

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

Schritt 1: Namen eingeben und gespeicherte Prozedur auswählen

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

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. 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 Invoke Stored Procedure-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Gespeicherte Prozedur auswählen: In diesem Bereich werden die im Snowflake-Endpunkt verfügbaren gespeicherten Prozeduren angezeigt. Beim erneuten Öffnen einer vorhandenen Aktivitätskonfiguration wird nur die ausgewählte gespeicherte Prozedur angezeigt, anstatt die gesamte Liste der gespeicherten Prozeduren neu zu laden.

    • Ausgewählte gespeicherte Prozedur: Nach der Auswahl einer gespeicherten Prozedur wird diese hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der gespeicherten Prozeduren zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn gespeicherte Prozeduren bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um gespeicherte Prozeduren 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 gespeicherte Prozeduren vom Snowflake-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn gespeicherte Prozeduren zu Snowflake hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Tabelle gespeicherter Prozeduren verwendet werden.

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

Tipp

Wenn die Tabelle nicht mit verfügbaren gespeicherten Prozeduren 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 der letzten Seite auf die Schaltfläche Fertig 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: 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 während der Datenzuordnung erneut angezeigt.

Hinweis

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

Tipp

Wenn in einer Request-Payload ein einfaches Anführungszeichen (') vorhanden ist, wird zur Laufzeit ein Syntaxfehler zurückgegeben. Sie können die Einstellung Sonderzeichen escapen in der Verbindung aktivieren, damit die Aktivität einfache Anführungszeichen (') zur Laufzeit automatisch escaped.

Die Datenschemas werden durch die gespeicherte Prozedur bestimmt, die aufgerufen wird. 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 Snowflake-Endpunkt neu zu generieren. Diese Aktion generiert auch ein 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 Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Snowflake-Aktivität Gespeicherte Prozedur aufrufen 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 Design-Canvas zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Snowflake Invoke Stored Procedure Aktivitäten können als Ziel mit diesen Operationsmustern verwendet werden:

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

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.