Tutorial: Comece a usar o aplicativo da web de um Snowflake Data Clean Room

Introdução

Uma Snowflake Data Clean Room é um ambiente criptograficamente seguro que permite que entidades colaborem em dados confidenciais. Ela permite que uma entidade compartilhe seus dados com um colaborador, mantendo a privacidade dos dados ao controlar rigorosamente o que pode ser feito com ela.

Este tutorial orienta você no fluxo básico de uso do aplicativo da Web a trabalhar com uma Snowflake Data Clean Room.

O que você aprenderá

Neste tutorial, você aprenderá a fazer o seguinte no aplicativo da Web:

  • Adicione um colaborador ao seu ambiente de sala limpa.

  • Crie uma sala limpa, incluindo como adicionar dados, especificar políticas de junção, definir que tipo de análise um colaborador pode executar nos dados e compartilhar a sala limpa com um colaborador.

  • Instale uma sala limpa, incluindo como adicionar dados e como definir a forma que esses dados são unidos aos dados do colaborador.

  • Execute uma análise, incluindo como criar uma nova análise com base no que é permitido na sala limpa e especifique os parâmetros relevantes para a análise.

  • Ative os resultados da análise.

Sobre os colaboradores da sala limpa

Os colaboradores da sala limpa são provedores ou consumidores.

Um provedor é a entidade que compartilha seus dados com outros colaboradores da sala limpa. Eles criam e configuram a sala limpa para manter a privacidade dos dados que estão compartilhando.

Um consumidor é a entidade que usa a sala limpa para interagir com os dados compartilhados. O consumidor pode analisar e consultar os dados na sala limpa, inclusive unindo e enriquecendo-os com seus próprios dados.

Neste tutorial, você atuará como provedor e consumidor da sala limpa.

Pré-requisitos

Antes de concluir este tutorial, um administrador deve configurar o ambiente de sala limpa e configurar a conta Snowflake associada a ele. Isso deve ser feito tanto para a conta do provedor quanto para a conta do consumidor. Para obter mais detalhes sobre como executar essas ações, consulte Introdução aos Snowflake Data Clean Rooms.

Para atuar como consumidor para os propósitos deste tutorial, você deve ter acesso a uma segunda conta Snowflake associada a uma segunda sala limpa. Isso permite que você imite como um consumidor instala e usa a sala limpa. Se você não tiver uma segunda conta, ainda poderá usar este tutorial para aprender a criar, configurar e compartilhar uma sala limpa.

Se você não for o administrador que configurou as salas limpas, um administrador de sala limpa também precisará adicionar você como um usuário para o aplicativo da Web. Você precisa ser um usuário administrador no ambiente de sala limpa.

Faça login no aplicativo da Web como provedor

Nesta seção, você fará login na sala limpa, onde irá criar, configurar e compartilhar uma sala limpa como provedor.

Para fazer login no aplicativo da Web como provedor:

  1. Navegue até a página de login do Snowflake Data Clean Rooms.

    Para este tutorial, você deve ser um usuário com a função de administrador.

  2. Digite seu endereço de e-mail e selecione Continue.

  3. Insira sua senha.

  4. Se você estiver associado a vários ambientes de sala limpa, selecione a conta Snowflake que deseja usar como conta de provedor.

Adicione o consumidor como colaborador

Nesta seção, você adicionará a conta de consumidor que estiver usando neste tutorial como colaborador. Os administradores devem definir alguém como colaborador antes que outros usuários possam compartilhar uma sala limpa com esse colaborador.

Para adicionar o consumidor como colaborador:

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

  2. Selecione a guia Snowflake Partners.

  3. Selecione + Snowflake Partner.

  4. No campo Company Name, insira Tutorial Consumer.

  5. No campo Email Address, insira o e-mail associado ao usuário da sua sala limpa.

  6. No campo Account Locator, insira o localizador de contas <label-account_locator> da conta Snowflake que você estiver usando para simular a experiência do consumidor.

  7. Selecione a nuvem e região da conta que você estiver usando para simular a experiência do consumidor.

  8. Selecione Add.

Crie e compartilhe uma sala limpa

Nesta seção, você fará o seguinte:

  • Crie uma sala limpa.

  • Adicione dados à sala limpa compartilhada com os colaboradores.

  • Defina uma política de junção, que controle as colunas nas quais um colaborador pode unir seus próprios dados.

  • Defina que tipo de análise um colaborador pode executar na sala limpa.

  • Compartilhe a sala limpa com o consumidor.

