Ausführen von SQL-Anweisungen¶

Verwenden von Variablen für SQL-Vorlagen¶

In bestimmten Situationen möchten Sie Ihre SQL-Abfragen vielleicht kontextabhängig ändern. Der snow sql-Befehl unterstützt die clientseitige Variablensubstitution, mit der Sie im Befehl Variablen verwenden können, die vor der Übermittlung der Abfrage lokal aufgelöst werde. Variablen in der SQL-Zeichenfolge haben die Form <% variable_name %>, und die Option -D (oder --variable) gibt den Wert der Variable an.

Bemerkung

Sie können derzeit die Syntax SnowSQL &variable_name und <% variable_name %> für Vorlagen verwenden. Snowflake empfiehlt jedoch die Verwendung der <% variable_name %>-Syntax.

Um beispielsweise eine Datenbank über eine clientseitige Variable anzugeben, können Sie einen Befehl ähnlich dem folgenden eingeben:

snow sql -q "select * from <% database %>.logs" -D "database=dev"

Bei der Ausführung ersetzt der Befehl den Wert dev in der Variable <% database %>, um den Dateinamen dev.logs zu erstellen und sendet dann die select * from dev.logs SQL-Abfrage zur Verarbeitung an Snowflake.

Sie können auch mehrere variable Eingaben wie folgt festlegen:

snow sql \
-q "grant usage on database <% database %> to <% role %>" \
-D "database=dev" \
-D "role=eng_rl"

Dieses Beispiel generiert die folgende SQL-Abfrage:

grant usage on database dev to eng_rl

Speichern von Variablen in der snowflake.yml-Projektdefinitionsdatei¶

Die Angabe von Variablen als snow sql-Befehlszeilenoptionen ist vielleicht nicht immer praktisch, oder Sie möchten vielleicht keine sensiblen Werte in der Befehlszeile angeben. In solchen Fällen können Sie Variablen und Werte in der Projektdefinitionsdatei snowflake.yml definieren. Dann können Sie die Variablennamen einfach im Format <% ctx.env.<variable_name> %> angeben, anstatt die Option -D "<variable> = <value>" zu verwenden.

Anhand des Beispiels aus dem vorigen Abschnitt könnten Sie die Datenbank- und Rollenvariablen in der Datei snowflake.yml speichern und die Abfrage wie folgt ändern:

snow sql -q "grant usage on database <% ctx.env.database %> to <% ctx.env.role %>"

In diesem Beispiel sucht der snow sql-Befehl nach den Variablendefinitionen in der Projektdefinitionsdatei und extrahiert die Werte, ohne sie in der Befehlszeile sichtbar zu machen. Die snowflake.yml-Datei sollte sich entweder im aktuellen Verzeichnis oder an dem mit der -p-Option angegebenen Speicherort befinden.

Weitere Informationen zum Speichern dieser Werte in der Projektdefinitionsdatei finden Sie unter Variablen in SQL verwenden.

Asynchrone Ausführung von SQL-Abfragen¶

Snowflake CLI lässt Sie eine oder mehrere SQL-Abfragen asynchron ausführen. Anstatt auf ein Ergebnis zu warten, plant der Befehl snow sql die Abfragen bei Snowflake und liefert eine Abfrage-ID. Nachdem eine Abfrage beendet ist, können Sie das Ergebnis mit dem Abfragebefehl !result oder dem SQL-Befehl RESULT_SCAN abrufen.

Um eine SQL-Abfrage asynchron auszuführen, beenden Sie die Abfrage mit ;> anstelle von ;, wie gezeigt:

snow sql -q 'select "My async query" ;>'

Das folgende Beispiel führt eine einzelne Abfrage asynchron aus:

snow sql -q "select 'This is async query';>"

select 'This is async query'
+--------------------------------------+
| scheduled query ID                   |
|--------------------------------------|
| 01bc3011-080f-f2d7-0001-c1be14bae7c2 |
+--------------------------------------+

Sie können dann die zurückgegebene Abfrage-ID in dem Abfragebefehl !result verwenden, um das Abfrageergebnis anzuzeigen:

snow sql -q '!result 01bc3011-080f-f2d7-0001-c1be14bae7c2'

path-to-private-key-file
+-----------------------+
| 'THIS IS ASYNC QUERY' |
|-----------------------|
| This is async query   |
+-----------------------+

Sie können auch mehrere Abfragen in der Abfragezeichenfolge ausführen, sowohl asynchron als auch synchron, wie gezeigt:

snow sql -q "select 'This is async query';> select 'Not an async query'; select 'Another async query';>"

select 'This is async query'
+--------------------------------------+
| scheduled query ID                   |
|--------------------------------------|
| 01bc3b8c-0109-2e81-0000-0f2d0e5a4a32 |
+--------------------------------------+

select 'Not an async query';
+----------------------+
| 'NOT AN ASYNC QUERY' |
|----------------------|
| Not an async query   |
+----------------------+

select 'Another async query'
+--------------------------------------+
| scheduled query ID                   |
|--------------------------------------|
| 01bc3b8c-0109-2e81-0000-0f2d0e5a4a36 |
+--------------------------------------+

Arbeiten mit SQL-Abfragebefehlen¶

Snowflake CLI stellt die folgenden Befehle zur Verfügung, die Sie innerhalb Ihrer SQL-Abfragen verwenden können:

