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

Você pode usar conectores para integrar seu ambiente de sala limpa com o que seus parceiros de ecossistema fornecem. Este tópico descreve como o administrador de sala limpa pode configurar um conector para que os usuários possam aprimorar seus dados na sala limpa com dados fornecidos por um parceiro de identidade.

Se você for um provedor que deseja controlar quais conectores aparecem como opções quando um usuário de sala limpa estiver criando ou instalando uma sala limpa, consulte Personalize os conectores disponíveis.

Importante

Conectores de terceiros não são oferecidos pela Snowflake e podem estar sujeitos a termos adicionais. Essas integrações são disponibilizadas para sua conveniência, mas você é responsável por qualquer conteúdo enviado ou recebido das integrações.

Os clientes são responsáveis por obter todos os consentimentos necessários em conexão com o uso das Snowflake Data Clean Rooms. Certifique-se de estar em conformidade com as leis e regulamentações aplicáveis ao usar os Snowflake Data Clean Rooms, inclusive em conexão com conectores de terceiro para fins de ativação.

Conector da API de recuperação LiveRamp

A API de recuperação LiveRamp traduz informações identificáveis pessoalmente (PII) para um pseudônimo RampID durável.

Antes de concluir o procedimento a seguir, você deve entrar em contato com o suporte Snowflake para criar a tabela de configuração necessária para este conector.

Para configurar o conector para que seu ambiente de sala limpa seja integrado à API de recuperação LiveRamp:

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

  2. Selecione a guia Identity & Data Providers.

  3. Expanda o LiveRamp Retrieval API.

  4. No campo Configuration Table, insira o nome totalmente qualificado da tabela de configuração que você criou com a assistência do suporte.

  5. Selecione Save.

Conector da API de transcodificação LiveRamp

A API de transcodificação LiveRamp traduz seu RampID para o espaço RampID de outro colaborador.

Antes de concluir o procedimento a seguir, você deve entrar em contato com o suporte Snowflake para criar a tabela de configuração necessária para este conector.

Para configurar o conector para que seu ambiente limpo seja integrado à API de transcodificação LiveRamp:

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

  2. Selecione a guia Identity & Data Providers.

  3. Expanda o LiveRamp Transcoding API.

  4. No campo Configuration Table, insira o nome totalmente qualificado da tabela de configuração que você criou com a assistência do suporte.

  5. Em RampID Collaborators, insira o seguinte:

    1. No campo Snowflake Account Locator, insira o localizador de contas da conta Snowflake do seu colaborador.

    2. No campo Target Domain, insira o domínio LiveRamp de destino do espaço RampID de seu colaborador.

  6. Selecione Save.

Conector da TransUnion TruAudience Identity

A TransUnion TruAudience Identity fornece soluções de higiene, enriquecimento e correspondência de dados do consumidor usando identificadores online e offline.

Esta seção descreve como configurar o conector da TransUnion TruAudience Identity. Se você for um usuário de sala limpa que deseja usar o TransUnion TruAudience Identity durante o processo de criação ou instalação, consulte Identity Hub: TransUnion TruAudience Identity.

Depois de configurar o conector, o Snowflake mantém um cache que mapeia os IDs do colaborador do TransUnion para valores que identificam exclusivamente os registros na tabela de origem. Como administrador, você pode gerenciar esse cache, por exemplo, excluindo registros específicos do cache. Para obter mais informações, consulte Cache para TransUnion TruAudience Identity.

Pré-requisitos

O seguinte deve ser concluído antes de configurar o conector do TransUnion TruAudience Identity no ambiente de sala limpa:

Pré-requisito 1: instalar o aplicativo nativo do TransUnion

Use o Snowflake Marketplace para instalar o aplicativo nativo do TransUnion TruAudience Identity.

Pré-requisito 2: conceder privilégios à função SAMOOHA_APP_ROLE

Após a instalação do aplicativo nativo do TransUnion, mas antes que um administrador de sala limpa configure o conector, o proprietário do aplicativo nativo do TransUnion deve:

  1. Faça login no Snowsight.

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

    USE ROLE tu_admin_role;
    Copy

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

    GRANT APPLICATION ROLE <transunion_app_database>.tru_app_public
   TO ROLE samooha_app_role;
    Copy
Pré-requisito 3: garantir que o procedimento armazenado necessário exista

O conector do TransUnion depende de um procedimento armazenado, que pode não existir em alguns ambientes de sala limpa. Para garantir que o procedimento armazenado exista, execute o seguinte comando como um usuário com a função ACCOUNTADMIN:

USE ROLE ACCOUNTADMIN;

DESCRIBE PROCEDURE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.GRANT_EXTERNAL_APP_ROLE;
Copy

Se você receber um erro informando que o procedimento não existe, você deve usar os seguintes comandos para criá-lo:

USE ROLE ACCOUNTADMIN;

CREATE OR REPLACE PROCEDURE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.GRANT_EXTERNAL_APP_ROLE(APP_ROLE string, APPLICATION string)
   RETURNS string
   LANGUAGE SQL
   EXECUTE AS OWNER
   AS
   $$
   GRANT APPLICATION ROLE IDENTIFIER(:APP_ROLE) TO APPLICATION IDENTIFIER(:APPLICATION);
   $$;

GRANT USAGE ON PROCEDURE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.GRANT_EXTERNAL_APP_ROLE(string, string) TO ROLE SAMOOHA_APP_ROLE;
Copy

Configuração do conector

Para configurar o conector do TransUnion TruAudience Identity:

  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 TransUnion - TruAudience Identity.

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

  6. No campo Collaboration Key, insira a chave de colaboração recebida da TransUnion para autorização.

  7. Selecione um warehouse que será usado quando usuários de sala limpa integrarem uma tabela com o TransUnion TruAudience Identity.

    Se você quiser concluir o processo de correspondência de identidades em uma hora, use as seguintes diretrizes para ajudar a selecionar o tamanho correto do warehouse:

    Número de linhas

    Tamanho do warehouse

    < 100 mil

    Large

    1 milhão

    XLarge

    5-10 milhões com endereços

    3X-Large

    > 10 milhões

    3X-Large

  8. Selecione Authenticate.

Conector do Acxiom Real ID

O Acxiom Real ID permite que você gere IDs Real com segurança dentro do Snowflake, sem nunca precisar transferir informações de identificação pessoal (PII) para fora da sua conta Snowflake.

Dica

Para obter ajuda adicional, leia a documentação do Acxiom Real ID documentation ou entre em contato com o accrealid@acxiom.com para obter suporte.

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 no 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 acesso do Snowflake Data Clean Rooms à função do aplicativo 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.

Conector do Acxiom Real ID Transcoding

A funcionalidade de transcodificação do Acxiom Real ID permite que você gere uma passagem cruzada de seus Acxiom Real IDs e dos Acxiom Real IDs dos seus parceiros de negócios, sem precisar transferir PII para fora da sua conta Snowflake.

Dica

Para obter ajuda adicional, leia a documentação do aplicativo Acxiom Real ID Transcoding ou entre em contato com o accrealid@acxiom.com para obter suporte.

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. Antes que um administrador de sala limpa configure o conector, o proprietário do aplicativo nativo Acxiom deve:

    1. Faça login no 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 acesso do Snowflake Data Clean Rooms à função do aplicativo 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. Você precisará entrar em contato com seus colaboradores para obter o ID do cliente e o segredo do cliente.

    Caso seu colaborador não apareça na lista, você deverá adicioná-lo ao ambiente de sala limpa.

  10. Selecione Save.

Linguagem: Português