ステップ1: リモートサービス（AWS のLambda関数）をManagementコンソールで作成する¶

JSON 経由の言語に依存しない入出力¶

このセクションの情報は、Snowflake外部関数のリモートサービスとして使用される、すべてのLambda関数に適用されます。外部関数の入出力に関するプラットフォーム固有の情報については、以下のサブセクションをご参照ください。

AWS では、 HTTP と互換性のあるサービスの規則は、 JSON オブジェクト内に本文を返すことです。これには、 HTTP ステータスコードも含まれます。AWS Lambda関数からの一般的な戻り値の JSON は次のようになります。

{
"statusCode": <http_status_code>,
"body":
        {
            "data":
                  [
                      [ 0, <value> ],
                      [ 1, <value> ]
                      ...
                  ]
        }
}

Copy

JSON 入力の構造は前述のものと似ていますが、必要になる可能性が低い追加のキーと値のペアが含まれており、 statusCode は除外されています。

Python固有のLambda関数の入力¶

次の資料は、このチュートリアルにあるサンプルLambda関数を含む、Snowflakeと互換性のあるPython言語のLambda関数に適用されます。この情報は、 入出力の言語に依存しないルール に 追加 されます。

Snowflake互換のPython言語Lambda関数は、2つのパラメーター event と context を受け取ります。単純な外部関数には通常、 event パラメーターのみが必要です。

event パラメーターには多くのサブフィールドが含まれ、そのうちの1つは body です。本文は、ディクショナリを含む JSON 互換の文字列です。

ディクショナリには data という名前のキーが含まれています。 data の対応する値は配列です。その配列には、Snowflakeによって渡された行が含まれます。

各行は、 data 配列内にネストされた配列によって表されます。

（AWS Lambdaは、Snowflakeから送信された HTTP POST リクエストを便利に処理し、本文を抽出してイベントパラメーター内の本文を渡すため、Snowflakeによって提供されるサンプル関数は、 HTTP POST リクエスト全体を解析する必要がありません。）

サンプル同期Lambda関数 には、 event パラメーターの読み取り方法を示すコードが含まれています。

Snowflakeのサンプル関数¶

Snowflakeは2つのサンプル関数を提供します。

• より短い例は、 同期 です。外部関数またはLambda関数を初めて使用する場合、Snowflakeは、これを使用して最初のサンプル外部関数を作成することをお勧めします。

  経験豊富なユーザーは、カスタムリモートサービスの開始点として使用するために、それをコピーして変更することもできます。

  このコードは、 サンプルの同期Lambda関数 にあります。

• もう1つの例は 非同期 です。

  このサンプルは、主に、カスタマイズされた非同期リモートサービスを構築するためのサンプルを目的としています。

  このコードは、 サンプルの非同期Lambda関数 にあります。

カスタムLambda関数¶

独自のLambda関数を最初から作成することも、開始点として Snowflakeのサンプル関数 （このトピック内）で説明されている関数の1つを使用することもできます。

使用したい既存のリモートサービスがある場合は、チュートリアルのこのステップにある大半の手順をスキップできます。代わりに、次の操作を実行します。

1. AWS アカウント ID を追跡ワークシートの Your AWS Account ID フィールドに記録します。

2. リモートサービスのLambda関数名を追跡ワークシートの Lambda Function Name フィールドに記録します。

3. ステップ2: AWS Managementコンソールでプロキシサービス（Amazon API Gateway）を作成する に移動します。