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:

Visão geral de alto nível da colaboração com dois participantes

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_name com 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_name

Conté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 chamado sales_data_registry.

Compartilhamentos e listagens

Veja abaixo os compartilhamentos e as listagens que estão envolvidos e são criados por colaboração, dependendo da sua função definida na colaboração.

Nome/formato do objeto

Tipo

Descrição

SFDCR: SCO collaboration_id

Listagem recebida

Listagem compartilhada pelo SCO para cada colaboração que você cria ou para a qual é convidado.

SCO_DATA_OFFERINGS_LISTING_hash

Listagem enviada

Nome da listagem de ofertas de dados compartilhadas do provedor de dados com os colaboradores.

SCO_ACTIVATION_LISTING_hash

Listagem enviada

Nome da listagem para resultado de ativação compartilhado por um executor de análise com outro colaborador.

SCO_STAGED_CODE_LISTING_hash

Listagem enviada

Nome da listagem para código preparado compartilhada de um provedor de código com um executor de análise para execução do código.

SCO_DATA_OFFERINGS_SHARE_hash

Compartilhamento enviado

Compartilhamento criado por um provedor de dados para compartilhar ofertas de dados (conjuntos de dados, políticas) com colaboradores.

SCO_ACTIVATION_SHARE_hash

Compartilhamento enviado

Compartilhamento criado por um executor de análise para compartilhar resultados de ativação com outro colaborador.

SCO_STAGED_CODE_SHARE_hash

Compartilhamento enviado

Compartilhamento criado por um provedor de código para um executor de análise para execução do código.

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

EXPECTED_VERSION_TASK

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

collaboration_name_hash_OWNER_AUTO_JOIN

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:

SHOW TABLES LIKE 'CUSTOMERS_2' IN SCHEMA SAMOOHA_SAMPLE_DATABASE.DEMO;

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:

USE ROLE ACCOUNTADMIN;
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;

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.