Snowflake Data Clean Rooms: objetos instalados

Este tópico fornece informações sobre os objetos criados na sua conta quando você instala um ambiente de sala limpa.

Pacotes de aplicativo

O Snowflake Data Clean Rooms instala os seguintes pacotes de aplicativo:

SAMOOHA_CLEANROOM_cleanroom name

A conta do provedor tem um pacote de aplicativo por sala limpa criada. Ele contém toda a lógica de aplicativo principal de uma sala limpa criada pelo provedor. Ele também contém as exibições seguras usadas para compartilhar dados com a sala limpa e várias tabelas que armazenam o estado da sala limpa. Isso inclui tabelas que registram o orçamento de privacidade diferencial atual dos consumidores, a coluna e a política de junção, e nomes de tabelas vinculadas à sala limpa.

Bancos de dados

SAMOOHA_BY_SNOWFLAKE

Esse banco de dados contém todas as funcionalidade principais e a lógica do aplicativo usadas para criar e gerenciar as salas limpas. O banco de dados tem os seguintes esquemas:

Esquema ADMIN

Esse esquema contém detalhes no nível do aplicativo, como estes:

  • Patches aplicados (versão, comandos)

  • Informações da versão (número)

Esquema APP_SCHEMA

Esse esquema contém as funções e os procedimentos necessários para facilitar todos os fluxos da sala limpa. Os principais detalhes incluem:

  • Funções de criptografia e descriptografia.

  • Procedimentos de sala limpa que você usa com as APIs de desenvolvedor e a UI de salas limpas para criar, instalar e trabalhar com as salas limpas.

Esquema TEMPLATES

Esse esquema contém os modelos Jinja em SQL fornecidos pela Snowflake.

Esses modelos pré-criados oferecem consultas SQL prontas para uso para colaboração de dados em Snowflake Data Clean Rooms. Eles aproveitam os modelos Jinja para personalização, permitindo que você adapte consultas a cenários específicos de compartilhamento de dados.

SAMOOHA_BY_SNOWFLAKE_LOCAL_DB

Esse banco de dados é criado pela UI de salas limpas durante o processo de instalação do Snowflake. Ele é o local de sua conta. Não é um aplicativo, mas contém lógica de aplicativo.

Esse banco de dados tem dois tipos de dados:

  • As APIs de desenvolvedor que você e a UI de salas limpas usam para criar e gerenciar as salas limpas.

  • Os conjuntos de dados intermediários de sua propriedade que são salvos no esquema PUBLIC durante os fluxos, como resolução de identidade. Por exemplo, as tabelas de saída do processo de resolução e transcodificação do LiveRamp são salvas no esquema PUBLIC e unidas à exibição que é vinculada à sala limpa pela UI de salas limpas.

O banco de dados possui os seguintes esquemas:

Esquema ADMIN

Este esquema contém informações necessárias para operar determinados recursos de sala limpa associados à conta, como:

  • Uso de preenchimento automático entre nuvens para colaborar entre regiões ou plataformas de nuvem.

  • Atualizações de metadados de salas limpas necessárias para registrar as salas limpas das APIs de desenvolvedor para a UI de salas limpas.

  • Criação de versão dos procedimentos atuais associados ao funcionamento da UI de salas limpas com a conta Snowflake.

  • Tarefas e fluxos que monitoram alterações no conjunto de compartilhamentos de salas limpas que são compartilhados de volta pelos colaboradores e para habilitar/desabilitar salas limpas conforme necessário com base nas alterações.

Esquema CONSUMER

Esse esquema contém as definições dos procedimentos da API de consumidor e algumas tarefas comuns do consumidor.

Esquema INFORMATION_SCHEMA

Como todos os bancos de dados Snowflake, este banco de dados contém o esquema INFORMATION_SCHEMA (“Dicionário de dados”), que consiste em um conjunto de exibições definidas pelo sistema e funções de tabela que fornecem informações abrangentes de metadados sobre os objetos criados em sua conta.

Esquema LIBRARY

Esse esquema contém as definições dos procedimentos da API do namespace library e algumas tarefas e procedimentos comuns usados por provedores e consumidores.

