Snowflake Data Clean Rooms:安装详细信息

本主题提供有关安装 Clean Room 环境时在账户中创建的对象的信息。

Snowflake Native App

Snowflake Data Clean Rooms 会安装以下 Snowflake Native App。

SAMOOHA_BY_SNOWFLAKE

该 Snowflake Native App 为 Snowflake Data Clean Room 提供支持。它包含用于创建和管理 Clean Room 的所有核心功能和应用程序逻辑。

此应用程序具有以下架构:

ADMIN

此架构包含管理应用程序所需的任何表或视图。您可以使用它跟踪应用程序版本、补丁和部署。 主要详细信息包括:

  • 版本信息(编号)

  • 应用的补丁(版本、命令)

APP SCHEMA

此架构包含加快所有 Clean Room 流程所必需的功能和过程。 主要详细信息包括:

  • 加密和解密功能。

  • 与开发者 APIs 和 Web 应用程序一起使用的 Clean Room 过程,用于创建、安装和处理 Clean Room。

TEMPLATES

此架构包含标准 SQL Jinja 模板,可用于在使用开发者 APIs 或 Web 应用程序时运行分析。

这些预构建的模板提供现成的 SQL 查询,用于 Snowflake Data Clean Rooms 内部的安全数据协作。它们利用 Jinja 模板进行自定义,允许您针对特定的数据共享场景定制查询。

应用程序包

Snowflake Data Clean Rooms 安装以下应用程序包。

SAMOOHA_CLEANROOM_*

此应用程序包仅安装在提供商账户中。它包含提供商创建的 Clean Room 的所有核心应用程序逻辑。它还包含用于与 Clean Room 共享数据的安全视图以及存储 Clean Room 状态的几个表。其中包括记录使用者当前差分隐私预算的表、列和联接策略以及链接到 Clean Room 的表名称。

数据库

Snowflake Data Clean Rooms 安装以下数据库。

SAMOOHA_BY_SNOWFLAKE_LOCAL_DB

此数据库由 Web 应用程序在 Snowflake 安装过程中创建。 它在您的账户本地。 它不是应用程序,但确实包含应用程序逻辑。

它有两个组成部分:

  1. 您和 Web 应用程序用于创建和管理 Clean Room 的开发者 APIs。

  2. 完全由您拥有的中间数据集,在身份解析等流程中保存到 PUBLIC 架构。 例如,LiveRamp 解析和转码过程中的输出表会保存到 PUBLIC 架构中,并联接到由 Web 应用程序链接到 Clean Room 的视图中。

数据库具有以下架构:

ADMIN

此架构包含操作与账户相关的某些 Clean Room 功能所必需的信息,例如:

  • 使用 Cross-Cloud Auto-Fulfillment 进行跨区域或云平台的协作。

  • 将 Clean Room 从开发者 APIs 注册到 Web 应用程序所需的 Clean Room 元数据更新。

  • 对与使用 Snowflake 账户运行 Web 应用程序相关的当前过程进行版本控制。

  • Tasks 和 Streams,侦听协作者共享回来的 Clean Room 共享集中的更改,以及根据更改视需要启用/禁用 Clean Room。

CONSUMER/CONSUMER_INIT

此架构包含操作与账户相关的 Clean Room 安装或使用者功能所必需的过程,例如:

  • 请求 Cross-Cloud Auto-Fulfillment Clean Room 所需的共享 Clean Room 列表详细信息。

  • 与使用联接/列策略和在 Clean Room 中注册数据库相关的功能。

  • 支持安装和编辑 Clean Room、运行分析和查看已添加的模板。

ID_HUB

此架构包含与身份中心关联的过程和中间表。

INFORMATION_SCHEMA

与所有 Snowflake 数据库一样,此数据库包含 INFORMATION_SCHEMA 架构(又名“数据字典”),后者由一组系统定义的视图和表函数组成,这些视图和表函数提供有关在账户中创建的对象的大量元数据信息。

LIBRARY

此架构包含启用 Clean Room 连接器所需的必要过程,以及适用于提供商和使用者的功能,例如:

  • 设置 Ads 连接器过程,方便与 ID 中心和 External Tables 集成。

  • 注册数据库过程以控制 Cross-Cloud Auto-Fulfillment 启用或禁用。

  • 应用补丁、取消注册数据库和更新 Clean Room 记录。

PROVIDER

此架构包含与激活(Streams 和过程,以方便提供商激活)相关的数据或信息、保存的分析报告、与 Snowflake Data Clean Rooms 账户上配置的连接器相关的元信息以及账户创建的 Clean Room 记录。

PUBLIC

