Como trabalhar com o Snowflake Data Clean Rooms no aplicativo da web¶
O aplicativo da Web de uma Snowflake Data Clean Room fornece uma UI intuitiva que permite aos usuários empresariais criarem e utilizarem salas limpas sem se preocupar com as complexidades de código.
Este tópico fornece uma introdução às tarefas que você conclui ao trabalhar em uma sala limpa. Ele descreve as ações do provedor que cria e compartilha uma sala limpa junto com o consumidor que usa essa sala limpa.
Criação de uma sala limpa como provedor¶
A página Clean Rooms no aplicativo da web permite que você, como provedor, gerencie o ciclo de vida de uma sala limpa, incluindo a criação e o compartilhamento. Para criar e compartilhar uma sala limpa:
Na navegação da esquerda, selecione Clean Rooms.
Selecione + Clean Room. O processo de criação contém 4 etapas:
Use a etapa Add Data para nomear a sala limpa e selecionar as tabelas que serão compartilhadas com o consumidor.
Use a etapa Specify Join Policies para aprimorar seus dados com dados de terceiros e selecionar quais colunas o consumidor pode unir.
Use a etapa Configure Analysis & Query para definir quais análises o consumidor pode executar na sala limpa e selecione as tabelas e colunas que ele pode usar em sua análise.
Use a etapa Share Clean Room para convidar os consumidores a usar a sala limpa para colaborar. Você também pode usar a opção Enable Run Analysis & Query para especificar quais colaboradores podem executar análises na sala limpa.
Execução de uma análise como provedor¶
Um provedor pode configurar uma sala limpa para que ele possa executar suas próprias análises nela. Ao configurar uma sala limpa para executar análises do provedor, o provedor pode especificar se o consumidor também pode executar análises na sala limpa. Se o provedor especificar que os consumidores não podem executar análises, eles atuarão apenas como provedores de dados na sala limpa.
Os provedores usam a opção Enable Run Analysis & Query durante o estágio Share Clean Room de criação de uma sala limpa para especificar quem pode executar uma análise. Para configurar a sala limpa para que o provedor possa executar uma análise, o provedor ativa essa opção para sua própria conta, que é listada junto com os consumidores.
Quando o provedor deseja executar uma análise, ele pode fazer uma das seguintes opções:
Selecione Clean Rooms na navegação à esquerda, encontre o bloco da sala limpa na guia Created e selecione Run.
Selecione Analyses & Queries na navegação à esquerda e execute uma análise existente ou crie uma nova, como um consumidor faria.
Para ambos os métodos de início de uma análise, o provedor pode selecionar qual colaborador tem os dados que deseja incluir em sua análise.
Importante
Se um consumidor permitir que um provedor execute uma análise em um modelo, o consumidor, não o provedor, será cobrado pelos créditos consumidos pela análise do provedor. Após o consumidor permitir que o provedor execute análises, o consumidor deve desinstalar a sala limpa para parar de incorrer em custos.
Se um consumidor quiser obter uma estimativa do número de créditos consumidos pelo provedor dentro de um período específico, ele pode executar a seguinte consulta, em que -5 retorna uma estimativa dos 5 dias anteriores de consumo de computação pelo provedor:
SELECT * FROM table(samooha_by_snowflake_local_db_dev.public.udtf(-5));
Se você é um consumidor que deseja monitorar as análises executadas pelo provedor, consulte Monitoramento de análises executadas pelo provedor.
Envio de resultados de análise executados pelo provedor para a conta Snowflake¶
Um provedor pode enviar resultados de uma análise executada pelo provedor para sua conta Snowflake, onde podem ser usados para ativação.
Importante
O consumidor que está contribuindo com seus dados para uma sala limpa configurada para uma análise executada pelo provedor deve consentir com a capacidade do provedor de enviar resultados para a conta Snowflake do provedor. Para fornecer este consentimento como consumidor, conclua estas etapas:
Comece instalando a sala limpa configurada para análises executadas pelo provedor.
Continue o processo de instalação até chegar à etapa Configure Analysis & Query.
Na seção Activation Settings, selecione Allow activation for clean room provider.
Para enviar os resultados de uma análise executada pelo provedor para sua conta Snowflake, conclua estas etapas:
Após executar a análise executada pelo provedor, selecione Activate na seção Results.
Selecione o nome da sua conta Snowflake.
Selecione Push Data.
Para obter informações sobre como visualizar os dados enviados quando eles estiverem disponíveis na conta Snowflake, consulte Visualização de resultados da análise na conta Snowflake do provedor.
Limitações nas análises executadas pelo provedor¶
Ao usar o aplicativo da web para executar uma análise, o provedor tem as seguintes limitações:
Nem todos os modelos são suportados. Atualmente, os modelos Audience Overlap & Segmentation e consulta SQL são suportados.
Se os colaboradores estiverem em nuvens ou regiões diferentes:
Os consumidores devem habilitar o preenchimento automático entre nuvens em suas contas.
Os resultados de uma análise executada pelo provedor são retornados com base na frequência de atualização combinada entre ambas as partes. Provedores e consumidores devem se coordenar para que a frequência de atualização do aplicativo do provedor e da listagem do consumidor sejam semelhantes (por exemplo, ambos têm uma frequência de 15 minutos). Isso garante que os resultados sejam retornados prontamente.
Instalação de uma sala limpa como consumidor¶
A página Clean Rooms no aplicativo da web permite que você, como consumidor, instale salas limpas que foram compartilhadas com você por um provedor. Para instalar uma sala limpa:
Na navegação da esquerda, selecione Clean Rooms.
Na aba Invited, encontre a sala limpa e selecione Join.
Selecione as tabelas que deseja usar para colaborar com os dados do provedor.
Use o campo Join Policies para definir a relação entre seus dados e os dados do provedor.
Selecione Next.
Execução de uma análise como consumidor¶
Como consumidor, você pode usar a página Clean Rooms ou a página Analyses & Queries para executar análises em uma sala limpa instalada.
Para usar a página Clean Rooms para executar uma nova análise com base nos tipos de análises que o provedor disponibilizou na sala limpa:
Na navegação da esquerda, selecione Clean Rooms.
Na aba Joined, encontre a sala limpa na lista e selecione Run.
Selecione o tipo de análise e depois selecione Proceed.
Adição de filtros à análise. Há dois motivos pelos quais os valores do filtro podem não estar disponíveis:
A coluna contém mais de 20 valores distintos.
A sala limpa foi instalada recentemente e não concluiu o processamento dos valores de versão da coluna. Você pode executar a análise novamente quando esses valores estiverem disponíveis.
Selecione Run.
Opcional: expanda a seção Save Analysis & Query para salvar a análise para uso futuro.
Para usar a página Analyses & Queries para executar análises existentes ou criar e executar uma nova análise:
Na navegação da esquerda, selecione Analyses & Queries.
Faça uma das seguintes opções:
Para executar uma análise existente, use os filtros para encontrar a análise e executá-la.
Para criar e executar uma nova análise com base nos tipos de análises que o provedor disponibilizou na sala limpa, selecione + New Analysis & Query.
Seleção de um warehouse para uma análise¶
Você pode selecionar qual warehouse deseja usar para executar uma análise. Aumentar o tamanho ou alterar o tipo do warehouse pode acelerar a análise.
Nota
O tipo de modelo determina que tipo de warehouse você pode selecionar para a análise. Por exemplo, alguns modelos (como o sobreposição de público) permitem apenas warehouses regulares, enquanto outros modelos (como Audience Lookalike Modeling) permitem apenas warehouses otimizados para Snowpark.
A opção para selecionar um warehouse diferente aparece ao lado do botão Run em um modelo. Esta opção não aparece para todos os modelos.
Esteja ciente de que aumentar o tamanho de um warehouse ou usar um warehouse otimizado para Snowpark pode aumentar o custo de execução da análise. Para obter informações sobre como o consumo de crédito cresce à medida que você usa um warehouse maior, consulte Tamanho do warehouse e Faturamento de warehouses otimizados para Snowpark.
Para uma descrição dos warehouses disponíveis, consulte Warehouses.
Se você é um administrador que deseja criar opções adicionais de warehouse, consulte Adição de opções de warehouse.
Visualização de detalhes sobre uma sala limpa¶
Você pode obter detalhes sobre uma sala limpa, incluindo:
Uma guia Collaborator Summary que lista os modelos na sala limpa junto com as tabelas e colunas de junção do seu colaborador.
Uma guia My Summary que lista suas tabelas e colunas de junção.
Uma guia Table Relations que lista o relacionamento entre suas tabelas e as tabelas do seu colaborador (ou seja, como as tabelas são unidas).
Uma guia Data Stats que fornece as seguintes métricas para suas tabelas:
Minha tabela: mostra quantos identificadores distintos pertencem a um determinado grupo. Observe que as estatísticas são atualizadas a cada 24 horas, portanto, pode haver um atraso entre a modificação da sala limpa e a visualização das estatísticas atualizadas. Observe também que colunas com mais de 20 valores distintos não são mostradas.
Estatísticas de sobreposição: uma sala limpa com os modelos de Audience Overlap & Segmentation ou consulta SQL mostrará estatísticas de sobreposição ao consumidor. Essas estatísticas descrevem quantos identificadores distintos (colunas de junção) pertencem a um determinado grupo com base nas colunas de atributo habilitadas no modelo. Você pode selecionar até 2 colunas de atributo para ver as estatísticas detalhadas. Os dados são gerados após a instalação inicial e são atualizados sempre que um usuário faz login no aplicativo da web da sala limpa. Observe que na visualização do gráfico de barras, apenas as 5 primeiras linhas de dados são plotadas com base na classificação padrão fornecida. Estatísticas que levarem mais de 10 minutos para serem executadas para uma análise específica não estarão disponíveis.
Para acessar esses detalhes da sala limpa, siga estas etapas:
Na navegação da esquerda, selecione Clean Rooms.
Clique no bloco para a sala limpa.
Os detalhes da sala limpa também estão disponíveis na seção Clean Rooms Details quando você estiver executando uma análise.