Inicie o processo de criação

Para iniciar o processo de criação de uma sala limpa:

  1. Na navegação da esquerda, selecione Clean Rooms.

  2. Na página Clean Rooms, selecione + Clean Room.

  3. Dê um nome à sua sala limpa Tutorial. Você permitirá que os colaboradores executem uma análise de sobreposição de público na sala limpa.

Adicione dados à sua sala limpa

Para adicionar dados à sua sala limpa:

  1. Na seção Datasource, selecione Snowflake.

  2. Na lista suspensa Tables, selecione a tabela DEMO.CUSTOMERS. Esta tabela está localizada abaixo do banco de dados SAMOOHA_SAMPLE_DATABASE.

  3. Selecione Next.

Especifique uma política de junção

Uma política de junção controla quais colunas de uma tabela compartilhada um colaborador pode unir.

Para especificar uma política de junção:

  1. Na lista suspensa Join Columns, selecione as seguintes colunas:

    • HASHED_EMAIL

    • HASHED_FIRST_NAME

    • HASHED_LAST_NAME

    • HASHED_PHONE

    Um colaborador pode unir seus dados somente com essas colunas.

  2. Selecione Next.

Configure um modelo de análise

Os modelos de análise controlam como um colaborador pode acessar os dados compartilhados em uma sala limpa. Os colaboradores só podem executar análises e consultas em conformidade com o modelo.

Para selecionar qual modelo de análise está disponível para os colaboradores na sala limpa e configurar o modelo:

  1. Selecione o modelo Audience Overlap & Segmentation. Os colaboradores estarão limitados a executar a sobreposição de público e análise de segmentação.

  2. A partir da lista suspensa Tables, selecione DEMO.CUSTOMERS. Os colaboradores só podem analisar dados na tabela DEMO.CUSTOMERS.

  3. Na lista suspensa Segmentation & Activation Columns, selecione as seguintes colunas:

    • AGE_BAND

    • DEVICE_TYPE

    • EDUCATION_LEVEL

    • STATUS

    Como consumidor, você poderá filtrar e criar segmentos usando essas colunas.

  4. Ative Allow categorical value previews during filtering.

  5. Selecione Next.

Compartilhamento da sala limpa com o consumidor

Agora a sala limpa foi criada e configurada, você pode compartilhá-la com um colaborador para que ele possa usá-la para executar análises.

Para compartilhar uma sala limpa:

  1. Use lista suspensa Select Collaborator para selecionar Tutorial Consumer.

  2. Selecione Finish.

  3. Você precisa esperar até que a sala limpa seja criada antes de continuar com este tutorial. Selecione periodicamente Refresh até que o bloco Tutorial mude de Processing para Edit.

Parabéns! Você criou e compartilhou uma Snowflake Data Clean Room.

O que você aprendeu

Nesta seção, você aprendeu como instalar, configurar e compartilhar uma sala limpa como provedor.

Na próxima parte deste tutorial, você irá alternar para o consumidor que entra na sala limpa e a usa para analisar dados.

Entre no aplicativo da Web como consumidor

Nesta seção, você deixa de ser o provedor que criou e compartilhou a sala limpa e passa a ser o consumidor que está instalando a sala limpa. Você está instalando a sala limpa em uma conta diferente para imitar como um consumidor instalaria e usaria a sala limpa em sua própria conta.

Para fazer login no aplicativo da Web como consumidor:

  1. Navegue até a página de login do Snowflake Data Clean Rooms.

  2. Digite seu endereço de e-mail e selecione Continue.

  3. Insira sua senha.

  4. Se você estiver associado a vários ambientes de sala limpa, selecione a conta Snowflake que deseja usar como conta de consumidor.

Instalar e configurar a sala limpa

Nesta seção, você irá:

  • Instalar a sala limpa compartilhada com você a partir da conta do provedor.

  • Adicionar dados à sala limpa para que eles possam ser unidos aos dados do provedor.

  • Adicionar uma política de junção para definir como os dados do consumidor e os dados do provedor estão relacionados.

  • Definir as colunas que os analistas podem usar para criar segmentos, filtrar resultados e enriquecer dados de ativação.

Inicie o processo de instalação

