Schneeflocken-Befehle

Um SQL-Vorgänge (Structured Query Language) in Snowflake®-Datenbanken als Teil einer Kette durchzuführen, fügen Sie einen Schritt hinzu, der einen Snowflake-Verbindungsbefehl enthält.

Um diese Befehle zu aktivieren, muss ein IT-Administrator zunächst unter einen Snowflake-JDBC-Konnektor erstellen .

Ausführen von create

Um eine CREATE Anweisung auszuführen, verwenden Sie einen Execute create Befehl.

Eigenschaften

Eigenschaft	Einzelheiten
SQL-Text/Datei	Geben Sie den auszuführenden SQL-Text oder die Datei ein.

Ausgaben

Ausgabe	Art der Ausgabe
SQL-Fehler	JSON

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Eingaben
3	Fehler	Der Befehl konnte nicht ausgeführt werden

Abfrage ausführen

Um eine SELECT Abfrage auszuführen und ihre Ergebnisse als kommagetrennte Werte (CSV) zu generieren, verwenden Sie den Befehl Abfrage ausführen.

Eigenschaften

Eigenschaft	Einzelheiten
SQL-Text/Datei	Geben Sie den auszuführenden SQL-Text oder die Datei ein.
Trennzeichen	Wählen Sie das Trennzeichen, das in der CSV-Ausgabe verwendet werden soll.
Vorschau der Ergebnisse	Um eine Vorschau der zurückgegebenen Zeilen zu sehen, markieren Sie dieses Feld.

Ausgaben

Ausgabe	Art der Ausgabe
Anzahl der Datensätze	Ganzzahl
Ergebnismenge (CSV)	Datei
SQL-Fehler	JSON

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Eingaben
3	Fehler	Der Befehl konnte nicht ausgeführt werden

SQL ausführen

Um einen beliebigen SQL-Befehl auszuführen, verwenden Sie den Befehl Execute SQL. Jede Ergebnismenge wird als Dateiausgabe zur Verfügung stehen.

Eigenschaften

Eigenschaft	Einzelheiten
SQL-Text/Datei	Geben Sie den auszuführenden SQL-Text oder die Datei ein.

Ausgaben

Ausgabe	Art der Ausgabe
Anzahl der Datensätze	Ganzzahl
Ergebnismenge (CSV)	Datei
Aktualisierte Datensätze	Ganzzahl
SQL-Fehler	JSON

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Eingaben
3	Fehler	Der Befehl konnte nicht ausgeführt werden

Aktualisierung durchführen

Um eine UPDATE Anweisung auszuführen, verwenden Sie einen Execute update Befehl.

Eigenschaften

Eigenschaft	Einzelheiten
SQL-Text/Datei	Geben Sie den auszuführenden SQL-Text oder die Datei ein.

Ausgaben

Ausgabe	Art der Ausgabe
Aktualisierte Datensätze	Ganzzahl
SQL-Fehler	JSON

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Eingaben
3	Fehler	Der Befehl konnte nicht ausgeführt werden

Tabellendefinition abrufen

Um die Details einer Tabelle - einschließlich ihrer Spalten, Primärschlüssel und Fremdschlüssel - als JSON abzurufen, verwenden Sie den Befehl Get table definition.

Eigenschaften

Eigenschaft	Einzelheiten
Tabelle	Geben Sie die Tabelle ein, deren Definition Sie abrufen möchten.

Ausgaben

Ausgabe	Art der Ausgabe
Metadaten der Tabelle	Datei
SQL-Fehler	JSON

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Es wurden ungültige Eingaben gemacht
3	Fehler	Der Befehl konnte nicht ausgeführt werden

Datensätze einfügen

Um eine INSERT Anweisung auszuführen, verwenden Sie einen Insert records Befehl. Die Quelle der Daten kann entweder ein mehrzeiliger Text oder eine CSV-Datei sein.

Eigenschaften

