ステップ5: Snowflakeで AWS 用の外部関数を作成する

このトピックでは、Snowflakeで外部関数オブジェクトを作成する手順について説明します。このオブジェクトには、リモートサービスが受け入れるパラメーターなど、リモートサービスに関する情報が保存されます。AWS Managementコンソールlまたは AWS CloudFormation テンプレートのどちらを使用しているかに関係なく、手順は同じです。

注釈

Snowflakeの外部関数はデータベースオブジェクトで、データベースのスキーマに作成する必要があります。外部関数を作成するには、関数を作成するデータベースとスキーマへの適切な権限が必要です。

詳細については、 アクセス制御権限 をご参照ください。

このトピックの内容:

前のステップ

ステップ4: AWS の API 統合をManagementコンソールのプロキシサービスにリンクする

外部関数を作成する

次に、Snowflakeウェブインターフェイス(先ほど CREATE API INTEGRATION コマンドを入力した場所)に戻ります。

  1. CREATE EXTERNAL FUNCTION コマンドを入力します。次のようになります。

    CREATE EXTERNAL FUNCTION my_external_function(n INTEGER, v VARCHAR)
        RETURNS VARIANT
        API_INTEGRATION = <api_integration_name>
        AS '<resource_invocation_url>';
    
    Copy

    コマンドをカスタマイズします。

    • <api_integration_name> 値には、以前に作成した API 統合の名前が含まれている必要があります。

    • <resource_invocation_url> 値は、ワークシートに記録した Resource Invocation URL である必要があります。この URL には、ステージ名だけでなく、 API Gatewayリソース名が含まれていることを確認してください。

    • 関数名をカスタマイズすることもできます。

    この例では2つの引数( INTEGER と VARCHAR)を渡します。これらの引数は、Lambda関数が期待する引数だからです。独自のLambda関数を作成するときは、Lambda関数に適切な引数を渡す必要があります。

  2. 追跡ワークシートの External Function Name フィールドに外部関数の名前を記録します。

  3. 上記で入力した CREATE EXTERNAL FUNCTION コマンドをまだ実行していない場合は、ここで実行してください。

外部関数をテストする

これで、外部関数を呼び出して、正しく機能することを確認できるはずです。

詳細については、 AWS 用の外部関数の呼び出し をご参照ください。

次のステップ

なし。関数を呼び出すことができた場合は、 AWS の外部関数が正常に作成されています。