Verwenden von Snowflake Scripting in Snowflake CLI, SnowSQL, Classic Console und im Python-Connector¶
Unter diesem Thema wird erläutert, wie Sie die Snowflake Scripting-Beispiele in Snowflake CLI, SnowSQL, dem Classic Console und dem Python-Connector ausführen.
Bemerkung
Wenn Sie andere Clients und Schnittstellen verwenden (z. B. Snowsight oder den JDBC-Treiber), können Sie dieses Thema überspringen und mit dem nächsten Abschnitt zu Snowflake Scripting-Blöcken fortfahren.
Einführung¶
Derzeit werden Snowflake Scripting-Blöcke von den folgenden Schnittstellen nicht korrekt analysiert:
Die Methoden
execute_stream()
undexecute_string()
in Python-Konnektor-CodeBemerkung
Die anderen Python-Konnektor-Methoden parsen Snowflake Scripting-Blöcke korrekt.
Die Eingabe und Ausführung eines Snowflake Scripting-Blocks kann zu folgendem Fehler führen:
SQL compilation error: syntax error line 2 at position 25 unexpected '<EOF>'
Um dies zu umgehen, müssen Sie bei Verwendung dieser Schnittstellen Anfang und Ende eines Snowflake Scripting-Blocks mit Trennzeichen versehen.
In den folgenden Abschnitten wird erläutert, wie Sie dies tun können:
Verwenden von Zeichenfolgenkonstanten als Trennzeichen um einen Block in einer gespeicherten Prozedur¶
Wenn Sie eine gespeicherte Prozedur erstellen, schließen Sie den Snowflake Scripting-Block in einfache Anführungszeichen oder doppelte Dollarzeichen ein. Beispiel:
CREATE OR REPLACE PROCEDURE myprocedure()
RETURNS VARCHAR
LANGUAGE SQL
AS
$$
-- Snowflake Scripting code
DECLARE
radius_of_circle FLOAT;
area_of_circle FLOAT;
BEGIN
radius_of_circle := 3;
area_of_circle := pi() * radius_of_circle * radius_of_circle;
RETURN area_of_circle;
END;
$$
;
Bemerkung
Wenn Sie den Scripting-Block direkt in der Snowflake CLI-Befehlszeile angeben, funktionieren die Trennzeichen $$
bei einigen Shells möglicherweise nicht, da sie dieses Trennzeichen als etwas anderes interpretieren. Die Shells bash und zsh zum Beispiel interpretieren es als die Prozess-ID (PID). Um diese Beschränkung zu umgehen, können Sie die folgenden Alternativen verwenden:
Wenn Sie den Skriptblock dennoch in der Befehlszeile angeben möchten, können Sie die
$$
-Begrenzungszeichen maskieren, wie in\$\$
.Sie können den Skriptblock auch mit den standardmäßigen
$$
-Begrenzungszeichen in eine separate Datei schreiben und mit dem Befehlsnow sql -f <filename>
aufrufen.
Übergeben eines Blocks als Zeichenfolgenliteral an EXECUTE IMMEDIATE¶
Wenn Sie einen anonymen Block schreiben, übergeben Sie den Block als Zeichenfolgenliteral an den Befehl EXECUTE IMMEDIATE. Zur Abgrenzung des Zeichenfolgenliterals verwenden Sie einfache Anführungszeichen oder doppelte Dollarzeichen.
Beispiel:
EXECUTE IMMEDIATE $$
-- Snowflake Scripting code
DECLARE
radius_of_circle FLOAT;
area_of_circle FLOAT;
BEGIN
radius_of_circle := 3;
area_of_circle := pi() * radius_of_circle * radius_of_circle;
RETURN area_of_circle;
END;
$$
;
Alternativ können Sie eine Sitzungsvariable definieren, die ein Zeichenfolgenliteral ist, das den Block enthält, und diese Sitzungsvariable an den Befehl EXECUTE IMMEDIATE übergeben. Beispiel:
SET stmt =
$$
DECLARE
radius_of_circle FLOAT;
area_of_circle FLOAT;
BEGIN
radius_of_circle := 3;
area_of_circle := pi() * radius_of_circle * radius_of_circle;
RETURN area_of_circle;
END;
$$
;
EXECUTE IMMEDIATE $stmt;
Bemerkung
Wenn Sie den Scripting-Block direkt in der Snowflake CLI-Befehlszeile angeben, funktionieren die Trennzeichen $$
bei einigen Shells möglicherweise nicht, da sie dieses Trennzeichen als etwas anderes interpretieren. Die Shells bash und zsh zum Beispiel interpretieren es als die Prozess-ID (PID). Um diese Beschränkung zu umgehen, können Sie die folgenden Alternativen verwenden:
Wenn Sie den Skriptblock dennoch in der Befehlszeile angeben möchten, können Sie die
$$
-Begrenzungszeichen maskieren, wie in\$\$
.Sie können den Skriptblock auch mit den standardmäßigen
$$
-Begrenzungszeichen in eine separate Datei schreiben und mit dem Befehlsnow sql -f <filename>
aufrufen.