# Snowflake - ステージからテーブルへの一括ロード


Snowflakeのステージからターゲットテーブルにファイルをロードします。このアクションは、COPY (opens new window)コマンドを使用して、データをステージからターゲットテーブルに直接ロードします。内部ステージを使用する場合、"Bulk load to an internal stage"と一緒にこのアクションを使用する必要があります。

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

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

# 入力フィールド

入力フィールド 説明
テーブル データをロードするターゲットテーブルを選択します。通常、これはデータをロードするためのステージングテーブルです。その後、このテーブルの行は本番テーブルにマージされます。
ステージ名

Snowflake内の既存のステージを選択します。このステージでファイルが指定されていない場合、すべての新しいファイルがロードされます。外部ステージを使用する場合、この外部ステージにはファイルの場所、AWSの資格情報、暗号化、およびファイル形式の詳細に関する情報が含まれている必要があります。

S3外部ステージの作成方法を学びましょう。

ファイル名 ロードする1つ以上のファイル名(カンマで区切る)を指定します。指定しない場合、ステージからすべてのファイルがロードされます。これらのファイルがすでにSnowflakeの内部または外部ステージにステージングされていることを確認してください。詳細を学ぶ
ファイル形式 データに適用したいファイル形式を指定します。デフォルトでは、Snowflakeのデフォルト形式がCOPYコマンドに適用されます。

# 出力フィールド

出力フィールド 説明
ソースファイル名 ソースファイルの相対パスと名前。
サンプル値:
外部ステージ: s3://bucket-name/parent_folder/file_name.csv
内部ステージ: @stage_name/folder/file_name.csv
ステータス
説明
LOADED すべての行が正常にロードされました。
LOAD FAILED ロードに失敗しました。データファイル全体がロードされませんでした。
PARTIALLY LOADED ロードに失敗しました。データファイルは部分的にロードされました。ロードが正確にどこで失敗したかを見つけるには、First error lineを使用してください。
解析された行数 ソースファイルから読み取られた行数。
ロードされた行数 ソースファイルからターゲットテーブルに正常にロードされた行数。
エラー制限 エラーの数がこの制限に達した場合、ロードを中止します。通常は0であり、これは最初のエラーでロードが中止されることを意味します。
検出されたエラー数 ソースファイル内のエラーのある行数。
最初のエラー ソースファイル内の最初のエラーの詳細。
最初のエラー行 エラーを引き起こした最初の行の行番号。
最初のエラー文字 エラーを引き起こした最初の文字の位置。
最初のエラー列名 最初のエラーが発生した列名。


Last updated: 2025/3/13 9:42:40