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 ID_HUB

Este esquema contém procedimentos e tabelas intermediárias associadas ao hub de identidade.

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

Esse banco de dados contém conjuntos de dados de amostra que você pode usar em sua sala limpa.

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

LISTEN_TO_REQUESTS

Montar, reparar e validar compartilhamentos recebidos de colaboradores quando a privacidade diferencial está habilitada na conta. A mesma tarefa em uma frequência mais alta é adicionada para evitar a execução em excesso da análise quando DP está habilitado.

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

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

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

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

SETUP_AUTO_RUN

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

Cronograma padrão: 60 minutos.

SAMOOHA_TASK_WAREHOUSE

Por conta

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

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

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

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

PROCESS_PROVIDER_ANALYSIS_REQUESTS

Executa a análise real do provedor.

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

PROVIDER_RUN_UUID

Por sala limpa

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

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

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

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_*

Por relatório de sala limpa

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.