此架构包含您和 Web 应用程序用于创建和管理 Clean Room 的开发者 APIs。它还包含完全由您拥有的中间数据集,在身份解析等流程中保存到 PUBLIC 架构。 例如,LiveRamp 解析和转码过程中的输出表会保存到 PUBLIC 架构中,并联接到由 Web 应用程序链接到 Clean Room 的视图中。

此架构具有以下表:

  • CLEANROOM_RECORD:此表包括 Clean Room 的状态(创建、删除)以及上次更新的用户和时间戳。如果更新是在 Web 应用程序中完成的,则该用户为服务账户用户。如果更新是使用开发者 APIs 在 Snowsight 中完成的,则用户是调用 API 的实际用户。Clean Room 数据库名称可在此表中自定义。

  • CONNECTOR_CONFIGURATION:此表是账户中配置的连接器列表。

  • REPORTS:此表包括使用者在 Web 应用程序中保存的报告列表。来自标准报告的顶级结果保存在表中。

  • HORIZONTAL_ANALYSIS_<report ID>:使用 SQL 查询模板执行的分析的输出,以及在 Web 应用程序中执行的自定义模板的输出。

数据库有三个从其中创建的共享:

  • SAMOOHA_INTERNAL_GOVERNANCE_SUMMARY SHARE_NAV2:此共享包含 PUBLIC 架构中 GOVERNACE_SUMMARY 和 ACTIVATION 表的视图。 这将与所有已创建此账户安装的 Clean Room 的提供商共享,并用于共享治理信息和提供商激活。

  • SAMOOHA_INTERNAL_LOGS_SHARE_NAV2:此共享位于 LOG_EVENTS 表上,主要用于共享有关 ID 解析过程如何返回到 Snowflake 的日志,因为这些过程使用的是第三方本机应用程序。 从来没有 PII 或数据共享回来,只有用于转码/解析的第三方应用程序 APIs 的成功/失败。

  • SAMOOHA_INTERNAL_PROVIDER_METADATA_NAV2:此共享位于两个表上:ADMIN.METADATA_UPDATE_REQUESTS(用于通过开发者 APIs 请求注册 Web 应用程序);以及 ADMIN.RESOURCE_MONITOR_USAGE(仅用于托管账户记录使用情况)。

SAMOOHA_CLEANROOM_REQUESTS_*

这是提供商一方的数据库,以及使用者一方的共享。它对应于作为使用者 Clean Room 安装过程的一部分从使用者处发回给 Clean Room 供应商的共享。该数据库包含有关使用者对 Clean Room 提出的所有请求的信息,用于跟踪使用者的差分隐私预算使用情况。

SAMOOHA_CLEANROOM_CONSUMER_*

此数据库仅安装在使用者账户中。它用于向 Clean Room 共享对象,如使用者数据的安全视图,以及使用者列/联接策略(如果应用)。它有下表:

  • SAMOOHA_CLEANROOM_CONSUMER_<cleanroom>.SHARED.REQUESTS。此表向使用者显示究竟是哪个查询试图运行(PROPOSED_QUERY 作为使用者 SQL 模板的输出查询)。

SAMOOHA_SAMPLE_DATABASE

此数据库包含示例数据集,您可以在 Clean Room 中使用它们运行分析和熟悉应用程序。

任务

Snowflake Data Clean Rooms 安装以下任务。

EXPECTED_VERSION_TASK

此任务会在新版本发布时自动升级 Snowflake Data Clean Room 的 Snowflake Native App。它存在于 SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN 架构中。

要启用该任务以便自动更新 Clean Room 环境,请使用开发者 API 执行 enable_local_db_auto_upgrades 命令。例如,使用 Snowsight 执行:

CALL samooha_by_snowflake_local_db.library.enable_local_db_auto_upgrades();
Copy

仓库

Snowflake Data Clean Rooms 安装了以下仓库。

仓库名称

备注

APP_WH

Snowflake Data Clean Rooms 使用此仓库支持无法为其选择仓库的操作。如果账户中尚不存在 APP_WH,Snowflake 会将其创建为 XS 仓库。

DCR_WH_SMALL

常规,SMALL 仓库

DCR_WH_Medium

常规,MEDIUM 仓库

DCR_WH_Large

常规,LARGE 仓库

DCR_WH_XLarge

常规,XLARGE 仓库

DCR_WH_2XLARGE

常规,XXLARGE 仓库

DCR_WH_4XLarge

常规,X4LARGE 仓库

DCR_WH_OPT_XLarge

Snowpark 优化,XLARGE 仓库

DCR_WH_OPT_2XLarge

Snowpark 优化,XXLARGE 仓库

DCR_WH_OPT_4XLarge

Snowpark 优化,X4LARGE 仓库

PROVIDER_RUN_<cleanroom_identifier>

使用者账户中执行提供商所运行的分析的仓库。

语言: 中文