Snowflake Data Clean Rooms におけるクロスクラウドの自動複製の管理¶

アカウント管理者¶

API を使用してアカウントのクロスクラウド自動フルフィルメントを有効にするには、プロバイダーアカウントとコンシューマーアカウントの両方の管理者が、ACCOUNTADMIN ロールを使用して次のコード例を実行する必要があります。これをアカウントごとに1回だけ実行する必要があります。

USE ROLE ACCOUNTADMIN;
-- Optionally check first to see if cross-cloud is enabled on the account.
CALL samooha_by_snowflake_local_db.library.is_laf_enabled_on_account();

-- If not, enable it.
CALL samooha_by_snowflake_local_db.library.enable_laf_on_account();

プロバイダーとコンシューマー¶

アカウントでクロスクラウド自動フルフィルメントを有効にした後、クリーンルームの作成またはインストール時にクロスクラウド自動フルフィルメントを有効にする方法は次のとおりです。

1. **プロバイダー**は provider.create_or_update_cleanroom_listing を呼び出すことで、通常の方法でクリーンルームを公開します。

2. **コンシューマー**は consumer.install_cleanroom を呼び出すことで、クリーンルームをインストールします。コンシューマーがプロバイダーとは異なるクラウドリージョンにある場合、consumer.install_cleanroom は失敗し、クロスクラウド自動フルフィルメントの複製がインストール中であるというメッセージが表示されます。

3. **コンシューマー**は成功が返されるまで、consumer.install_cleanroom を呼び出し続けます。インストールには数分かかります。

この時点で、コンシューマーは基本的なクリーンルームの機能を備えています。コンシューマーがクライアントテンプレートリクエスト、プロバイダーが実行する分析、およびプロバイダーのアクティベーションに対するサポートを希望する場合は、以下の追加ステップに従ってください。

1. **プロバイダー**は provider.mount_request_logs_for_all_consumers を呼び出し、コンシューマーからプロバイダーへの通信を可能にします。

完全な設定コード例:

1. プロバイダー： プロバイダーは、標準的な方法でclean roomを作成、共有、公開します。

   USE WAREHOUSE APP_WH;
   USE ROLE SAMOOHA_APP_ROLE;
   
   SET cleanroom_name = 'LAF example';
   SET consumer_locator = '<CONSUMER_LOCATOR>';
   SET consumer_account_name = '<CONSUMER_DATA_SHARING_ACCOUNT_ID>';
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.cleanroom_init($cleanroom_name);
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.set_default_release_directive(
     $cleanroom_name,
     'V1_0', '0');
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.add_consumers(
     $cleanroom_name,
     $consumer_locator,
     $consumer_account_name);
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.create_or_update_cleanroom_listing($cleanroom_name);
   

   Copy

2. **コンシューマー:**コンシューマーはクリーンルームをインストールします。

   USE WAREHOUSE APP_WH;
   USE ROLE samooha_app_role;
   
   SET cleanroom_name = 'LAF example';
   SET provider_locator = '<PROVIDER_LOCATOR>';
   
   -- Initial call starts the process and returns a cross-cloud/region replication failure.
   -- Continue to call this procedure until it returns a success message.
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.consumer.install_cleanroom(
     $cleanroom_name,
     $provider_locator);
   
   -- Continue with standard clean room configuration and use.
   -- Consumer can run analyses, but requests to submit a template aren't
   -- supported until the provider calls ``provider.mount_request_logs_for_all_consumers``.
   ...
   

   Copy

3. **プロバイダー:**コンシューマーがクリーンルームをインストールした後、プロバイダーとコンシューマー間のリクエストベースのアクションを有効にする場合、プロバイダーはリクエスト共有をマウントする必要があります。リクエストベースのアクションには、分析実行のプロバイダーリクエストと、クリーンルームにテンプレートを追加するコンシューマーリクエストが含まれます。

   -- Call mount_request_logs_for_all_consumers until it reports success.
   provider.mount_request_logs_for_all_consumers($cleanroom_name);
   

   Copy

   プロバイダー/コンシューマー機能がすべて利用可能になりました。