データのアンロード機能の概要

このトピックでは、 COPY INTO <場所> コマンドを使用してSnowflakeテーブルからフラットファイルにデータをアンロードするためにサポートされている機能のクイックリファレンスを提供します。

サポートされている機能の一部、特に圧縮と暗号化は、Snowflakeの内部の場所または外部の場所(つまり、Amazon S3、Google Cloud Storage、またはMicrosoft Azure)のどちらにアンロードするかによって決まります。

このトピックの内容:

出力データファイルの詳細

次のテーブルは、データをアンロードするときにSnowflakeによって生成される出力ファイルの一般的な詳細を示しています。

機能

サポート対象

注意

ファイルの場所

ローカルファイル

ファイルはまずSnowflakeの内部の場所にアンロードされます。その後、 GET を使用してローカルにダウンロードできます。

Amazon S3のファイル

ファイルは、S3のユーザー提供のバケットに直接アンロードできます。その後、 AWS ユーティリティを使用してローカルにダウンロードできます。

Google Cloud Storageのファイル

ファイルは、Cloud Storageのユーザー提供のコンテナーに直接アンロードでき、Cloud Storageユーティリティを使用してローカルにダウンロードできます。

Microsoft Azureのファイル

ファイルは、Azureのユーザー提供のコンテナーに直接アンロードでき、Azureユーティリティを使用してローカルにダウンロードできます。

ファイル形式

区切りファイル(CSV、 TSVなど)

有効な区切り文字がサポートされています。デフォルトはカンマ(つまり、CSV).

JSON

Parquet

ファイルエンコーディング

UTF-8

出力ファイルは、ファイル形式に関係なく、常に UTF-8を使用してエンコードされます。他の文字セットはサポートされていません。

出力データファイルの圧縮

次のテーブルは、SnowflakeがデータをアンロードするときにSnowflakeによって生成された出力ファイルの圧縮をどのように処理するかを説明しています。

ファイルの場所

サポート対象

注意

内部または外部の場所

gzip

デフォルトでは、圧縮が明示的に無効にされているか、サポートされている他の圧縮方法のいずれかが明示的に指定されていない限り、アンロードされたデータファイルはすべてgzipを使用して圧縮されます

bzip2

Brotli

Zstandard

出力データファイルの暗号化

次のテーブルは、Snowflakeがデータのアンロード時にSnowflakeによって生成された出力ファイルの暗号化を処理する方法を説明しています。オプションは、ファイルが内部の場所(つまり、Snowflakeステージ)にアンロードされるか、外部の場所(Amazon S3、Google Cloud Storage、またはMicrosoft Azure)にアンロードされるかに応じて異なります。

ファイルの場所

サポート対象

注意

内部の場所

128ビットまたは256ビットキー

Snowflakeの内部の場所にアンロードされるすべてのデータファイルは、128ビットキーを使用して自動的に暗号化されます。ファイルは、ローカルディレクトリにダウンロードされるときに暗号化されません。

256ビットキーを有効にすることができます(より強力な暗号化のため)。ただし、追加の構成が必要です。

外部の場所

ユーザー提供のキー

セキュリティキー(ファイルの暗号化用)がSnowflakeに提供されている場合、クラウドストレージにアンロードされたデータファイルを暗号化できます。