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 colaborações e ser proprietário, você deve ter a Standard Edition ou superior.

  • Para ingressar em uma colaboração como executor de análises, você deve ter a Standard Edition ou superior.

  • Para ingressar em uma colaboração como provedor de dados ou ativar dados para outro colaborador, você deve ter a Enterprise Edition ou superior.

• O instalador deve cumprir estes requisitos de função e usuário.

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

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

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 de função e usuário¶

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 Open e aceite as opções padrão.

A instalação leva vários minutos. Quando concluir, 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. Clique no botão Open in Worksheet no canto superior direito. 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:

   CopyExpand

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

   Show lessSee more

   Scroll to top

   Se ele retornar FALSE, confirme que você use SAMOOHA_APP_ROLE e, em caso afirmativo, tente executar novamente o comando mount script com a função ACCOUNTADMIN outra vez.