Snowflake Data Clean Rooms：身份和数据提供商连接器¶

先决条件¶

1. 在配置 Acxiom 连接器之前，您必须联系 Acxiom 寻求帮助以安装他们的本机应用程序。

2. 在 Clean Room 管理员配置连接器之前，Acxiom 本机应用程序的所有者必须：

   1. 登录 Snowsight。

   2. 假设拥有 Acxiom 本机应用程序的所有权角色。例如，如果 acxiom_admin_role 角色是 Acxiom 本机应用程序的所有者，请执行：

      USE ROLE acxiom_admin_role;
      

      Copy

   3. 执行以下命令以授予 Snowflake Data Clean Rooms 对 Acxiom realid_app_role 应用程序角色的访问权限：

      GRANT APPLICATION ROLE <acxiom_app_database>.realid_app_role
        TO ROLE samooha_app_role;
      

      Copy

配置 Acxiom Real ID 连接器¶

要配置 Acxiom Real ID 连接器，请执行以下步骤：

1. 在 Web 应用程序 中登录 Clean Room 环境。

2. 在左侧导航栏中，选择 Connectors。

3. 选择 Identity & Data Providers 选项卡。

4. 展开 Acxiom - Real ID。

5. 在 Application Database 字段中，输入由 Acxiom 本机应用程序安装的应用程序数据库的名称。

