Snowflake - Bulk Load from external stage (外部ステージからの一括読み込み) アクション

外部ステージの Amazon S3 バケットを外部ソースとして、ターゲットのテーブルにファイルを読み込みます。このアクションは COPY (opens new window) コマンドを使用して、外部ソースからターゲットのテーブルに直接データを読み込みます。

このアクションは読み込みを実行し、完了するまで待機してから、次のステップへ進みます。読み込みにかかる時間はソースファイルのサイズ、列の数、ターゲットのテーブルにおける追加の検証、およびネットワーク速度 (S3 から AWS でデプロイメントされた Snowflake インスタンスにデータを読み込む場合は高速) によって異なります。 30の列 と 300万の行 を持つ 1 GB の CSV ファイルの読み込みには60秒かかります。

ソースファイルには、CSV 形式、JSON、PARQUET、およびその他の半構造化ファイルタイプ (opens new window)のデータを含めることができます。

Amazon S3 バケットからテーブルへのデータの読み込み

Bulk Load from Amazon S3 アクション

入力項目

入力項目	説明
Table	データの読み込み先のターゲットのテーブルを選択します。通常、これはデータを読み込むためのステージングテーブルです。その後、このテーブル内の行を本番用テーブルにマージできます。
Stage	Amazon S3 バケットを指す既存の外部ステージを選択します。このステージでファイルが指定されない場合、新規ファイルがすべて読み込まれます。この外部ステージには、ファイルの場所、AWS 資格情報、暗号化、およびファイル形式の詳細に関する情報が含まれます。 S3 外部ステージの作成方法については、こちらを参照してください。

出力項目

出力項目	説明
Bucket URL	ソースファイルの相対パスおよび名前。 例 : s3://bucket-name/parent_folder/file_name.csv
Status	値 説明 LOADED すべての行が正常に読み込まれました。 LOAD FAILED 読み込みが失敗しました。データファイル全体が読み込まれませんでした。 PARTIALLY LOADED 読み込みが失敗しました。データファイルの一部が読み込まれました。[First error line] で読み込みが失敗した場所を正確に把握してください。
Rows parsed	ソースファイルから読み取られる行の数。
Rows loaded	ソースファイルからターゲットのテーブルに正常に読み込まれた行の数。
Error limit	エラーの数がこの制限に達すると、読み込みが中止されます。通常は0です。これは読み込みが最初のエラーで中止されることを意味しています。
Errors seen	ソースファイル内のエラーがある行の数。
First error	ソースファイル内の最初のエラーの詳細。
First error line	エラーの原因となった最初の行の行番号。
First error character	エラーの原因となった最初の文字の位置。
First error column name	最初のエラーが発生した列の名前。