Esquema PROVIDER

Esse esquema contém as definições dos procedimentos da APIde provedor e algumas tarefas comuns do provedor.

Esquema PUBLIC

Esse esquema contém as APIs de desenvolvedor que você e a UI de salas limpas usam para criar e gerenciar salas limpas. Ele também contém conjuntos de dados intermediários de sua propriedade, que são salvos no esquema PUBLIC durante fluxos como resolução de identidade. Por exemplo, as tabelas de saída do processo de resolução e transcodificação do LiveRamp são salvas no esquema PUBLIC e unidas à exibição que é vinculada à sala limpa pela UI de salas limpas.

Este esquema possui as seguintes tabelas:

  • CLEANROOM_RECORD: essa tabela inclui o status de uma sala limpa (criada, excluída), junto com o usuário e o carimbo de data/hora da última atualização. Se a atualização foi feita na UI de salas limpas, o usuário é o da conta de serviço. Se a atualização foi feita na Snowsight usando as APIs de desenvolvedor, o usuário é o aquele real que chamou a API. O nome do banco de dados da sala limpa pode ser personalizado nessa tabela.

  • CONNECTOR_CONFIGURATION: essa tabela é a lista de conectores configurados na conta.

  • REPORTS: essa tabela inclui a lista de relatórios salvos pelo consumidor na UI de salas limpas. Os resultados de nível superior dos relatórios padrão são salvos na tabela.

  • HORIZONTAL_ANALYSIS_<ID do relatório>: saída das análises executadas com o modelo de consulta SQL e os modelos personalizados executados na UI de salas limpas.

  • CONSUMER_ACTIVATION_SUMMARY: Resultados da ativação do consumidor.

  • PROVIDER_ACTIVATION_SUMMARY: Resultados da ativação do provedor.

Esse banco de dados tem três compartilhamentos criados dele:

  • SAMOOHA_INTERNAL_GOVERNANCE_SUMMARY SHARE_NAV2: esse compartilhamento contém exibições nas tabelas GOVERNACE_SUMMARY e ACTIVATION e no esquema PUBLIC. Isso é compartilhado com todos os provedores que criaram salas limpas instaladas por esta conta e é usado para compartilhar de volta as informações de governança e ativações de provedor.

  • SAMOOHA_INTERNAL_LOGS_SHARE_NAV2: esse compartilhamento está na tabela LOG_EVENTS e é usado principalmente para compartilhar logs sobre o progresso dos procedimentos de resolução de ID com o Snowflake, já que ele usa apps nativos de terceiro. Nenhum PII ou dados são compartilhados de volta, apenas os APIs de sucesso/falha do aplicativo de terceiro usado para transcodificação/resolução.

  • SAMOOHA_INTERNAL_PROVIDER_METADATA_NAV2: esse compartilhamento está em duas tabelas: ADMIN.METADATA_UPDATE_REQUESTS, que é usada para enviar solicitações de registro da API para a UI, e ADMIN.RESOURCE_MONITOR_USAGE, que é usada apenas por contas gerenciadas para registrar o uso.

SAMOOHA_CLEANROOM_cleanroom ID

Cada sala limpa tem um banco de dados associado que inclui todos os detalhes dela, como os modelos instalados, os logs de solicitações, o status do LAF e muito mais. Esse banco de dados inclui os seguintes esquemas:

  • Admin: chaves criptográficas, orçamento de privacidade, logs de solicitações, solicitações de análises de provedor e muito mais.

  • Shared_schema: política de junção, status do LAF, tabelas vinculadas e versões.

  • Templates: lista de modelos de ativação, modelos personalizados e cadeias de modelos nesta sala limpa.

SAMOOHA_CLEANROOM_REQUESTS_clean room ID

Este é um banco de dados do lado do provedor e um compartilhamento do lado do consumidor. Corresponde ao compartilhamento que é devolvido por um consumidor ao provedor de uma sala limpa como parte do processo de instalação da sala limpa do consumidor. Este banco de dados contém informações sobre todas as solicitações feitas pelo consumidor em relação à sala limpa e é usado para monitorar o uso diferencial do orçamento de privacidade pelo consumidor.

