Snowflake Data Clean Rooms: detalhes da instalação¶
Este tópico fornece informações sobre os objetos criados na sua conta quando você instala um ambiente de sala limpa.
Snowflake Native App¶
Snowflake Data Clean Rooms instala o seguinte Snowflake Native App.
SAMOOHA_BY_SNOWFLAKE¶
Este Snowflake Native App alimenta as Snowflake Data Clean Rooms. Ele contém todas as funcionalidade principais e lógica de aplicativo usadas para criar e gerenciar salas limpas.
Este aplicativo possui os seguintes esquemas:
ADMIN¶
Este esquema contém todas as tabelas ou exibições necessárias para a administração do aplicativo. Você pode usá-lo para rastrear versões de aplicativo, patches e implantações. Os principais detalhes incluem:
Informações da versão (número)
Patches aplicados (versão, comandos)
APP SCHEMA¶
Este esquema contém funções e 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 APIs do desenvolvedor e o aplicativo da web para criar, instalar e trabalhar com salas limpas.
TEMPLATES¶
Este esquema contém os modelos SQL Jinja padrão que podem ser usados para executar análises usando APIs do desenvolvedor ou o aplicativo da web.
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.
Pacotes de aplicativo¶
Snowflake Data Clean Rooms instala os seguintes pacotes de aplicativo.
SAMOOHA_CLEANROOM_*¶
Este pacote de aplicativo é instalado somente em contas de provedor. 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¶
Snowflake Data Clean Rooms instala os seguintes bancos de dados.
SAMOOHA_BY_SNOWFLAKE_LOCAL_DB¶
Este banco de dados é criado pelo aplicativo da web 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.
Possui dois componentes:
As APIs do desenvolvedor que você e o aplicativo da web usam para criar e gerenciar salas limpas.
Conjuntos de dados intermediários de sua propriedade exclusiva 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 pelo aplicativo da web.
O banco de dados possui os seguintes esquemas:
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 salas limpas de APIs do desenvolvedor para o aplicativo da web.
Criação de versão dos procedimentos atuais associados ao funcionamento do aplicativo da web com a conta Snowflake.
Tarefas e fluxos que monitoram alterações no definir 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.
CONSUMER/CONSUMER_INIT¶
Este esquema contém procedimentos necessários para operar a instalação de sala limpa ou recursos do consumidor associados à conta, como:
Detalhes da listagem de salas limpas compartilhadas são necessários para solicitar salas limpas do preenchimento automático entre nuvens.
Recursos relacionados ao uso de políticas de junção/coluna e ao registro de um banco de dados em uma sala limpa.
Suporte para instalar e editar uma sala limpa, executar análises e visualizar modelos que foram adicionados.
ID_HUB¶
Este esquema contém procedimentos e tabelas intermediárias associadas ao hub de identidade.
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.
LIBRARY¶
Este esquema contém procedimentos necessários para habilitar conectores e recursos de sala limpa que são aplicáveis tanto para provedor quanto para consumidores, como:
Configuração do procedimentos do conector de anúncios facilitando a integração com hubs de ID e tabelas externas.
Registro de procedimentos de banco de dados para controlar a ativação ou desativação do preenchimento automático entre nuvens.
Aplicação de patches, cancelamento de registro de bancos de dados e atualização de registros de salas limpas.
PROVIDER¶
Este esquema contém dados ou informações relacionadas a ativações (fluxos e procedimentos para facilitar ativações de provedor), relatórios de análise salvos, metadados relacionados a conectores configurados nas contas Snowflake Data Clean Rooms e registros de sala limpa criados pela conta.
PUBLIC¶
Este esquema contém APIs do desenvolvedor que você e o aplicativo da web 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 pelo aplicativo da web.
Este esquema possui as seguintes tabelas:
CLEANROOM_RECORD: esta tabela inclui o status de uma sala limpa (criada, excluída), juntamente com o usuário e o carimbo de data/hora da última atualização. Se a atualização foi feita no aplicativo da web, o usuário é o usuário da conta de serviço. Se a atualização foi feita no Snowsight usando APIs do desenvolvedor, o usuário é o usuário real que chamou a API. O nome do banco de dados da sala limpa pode ser personalizado nesta tabela.
CONNECTOR_CONFIGURATION: esta tabela é a lista de conectores configurados na conta.
REPORTS: esta tabela inclui a lista de relatórios salvos pelo consumidor no aplicativo da web. Os resultados de nível superior dos relatórios padrão são salvos na tabela.
HORIZONTAL_ANALYSIS_<report ID>: saída de análises executadas com o modelo do SQL Query e modelos personalizados executados no aplicativo da web.
O banco de dados tem três compartilhamentos que são criados a partir dele:
SAMOOHA_INTERNAL_GOVERNANCE_SUMMARY SHARE_NAV2: este compartilhamento contém exibições nas tabelas GOVERNACE_SUMMARY e ACTIVATION no esquema PUBLIC. Isso é compartilhado com todos os provedores que criaram salas limpas instaladas por esta conta e é usado para compartilhar informações de governança e ativações de provedor.
SAMOOHA_INTERNAL_LOGS_SHARE_NAV 2: Este compartilhamento está na tabela LOG_EVENTS e é usado principalmente para compartilhar logs sobre como os procedimentos de resolução de ID estão progredindo de volta ao Snowflake, já que eles usam aplicativos 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: este compartilhamento é em duas tabelas, ADMIN.METADATA_UPDATE_REQUESTS, que é usado pelas APIs do desenvolvedor para solicitações de registro do aplicativo da web e ADMIN.RESOURCE_MONITOR_USAGE, que é usado apenas por contas gerenciadas para registrar o uso.
SAMOOHA_CLEANROOM_REQUESTS_*¶
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_*¶
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_<cleanroom>.SHARED.REQUESTS. Esta tabela mostra ao consumidor exatamente qual consulta estava tentando executar (PROPOSED_QUERY como a consulta de saída do modelo SQL do consumidor).
SAMOOHA_SAMPLE_DATABASE¶
Este banco de dados contém um conjunto de dados de amostra que você pode usar na sala limpa para executar análises e se familiarizar com o aplicativo.
Tarefas¶
Snowflake Data Clean Rooms instala a seguinte tarefa.
EXPECTED_VERSION_TASK¶
Esta tarefa atualiza automaticamente o Snowflake Native App para Snowflake Data Clean Rooms à medida que novas versões são lançadas. Ele existe no esquema SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.
Para habilitar a tarefa para que ela atualize automaticamente seu ambiente de sala limpa, use o API do desenvolvedor para executar o comando enable_local_db_auto_upgrades
. Por exemplo, use Snowsight para executar:
CALL samooha_by_snowflake_local_db.library.enable_local_db_auto_upgrades();
Warehouses¶
Snowflake Data Clean Rooms instala os seguintes warehouses.
Nome do warehouse |
Notas |
---|---|
APP_WH |
Snowflake Data Clean Rooms usa este warehouse para executar ações para as quais você não pode selecionar um warehouse. Se APP_WH ainda não existir na sua conta, o Snowflake o criará como um warehouse XS. |
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. |