Criação, junção, remoção e desinstalação de clean rooms

Esta página mostra como criar uma clean room básica, ingressar em uma clean room para a qual você foi convidado, excluir uma clean room que você criou ou remover uma clean room na qual ingressou como consumidor.

Crie uma nova clean room

Você deve ter a permissão adequada em uma conta Snowflake para poder criar uma clean room. O criador da clean room é chamado de 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. Se você não tiver acesso ao aplicativo da Web de clean rooms, fale com um administrador de clean rooms para sua conta Snowflake.

Para criar e compartilhar uma clean room, faça o seguinte:

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

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

  3. Selecione + Clean Room. O processo de criação tem as seguintes etapas:

    1. Use a etapa Add Data para nomear a sala limpa e selecionar as tabelas que serão compartilhadas com o consumidor. O nome pode ter no máximo 80 caracteres, sem distinção de maiúsculas e minúsculas, a–z, 0–9, espaços e sublinhados.

    2. Use a etapa Specify Join Policies para habilitar os provedores de identidade habilitados pelo administrador de conta de clean rooms e selecione em quais colunas o consumidor pode ingressar.

    3. Use a etapa Configure Analysis & Query para definir quais modelos estão disponíveis na clean room, definições de configuração específicas do modelo e recursos adicionais, como configurações de ativação e privacidade.

    4. 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.

Para obter um passo a passo completo sobre a criação de uma nova clean room na UI de clean room, experimente o tutorial do aplicativo da Web de clean rooms

Nota

Há um limite para o número de (clean rooms + colaboradores) que você pode criar em uma única conta. Se você criar muitas clean rooms de teste, talvez seja necessário excluir algumas para criar novas clean rooms. Se você precisar de mais clean rooms do que sua conta pode comportar, entre em contato com o suporte Snowflake.

Instale (ingresse em) a uma clean room

Se você tiver sido convidado a participar de uma clean room, receberá uma mensagem de e-mail com um link para instalar, configurar e executar a clean room na UI de clean room. Você pode seguir o link e usar a UI de clean room ou instalar e executar a clean room usando o código.

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 clean room, faça o seguinte:

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

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

  3. Na aba Invited, encontre a sala limpa e selecione Join. Você deve receber um link direto para esta página em um e-mail de convite quando for adicionado como colaborador na UI de clean room.

  4. Selecione as tabelas que você deseja usar para colaborar com os dados do provedor e, em seguida, selecione Next.

  5. Selecione todos os provedores de identidade disponíveis no ambiente de Clean Room que você precisa usar nessa clean room.

  6. Especifique quais colunas da sua tabela podem ser unidas e as colunas correspondentes dos dados do provedor.

  7. Selecione Next.

  8. Forneça configurações específicas do modelo para todos os modelos atribuídos à clean room.

  9. Clique em Finish e, opcionalmente, execute um modelo imediatamente ou agende uma execução repetida desse modelo.

Nota

Algumas clean rooms apresentam o seguinte erro quando você tenta ingressar nelas:

Application role `SAMOOHA_BY_SNOWFLAKE.DCR_DELEGATED_CLEANROOM_ROLE` does not exist
or not authorized.

Se encontrar esse erro, execute o código a seguir e tente entrar na clean room novamente:

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.PREPARE_MOUNT_SCRIPT();
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;
Copy

Exclusão de uma sala limpa que você criou

Após a exclusão, uma clean room não estará mais visível aos usuários compartilhados na próxima vez que eles abrirem o aplicativo da Web da clean room. Se uma análise estiver em andamento quando uma sala limpa for excluída, ela poderá não ser concluída antes que a sala limpa seja excluída.

Para usar a UI de clean room para excluir uma clean room que você criou, faça o seguinte:

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

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

  3. Na clean room a ser excluída, selecione Mais (Três pontos verticais indicando mais opções) > Delete.

Desinstale (saia de) uma clean room

É possível desinstalar uma sala limpa que você instalou (em que ingressou) como consumidor. Isso desinstalará a sala limpa para todos os usuários da conta.

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

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

  3. Navegue até Clean Rooms » Joined

  4. Na clean room, para desinstalar, selecione Mais (Três pontos verticais indicando mais opções) > Leave.

Adicione ou remova tabelas de uma clean room

Veja como adicionar ou remover (vincular ou desvincular) tabelas de uma clean room:

Ao usar a UI, somente tabelas ou exibições registradas por um administrador podem ser vinculadas a uma clean room. Se você não vir uma tabela ou exibição como disponível para uso em sua clean room, peça ao administrador para registrar o objeto em sua conta.

  • Como provedor, você escolhe quais tabelas serão vinculadas à clean room na etapa Add Data ao criar ou editar uma clean room.

  • Como consumidor, você escolhe as tabelas que serão vinculadas à clean room na etapa Add Data ao ingressar em uma clean room ou editá-la.

Depois que uma tabela é adicionada a uma clean room, ela não pode ser removida dessa clean room. Você pode, no entanto, remover os dados de toda a conta. Se precisar remover uma tabela ou exibição de uma clean room, fale com o administrador da clean room.