SAMOOHA_CLEANROOM_CONSUMER_clean room ID

Este banco de dados é instalado somente em contas de consumidor. Ele é usado para compartilhar objetos como a exibição segura dos dados do consumidor para a sala limpa e políticas de junção/coluna do consumidor, se aplicadas. Possui a seguinte tabela:

  • SAMOOHA_CLEANROOM_CONSUMER_clean room ID.SHARED.REQUESTS. Essa tabela mostra ao consumidor exatamente qual consulta estava tentando ser executada, em que PROPOSED_QUERY é a consulta renderizada do modelo do consumidor.

SAMOOHA_SAMPLE_DATABASE

Este banco de dados contém conjuntos de dados de amostra denominados 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;
Copy

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;
Copy

Tarefas

Estas são algumas tarefas usadas por salas limpas que você pode ver em execução no seu ambiente.

É possível encontrar mais informações sobre uma determinada tarefa executando o seguinte procedimento:

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.DCR_HEALTH.DCR_TASKS_HEALTH_CHECK();
Copy

Saiba como visualizar seus custos de uso de tarefa e warehouse.

Tarefas de sala limpa

Nome da tarefa

Descrição

Warehouse

Nível de entidade

AUTO_RUN_warehouse

Executa os relatórios agendados para cada warehouse. Usa o warehouse do qual ele gera os relatórios.

Cronograma padrão: 1 dia.

DCR_WH_warehouse

Por relatório de sala limpa

AUTO_RUN_TASK

Executa os relatórios definidos para execução automática.

Cronograma padrão: 1 dia.

O warehouse escolhido pelo usuário.

Por conta

COMPUTE_DATA_STATS_​FOR_ACCOUNT_consumer locator

Calcula as métricas de linha de base das salas limpas unidas.

Cronograma padrão: 3 horas.

SAMOOHA_TASK_WAREHOUSE

Por conta

COMPUTE_DATA_STATS_​FOR_ACCOUNT_provider locator

Calcula as métricas de linha de base das salas limpas criadas.

Cronograma padrão: 3 horas.

SAMOOHA_TASK_WAREHOUSE

Por conta

DISTINCT_COLUMN_VALUES​_TASK

Calcula valores distintos para conjuntos de dados vinculados em uma sala limpa para permitir menus suspensos de filtros.

Cronograma padrão: 1 dia.

SAMOOHA_TASK_WAREHOUSE

Por sala limpa

EXPECTED_VERSION_TASK

Atualiza automaticamente o app nativo à medida que novas versões são lançadas.

Cronograma padrão: Acionamento por solicitação.

SAMOOHA_TASK_WAREHOUSE

Por conta

LISTEN_TO_REQUESTS

Montar, reparar e validar compartilhamentos recebidos de colaboradores quando a privacidade diferencial está habilitada na conta. A mesma tarefa, com uma frequência maior, é adicionada para evitar a sobrecarga da análise quando o DP está ativado. Essa tarefa custa aproximadamente seis créditos por dia.

Cronograma padrão: 1 minuto.

Sem servidor

Por conta

LISTEN_TO_REQUESTS_NODP

Montar, reparar e validar compartilhamentos recebidos de colaboradores.

Cronograma padrão: 30 minutos.

SAMOOHA_TASK_WAREHOUSE

Por conta

LISTEN_TO_REQUESTS​_1_COLLABORATOR

Configura ouvintes para as solicitações de retorno transmitidas de volta do consumidor para o provedor. Determina se uma sala limpa foi habilitada.

Cronograma padrão: Acionamento por solicitação.

SAMOOHA_TASK_WAREHOUSE

Por colaborador

MONITORING_SUMMARY_CRON_TASK

Uso interno.

Cronograma padrão: 30 minutos.

SAMOOHA_TASK_WAREHOUSE

Por conta

MOUNT_PROVIDER_ACTIVATIONS_TASK

Monta o compartilhamento recebido de cada consumidor para ativações.

Cronograma padrão: 15 minutos.

SAMOOHA_TASK_WAREHOUSE

Por conta