Eigenschaft	Einzelheiten
Tabelle	Geben Sie die Tabelle ein, in die Datensätze eingefügt werden sollen.
CSV-Datenquelle	Geben Sie die CSV-Datei ein, die in die Tabelle eingefügt werden soll. Die Spalten in der CSV-Datei müssen in der gleichen Reihenfolge angeordnet sein, wie sie in Columns angegeben ist.
Trennzeichen	Wählen Sie das in der CSV-Datenquelle verwendete Trennzeichen.
Ist eine Datei	Aktivieren Sie dieses Kontrollkästchen, um die CSV-Datenquelle „ “ ( ) als Datei zu behandeln.
Enthält Kopfzeilen	Aktivieren Sie dieses Kontrollkästchen, um die erste Zeile der CSV-Datenquelle „ “ ( ) als Kopfzeile zu behandeln.
Spalten	Geben Sie die Liste der Spalten ein, die CSV-Datenquelle auffüllen soll. Die Reihenfolge ist wichtig und sollte mit der CSV-Datenquelle übereinstimmen.
Wertvorlage	Geben Sie die Deklaration der benutzerdefinierten Werte für den Befehl „ “ `INSERT ein und kennzeichnen Sie dabei jeden Wert mit einem „ “ ? . Die Anzahl der ?s sollte der Anzahl der Felder im Ziel entsprechen. Um die automatische Generierung zu aktivieren, lassen Sie dieses Feld leer.`
Automatische Bestätigung	Geben Sie die von diesem Befehl zu verwendende Batchgröße ein. Der Mindestwert beträgt 1000, ein Höchstwert ist nicht festgelegt.
Leere Werte als NULL behandeln	Aktivieren Sie dieses Kontrollkästchen, um leere Spalten als NULL zu behandeln, wenn die Spalte den Typ „Zeichenkette“ hat. (Eine Zeichenkette entspricht in der Regel einem Text, beispielsweise einem Namen.)

Ausgaben

Ausgabe	Art der Ausgabe
Eingefügte Datensätze	Ganzzahl
SQL-Fehler	JSON

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Eingaben
3	Fehler	Der Befehl konnte nicht ausgeführt werden

Upsert-Datensätze

Um eine Anweisung UPSERT auszuführen, verwenden Sie einen Befehl Upsert records. Wenn die eindeutigen Schlüssel eines vorhandenen Datensatzes mit denen eines Datensatzes in der Datenquelle übereinstimmen, aktualisiert der Befehl den Datensatz; andernfalls fügt es den Datensatz ein.

Eigenschaften

Eigenschaft	Einzelheiten
Zieltabelle	Geben Sie die Tabelle ein, in die die Datensätze eingefügt werden sollen.
Staging-Tabelle (automatisch generiert)	Geben Sie den Namen der Tabelle ein, die Datensätze vorübergehend aufnimmt, während sie in die Zieltabelle hochgeladen werden. Hinweis: Do nicht eine bestehende Tabelle verwenden; der Befehl erstellt diese Tabelle automatisch und löscht sie dann während des Upsets.
Einzigartige Spalten	Geben Sie eine Liste der Spalten ein, die eindeutige Werte für jeden Datensatz enthalten. Wenn diese Spalten zwischen den Datensätzen in der Staging- und der Zieltabelle übereinstimmen, aktualisiert der Befehl den Datensatz; andernfalls fügt er den Datensatz ein.
CSV-Datenquelle	Geben Sie den mehrzeiligen Text oder die CSV-Datei ein, die in die Zieltabelle eingefügt werden soll. Die Spalten in dieser Datenquelle müssen der Reihenfolge entsprechen, die in Columns angegeben ist.
Trennzeichen	Wählen Sie das in der CSV-Datenquelle verwendete Trennzeichen.
Ist eine Datei	Wenn es sich bei der Datenquelle CSV um eine CSV-Datei handelt, markieren Sie dieses Feld.
Enthält Kopfzeilen	Wenn die CSV-Datenquelle Eingabe mit einer Kopfzeile beginnt, markieren Sie dieses Feld.
Spalten	Geben Sie die Liste der Spalten ein, die die CSV-Datenquelle in der gleichen Reihenfolge wie die CSV-Datenquelle auffüllen soll.
Wertvorlage	Geben Sie die benutzerdefinierten Werte für die Anweisung `UPSERT` ein. Geben Sie die Werte mit einem `?` an. Die Anzahl der `?`s sollte der Anzahl der Felder im Ziel entsprechen. Für die automatische Generierung lassen Sie das Feld leer.

Ausgaben

Ausgabe	Art der Ausgabe
Hochgeladene Datensätze	Ganzzahl
SQL-Fehler	JSON

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Es wurden ungültige Eingaben gemacht
3	Fehler	Der Befehl konnte nicht ausgeführt werden

Workiva Support Center