Apache Iceberg™ REST カタログのカタログ統合を構成する

Apache Iceberg™ REST カタログ統合 により、Snowflakeはオープンソース Apache Iceberg REST OpenAPI 仕様 に準拠した Apache Iceberg™ テーブル で管理されているリモートカタログにアクセスできます。

Iceberg REST カタログ統合を使用する場合、Snowflakeは以下の追加機能をサポートします。

認証方法

Snowflake は Iceberg REST カタログに対して以下の認証方法をサポートしています。

  • OAuth

  • ベアラートークンまたはパーソナルアクセストークン （PAT）

  • 署名バージョン4 (SigV4)

サポートされている認証方法は、 カタログソース によって異なります。

認証情報・ローテーション

カタログ統合の認証情報を変更するには、 ALTER CATALOG INTEGRATION コマンドを使用して、Snowflake がリモートカタログとの認証に使用する認証情報を更新します。

例:

ALTER CATALOG INTEGRATION my_cat_int SET
  REST_AUTHENTICATION (
    OAUTH_CLIENT_SECRET = 'myNewSecret'
  );

接続オプション

このセクションでは、Iceberg REST カタログの接続オプションについて説明します。

ベンディングされた認証情報

外部ボリューム に加え、Snowflake は Iceberg REST カタログの以下の接続オプションをサポートしています：

サポートされる接続オプションは、 カタログソース によって異なります。

プライベート接続

Snowflakeは:doc:プライベート接続</user-guide/tables-iceberg-configure-catalog-integration-rest-private> を介したIceberg REST カタログへの接続をサポートしています。

ただし、プライベート接続でカタログに接続する場合は、カタログデータに接続するために外部ボリュームを使用する必要があります。

サポートされる接続オプションは、 カタログソース によって異なります。

カタログソース

Snowflake は、Iceberg REST 仕様に準拠する外部カタログサーバーをサポートします。

次のトピックでは、一般的に使用される REST カタログの例を示します：

リモートカタログの閲覧

Iceberg REST 用のカタログ統合を作成したら、以下の Snowflake システム関数を使用して、カタログ内の名前空間とテーブルを参照できます：

テーブルをIceberg REST カタログ統合に移行する

Iceberg用カタログ統合を作成した後 REST必要に応じて、標準のSnowflakeデータベースで外部管理Icebergテーブルに関連付けられたカタログ統合を、作成したカタログ統合に置き換えることができます。手順については、 SYSTEM$SET_CATALOG_INTEGRATION をご参照ください。

カタログリンクデータベースの作成

Iceberg REST 用のカタログ統合を作成した後、カタログリンクデータベースを作成することで、リモートのIceberg REST カタログからSnowflakeにデータを取り込むことができます。カタログリンクデータベースを作成するときは、作成したカタログ統合の名前をカタログとして指定します。

カタログにリンクされたデータベースは、リモートカタログ内の名前空間とテーブルを自動的に検出し、同期を保ちます。カタログにリンクされたデータベースを使用して、Snowflakeからリモートカタログのテーブルを読み書きすることができ、既存のIcebergエコシステムとの完全な相互運用性を維持できます。詳細については、次のトピックをご参照ください。