在 Clean Room 中实施激活¶

使用者可以通过以下方式将结果推送到自己的 Snowflake 账户。

提供商

1. 按照标准 Clean Room 创建 Clean Room、链接数据集并设置联接策略。

2. 选择 支持的 Snowflake 标准模板，或向 Clean Room 添加 自定义激活模板。如果要在 UI 中使用此 Clean Room，则必须提供一个包含正确激活字段的 Web 表单，如模板文档中所述。

3. 通过调用 provider.enable_template_for_consumer_activation 启用使用者激活模板。

4. 在 Clean Room 中为该模板设置激活策略，以指定可以激活哪些提供商列。激活模板中使用的所有列都必须在激活策略中，无论是否已投影。

5. 像往常一样添加使用者协作者，设置默认发布指令，并发布 Clean Room。

使用者

1. 按照标准 Clean Room 安装 Clean Room、链接数据集并设置联接策略。

2. 在 Clean Room 中为该模板设置激活策略，以指定可以激活哪些使用者列。激活模板中使用的所有列都必须在激活策略中，无论是否已投影。

3. 通过调用 consumer.run_activation 运行激活，将最后一个参数设置为 TRUE 表示使用者激活。

4. 查看结果，如下所述。

示例

下载以下示例，并将其作为工作表文件上传到 Snowflake 账户中。您需要为提供商和使用者开设单独的账户，每个账户都安装 Clean Room API。按照示例文件中的说明替换信息。

• Provider example code

• Consumer example code

使用者可以通过以下方式将结果推送到提供商的 Snowflake 账户。

1.提供商

1. 以标准方式创建 Clean Room。

2. 链接数据集。提供商还必须将 samooha_by_snowflake_local_db.library.temp_public_key 表连接到 Clean Room。

3. 以标准方式设置联接策略。

4. 选择 支持的 Snowflake 标准模板，或向 Clean Room 添加 自定义激活模板。如果要在 Clean Room UI 中使用此 Clean Room，则必须 提供 Web 表单，其中带有正确的激活字段。

5. 在 Clean Room 中为该模板设置激活策略，以指定可以激活哪些提供商列。激活模板中使用的所有列都必须在激活策略中，无论是否已投影。

6. 像往常一样添加使用者协作者，设置默认发布指令，并发布 Clean Room。（如果您没有安装 Clean Room UI，请在添加使用者后调用 provider.setup_provider_activation_share_mount_task。）

2.使用者

1. 按照标准 Clean Room 安装 Clean Room、链接数据集并设置联接策略。

2. 在 Clean Room 中为该模板设置激活策略，以指定可以激活哪些使用者列。激活模板中使用的所有列都必须在激活策略中，无论是否已投影。

3. 通过调用 consumer.run_activation 运行激活，将最后一个实参设置为 FALSE 表示提供商激活。

3.提供商

1. 使用者首次向您的账户激活数据时，您必须在使用者激活数据后约 30 分钟内登录该账户的 Clean Room UI。之后，数据将出现在您的账户中。每位使用者账户每个 Clean Room 只需要执行此操作一次。之后，同一使用者在同一 Clean Room 中进行激活无需执行此步骤。

   结果必须先解密，然后才能保存到您的账户，这可能需要一些时间。解密任务在 60 分钟后超时；如果发生这种情况，请调用 provider.update_activation_warehouse 以增加用于解密的仓库规模。

2. 查看结果，如下所述。

示例

下载以下示例，并将其作为工作表文件上传到 Snowflake 账户中。您需要为提供商和使用者开设单独的账户，每个账户都安装 Clean Room API。按照示例文件中的说明替换信息。

• Provider example code

• Consumer example code

提供商可以通过以下方式将结果推送到自己的 Snowflake 账户。这结合了多种技术，包括自定义模板、提供商运行分析和提供商激活，因此涉及提供商和使用者之间的多轮请求和批准。

1.提供商

1. 按照标准 Clean Room 创建 Clean Room、链接数据集并设置联接策略，但 有一个例外：您必须在表 samooha_by_snowflake_local_db.library.temp_public_key 中链接。提供商运行的数据经过加密，这样可以对结果进行加密和解密。

2. 选择 支持的 Snowflake 标准模板，或向 Clean Room 添加 自定义激活模板。如果要在 UI 中使用此 Clean Room，则必须提供一个包含正确字段的 Web 表单以支持激活，如模板文档中所述。

3. 在 Clean Room 中为该模板设置激活策略，以指定可以激活哪些提供商列。激活模板中使用的所有列都必须在激活策略中，无论是否已投影。

4. 以标准方式添加使用者协作者。如果您没有安装 Clean Room UI，则必须在添加使用者后调用 provider.setup_provider_activation_share_mount_task。

5. 通过调用 provider.enable_provider_run_analysis，在 Clean Room 中启用提供商运行的分析。这必须在添加协作者 之后，协作者安装 Clean Room 之前 完成。如果您在使用者安装 Clean Room 后更改此设置，则使用者必须重新安装 Clean Room，变更才能生效。

6. 照常设置默认发布指令，并发布 Clean Room。

2.使用者

1. 按照标准 Clean Room 安装 Clean Room、链接数据集并设置联接策略。

2. 在 Clean Room 中为该模板设置激活策略，以指定可以激活哪些使用者列。激活模板中使用的所有列都必须在激活策略中，无论是否已投影。

3.提供商

• 通过调用 provider.request_provider_activation_consent 向使用者请求运行激活模板的权限。

4.使用者

1. 通过调用 consumer.enable_templates_for_provider_run 授予提供商在此 Clean Room 中运行给定模板的权限。

2. 通过调用 consumer.approve_provider_activation_consent 授予提供商在此 Clean Room 中激活给定模板结果的权限。

5.提供商

1. 通过调用 provider.mount_request_logs_for_all_consumers 启用提供商激活时要共享的使用者数据。

2. 通过调用 provider.submit_analysis_request 运行激活模板）。该请求需要几分钟才能出现在日志中；可通过调用 provider.check_analysis_status 检查状态。请注意，即使状态报告为 SUCCESS 后，也还需要更多时间才能解密结果并将其写入提供商的 Snowflake 表。所有解密的数据一次性附加到结果表中。定期检查结果表以了解您的区段或激活 ID。解密任务在 60 分钟后超时；如果发生这种情况，请调用 provider.update_activation_warehouse 以增加用于解密的仓库规模。

备注

要在使用者批准模板后对其进行修改，您必须采取以下步骤，否则 provider.submit_analysis_request 将继续运行模板的最后批准版本。

1. 提供商通过调用 provider.add_custom_sql_template 更新模板。无需调用 create_or_update_cleanroom_listing。

2. 使用者调用 consumer.enable_templates_for_provider_run。

3. 使用者调用 consumer.approve_provider_activation_consent。

4. 更新后的模板现已准备就绪，可供提供商激活。

常见错误

• Object cleanroom_name.CLEANROOM.TEMP_RESULT_DATA does not exist or not authorized – 由于某种原因无法生成临时结果表。可能是模板中的 SQL 错误，或者模板没有明确生成表；请查看错误详情。

• Query validation checks failed – 模板中使用的某些列不在激活策略中。

示例

下载以下示例，并将其作为工作表文件上传到 Snowflake 账户中。您需要为提供商和使用者开设单独的账户，每个账户都安装 Clean Room API。按照示例文件中的说明替换信息。

• Provider example code

• Consumer example code