CALL

Ruft eine gespeicherte Prozedur auf.

Siehe auch:

CREATE PROCEDURE, SHOW PROCEDURES

Syntax

CALL <procedure_name> ( [ [ <arg_name> => ] <arg> , ... ] )
  [ INTO :<snowflake_scripting_variable> ]
Copy

Erforderliche Parameter

procedure_name ( [ [ arg_name => ] arg , ... ] )

Gibt den Bezeichner (procedure_name) für die aufzurufende Prozedur sowie alle Eingabeargumente an.

Sie können die Eingabeargumente entweder über den Namen (arg_name => arg) oder über die Position (arg) angeben.

Beachten Sie Folgendes:

  • Sie müssen alle Argumente entweder über den Namen oder über die Position angeben. Sie können nicht einige der Argumente über den Namen und andere Argumente über die Position angeben.

    Wenn Sie ein Argument über den Namen angeben, können Sie den Argumentnamen nicht in doppelten Anführungszeichen einschließen.

  • Wenn zwei Funktionen oder zwei Prozeduren den gleichen Namen, aber unterschiedliche Argumenttypen haben, können Sie die Argumentnamen verwenden, um anzugeben, welche Funktion bzw. Prozedur ausgeführt werden soll, allerdings müssen die Argumentnamen unterschiedlich sein. Weitere Informationen dazu finden Sie unter Überladen von Prozeduren und Funktionen.

Optionale Parameter

INTO :snowflake_scripting_variable

Setzt die angegebene Snowflake Scripting-Variable auf den Rückgabewert der gespeicherten Prozedur.

Nutzungshinweise

  • Prozedurnamen sind im Schema nicht unbedingt eindeutig; gespeicherte Prozeduren werden durch ihre Argumenttypen sowie ihre Namen identifiziert und aufgelöst (d. h. gespeicherte Prozeduren können überladen werden).

  • Außerhalb des Snowflake Scripting-Blocks kann der von der gespeicherten Prozedur zurückgegebene Wert nicht verwendet werden, da der Aufruf nicht Teil eines Ausdrucks sein darf.

    In einem Snowflake Scripting-Block können Sie INTO :snowflake_scripting_variable angeben, um den Rückgabewert der gespeicherten Prozedur in einer Snowflake Scripting-Variablen zu erfassen.

  • Gespeicherte Prozeduren sind nicht atomar. Wenn eine Anweisung in einer gespeicherten Prozedur fehlschlägt, werden die anderen Anweisungen in der gespeicherten Prozedur nicht unbedingt zurückgesetzt. Weitere Informationen zu gespeicherten Prozeduren und Transaktionen finden Sie unter Transaktionsmanagement.

  • Sie können auch eine anonyme Prozedur mit CALL (mit anonymen Prozeduren) erstellen und aufrufen.

Beispiele

Im folgenden Beispiel wird eine gespeicherte Prozedur mit dem Namen sv_proc1 aufgerufen, die dabei ein Zeichenfolgenliteral und eine Zahl als Eingabeargumente übergibt: Im Beispiel werden die Argumente über die Position übergeben:

CALL sv_proc1('Manitoba', 127.4);
Copy

Sie können die Argumente auch über den Namen übergeben:

CALL sv_proc1(province => 'Manitoba', amount => 127.4);
Copy

Das folgende Beispiel zeigt, wie eine Sitzungsvariable als Eingabeargument festgelegt und an eine gespeicherte Prozedur übergeben wird:

SET Variable1 = 49;
CALL sv_proc2($Variable1);
Copy

Das folgende Beispiel zeigt einen Snowflake Scripting-Block, der den Rückgabewert einer gespeicherten Prozedur in einer Snowflake Scripting-Variablen speichert.

DECLARE
  ret1 NUMBER;
BEGIN
  CALL sv_proc1('Manitoba', 127.4) into :ret1;
  RETURN ret1;
END;
Copy

Hinweis: Wenn Sie SnowSQL oder die klassische Weboberfläche verwenden, benutzen Sie stattdessen dieses Beispiel (siehe Verwenden von Snowflake Scripting in SnowSQL und über die klassische Weboberfläche):

EXECUTE IMMEDIATE $$
DECLARE
  ret1 NUMBER;
BEGIN
  CALL sv_proc1('Manitoba', 127.4) into :ret1;
  RETURN ret1;
END;
$$
;
Copy

Ausführlichere Beispiele zum Erstellen und Aufrufen gespeicherter Prozeduren finden Sie unter Verwenden von gespeicherten Prozeduren.