Snowflake Data Clean Rooms: conectores de provedor de dados e identidade¶

Pré-requisitos¶

1. Antes de configurar o conector Acxiom, você deve entrar em contato com a Acxiom para obter ajuda na instalação do aplicativo nativo.

2. Antes que um administrador de sala limpa configure o conector, o proprietário do aplicativo nativo Acxiom deve:

   1. Faça login na Snowsight.

   2. Assumir a função que tem direitos de propriedade sobre o aplicativo nativo Acxiom. Por exemplo, se a função acxiom_admin_role for o proprietário do aplicativo nativo Acxiom, execute:

      USE ROLE acxiom_admin_role;
      

      Copy

   3. Execute o seguinte comando para conceder a Snowflake Data Clean Rooms acesso à função de aplicativo realid_app_role do Acxiom:

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

      Copy

Configuração do conector do Acxiom Real ID¶

Para configurar o conector Acxiom Real ID:

1. Entre no seu ambiente de sala limpa no aplicativo da web.

2. Na navegação da esquerda, selecione Connectors.

3. Selecione a guia Identity & Data Providers.

4. Expanda o Acxiom - Real ID.

5. No campo Application Database, insira o nome do banco de dados do aplicativo que foi instalado pelo aplicativo nativo Acxiom.

6. Na lista suspensa Warehouse, selecione o tamanho do warehouse. Recomendamos DCR_WH_XLarge, mas você pode ler as orientações da Acxiom sobre tamanho e desempenho do warehouse. Para obter mais informações sobre como criar um warehouse para usar com Snowflake Data Clean Rooms, consulte Adição de opções de warehouse.

7. Selecione Save.

Pré-requisitos¶

1. Você deve ter instalado o aplicativo nativo Acxiom Real ID, conforme descrito anteriormente.

2. Você deve instalar o aplicativo Acxiom Real ID Transcoding.

3. Entre em contato com seus colaboradores para obter o ID do cliente e o segredo do cliente gerados para eles quando instalaram o aplicativo nativo Acxiom Real ID Transcoding.

4. Antes que um administrador de sala limpa configure o conector, o proprietário do aplicativo nativo Acxiom deve:

   1. Faça login na Snowsight.

   2. Assumir a função que tem direitos de propriedade sobre o aplicativo nativo Acxiom. Por exemplo, se a função acxiom_admin_role for o proprietário do aplicativo nativo Acxiom, execute:

      USE ROLE acxiom_admin_role;
      

      Copy

   3. Execute o seguinte comando para conceder a Snowflake Data Clean Rooms acesso à função de aplicativo realid_app_role do Acxiom:

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

      Copy

Configuração do conector Acxiom Real ID Transcoding¶

Para configurar o conector Acxiom Real ID Transcoding:

1. Entre no seu ambiente de sala limpa no aplicativo da web.

2. Na navegação da esquerda, selecione Connectors.

3. Selecione a guia Identity & Data Providers.

4. Expanda o Acxiom Real ID Transcoding.

5. No campo Application Database, insira o nome do banco de dados do aplicativo que foi instalado pelo aplicativo nativo Acxiom.

6. No campo Client ID, insira o ID do cliente fornecido pela Acxiom quando você instalou o aplicativo nativo.

7. No campo Client Secret, insira o segredo do cliente fornecido pela Acxiom quando você instalou o aplicativo nativo.

8. Na lista suspensa Warehouse, selecione o tamanho do warehouse. Recomendamos DCR_WH_Medium, mas você pode ler as orientações da Acxiom sobre tamanho e desempenho do warehouse. Para obter mais informações sobre como criar um warehouse para usar com Snowflake Data Clean Rooms, consulte Adição de opções de warehouse.

9. Na seção Acxiom Collaborator, selecione um ou mais colaboradores junto com o ID do cliente e o segredo do cliente que foi gerado para eles quando instalaram o aplicativo nativo Acxiom Real ID Transcoding. Caso seu colaborador não apareça na lista, você deverá adicioná-lo ao ambiente de sala limpa.

10. Selecione Save.

Etapa 1: instale o aplicativo nativo Merkury Identity Connector¶

1. Instale o aplicativo nativo Merkury Identity Connector; entre em contato com a Merkury pelo e-mail IDConnector@dentsu.com para adicionar a listagem à sua conta.

2. Conceda privilégios à função SAMOOHA_APP_ROLE

   1. Entre no Snowsight.

   2. Assumir a função que tem direitos de propriedade sobre o aplicativo nativo Merkury. Por exemplo, se a função ACCOUNTADMIN for o proprietário do aplicativo nativo da Merkury, execute USE ROLE ACCOUNTADMIN;

   3. Execute o seguinte comando para conceder ao Snowflake Data Clean Rooms acesso à função de aplicativo DCR_DB_ROLE do Merkury:

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

   Copy

Etapa 2: configure o aplicativo nativo Merkury Identity Connector¶

1. Faça login em sua sala limpa no aplicativo da Web.

2. Na navegação da esquerda, selecione Connectors.

3. Selecione a guia Identity & Data Providers.

4. Expanda o Merkury Identity Connector.

5. No campo Application database, digite o nome do banco de dados do aplicativo instalado pelo aplicativo nativo Merkury Identity.

6. Autentique-se.

Cache para TransUnion TruAudience Identity¶

O Snowflake mantém um cache que mapeia IDs do colaborador TransUnion para valores na tabela de origem que identificam exclusivamente os registros. Por exemplo, o cache pode mapear cada ID do colaborador para um valor na coluna user_id da tabela de origem. O cache é armazenado na tabela SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS. Esta tabela contém as seguintes colunas:

Coluna	Tipo de dados	Descrição
inputid	VARCHAR	Valor da coluna selecionada como Unique Record Column durante a integração.
collaborationid	VARCHAR	ID da colaboração do TransUnion gerada com base no ID de entrada e outros parâmetros de integração.
lastprocessed	TIMESTAMP_NTZ	Carimbo de data/hora em que TransUnion gerou o ID da colaboração.

Você pode executar as seguintes ações em um cache:

Apagar o cache

TRUNCATE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS;

Copy

Excluir registros específicos do cache

Você pode excluir registros específicos do cache especificando-os como uma lista separada por vírgulas de valores entre aspas simples. Por exemplo, para excluir os registros com IDs de entrada de 123456 e abcedf, execute:

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

Copy

Excluir vários registros com base em IDs de entrada em um conjunto de dados separado

Você pode excluir vários registros do cache quando IDs da entrada estiverem presentes em uma coluna de outra tabela. Por exemplo, se os IDs de entrada a serem excluídos estiverem listados na coluna user_id da tabela my_db.my_schema.ref_table, execute:

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

Adição de todos os registros de um lote

Você pode adicionar todos os registros de um lote que está presente na exibição do TransUnion ao cache.

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

Mescla de todos os registros de um lote

Você pode mesclar todos os registros de um lote que está presente na exibição do TransUnion no cache, substituindo os registros de ID de entrada existentes pelos novos IDs de colaboração correspondente e pelos novos carimbos de data/hora do último processamento.

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

Adição de IDs do colaborador para registros de ID de entrada

Você pode adicionar IDs do colaborador para registros de ID de entrada presentes como uma coluna em um conjunto de dados e também presentes em um lote específico.

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