• !source, der SQL in lokalen Dateien oder URLs ausführt.

• !queries, der alle SQL-Abfragen auflistet.

• !result, der das Ergebnis einer SQL-Abfrage anzeigt.

• !abort, der eine aktive SQL-Abfrage abbricht.

snow sql -q '!source my_sql_code.sql'

select emp_id FROM employees;
!source code_file_2.sql

snow sql -q '!result 01bc3011-080f-f2d7-0001-c1be14bae7c2'

+-----------------------+
| 'THIS IS ASYNC QUERY' |
|-----------------------|
| This is async query   |
+-----------------------+

snow sql -q '!abort 01bc3011-080f-f2d7-0001-c1be14bae7c2'

+-------------------------------------------------------------+
| SYSTEM$CANCEL_QUERY('01BC3011-080F-F2D7-0001-C1BE14BAE7C2') |
|-------------------------------------------------------------|
| Identified SQL statement is not currently executing.        |
+-------------------------------------------------------------+

Eingeben mehrerer Befehle in einer einzigen Transaktion¶

Mit der Option --single-transaction können Sie mehrere SQL-Befehle eingeben, die als Alles-oder-Nichts-Satz von Befehlen ausgeführt werden. Indem Sie Befehle in einer einzigen Transaktion ausführen, können Sie sicherstellen, dass alle Befehle erfolgreich abgeschlossen werden, bevor Sie die Änderungen festschreiben. Wenn einer der Befehle fehlschlägt, bleibt keine der Änderungen aus den erfolgreichen Befehlen erhalten.

Die folgenden Beispiele zeigen erfolgreiche und erfolglose Transaktionen:

• Erfolgreiche Befehlsausführung

  snow sql -q "insert into my_tbl values (123); insert into my_tbl values (124);" --single-transaction
  

  Copy

  BEGIN;
  +----------------------------------+
  | status                           |
  |----------------------------------|
  | Statement executed successfully. |
  +----------------------------------+
  
  insert into my_tbl values (123);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  insert into my_tbl values (124);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  COMMIT
  +----------------------------------+
  | status                           |
  |----------------------------------|
  | Statement executed successfully. |
  +----------------------------------+
  

  Sie können dann überprüfen, ob die Befehle in die Datenbank übertragen wurden:

  snow sql -q "select count(*) from my_tbl"
  

  Copy

  select count(*) from my_tbl
  +----------+
  | COUNT(*) |
  |----------|
  | 2        |
  +----------+
  

• Erfolglose Einzeltransaktion

  snow sql -c patcli -q "insert into my_tbl values (123); insert into my_tbl values (124); select BAD;" --single-transaction
  

  Copy

  BEGIN;
  +----------------------------------+
  | status                           |
  |----------------------------------|
  | Statement executed successfully. |
  +----------------------------------+
  
  insert into my_tbl values (123);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  insert into my_tbl values (124);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  select BAD;
  ╭─ Error ───────────────────────────────────────────────────────────────────────────────╮
  │ 000904 (42000): 01bc3b84-0810-0247-0001-c1be14ee11ce: SQL compilation error: error    │
  │ line 1 at position 7                                                                  │
  │ invalid identifier 'BAD'                                                              │
  ╰───────────────────────────────────────────────────────────────────────────────────────╯
  

Sie können dann überprüfen, dass die Befehle nicht in die Datenbank übertragen wurden:

snow sql -q "select count(*) from my_tbl"

Copy

select count(*) from my_tbl
+----------+
| COUNT(*) |
|----------|
| 0        |
+----------+

Eingabe von SQL-Befehlen im interaktiven Modus¶

Der Befehl snow sql unterstützt einen interaktiven Modus, in dem Sie SQL-Befehle einzeln eingeben können. Der interaktive Modus bietet die folgenden Features:

• Syntax-Hervorhebung

  

• Code-Vervollständigung beim Tippen

  

• Durchsuchbarer Verlauf

  Durch Drücken von CTRL-R: können Sie Ihren Befehlsverlauf durchsuchen:

  

• Mehrzeilige Eingabe

  Wenn Sie ENTER in einer Zeile drücken, die nicht mit einem Semikolon endet (;), springt der Cursor für weitere Befehle in die nächste Zeile, bis eine Anweisung mit einem Semikolon endet.

  

Um den interaktiven Modus zu verwenden, geben Sie den Befehl snow sql ein, gefolgt von ENTER, wie gezeigt:

snow sql

Der Befehl öffnet eine Sub-Shell mit einer >-Eingabeaufforderung, an der Sie interaktiv SQL-Befehle eingeben können:

$ snow sql
  ╭───────────────────────────────────────────────────────────────────────────────────╮
  │ Welcome to Snowflake-CLI REPL                                                     │
  │ Type 'exit' or 'quit' to leave                                                    │
  ╰───────────────────────────────────────────────────────────────────────────────────╯
  >

Sie können dann SQL-Befehle eingeben, wie gezeigt:

> create table my_table (c1 int);

+-------------------------------------+
| status                              |
|-------------------------------------|
| Table MY_TABLE successfully created.|
+-------------------------------------+

Um den interaktiven Modus zu verlassen, geben Sie exit, quit, oder CTRL-D ein.