Snowflake Open Catalog のカタログ統合を設定する¶
注釈
これらの手順は、Apache Polaris™のカタログ統合の構成にも適用されます。
Snowflake Open Catalog のカタログ統合を作成します。このカタログ統合は、Snowflakeを使用して Snowflake Open Catalog のテーブルをクエリしたり、Snowflakeで管理されたテーブルを Open Catalog と同期したりするために使用できます。詳細については、 Snowflakeで Snowflake Open Catalog を使用して Apache Iceberg™ テーブルを使用する をご参照ください。
Open Catalog のカタログ統合は、 Open Catalog アカウントの特定のカタログおよびサービス接続に関連付けられています。
Open Catalog と Snowflake を接続するためのカタログ統合の作成については、以下のトピックを参照してください:
例: Open Catalog のカタログ統合を作成します。¶
Open Catalog のカタログ統合を作成するには、 CREATE CATALOG INTEGRATION コマンドを使用します。
例:
CREATE OR REPLACE CATALOG INTEGRATION my_open_catalog_int
CATALOG_SOURCE = POLARIS
TABLE_FORMAT = ICEBERG
CATALOG_NAMESPACE = 'myOpenCatalogCatalogNamespace'
REST_CONFIG = (
CATALOG_URI = 'https://ABCDEFG-ACCOUNT1.snowflakecomputing.com/polaris/api/catalog'
CATALOG_NAME = 'myOpenCatalogExternalCatalogName'
)
REST_AUTHENTICATION = (
TYPE = OAUTH
OAUTH_CLIENT_ID = 'myClientId'
OAUTH_CLIENT_SECRET = 'myClientSecret'
OAUTH_ALLOWED_SCOPES = ('PRINCIPAL_ROLE:ALL')
)
ENABLED = TRUE;
CATALOG_URI の値は Open Catalog アカウント URL です。詳細情報については、 CATALOG_URI パラメーターの説明を参照してください。
Snowflake管理テーブルをOpen Catalog と同期する場合、 CATALOG_NAMESPACE パラメーターは必須ではなく、 Open Catalog との同期方法にも影響しません。Snowflakeは、カタログ統合で指定した Open Catalog に、Snowflakeから親名前空間とともに外部カタログにテーブルを同期します。
例えば、Snowflakeに
db1.public.table1
Icebergテーブルが登録されていて、カタログ統合でcatalog1
を指定した場合、Snowflakeは次の完全修飾名を持つ Open Catalog とテーブルを同期します:catalog1.db1.public.table1
。
注釈
認証の構成を確認するには、 Check a configuration for OAuth をご参照ください。