AWS 用の外部関数の呼び出し¶

このトピックでは、外部関数のトラブルシューティング方法について説明します。

外部関数は、他の UDF （ユーザー定義関数） と同様に呼び出されます。（そして、他の UDF と同様、外部関数はプラットフォームに関係なく同じ方法で呼び出されます。）

1. まだ実行していない場合は、セッションが関数を含むデータベースとスキーマを使用していることを確認してください。

   （外部関数はデータベースオブジェクトであるため、関数を呼び出す場合は、関数を含むデータベースとスキーマをセッションで使用するか、関数の完全修飾名を指定する必要があります。）

   USE DATABASE <database_name>;
   USE SCHEMA <schema_name>;
   

   Copy

2. 必要に応じて、まだ実行していない場合は、外部関数を呼び出す必要がある1つ以上のSnowflakeロールに、外部関数に対する USAGE 権限を付与します。

   （ロールは、それを呼び出す外部関数に対する USAGE または OWNERSHIP 権限を持っている必要があります。）

   GRANT USAGE ON FUNCTION <external_function_name>(<parameter_data_type>) TO <role_name>;
   

   Copy

   例:

   GRANT USAGE ON FUNCTION echo(INTEGER, VARCHAR) TO analyst_role;
   

   Copy

3. 適切なロールを使用して、 SQL ステートメントの一部として外部関数を呼び出します。Snowflakeが提供するサンプル外部関数の1つを作成した場合、以下に示すように関数を呼び出すことができます。

   SELECT echo(42, 'Adams');
   

   Copy

   echo 以外の関数名を使用した場合は、 echo を実際の関数名に置き換えます。

   戻り値は、次のようになっている必要があります。

   [0, 42, "Adams"]
   

   Copy

   条件:

   • 0 は戻り値の行番号です。

   • 42, "Adams" は戻り値です。