Itens instalados com o ambiente Snowflake Data Clean Room¶
Este tópico apresenta informações sobre objetos criados na sua conta quando você instala o ambiente Snowflake Data Clean Room e cria ou ingressa em uma colaboração. Para obter informações sobre salas limpas de provedor e consumidor, consulte Snowflake Data Clean Rooms: objetos instalados.
Visão geral de alto nível¶
O diagrama a seguir é uma representação simplificada de uma colaboração entre duas partes:
Observações sobre o diagrama:
Este diagrama mostra dois colaboradores que estão usando a API Data Clean Rooms Collaboration para criar e gerenciar uma colaboração.
O colaborador A é o proprietário e criador, conforme indicado pelo YAML de definição de colaboração no diagrama.
Ambos os colaboradores A e B são provedores de dados, conforme indicado pelo compartilhamento da oferta de dados no diagrama.
Ambos os colaboradores A e B podem atuar como executores de análise, se a definição da colaboração permitir isso.
O colaborador B adicionou um modelo à colaboração.
O orquestrador de colaboração segura (Secure Collaboration Orchestrator, SCO) é uma conta Snowflake dedicada usada para gerenciar colaborações de todas as contas na respectiva região. Há um SCO para cada região. O SCO para uma colaboração é determinado com base na região da conta do proprietário.
Para cada colaboração, o SCO cria um pacote de app junto com uma listagem. Os colaboradores instalam um aplicativo chamado
SFDCR_collaboration_namecom base nessa listagem, o que lhes concede acesso à colaboração.Os colaboradores interagem com a colaboração por meio da DCR Collaboration API no respectivo SAMOOHA_BY_SNOWFLAKE_LOCAL_DB local.
Os colaboradores criam ofertas de dados, e o SCO compartilha esses dados com os colaboradores de acordo com a definição de colaboração. O SCO usa as especificações de colaboração, oferta de dados, modelo e análise para aplicar políticas de colaboração, como quem pode acessar quais dados usando quais modelos, quais dados podem ser ativados e para quem, e se o acesso SQL de formato livre é fornecido.
Aplicativos¶
Os seguintes aplicativos são instalados ao instalar o ambiente Snowflake Data Clean Rooms ou ingressar em uma colaboração:
- Data Clean Rooms Native Application
SAMOOHA_BY_SNOWFLAKE Aplicativo instalado durante a instalação do ambiente Snowflake Data Clean Rooms. Cada conta tem esse aplicativo bootstrapper instalado da listagem do Marketplace do Snowflake Data Clean Rooms. Ele inclui procedimentos de biblioteca, funções de delegação e funções auxiliares usados pelo DB local e opera em objetos de DB e de sala limpa locais.
- Aplicativo de colaboração
SFDCR_collaboration_name Aplicativo instalado por colaboração na qual uma conta ingressa. Ele fornece um esquema COLLABORATION com exibições seguras (como DATA_OFFERINGS, TEMPLATE_SPECS e CODE_SPECS) filtrado para a conta de instalação, e um esquema COLLABORATION_INTERNAL com procedimentos armazenados para processar as operações de ingresso, execução e saída. Ele grava no DB local de sala limpa e envia mensagens de volta para o SCO.
Bancos de dados¶
Os seguintes bancos de dados são criados ao instalar o ambiente Snowflake Data Clean Rooms ou ingressar em uma colaboração:
SFDCR_LOCAL_collaboration_nameContém informações locais para uma colaboração instalada, incluindo dados ativados e exibições de dados somente locais.
- SAMOOHA_BY_SNOWFLAKE_LOCAL_DB
Este banco de dados é criado ao instalar o ambiente Snowflake Data Clean Rooms em sua conta. Ele é o local de sua conta. Não é um aplicativo, mas contém lógica de aplicativo.
O banco de dados tem os seguintes esquemas:
- Esquema ADMIN
Esquema no DB local para funções administrativas, incluindo gerenciamento de privilégios, informações de versão e habilitação de análise de tabela externa.
- Esquema COLLABORATION
Esquema principal no DB local para a funcionalidade de sala limpa de colaboração. Contém tarefas, fluxos e procedimentos para processamento de mensagens.
- Esquema REGISTRY
Armazena modelos registrados, ofertas de dados, especificações de código e a tabela de mapeamento de objetos para registro.
- Esquema
registry_name_REGISTRY Esquema criado quando você cria um registro personalizado. Por exemplo, se você criar um registro personalizado chamado
sales_data, o sistema criará um esquema chamadosales_data_registry.
Tarefas¶
Veja abaixo as tarefas relacionadas à operação do novo ambiente Snowflake Data Clean Rooms. Para tarefas relacionadas a salas limpas legadas de provedor e consumidor, consulte Snowflake Data Clean Rooms: objetos instalados.
Nome da tarefa |
Descrição |
Warehouse |
|---|---|---|
|
Atualiza automaticamente o app nativo e o BD local à medida que novas versões são lançadas. Frequência: Acionamento por solicitação. |
SAMOOHA_TASK_WAREHOUSE |
|
Tarefa habilitada pelo proprietário para ingressar automaticamente em uma colaboração que ele inicia. Frequência: A cada 1 minuto, suspensa após 1 hora. |
Warehouse especificado pelo usuário |
Amostra de dados¶
Os dados de amostra são armazenados no banco de dados SAMOOHA_SAMPLE_DATABASE. Esse banco de dados contém tabelas de dados de amostra chamadas DEMO.CUSTOMERS e DEMO.CUSTOMERS_2 que você pode usar como dados de teste.
Nota
A tabela CUSTOMERS_2 foi adicionada em setembro de 2025. Se você instalou seu ambiente de salas limpas antes disso, talvez não tenha esta tabela de amostra instalada. Para verificar se você tem a CUSTOMERS_2 instalada, execute o seguinte código SQL:
Se a resposta não contiver linhas, você ou alguém com a função ACCOUNTADMIN deverá executar o seguinte comando para instalar a tabela de amostra:
Warehouses¶
Snowflake Data Clean Rooms instala os seguintes warehouses em sua conta. Você pode mudar o tamanho de qualquer warehouse conforme necessário. Recomendamos que você use warehouses XS para comandos gerais de edição, criação ou exclusão de salas limpas. Considere usar warehouses maiores, ou warehouses otimizados para Snowpark, ao executar grandes análises, como cargas de trabalho de machine learning.
Saiba como visualizar seus custos de uso de warehouse.
Nome do warehouse |
Notas |
|---|---|
APP_WH |
Warehouse XSMALL que, por padrão, recebe acesso a SAMOOHA_APP_ROLE. |
SAMOOHA_TASK_WAREHOUSE |
Warehouse XSMALL usado para operações como atualizações automáticas. |