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();
Saiba como visualizar seus custos de uso de tarefa e warehouse.
Nome da tarefa |
Descrição |
Warehouse |
Nível de entidade |
---|---|---|---|
|
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 |
|
Montar, reparar e validar compartilhamentos recebidos de colaboradores. Cronograma padrão: 30 minutos. |
SAMOOHA_TASK_WAREHOUSE |
Por conta |
|
Calcula as métricas de linha de base das salas limpas criadas. Cronograma padrão: 3 horas. |
SAMOOHA_TASK_WAREHOUSE |
Por conta |
|
Calcula as métricas de linha de base das salas limpas unidas. Cronograma padrão: 3 horas. |
SAMOOHA_TASK_WAREHOUSE |
Por conta |
|
Monta o compartilhamento recebido de cada consumidor para ativações. Cronograma padrão: 15 minutos. |
SAMOOHA_TASK_WAREHOUSE |
Por conta |
|
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 |
|
Descriptografa os dados de ativação enviados de volta pelo consumidor. Cronograma padrão: Acionamento por solicitação. |
SAMOOHA_TASK_WAREHOUSE |
Por conta |
|
Configura relatórios de execução automática. Cronograma padrão: 60 minutos. |
SAMOOHA_TASK_WAREHOUSE |
Por conta |
|
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 |
|
Executa os relatórios definidos para execução automática. Cronograma padrão: 1 dia. |
O warehouse escolhido pelo usuário. |
Por conta |
|
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 |
|
Processa o orçamento de privacidade diferencial para uma sala limpa. Cronograma padrão: Acionamento por solicitação. |
SAMOOHA_TASK_WAREHOUSE |
Por colaborador |
|
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. |
|
Por sala limpa |
|
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 |
|
Redefine o orçamento de privacidade de todas as salas limpas. Cronograma padrão: 1 dia. |
SAMOOHA_TASK_WAREHOUSE |
Por sala limpa |
|
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 |
|
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 |