Para iniciar a instalação de uma sala limpa compartilhada pela conta do provedor:

  1. Na navegação da esquerda, selecione Clean Rooms.

  2. Selecione a guia Invited.

  3. Encontre o bloco Tutorial e selecione Join.

Como adicionar dados de consumidor à sala limpa

Para adicionar dados à sala limpa:

  1. Na seção Datasource, selecione Snowflake.

  2. Na lista suspensa Tables, selecione a tabela DEMO.CUSTOMERS. Esta tabela está localizada abaixo do banco de dados SAMOOHA_SAMPLE_DATABASE.

  3. Selecione Next.

Defina uma política de junção

Os consumidores usam uma política de junção para especificar quais colunas são unidas em uma análise ou consulta, definindo assim o relacionamento entre tabelas de provedores e tabelas de consumidores.

Para definir uma política de junção:

  1. Certifique-se de que as colunas da tabela do consumidor (My Columns) e as colunas da tabela do provedor (Collaborator Columns) correspondam. Por exemplo, a coluna HASHED_EMAIL do consumidor deve ser unida à coluna HASHED_EMAIL do provedor. Você especificou que os colaboradores só podem unir nessas colunas quando criou a sala limpa.

  2. Selecione Next.

Defina as colunas de segmentação e ativação

Ao selecionar colunas de segmentação e ativação durante o processo de instalação da sala limpa, você está definindo quais colunas estarão disponíveis para usuários que executam análises na sala limpa. Os analistas só podem criar um segmento com base nessas colunas. Ao enviar os dados de ativação de volta ao provedor, os analistas não podem enriquecer os resultados da análise com dados, a menos que eles venham de uma dessas colunas.

Para definir as colunas de segmentação e ativação:

  1. Na lista suspensa Tables, selecione a tabela DEMO.CUSTOMERS.

  2. Na lista suspensa Segmentation & Activation Columns, selecione as seguintes colunas:

    • INCOME_BRACKET

    • REGION_CODE

    • STATUS

  3. Selecione Finish.

  4. Você precisa esperar até que a sala limpa seja instalada antes de prosseguir com este tutorial. Selecione periodicamente Refresh até que o bloco Tutorial mude de Processing para Run.

Execute uma análise

Nesta seção, você executará uma análise de sobreposição e segmentação de público na sala limpa.

Para executar uma análise:

  1. Na navegação da esquerda, selecione Clean Rooms.

  2. Selecione a guia Joined.

  3. Encontre o bloco Tutorial e selecione Run.

  4. Selecione o bloco Audience Overlap & Segmentation e selecione Proceed.

  5. No My Tables, selecione Customers.

  6. No Collaborator Table, selecione Customers.

  7. Em My Join Columns, defina as seguintes junções:

    1. Na lista suspensa, selecione HASHED_EMAIL.

    2. Selecione + Join Column e depois escolha HASHED_FIRST_NAME e HASHED_LAST_NAME.

    3. Selecione + Join Column e depois selecione HASHED_PHONE.

    Ao executar uma análise na sala limpa, os resultados incluirão registros quando qualquer das seguintes opções for verdadeira:

    • O HASHED_EMAIL na tabela do consumidor corresponde a HASHED_EMAIL na tabela do provedor.

    • O HASHED_FIRST_NAME do consumidor corresponde ao HASHED_FIRST_NAME do provedor e o HASHED_LAST_NAME do consumidor corresponde ao HASHED_LAST_NAME do provedor.

    • O HASHED_PHONE do consumidor corresponde ao HASHED_PHONE do provedor.

  8. Na seção User Segmentation, faça o seguinte:

    1. A partir da lista suspensa My Columns, selecione INCOME_BRACKET.

    2. A partir da lista suspensa Collaborator Columns, selecione AGE_BAND.

    Os resultados da análise serão agrupados nesses segmentos.

  9. Na seção Filters, use as listas suspensas para definir DEMO.CUSTOMERS.STATUS = GOLD. Certifique-se de usar a codificação por cores para selecionar a coluna na conta do consumidor (My Columns).

    O STATUS de um registro na tabela do consumidor deve ser GOLD para ser incluso nos resultados da análise.

  10. Selecione Run.

  11. Use a seção Results para ver seus resultados. Você pode alternar sua métrica de resultados entre taxa de correspondência e contagem de sobreposição.

  12. Para ver os grupos de segmentação da sua análise, selecione Download e abra o arquivo delimitado por vírgulas.

  13. Continue para a próxima etapa do tutorial para enviar resultados enriquecidos de volta ao provedor para ativação.

