翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Snowflake のトラブルシューティング
このセクションでは、Snowflake を宛先として使用する際の一般的なトラブルシューティングステップについて説明します
Firehose ストリームの作成が失敗する
PrivateLink 対応の Snowflake クラスターにデータを配信するストリームのための Firehose ストリームの作成が失敗した場合、これは、Firehose が VPCE-ID に到達できないことを示唆しています。これは、次のいずれかの理由で発生する場合があります:
VPCE-ID が正しくありません。タイプミスがないことを確認してください。
-
Firehose は、リージョンレス Snowflake URL (プレビュー) をサポートしていません。Snowflake Account Locator を使用して URL を指定してください。詳細については、Snowflake ドキュメント
を参照してください。 Firehose ストリームが Snowflake AWS リージョンと同じリージョンに作成されていることを確認します。
問題が解決しない場合は、 AWS サポートにお問い合わせください。
配信失敗
データが Snowflake テーブルに配信されない場合は、次を確認してください。Snowflake 配信に失敗したデータは、エラーコードと、ペイロードに対応するエラーメッセージとともに、S3 エラーバケットに配信されます。一般的なエラーシナリオをいくつか次に示します。エラーコードのリスト全体については、「Snowflake データ配信エラー」を参照してください。
-
エラーコード: Snowflake.DefaultRoleMissing: Firehose ストリームの作成中に Snowflake ロールが設定されていないことを示します。Snowflake ロールが設定されていない場合は、指定された Snowflake ユーザーにデフォルトのロールが設定されていることを確認してください。
-
エラーコード: Snowflake.ExtraColumns: Snowflake への挿入が、入力ペイロード内の余分な列を理由として拒否されることを示します。テーブルに存在しない列は指定しないでください。Snowflake 列名では大文字と小文字が区別されることに留意してください。テーブルに列が存在するにもかかわらず、このエラーで配信が失敗する場合は、入力ペイロードの列名の大文字/小文字の区別と、テーブル定義で宣言された列名が一致していることを確認してください。
-
エラーコード: Snowflake.MissingColumns: Snowflake への挿入が、入力ペイロード内で欠落している列を理由として拒否されることを示します。nullable 以外のすべての列のために値が指定されていることを確認してください。
-
エラーコード: Snowflake.InvalidInput: これは、Firehose が提供された入力ペイロードを解析して、有効な JSON 形式にできなかった場合に発生する可能性があります。JSON ペイロードが適切に形成されており、余分な二重引用符、引用符、エスケープ文字などがないことを確認してください。現在、Firehose はレコードペイロードとして単一の JSON 項目のみをサポートしていますが、JSON 配列はサポートされていません。
-
エラーコード: Snowflake.InvalidValue: 入力ペイロードのデータ型が正しくないことを理由として配信が失敗したことを示します。入力ペイロードで指定された JSON 値が Snowflake テーブル定義で宣言されたデータ型に準拠していることを確認してください。
-
エラーコード: Snowflake.InvalidTableType: Firehose ストリームで設定されたテーブルタイプがサポートされていないことを示します。サポートされているテーブル、列、データ型については、Snowpipe Streaming の制限の「Limitations
」を参照してください。
注記
何らかの理由で、Firehose ストリームの作成後に Snowflake の宛先でテーブル定義またはロールの許可が変更された場合、Firehose がこれらの変更を検出するまでに数分かかることがあります。これを理由として配信エラーが表示されている場合は、Firehose ストリームを削除して再作成してみてください。
