Apache Iceberg™ テーブルには、カタログ提供認証情報を使用します。¶

考慮事項¶

Icebergテーブルでカタログ提供認証情報を使用する場合は、以下を考慮してください。

• この機能は、Amazon S3にデータとメタデータを保存するテーブルでのみサポートされています。

• テーブルファイルは単一のバケットに格納する必要があります。複数のバケットに分散することはできません。

• REST カタログで構成されたサービスプリンシパルには、バケット内のテーブルファイルを含む*すべての*場所からの読み取り権限が必要です。AWS Lake Formation を AWS Glue と併用する場合は、このアクセスを有効にするために追加の手順が必要になる場合があります。詳細については、（オプション）Lake ormationのアクセス制御を構成する をご参照ください。

• Snowflakeは、カタログが供給された認証情報の有効期限を提供することを期待し、キーが expiration-time で、値がミリ秒単位で有効期限を指定するタイムスタンプ（たとえば、 1730234407000）であるキーと値のペアを探します。

  カタログに有効期限が記載されていない場合、Snowflakeは認証情報の有効期限を受信後60分とみなします。

• カタログが無効な認証情報を提供した場合、テーブルの作成に失敗します。

• データ共有はサポートされていません。

自動供給された認証情報のカタログ統合の作成¶

ベンディングされた認証情報のカタログ統合を作成するには、CREATE CATALOG INTEGRATION （Apache Iceberg™ REST） コマンドを使用し、ACCESS_DELEGATION_MODE プロパティを VENDED_CREDENTIALS に設定します。

条件:

ACCESS_DELEGATION_MODE = {VENDED_CREDENTIALS | EXTERNAL_VOLUME_CREDENTIALS}

外部クラウドストレージにあるIcebergテーブルファイルへのアクセスに使用するアクセス委譲モードを指定します。

• VENDED_CREDENTIALS は、Snowflake が自動供給された認証情報を使用するように指定します。

• EXTERNAL_VOLUME_CREDENTIALS はSnowflakeが外部ボリュームを使用するように指定します。

デフォルト: EXTERNAL_VOLUME_CREDENTIALS

任意の CREATE CATALOG INTEGRATION （Apache Iceberg™ REST） ステートメントの REST_CONFIG プロパティのリストで、ACCESS_DELEGATION_MODE プロパティを指定できます。次のトピックでは、最も一般的なユースケースの例を示します。

• Snowflake Open Catalog。これらの指示は、Apache Polaris™にも適用されます。

• AWS Glue

• Amazon API Gateway

• Tabular

• Unity Catalog

CREATE CATALOG INTEGRATION glue_rest_catalog_int
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'rest_catalog_integration'
  REST_CONFIG = (
    CATALOG_URI = 'https://glue.us-west-2.amazonaws.com/iceberg'
    CATALOG_API_TYPE = AWS_GLUE
    CATALOG_NAME = '123456789012'
    ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS
  )
  REST_AUTHENTICATION = (
    TYPE = SIGV4
    SIGV4_IAM_ROLE = 'arn:aws:iam::123456789012:role/my-role'
    SIGV4_SIGNING_REGION = 'us-west-2'
  )
  ENABLED = TRUE;

CREATE OR REPLACE CATALOG INTEGRATION my_s3_tables_catalog_integration
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'my_namespace'
  REST_CONFIG = (
    CATALOG_URI = 'https://glue.us-west-2.amazonaws.com/iceberg'
    CATALOG_API_TYPE = AWS_GLUE
    CATALOG_NAME = '123456789012:S3tablescatalog/my_table_bucket'
    ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS
  )
  REST_AUTHENTICATION = (
    TYPE = SIGV4
    SIGV4_IAM_ROLE = 'arn:aws:iam::123456789012:role/my_api_permissions_role'
  )
  ENABLED = TRUE;

供給された認証情報を使用するIcebergテーブルの作成¶

サードパーティの Iceberg REST カタログでアクセス制御をセットアップし、供給された認証情報のカタログ統合を作成したら、Iceberg テーブルを作成できます。

ベンディングされた認証情報を使用するIcebergテーブルを作成する場合は、ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS で構成されたカタログ統合を指定し、CREATE ICEBERG TABLE (Iceberg REST カタログ) ステートメントから EXTERNAL_VOLUME パラメーターを除外します。

例:

CREATE ICEBERG TABLE my_iceberg_table
  CATALOG = open_catalog_int_vended_credentials
  CATALOG_TABLE_NAME = 'my_table'
  AUTO_REFRESH = TRUE;