Instalação do ambiente Snowflake Data Clean Rooms¶

Requisitos de conta, instalador e usuário¶

Ao instalar o ambiente do Clean Rooms, você o instala para todos os usuários potenciais na conta Snowflake. No entanto, o acesso ao ambiente do Clean Rooms deve ser concedido explicitamente aos usuários por um administrador.

Aqui estão os requisitos para instalar Snowflake Data Clean Rooms em sua conta Snowflake:

• A conta deve ter a edição do Snowflake exigida:

  • Para criar clean rooms, você deve ter a Enterprise Edition ou superior.

  • Para participar e usar uma clean room criada em outra conta, você deve ter a Standard Edition ou superior.

• O instalador deve cumprir estes requisitos de função.

• Não há suporte para contas de leitor, porque elas não permitem o compartilhamento de dados necessário para instalar e executar o aplicativo de salas limpas.

• A conta deve permitir a autenticação por par de chaves, que é usada pela conta de serviço para autenticação.

• Você precisa aceitar os termos de compartilhamento de dados. Se você não aceitou os Termos da Funcionalidade de Compartilhamento de Dados Controlado pelo Cliente do Snowflake, entre em contato com o suporte Snowflake. O Snowflake Data Clean Rooms utiliza listagens, que fazem parte do Serviço Snowflake e estão sujeitas aos seus termos de Serviço com o Snowflake, incluindo os Termos da Funcionalidade de Compartilhamento de Dados Controlado pelo Cliente do Snowflake e a Política de Uso Aceitável Snowflake.

• Você deve remover da definição os parâmetros incompatíveis no nível da conta. Consulte a lista de configurações incompatíveis no nível da conta.

• (UI de clean rooms somente) A conta Snowflake deve ser uma conta de capacidade: é uma conta que tem um compromisso de capacidade inicial. As contas Snowflake sob demanda não podem acessar a UI de clean rooms.

• (UI de clean rooms somente) Você deve usar a autenticação multifator (MFA) com um aplicativo autenticador compatível.

Se você não atender a todos esses requisitos e precisar fazer o upgrade, entre em contato com o suporte Snowflake.

Parâmetros de nível de conta não aceitos¶

O Snowflake Data Clean Rooms não aceita determinados valores de parâmetros no nível da conta. A tabela a seguir mostra os valores necessários para os parâmetros:

Para verificar um parâmetro na sua conta, execute o seguinte comando SQL, substituindo o nome do parâmetro por <parameter_name>:

SHOW PARAMETERS LIKE '<parameter_name>' IN ACCOUNT;

Por exemplo:

SHOW PARAMETERS LIKE 'DEFAULT_DDL_COLLATION' IN ACCOUNT;

Requisitos da função¶

Aqui estão os requisitos de função para a pessoa que instala o ambiente do Clean Rooms:

• Você precisa ter a função ACCOUNTADMIN em uma conta Snowflake para instalar o ambiente do Clean Rooms nessa conta.

• O usuário com a função ACCOUNTADMIN deve ter um nome, sobrenome e e-mail válidos definidos para seu objeto de usuário. Para verificar, execute DESCRIBE USER.

1. Instale o aplicativo nativo¶

Instale o aplicativo nativo do marketplace:

1. Defina sua função atual como ACCOUNTADMIN

2. Instale o aplicativo Snowflake Data Clean Rooms do Snowflake Marketplace

3. Selecione Get e aceite as opções padrão.

A instalação leva alguns minutos. Quando terminar, prossiga para a etapa 2.

2. Instale a API de salas limpas¶

A API do Clean Rooms é necessária para usar salas limpas pela UI ou pela API.

Estas são as etapas para instalar a API de salas limpas em sua conta Snowflake:

1. Após instalar o aplicativo nativo, inicie-o no Snowflake. No menu de navegação, selecione Catalog » Apps » Snowflake Data Clean Rooms » Launch app. Isso abre uma planilha com comandos SQL.

2. Execute os comandos SQL para instalar a API de salas limpas, com as seguintes observações:

   • Se você renomeou o aplicativo nativo durante a instalação, será necessário modificar o script conforme indicado nos comentários do script.

   • Se quiser revisar o script de instalação completo antes de executá-lo, descomente a linha do script DRY_RUN=TRUE e execute todos os comandos até essa linha, inclusive, para ver o conteúdo do script. Observe que você não deve executar manualmente o script de instalação exposto por esse comando, pois isso pode resultar em uma instalação incompleta.

   • Observe que a instalação leva alguns minutos.

3. Confirme que você pode acessar a API:

   USE ROLE SAMOOHA_APP_ROLE;
   USE WAREHOUSE app_wh;
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.CHECK_MOUNT_STATUS();
   

   Copy

   Se isso retornar FALSE, consulte a seção de solução de problemas abaixo.

4. Conceda acesso à API a outros usuários de sua conta Snowflake:

   • Para adicionar usuários com capacidades completas para criar e gerenciar clean rooms, execute GRANT ROLE SAMOOHA_APP_ROLE to USER USER

   • Para adicionar usuários com permissões apenas de execução pelo consumidor, crie uma ou mais funções do Snowflake e conceda aos usuários acesso a essa função. Em seguida, conceda acesso de execução a clean rooms específicas chamando consumer.grant_run_on_cleanrooms_to_role.

5. (Opcional) Instale a UI de clean rooms para permitir o acesso sem código às suas clean rooms ou a outros recursos, como consultas agendadas.

3. Habilite a UI de clean rooms¶

A UI de salas limpas oferece um ambiente fácil e sem código para gerenciar sua conta de salas limpas, criar salas limpas e executar análises. Ela também oferece algumas funcionalidades adicionais não disponível na API de salas limpas, como consultas agendadas, ativação de terceiro e modelos predefinidos úteis.

Veja como habilitar a UI de clean rooms em sua conta Snowflake:

1. Configure suas políticas de rede para permitir que a UI de clean rooms acesse sua conta Snowflake. (Necessário somente se sua conta Snowflake usar uma política de redes para controlar o tráfego de rede.)

2. Preencha a configuração da UI. Essa etapa configura um usuário de serviço [*] que a UI de salas limpas usa para se comunicar com o Snowflake.

   1. Faça login na UI de clean rooms com suas credenciais Snowflake.

   2. Abra Admin » Snowflake Admin » Connect to Snowflake account.

   3. Em Enable the Data Clean Rooms UI, escolha Quick Setup ou Manual Setup:

      • Quick Setup: cria um usuário de serviço para você. Especifique um nome de usuário de serviço exclusivo para esta conta.

      • Manual Setup: se você mesmo quer criar o usuário de serviço ou reutilizar um existente, selecione essa opção. Observe que as salas limpas assumem o controle do usuário de serviço e o modificam, portanto, certifique-se de que o usuário de serviço não seja usado para mais nada. Saiba mais como criar um usuário de serviço.

   4. Insira seu nome de usuário de serviço exclusivo e selecione Finish.

3. Configure seu ambiente de salas limpas conforme descrito na próxima seção.