ストアドプロシージャの呼び出し¶

プロシージャを呼び出すツール¶

プロシージャを呼び出すツールを選択します。

ストアドプロシージャを呼び出す権限を取得すると、 CALL ステートメントを使用してストアドプロシージャを呼び出すことができます。

使用上の注意¶

• プロシージャ名はスキーマ内で必ずしも一意ではありません。ストアドプロシージャは、名前だけでなく引数のタイプによっても識別され、解決されます（つまり、ストアドプロシージャはオーバーロードすることができます）。

• Snowflakeスクリプトのブロック 外では、呼び出しを式の一部にすることはできないため、ストアドプロシージャによって返される値は使用できません。

  Snowflakeスクリプトのブロックでは、 INTO :snowflake_scripting_variable を指定して、ストアドプロシージャからの戻り値をSnowflakeスクリプト変数にキャプチャできます。

• ストアドプロシージャはアトミックではありません。ストアドプロシージャ内の1つのステートメントが失敗した場合、ストアドプロシージャ内の他のステートメントは必ずしもロールバックされるとは限りません。ストアドプロシージャとトランザクションについては、 トランザクション管理 をご参照ください。

• CALL （匿名プロシージャでの場合） を使用して匿名プロシージャを作成し、呼び出すこともできます。

SQL でストアドプロシージャを呼び出します。¶

ストアドプロシージャに引数がある場合は、それらの引数を名前または位置で指定できます。

たとえば、次のストアドプロシージャは、3つの引数を受け付けます。

CREATE OR REPLACE PROCEDURE sp_concatenate_strings(
    first_arg VARCHAR,
    second_arg VARCHAR,
    third_arg VARCHAR)
  RETURNS VARCHAR
  LANGUAGE SQL
  AS
  $$
  BEGIN
    RETURN first_arg || second_arg || third_arg;
  END;
  $$;

プロシージャの呼び出し時に、引数を名前で指定できます。

CALL sp_concatenate_strings(
  first_arg => 'one',
  second_arg => 'two',
  third_arg => 'three');

+------------------------+
| SP_CONCATENATE_STRINGS |
|------------------------|
| onetwothree            |
+------------------------+

引数を名前で指定する場合は、引数を特定の順序で指定する必要はありません。

CALL sp_concatenate_strings(
  third_arg => 'three',
  first_arg => 'one',
  second_arg => 'two');

+------------------------+
| SP_CONCATENATE_STRINGS |
|------------------------|
| onetwothree            |
+------------------------+

また、引数を位置で指定することもできます。

CALL sp_concatenate_strings(
  'one',
  'two',
  'three');

+------------------------+
| SP_CONCATENATE_STRINGS |
|------------------------|
| onetwothree            |
+------------------------+

次の点に注意してください。

• すべての引数を名前または位置のいずれかで指定する必要があります。一部の引数を名前で、他の引数を位置で指定することはできません。

  引数を名前で指定する場合は、引数名を二重引用符で囲むことはできません。

• 2つの関数または2つのプロシージャが同じ名前で引数の型が異なり、引数名が異なる場合は、引数名を使ってどの関数またはプロシージャを実行するかを指定することができます。 プロシージャおよび関数のオーバーロード をご参照ください。

CREATE OR REPLACE PROCEDURE build_string_proc(
    word VARCHAR,
    prefix VARCHAR DEFAULT 'pre-',
    suffix VARCHAR DEFAULT '-post'
  )
  RETURNS VARCHAR
  LANGUAGE SQL
  AS
  $$
    BEGIN
      RETURN prefix || word || suffix;
    END;
  $$
  ;

CALL build_string_proc('hello');

+-------------------+
| BUILD_STRING_PROC |
|-------------------|
| pre-hello-post    |
+-------------------+

CALL build_string_proc('hello', 'before-');

+-------------------+
| BUILD_STRING_PROC |
|-------------------|
| before-hello-post |
+-------------------+

CALL build_string_proc(word => 'hello', suffix => '-after');

+-------------------+
| BUILD_STRING_PROC |
|-------------------|
| pre-hello-after   |
+-------------------+