6. 在 Warehouse 下拉列表中，选择仓库规模。我们推荐 DCR_WH_XLarge，但您可以阅读 Acxiom 关于仓库规模和性能的指导 (https://acxiom.my.salesforce.com/sfc/p/#80000000Lm8w/a/8b0000011nke/tK9CJE0OvFfutuk4CZjBYb3eDT5qXAfTJItUa7GOGl0)。有关创建用于 Snowflake Data Clean Rooms 的仓库的更多信息，请参阅 添加仓库选项。

7. 选择 Save。

先决条件¶

1. 您必须安装 Acxiom Real ID 本机应用程序，如 前文所述。

2. 您必须安装 Acxiom Real ID 转码应用程序。

3. 联系您的合作者，以获取他们在安装 Acxiom Real ID Transcoding 本机应用程序时生成的客户端 ID 和客户端密钥。

4. 在 Clean Room 管理员配置连接器之前，Acxiom 本机应用程序的所有者必须：

   1. 登录 Snowsight。

   2. 假设拥有 Acxiom 本机应用程序的所有权角色。例如，如果 acxiom_admin_role 角色是 Acxiom 本机应用程序的所有者，请执行：

      USE ROLE acxiom_admin_role;
      

      Copy

   3. 执行以下命令以授予 Snowflake Data Clean Rooms 对 Acxiom realid_app_role 应用程序角色的访问权限：

      GRANT APPLICATION ROLE <acxiom_app_database>.realid_app_role TO ROLE samooha_app_role;
      

      Copy

配置 Acxiom Real ID 转码连接器¶

要配置 Acxiom Real ID 转码连接器：

1. 在 Web 应用程序 中登录 Clean Room 环境。

2. 在左侧导航栏中，选择 Connectors。

3. 选择 Identity & Data Providers 选项卡。

4. 展开 Acxiom Real ID Transcoding。

5. 在 Application Database 字段中，输入由 Acxiom 本机应用程序安装的应用程序数据库的名称。

6. 在 Client ID 字段中，输入您在安装本机应用程序时由 Acxiom 提供的客户 ID。

7. 在 Client Secret 字段中，输入您在安装本机应用程序时由 Acxiom 提供的客户端密钥。

8. 在 Warehouse 下拉列表中，选择仓库规模。我们推荐 DCR_WH_Medium，但您可以阅读 Acxiom 关于仓库规模和性能的指导 (https://acxiom.my.salesforce.com/sfc/p/#80000000Lm8w/a/8b0000011nke/tK9CJE0OvFfutuk4CZjBYb3eDT5qXAfTJItUa7GOGl0)。有关创建用于 Snowflake Data Clean Rooms 的仓库的更多信息，请参阅 添加仓库选项。

9. 在 Acxiom Collaborator 部分，当一个或多个合作者安装 Acxiom Real ID Transcoding 本机应用程序时，将他们与客户端 ID 及为他们生成的客户端密钥一起选中。如果合作者不在列表中，您必须 将他们添加到 Clean Room 环境中。

10. 选择 Save。

第 1 步：安装 Merkury 身份连接器本机应用程序¶

1. 安装 Merkury 身份连接器本机应用程序。您必须联系 Merkury 以获取安装本机应用程序的帮助。

2. 向 SAMOOHA_APP_ROLE 角色授予权限：

   1. 登录 Snowsight。

   2. 假设该角色拥有 Merkury 本机应用程序的所有权。例如，如果 ACCOUNTADMIN 角色是 Merkury 本机应用程序的所有者，则执行 USE ROLE ACCOUNTADMIN;

   3. 执行以下命令以授予 Snowflake Data Clean Room 访问 Merkury DCR_DB_ROLE 的应用程序角色：

   GRANT APPLICATION ROLE <merkury_app_database>.DCR_DB_ROLE TO ROLE samooha_app_role;
   

   Copy

第 2 步：配置 Merkury 身份连接器本机应用程序¶

1. :ref:` 登录到您的网络应用程序中的 Clean Room。<label-cleanroom_web_app_sign_in>`

2. 在左侧导航栏中，选择 Connectors。

3. 选择 Identity & Data Providers 选项卡。

4. 展开 Merkury Identity Connector。

5. 在 Application database 字段中，输入由 Merkury Identity 本机应用程序安装的应用程序数据库的名称。

6. 验证您的身份。

TransUnion TruAudience Identity 的缓存¶

Snowflake 会维护一个缓存，它会将 TransUnion 协作者 IDs 映射到源表中唯一标识记录的值。例如，缓存可能将每个协作者 ID 映射到源表的 user_id 列中的值。缓存存储在 SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS 表中。此表包含以下列：

列	数据类型	描述
inputid	VARCHAR	集成期间选择作为 Unique Record Column 的列的值。
collaborationid	VARCHAR	根据输入 ID 和其他集成参数生成的 TransUnion 协作 ID。
lastprocessed	TIMESTAMP_NTZ	TransUnion 生成协作 ID 时的时间戳。

可以对缓存执行以下操作：

删除缓存

TRUNCATE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS;

Copy

从缓存中删除特定记录

您可以通过将特定记录指定为单引号值的逗号分隔列表来从缓存中删除这些记录。例如，要删除输入 IDs 为 123456 和 abcedf 的记录，请执行以下操作：

DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS
  WHERE inputid IN ('123456', 'abcedf');

Copy

根据单独数据集中的输入 IDs 删除多条记录

当输入 IDs 存在于另一个表的列中时，可以从缓存中删除多条记录。例如，如果要删除的输入 IDs 在 my_db.my_schema.ref_table 表的 user_id 列中列出，请执行以下操作：

DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS
  WHERE INPUTID IN (
    SELECT user_id as INPUTID
    FROM my_db.my_schema.ref_table
  );

Copy

添加批次中的所有记录

您可以将存在于 TransUnion 视图中的批次中的所有记录添加到缓存中。

INSERT INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS (
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
SELECT
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
FROM <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW
WHERE BATCHID = '<BATCH_ID>';

Copy

合并批次中的所有记录

您可以使用相应的新协作 IDs 和新的最后处理时间戳覆盖现有的输入 ID 记录，从而将存在于 TransUnion 视图中的批次中的所有记录合并到缓存中。

MERGE INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS CT
USING <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW OT
  ON
    CT.INPUTID = OT.INPUTID
    AND OT.BATCHID = '<BATCH_ID>'
WHEN MATCHED THEN
  UPDATE SET
    CT.COLLABORATIONID = OT.COLLABORATIONID,
    CT.LASTPROCESSED = OT.LASTPROCESSED
WHEN NOT MATCHED THEN
  INSERT (
    INPUTID,
    COLLABORATIONID,
    LASTPROCESSED
  ) VALUES (
      OT.INPUTID,
      OT.COLLABORATIONID,
      OT.LASTPROCESSED
  );

Copy

为输入 ID 记录添加协作者 IDs

您可以为输入 ID 记录添加协作者 IDs，这些输入记录以列的形式存在于数据集内，同时也存在于特定批次中。

INSERT INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS (
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
)
  SELECT
    INPUTID,
    COLLABORATIONID,
    LASTPROCESSED
  FROM <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW
  WHERE INPUTID IN (
    SELECT <column_name_containing_input_ids_to_be_added> as INPUTID
    FROM <dataset_fqtn_containing_input_ids_to_be_added>
    )
    AND BATCHID = '<BATCH_ID>';

Copy