Instalação do ambiente Snowflake Data Clean Rooms¶

Requisitos de conta, instalador e usuário¶

When you install the clean rooms environment, you install it for all potential users in the Snowflake account. However, access to the clean rooms environment must be granted to users explicitly by a clean rooms administrator.

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¶

Here are the role requirements for the person installing the clean rooms environment:

• You must have an ACCOUNTADMIN role in a Snowflake account in order to install the clean rooms environment in that account.

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

2. Instale a API de salas limpas¶

A API de salas limpas é usada para criação e uso programáticos de salas limpas.

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.