Ative os resultados

Nesta seção, você ativará os resultados da análise, enviando-os por push de volta para a conta Snowflake do provedor. Esses resultados serão enriquecidos com os dados das tabelas de consumidores e provedores.

Para ativar os resultados da análise:

  1. Dentro da seção Results, selecione Activate.

  2. Selecione o nome da conta do provedor que você usou para compartilhar a sala limpa.

  3. No campo Segment Name, especifique Provider Snowflake Account.

  4. A partir da lista suspensa ID Columns, selecione HASHED_EMAIL.

  5. A partir da lista suspensa Attribute Columns, selecione Select All. Quando o provedor analisar os resultados da análise, os registros correspondentes serão enriquecidos com os dados adicionais encontrados nessas colunas.

    Você notará que as colunas disponíveis são as mesmas que as colunas de segmentação e ativação que você selecionou como provedor ao configurar a sala limpa, juntamente com as colunas de segmentação e ativação que você selecionou como consumidor ao instalar a sala limpa.

  6. Selecione Push Data.

Parabéns! Você instalou e configurou uma sala limpa em uma conta de consumidor, executou uma análise e enviou por push os resultados de volta para a conta do provedor para ativação.

Visualize os dados de ativação como o provedor

Nesta seção, você retorna à função de provedor para visualizar os resultados da ativação do consumidor. Os dados de ativação do consumidor são armazenados na tabela SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY da conta Snowflake do provedor.

Antes de usar o Snowsight para consultar esta tabela, você deve entrar no ambiente de sala limpa para criar o pipeline entre a conta do consumidor e a conta do provedor.

Para entrar no ambiente de sala limpa como provedor:

  1. Navegue até a página de login do Snowflake Data Clean Rooms.

  2. Digite seu endereço de e-mail e selecione Continue.

  3. Insira sua senha.

  4. Se você estiver associado a vários ambientes de sala limpa, selecione a conta Snowflake que você usou como a conta do provedor para este tutorial.

Após a criação bem-sucedida do pipeline, você pode visualizar os dados de ativação usando uma consulta SQL ou o explorador de objetos de banco de dados no Snowsight:

  1. Faça login na conta do provedor no Snowsight. Você está acessando a conta Snowflake, não o ambiente de sala limpa.

  2. No painel de navegação à esquerda, selecione Data » Database.

  3. Navegue até SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.

  4. Selecione Data Preview para visualizar os dados de ativação.

Limpeza

Você pode excluir a sala limpa e os dados de ativação que criou para este tutorial para limpar seu ambiente de produção.

Exclua os dados de ativação

Para excluir os dados de ativação da conta Snowflake do provedor:

  1. Faça login na conta do provedor no Snowsight. Você está acessando a conta Snowflake, não o ambiente de sala limpa.

  2. Abra Projects » Worksheets.

  3. Selecione + » SQL Worksheet.

  4. Na nova planilha, cole e execute a seguinte instrução para excluir os dados de ativação criados para este tutorial:

    DELETE FROM samooha_by_snowflake_local_db.public.provider_activation_summary
   WHERE segment = 'Provider Snowflake Account';
    Copy

Exclua a sala limpa

Excluir uma sala limpa na conta do provedor a remove tanto da conta do provedor quanto da conta do consumidor.

Para excluir uma sala limpa:

  1. Navegue até a página de login do Snowflake Data Clean Rooms.

  2. Digite seu endereço de e-mail e selecione Continue.

  3. Insira sua senha.

  4. Selecione a conta Snowflake usada como conta de provedor.

  5. Na navegação da esquerda, selecione Clean Rooms.

  6. Na aba Created, encontre o bloco Tutorial e selecione o ícone Mais (Três pontos verticais indicando mais opções).

  7. Selecione Delete.

  8. Selecione Proceed.

Saiba mais

Parabéns! Agora você usou o aplicativo da Web para criar e compartilhar uma sala limpa como provedor. Você também atuou como o consumidor que está usando a sala limpa para analisar dados em um ambiente de preservação de privacidade.

Você pode usar os seguintes recursos para saber mais:

Linguagem: Português