GCP 用の外部関数のトラブルシューティング¶

このトピックでは、 GCP 用の外部関数のトラブルシューティング情報を提供します。

このトピックの内容:

プラットフォームに依存しないランタイムの問題¶

外部関数との間で引数を渡すときは、データ型が適切であることを確認してください。送信された値が受信中のデータ型に適合しない場合、値は切り捨てられるか、他の方法で破損する可能性があります。

考えられる原因:

各バッチ内で返される行番号は、0から始まる単調な昇順の整数でなければなりません。入力行番号もこのルールに従う必要があり、各出力行は対応する入力行と一致する必要があります。たとえば、出力行0の出力は、入力行0の入力に対応している必要があります。

考えられる解決策:

返される行番号が受け取った行番号と同じであること、および各出力値が対応する入力の行番号を使用していることを確認してください。これが機能しない場合は、入力された行番号が正しくないか、行を正しい順序で返さなかった可能性があります。

次に、出力行番号が0から始まり、1ずつ増加し、順番に並んでいることを確認します。

データの入力形式および出力形式の詳細については、リモートサービスの入力および出力データ形式をご参照ください。

考えられる原因:: 最も可能性の高い原因は、リモートサービスから返された JSON （例: AWS Lambda関数）が正しく構築されていないことです。
考えられる解決策:: 外部関数が受け取った入力行ごとに1つの内部配列を返し、配列中の配列1つを返すことを確認します。 Snowflakeが受信するデータ形式で出力形式の説明を確認します。

考えられる原因:: 考えられる原因の1つは、戻り値の中に二重引用符が含まれていることです。
考えられる解決策:: JSON文字列は二重引用符で区切られますが、ほとんどの場合、文字列自体は引用符で開始および終了できません。埋め込まれた二重引用符が正しくない場合は、削除してください。

考えられる原因:: リモートサービスが受信した行よりも多いか少ない行を返そうとしました。関数は名目上スカラーではあるものの、 event パラメーターの body フィールドに複数の行を受け取る可能性があり、受け取った行とまったく同じ数の行を返す必要があります。
考えられる解決策:: リモートサービスが、受信する行ごとに1行を返すことを確認します。

考えられる原因:

API統合の google_audience フィールドの値が許可されていません。

考えられる解決策:

API 統合の google_audience 値が、API のマネージドサービス名と一致することを確認します。この名前は、追跡ワークシートの Managed Service Identifier フィールドに記録する必要があります。
API Configファイルの securityDefinitions セクションに x-google-audiences フィールドを追加した場合は、 x-google-audiences の値が API 統合の google_audience フィールドの値と一致することを確認してください。

Googleでの認証の詳細については、Googleサービスアカウント認証のドキュメントをご参照ください。

考えられる原因:

構成ファイルの securityDefinitions フィールドにある x-google-issuer フィールドの値が、追跡ワークシートに記録されているAPI統合の API_GCP_SERVICE_ACCOUNT の値と一致しない場合があります。
x-google-issuer の値には、余分な空白が含まれている可能性があります。

考えられる解決策: