Icebergテーブル用に外部ボリュームを構成する¶

ステップ1: S3バケットのアクセス許可を構成する¶

ステップ2: AWS で IAM ロールを作成する¶

AWS 管理コンソールで、 AWS IAM ロールを作成して、データファイルを含むS3バケットに対する権限を付与します。

1. AWS 管理コンソールにログインします。

2. ホームダッシュボードから、 Identity & Access Management （IAM）を選択します。

   

3. 左側のナビゲーションペインから Roles を選択します。

4. Create role を選択します。

   

5. 信頼できるエンティティタイプでは、 Another AWS account を選択します。

6. Account ID フィールドに、自分の AWS アカウント ID を入力します。後のステップで、信頼関係を変更し、Snowflake にアクセスを許可します。

7. Require external ID オプションを選択します。外部 ID は、Snowflakeなどのサードパーティに AWS リソース（S3バケットなど）へのアクセスを許可するために使用されます。

   0000 などのプレースホルダー ID を入力します。後のステップで、 IAM ロールの信頼関係を変更し、外部ボリュームに外部 ID を指定します。

8. Next を選択します。

9. ステップ1: S3バケットのアクセス許可を構成する で作成したポリシーを探し、このポリシーを選択します。

10. Next を選択します。

    

11. ロールの名前と説明を入力し、 Create role を選択します。これで、バケットの IAM ポリシー、および IAM ロールを作成し、ロールにポリシーを添付しました。

12. ロールの概要ページにある Role ARN 値を見つけて記録します。次のステップでこの値を使用して、このロールを参照するSnowflake外部ボリュームを作成します。

    

ステップ3: SSE-KMS 暗号化に必要な権限を IAM ロールに付与する（オプション）¶

AWS KMS キーで暗号化されたオブジェクトをAmazon S3にアップロードするには、 ステップ2: AWS で IAM ロールを作成する で作成した IAM ロールにキーに対する kms:GenerateDataKey 権限が必要です。AWS KMS キーで暗号化されたオブジェクトをダウンロードするには、 IAM ロールにキーに対する kms:Decrypt 権限が必要です。

サーバー側の暗号化に KMS キーを使う場合、これらのステップに従ってキーを作成し、参照します。

1. AWS 管理コンソールで、 KMS サービスに移動します。左のナビゲーションから Customer managed keys を選択し、次に Create key を選択します。バケットと同じリージョンにキーを作成する必要があります。

2. 対称キー型を作成します。キーの使い方に、 Encrypt and decrypt を選択します。 Next を選択します。

3. Alias ボックスでキーの名前を作成し、 Next を選択します。

4. 必要であれば、キーの管理者を指定し、 Next を選択します。

5. Define key usage permissions ステップで、 IAM ロールの名前を入力します。ロールの横にあるチェックボックスを選択し、 Next を選択します。

6. Finish を選択してキーを作成します。

7. 顧客管理キーのリストからキーを見つけて選択し、その ARN を記録します。以下はキーの ARN の例です: arn:aws:kms:us-west-2:111111122222:key/1a1a11aa-aa1a-aaa1a-a1a1-000000000000。

   外部ボリュームを作成する際に、 KMS_KEY_ID 値をキーの ARN に設定します。

ステップ4: Snowflakeで外部ボリュームを作成する¶

CREATE EXTERNAL VOLUME コマンドを使用して外部ボリュームを作成します。

次の例は、暗号化されたAmazon S3ストレージの場所を定義する外部ボリュームを作成しています。

CREATE OR REPLACE EXTERNAL VOLUME exvol
   STORAGE_LOCATIONS =
      (
         (
            NAME = 'my-s3-us-west-2'
            STORAGE_PROVIDER = 'S3'
            STORAGE_BASE_URL = 's3://MY_EXAMPLE_BUCKET/'
            STORAGE_AWS_ROLE_ARN = 'arn:aws:iam::123456789012:role/myrole'
            ENCRYPTION=(TYPE='AWS_SSE_KMS' KMS_KEY_ID='arn:aws:kms:us-west-2:111111122222:key/1a1a11aa-aa1a-aaa1a-a1a1-000000000000')
         )
      );

ステップ5: Snowflakeアカウントの AWS IAM ユーザーを取得する¶

1. Snowflakeアカウント用に自動的に作成された AWS IAM ユーザーの ARN を取得するには、 DESCRIBE EXTERNAL VOLUME コマンドを使用します。以前に作成した外部ボリュームの名前を指定します。

   例:

   DESC EXTERNAL VOLUME exvol;
   

   Copy

2. 次のプロパティの値を記録します。

   プロパティ	説明
   STORAGE_AWS_IAM_USER_ARN	Snowflakeアカウント用に作成された AWS IAM ユーザー。例えば、 arn:aws:iam::123456789001:user/abc1-b-self1234。Snowflakeは、Snowflakeアカウント全体用に単一の IAM ユーザーをプロビジョニングします。アカウント内のすべてのS3外部ボリュームは、その IAM ユーザーを使用します。
   STORAGE_AWS_EXTERNAL_ID	Snowflakeが AWS との信頼関係を確立するために使用する外部 ID。外部ボリュームの作成時に外部 ID （STORAGE_AWS_EXTERNAL_ID）を指定しなかった場合、Snowflakeがお客様用の ID を生成します。

   これらの値は次のステップで提供します。

ステップ6: バケットオブジェクトにアクセスするために IAM ユーザー権限を付与する¶

このステップでは、Snowflakeアカウントの IAM ユーザーがS3バケットのオブジェクトにアクセスできるように権限を設定します。

1. AWS 管理コンソールにログインします。

2. Identity & Access Management （IAM）を選択します。

   

3. 左側のナビゲーションペインから Roles を選択します。

4. ステップ2: AWS で IAM ロールを作成する で作成したロールを選択します。

5. Trust relationships タブを選択します。

6. Edit trust relationship を選択します。

7. ポリシードキュメントを ステップ5: Snowflakeアカウントの AWS IAM ユーザーを取得する に記録した出力値で変更します。

   IAM ロールのポリシードキュメント

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Sid": "",
         "Effect": "Allow",
         "Principal": {
           "AWS": "<snowflake_user_arn>"
         },
         "Action": "sts:AssumeRole",
         "Condition": {
           "StringEquals": {
             "sts:ExternalId": "<snowflake_external_id>"
           }
         }
       }
     ]
   }
   

   Copy

   条件:

   • snowflake_user_arn は、記録した STORAGE_AWS_IAM_USER_ARN 値です。

   • snowflake_external_id は、記録した STORAGE_AWS_EXTERNAL_ID 値です。

   注釈

   新しい外部ボリュームを作成する場合（または CREATE OR REPLACE EXTERNAL VOLUME 構文を使用して既存の外部ボリュームを再作成する場合）に、独自の外部 ID を提供しない場合は、このポリシードキュメントを更新する必要があります。セキュリティ上の理由から、新規または再作成された外部ボリュームは異なる外部 ID を持ち、この信頼ポリシーを更新しない限り、信頼関係を解決できません。

8. Update Trust Policy を選択します。変更が保存されます。

次のステップ¶

外部ボリュームを構成したら、Icebergテーブルを作成できます。

• カタログ統合を使用する読み取り専用のIcebergテーブルを作成するには、 Icebergテーブルのカタログ統合を構成する をご参照ください。

• Snowflakeプラットフォームを完全にサポートしたIcebergテーブルを作成するには、 SnowflakeをカタログとしてIcebergテーブルを作成する をご参照ください。

ステップ1: Snowflakeで外部ボリュームを作成する¶

CREATE EXTERNAL VOLUME コマンドを使用して外部ボリュームを作成します。

次の例は、暗号化された GCS ストレージの場所を定義する外部ボリュームを作成しています。

CREATE EXTERNAL VOLUME exvol
  STORAGE_LOCATIONS =
    (
      (
        NAME = 'my-us-east-1'
        STORAGE_PROVIDER = 'GCS'
        STORAGE_BASE_URL = 'gcs://mybucket1/path1/'
        ENCRYPTION=(TYPE='GCS_SSE_KMS' KMS_KEY_ID = '1234abcd-12ab-34cd-56ef-1234567890ab')
      )
    );

ステップ2: Snowflakeアカウント用のCloud Storageサービスアカウントを取得する¶

Snowflakeアカウント用に自動的に作成されたCloud Storageサービスアカウントの ID を取得するには、 DESCRIBE EXTERNAL VOLUME コマンドを使用します。以前に作成した外部ボリュームの名前を指定します。

例:

DESC EXTERNAL VOLUME exvol;

Copy

出力に STORAGE_GCP_SERVICE_ACCOUNT プロパティの値を記録します（例えば、 service-account-id@project1-123456.iam.gserviceaccount.com）。

Snowflakeは、Snowflakeアカウント全体に単一のCloud Storageサービスアカウントをプロビジョニングします。すべてのGoogle Cloud Storage外部ボリュームは、そのサービスアカウントを使用します。

ステップ3: バケットオブジェクトにアクセスするためのサービスアカウント権限を付与する¶

このステップでは、Google Cloud Platform ConsoleでSnowflakeの IAM アクセス許可を構成します。

次のステップ¶

外部ボリュームを構成したら、Icebergテーブルを作成できます。

• カタログ統合を使用する読み取り専用のIcebergテーブルを作成するには、 Icebergテーブルのカタログ統合を構成する をご参照ください。

• Snowflakeプラットフォームを完全にサポートしたIcebergテーブルを作成するには、 SnowflakeをカタログとしてIcebergテーブルを作成する をご参照ください。

ステップ1: Snowflakeで外部ボリュームを作成する¶

CREATE EXTERNAL VOLUME コマンドを使用して外部ボリュームを作成します。

次の例は、暗号化されたAzureストレージの場所を定義する外部ボリュームを作成しています。

CREATE EXTERNAL VOLUME exvol
  STORAGE_LOCATIONS =
    (
      (
        NAME = 'my-azure-northeurope'
        STORAGE_PROVIDER = 'AZURE'
        STORAGE_BASE_URL = 'azure://exampleacct.blob.core.windows.net/my_container_northeurope/'
        AZURE_TENANT_ID = 'a123b4c5-1234-123a-a12b-1a23b45678c9'
      )
    );

ステップ2: Snowflakeにストレージの場所へのアクセスを許可する¶

1. Microsoftの許可リクエストページへの URL を取得するには、 DESCRIBE EXTERNAL VOLUME コマンドを使用します。以前に作成した外部ボリュームの名前を指定します。

   DESC EXTERNAL VOLUME exvol;
   

   Copy

   次のプロパティの値を記録します。

   プロパティ	説明
   AZURE_CONSENT_URL	Microsoftのアクセス許可リクエストページへの URL。
   AZURE_MULTI_TENANT_APP_NAME	アカウント用に作成されたSnowflakeクライアントアプリケーションの名前。このセクションの後半のステップでは、このアプリケーションに許可されたストレージの場所でアクセストークンを取得するための権限を付与します。

   これらの値は次のステップで使用します。

2. ウェブブラウザーで、Microsoftの許可リクエストページ（AZURE_CONSENT_URL）に移動します。

3. Accept を選択します。このアクションにより、Snowflakeアカウント用に作成されたAzureサービスプリンシパルは、テナント内のリソースでアクセストークンを取得できます。アクセストークンの取得は、コンテナーに対する適切なアクセス許可をサービスプリンシパルに付与した場合にのみ成功します（次のステップを参照）。

   Microsoftの権限リクエストページは、Snowflakeの企業サイト（snowflake.com）にリダイレクトされます。

4. Microsoft Azureポータルにログインします。

5. Azure Services » Storage Accounts に移動します。Snowflakeサービスプリンシパルにアクセスを許可するストレージアカウント名を選択します。

   注釈

   外部ボリュームの IAM 権限はコンテナレベルではなく、ストレージアカウントレベルで設定する必要があります。

6. Access Control (IAM) » Add role assignment を選択します。

7. Storage Blob Data Contributor ロールを選択して、Snowflakeサービスプリンシパルに読み取りと書き込みのアクセスを許可します。

   注釈

   Storage Blob Data Contributor ロールは外部ボリュームの場所への書き込みアクセスを許可します。書き込みアクセスを完全に構成するには、外部ボリュームの ALLOW_WRITES パラメーターを TRUE （デフォルト値）に設定する必要があります。

8. Snowflakeサービスプリンシパルを検索します。これは DESC EXTERNAL VOLUME 出力（ステップ1）の AZURE_MULTI_TENANT_APP_NAME プロパティにあるIDです。AZURE_MULTI_TENANT_APP_NAME プロパティで、アンダースコアの 前にある 文字列を検索します。

   重要

   • このセクションのMicrosoftリクエストページでリクエストされたSnowflakeサービスプリンシパルをAzureが作成するのに、1時間以上かかる場合があります。サービスプリンシパルがすぐに利用できない場合は、1～2時間待ってから、もう一度検索してください。

   • サービスプリンシパルを削除すると、外部ボリュームは機能しなくなります。

   

9. Review + assign を選択します。

   注釈

   ロールを割り当てると、変更が有効になるまで最大10分かかることがあります。詳細については、Microsoft Azureドキュメントの 症状 - ロールの割り当て変更が検出されない をご参照ください。

次のステップ¶

外部ボリュームを構成したら、Icebergテーブルを作成できます。

• カタログ統合を使用する読み取り専用のIcebergテーブルを作成するには、 Icebergテーブルのカタログ統合を構成する をご参照ください。

• Snowflakeプラットフォームを完全にサポートしたIcebergテーブルを作成するには、 SnowflakeをカタログとしてIcebergテーブルを作成する をご参照ください。

例¶

次のステートメントは、 my_database_1 という名前のデータベース用に外部ボリューム（my_s3_vol）を設定します。

ALTER DATABASE my_database_1
  SET EXTERNAL_VOLUME = 'my_s3_vol';

データベースレベルで外部ボリュームを設定した後、外部ボリュームを指定せずにそのデータベースにIcebergテーブルを作成できます。次のステートメントは、カタログとしてSnowflakeを使用し、データベースに設定されたデフォルトの外部ボリューム（my_s3_vol）を使用するIcebergテーブルを my_database_1 に作成します。

CREATE ICEBERG TABLE iceberg_reviews_table (
  id STRING,
  product_name STRING,
  product_id STRING,
  reviewer_name STRING,
  review_date DATE,
  review STRING
)
CATALOG = 'SNOWFLAKE'
BASE_LOCATION = 'my/product_reviews/';