PRIVACY_AND_SECURITY_SCANNER

Verifica se há problemas de privacidade e segurança em cada modelo na sala limpa de cada provedor.

Cronograma padrão: 30 minutos.

SAMOOHA_TASK_WAREHOUSE

Por conta

PROCESS_ACTIVATIONS

Descriptografa os dados de ativação enviados de volta pelo consumidor.

Cronograma padrão: Acionamento por solicitação.

SAMOOHA_TASK_WAREHOUSE

Por conta

PROCESS_PROVIDER_ANALYSIS_REQUESTS

Executa a análise real do provedor.

Cronograma padrão: Acionamento por solicitação.

PROVIDER_RUN_UUID

Por sala limpa

PROCESS_REQUESTS_​BUDGET_COLLABORATOR_1

Processa o orçamento de privacidade diferencial para uma sala limpa.

Cronograma padrão: Acionamento por solicitação.

SAMOOHA_TASK_WAREHOUSE

Por colaborador

PROCESS_TEMPLATE_REQUESTS​_COLLABORATOR

Processa as solicitações de modelo para uma sala limpa.

Cronograma padrão: Acionamento por solicitação.

SAMOOHA_TASK_WAREHOUSE

Por colaborador

RESET_PRIVACY_BUDGET

Redefine o orçamento de privacidade de todas as salas limpas.

Cronograma padrão: 1 dia.

SAMOOHA_TASK_WAREHOUSE

Por sala limpa

SAMOOHA_INTERNAL_UID_​OUTPUT_TABLE_REFRESH_TABLE_DATA_TASK

Criado uma vez por tabela.

Cronograma padrão: 1 dia.

SAMOOHA_TASK_WAREHOUSE

Por conta

SETUP_AUTO_RUN

Configura relatórios de execução automática.

Cronograma padrão: 60 minutos.

SAMOOHA_TASK_WAREHOUSE

Por conta

SETUP_PROVIDER_ANALYSIS​_REQUESTS

Configura uma infraestrutura de análise do provedor e processa as solicitações para análise do provedor.

Cronograma padrão: Acionamento por solicitação.

SAMOOHA_TASK_WAREHOUSE

Por sala limpa

TRIGGER_REFRESH_FOR_LAF_CLEANROOMS

Aciona a atualização de dados para salas limpas ativadas para preenchimento automático entre nuvens.

Cronograma padrão: 30 minutos.

SAMOOHA_TASK_WAREHOUSE

Por conta

Warehouses

O Snowflake Data Clean Rooms instala em sua conta os warehouses a seguir. Você pode alterar o tamanho de qualquer warehouse conforme necessário.

Saiba como visualizar seus custos de uso de warehouse.

Nome do warehouse

Notas

APP_WH

O warehouse XSMALL tem acesso à API, configura novas salas limpas, gerencia permissões e compartilhamento de dados.

DCR_WH_SMALL

Warehouse regular, SMALL

DCR_WH_Medium

Warehouse regular, MEDIUM

DCR_WH_Large

Warehouse regular, LARGE

DCR_WH_XLarge

Warehouse regular, XLARGE

DCR_WH_2XLARGE

Warehouse regular, XXLARGE

DCR_WH_4XLarge

Warehouse regular, X4LARGE

DCR_WH_OPT_XLarge

Warehouse XLARGE otimizado para Snowpark

DCR_WH_OPT_2XLarge

Warehouse XXLARGE otimizado para Snowpark

DCR_WH_OPT_4XLarge

Warehouse X4LARGE otimizado para Snowpark

PROVIDER_RUN_<identificador_de_sala_limpa>

Warehouse na conta do consumidor que executa análises executadas pelo provedor.

SAMOOHA_TASK_WAREHOUSE

O warehouse XSMALL é usado para muitas coisas, como verificações de privacidade e segurança, processamento de relatórios de execução automática, cálculo de estatísticas de dados e processamento de solicitações de modelo do consumidor.

DCR_ACTIVATION_WAREHOUSE

Usado para descriptografar os resultados de ativação enviados ao provedor. O tamanho padrão é XL, mas pode ser modificado chamando provider.update_activation_warehouse.