在 Snowflake Data Clean Rooms 中管理 Cross-Cloud Auto-Fulfillment¶

账户管理员操作¶

要使用 API 为账户启用 Cross-Cloud Auto-Fulfillment，提供商和使用者账户中的管理员都必须使用 ACCOUNTADMIN 角色运行以下 SQL 代码。对于每个账户，仅需运行一次。

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

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

提供商和使用者操作¶

为账户启用 Cross-Cloud Auto-Fulfillment 后，以下是在创建或安装 Clean Room 时启用 Cross-Cloud Auto-Fulfillment 的方法：

1. 提供商 通过调用 provider.create_or_update_cleanroom_listing 以正常方式发布 Clean Room。

2. 使用者 通过调用 consumer.install_cleanroom 安装 Clean Room。如果使用者与提供商位于不同的云区域，则 consumer.install_cleanroom 会失败并显示一条消息，提示正在安装 Cross-Cloud Auto-Fulfillment 副本。

3. 使用者 继续调用 consumer.install_cleanroom 直至返回“成功”。安装只需几分钟时间。

   此时，使用者可以使用基本的 Clean Room 功能。要支持客户端自定义模板请求、提供商运行分析和提供商激活，请执行以下附加步骤：

4. 提供商 持续调用 provider.mount_request_logs_for_all_consumers，直到过程报告成功。这意味着使用者与提供商之间的通信已启用。

完整设置代码示例：

1. 提供商： 提供商以标准方式创建、共享和发布 Clean Room。

   CopyExpand

   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);
   

   Show lessSee more

   Scroll to top

2. 使用者： 使用者安装 Clean Room。

   CopyExpand

   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.
   -- The consumer can run analyses, but client custom templates, provider run, and provider analysis
   -- aren't supported until the provider takes the action shown in the next step.
   ...
   

   Show lessSee more

   Scroll to top

3. 提供商： 使用者安装 Clean Room 后，提供商必须挂载请求共享，以在提供商与使用者之间启用基于请求的操作。基于请求的操作包括运行分析的提供商请求，以及向 Clean Room 添加模板的使用者请求。

   CopyExpand

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

   Show lessSee more

   Scroll to top

   此时可以使用完整的提供商/使用者功能。