Azureステージの作成¶
ステージは、ファイル内のデータをテーブルにロードできるように、データファイルの保存場所(つまり、「ステージングした場所」)を指定します。
このトピックの内容:
データは、指定されたAzureコンテナーまたはAzureの「フォルダー」パス(つまり、キー値プレフィックス)のファイルから直接ロードできます。パスが /
で終わる場合、対応するAzureフォルダー内のすべてのオブジェクトがロードされます。
外部ステージ¶
Snowflakeは、Azureコンテナー内のファイルからの直接ロードに加えて、次のようなステージングファイルに必要なすべての情報をカプセル化する名前付き外部ステージの作成をサポートしています。
ファイルがステージングされるAzureコンテナー。
コンテナーの名前付きストレージ統合オブジェクトまたはAzure認証情報(保護されている場合)。
暗号化キー(コンテナー内のファイルが暗号化されている場合)。
名前付きの外部ステージはオプションですが、同じ場所から定期的にデータをロードする予定がある場合は、使用することを お勧め します。外部ステージを作成する手順については、以下の ステージの作成 をご参照ください。
ステージの作成¶
ウェブインターフェイスまたは SQLを使用して、名前付きステージを作成できます。
- ウェブインターフェイス
- SQL
外部ステージの作成¶
次の例では、 SQL を使用して、Azureの認証情報とマスター暗号化キーを含む my_azure_stage
という名前の外部ステージを作成します。ステージ URL はAzure myaccount
アカウントを参照します。データファイルは mycontainer
コンテナーと /load/files
パスに保存されます。ステージは my_csv_format
という名前のファイル形式オブジェクトを参照します。
CREATE OR REPLACE STAGE my_azure_stage URL='azure://myaccount.blob.core.windows.net/mycontainer/load/files' CREDENTIALS=(AZURE_SAS_TOKEN='?sv=2016-05-31&ss=b&srt=sco&sp=rwdl&se=2018-06-27T10:05:50Z&st=2017-06-27T02:05:50Z&spr=https,http&sig=bgqQwoXwxzuD2GJfagRg7VOS8hzNr3QLT7rhS8OFRLQ%3D') ENCRYPTION=(TYPE='AZURE_CSE' MASTER_KEY = 'kPxX0jzYfIamtnJEUTHwq80Au6NbSgPH5r4BDDwOaO8=') FILE_FORMAT = my_csv_format;
注釈
Data Lake Storage Gen2を含む、サポートされているすべてのタイプのAzure BLOBストレージアカウントに、 blob.core.windows.net
エンドポイントを使用します。
この例で使用されている AZURE_SAS_TOKEN と MASTER_KEY の値は、説明のみを目的としています。
注釈
ステージに名前付きファイル形式オブジェクト(または個々のファイル形式オプション)を指定すると、後でステージからデータをロードするために使用される COPY コマンドで同じファイル形式オプションを指定する必要がありません。ファイル形式オブジェクトとオプションの詳細については、 CREATE FILE FORMAT をご参照ください。