Éléments installés avec l’environnement Snowflake Data Clean Room

Ce chapitre fournit des informations sur les objets créés dans votre compte lorsque vous installez l’environnement Snowflake Data Clean Room et que vous créez ou rejoignez une collaboration. Pour plus d’informations sur les salles blanches des fournisseurs et des consommateurs, consultez Snowflake Data Clean Rooms : objets installés.

Vue d’ensemble

Le schéma suivant est une représentation simplifiée d’une collaboration à deux parties :

Vue d’ensemble de haut niveau de la collaboration avec deux participants

Remarques sur le schéma :

Ce schéma montre deux collaborateurs qui utilisent l’API Data Clean Rooms Collaboration pour créer et gérer une collaboration.

  • Le collaborateur A est le propriétaire et le créateur, comme indiqué par la définition de la collaboration YAML dans le schéma.

  • Les collaborateurs A et B sont tous deux des fournisseurs de données, comme indiqué par le partage de l’offre de données dans le diagramme.

  • Les collaborateurs A et B peuvent tous deux fonctionner comme des exécuteurs d’analyses, si la définition de la collaboration le permet.

  • Le collaborateur B a ajouté un modèle à la collaboration.

  • Le Secure Collaboration Orchestrator (SCO) est un compte Snowflake dédié utilisé pour gérer les collaborations de tous les comptes de sa région. Il existe un SCO pour chaque région. Le SCO pour une collaboration est déterminée en fonction de la région du compte du propriétaire.

  • Pour chaque collaboration, le SCO crée un paquet d’application avec une annonce. Les collaborateurs installent une application nommée SFDCR_collaboration_name à partir de cette liste, qui leur donne accès à la collaboration.

  • Les collaborateurs interagissent avec la collaboration par le biais de l’API de collaboration DCR dans leur SAMOOHA_BY_SNOWFLAKE_LOCAL_DB locale.

Les collaborateurs créent des offres de données et la SCO partage ces données avec les collaborateurs selon la définition de la collaboration. La SCO utilise les spécifications de collaboration, d’offre de données, de modèle et d’analyse pour appliquer des politiques de collaboration, par exemple qui peut accéder à quelles données en utilisant quels modèles, quelles données peuvent être activées, et vers qui, et si l’accès au SQL de forme libre est fourni.

Applications

Les applications suivantes sont installées lors de l’installation de l’environnement Snowflake Data Clean Rooms ou de l’adhésion à une collaboration :

Application native Data Clean Rooms SAMOOHA_BY_SNOWFLAKE

Application installée lors de l’installation de l’environnement Snowflake Data Clean Rooms. Chaque compte dispose de cette application de démarrage, installée à partir de l’annonce sur la Snowflake Data Clean Rooms Marketplace. Elle fournit des procédures de bibliothèque, des rôles de délégation et des fonctions d’aide utilisées par la DB locale, et fonctionne sur une DB locale et sur des objets de salle blanche.

Application de collaboration SFDCR_collaboration_name

Application installée pour chaque collaboration à laquelle un compte adhère. Elle fournit un schéma COLLABORATION avec des vues sécurisées (comme DATA_OFFERINGS, TEMPLATE_SPECS et CODE_SPECS) filtrées vers le compte d’installation, et un schéma COLLABORATION_INTERNAL avec des procédures stockées pour gérer les opérations de jointure, d’exécution et de sortie. Elle écrit dans la DB de salles blanches locale et renvoie des messages au SCO.

Bases de données

Les bases de données suivantes sont créées lors de l’installation de l’environnement Snowflake Data Clean Rooms ou de l’adhésion à une collaboration :

SFDCR_LOCAL_collaboration_name

Contient des informations locales relatives à une collaboration installée, y compris des données activées et des vues de données disponibles uniquement en local.

SAMOOHA_BY_SNOWFLAKE_LOCAL_DB

Cette base de données est créée lors de l’installation de l’environnement Snowflake Data Clean Rooms dans votre compte. Elle est locale à votre compte. Il ne s’agit pas d’une application, mais elle contient une logique d’application.

Cette base de données possède les schémas suivants :

Schéma ADMIN

Schéma dans la DB locale pour les fonctions administratives, y compris la gestion des privilèges, les informations sur la version et l’activation de l’analyse des tables externes.

Schéma COLLABORATION

Schéma principal dans la DB locale pour la fonctionnalité de salle blanche de collaboration. Contient des tâches, des flux et des procédures pour le traitement des messages.

Schéma REGISTRY

Stocke les modèles enregistrés, les offres de données, les spécifications de code et la table de mappage objets-registres.

Schéma registry_name_REGISTRY

Schéma créé lorsque vous créez un registre personnalisé. Par exemple, si vous créez un registre sales_data personnalisé, le système crée un schéma appelé sales_data_registry.

Partages et annonces

Vous trouverez ci-dessous les partages et les annonces qui sont impliqués et créés par collaboration, en fonction de votre rôle défini dans la collaboration.

Nom/format d’objet

Type

Description

SFDCR: SCO collaboration_id

Annonce entrante

Annonce partagée par le SCO pour chaque collaboration que vous créez ou êtes invité à créer.

SCO_DATA_OFFERINGS_LISTING_hash

Annonce sortante

Nom de l’annonce pour les offres de données partagées entre le fournisseur de données et les collaborateurs.

SCO_ACTIVATION_LISTING_hash

Annonce sortante

Nom de l’annonce pour le résultat de l’activation partagé par un exécuteur d’analyses à un autre collaborateur.

SCO_STAGED_CODE_LISTING_hash

Annonce sortante

Nom de l’annonce pour le code en zone de préparation partagé entre un fournisseur de code et un exécuteur d’analyses pour l’exécution de code.

SCO_DATA_OFFERINGS_SHARE_hash

Partage sortant

Partage créé par un fournisseur de données pour partager des offres de données (ensembles de données, politiques) à des collaborateurs.

SCO_ACTIVATION_SHARE_hash

Partage sortant

Partage créé par un exécuteur d’analyses pour repartager les résultats de l’activation avec un autre collaborateur.

SCO_STAGED_CODE_SHARE_hash

Partage sortant

Partage créé par un fournisseur de code pour un exécuteur d’analyses pour l’exécution de code.

Tâches

Vous trouverez ci-dessous les tâches liées à l’exploitation du nouvel environnement Snowflake Data Clean Rooms. Pour les tâches liées aux salles blanches héritées des fournisseurs et des consommateurs, référez-vous à Snowflake Data Clean Rooms : objets installés.

Nom de la tâche

Description

Entrepôt

EXPECTED_VERSION_TASK

Met automatiquement à niveau l’application native et la base de données locale à mesure que de nouvelles versions sont publiées.

Fréquence : Déclenché par une requête.

SAMOOHA_TASK_WAREHOUSE

collaboration_name_hash_OWNER_AUTO_JOIN

Tâche activée par le propriétaire pour rejoindre automatiquement une collaboration qu’il initie.

Fréquence : Toutes les minutes, est suspendu après 1 heure.

Entrepôt spécifié par l’utilisateur

Données d’échantillon

Les données d’échantillon sont stockées dans la base de données SAMOOHA_SAMPLE_DATABASE. Cette base de données contient des exemples d’ensembles de données nommés DEMO.CUSTOMERS et DEMO.CUSTOMERS_2 que vous pouvez utiliser comme données de test.

Note

La table CUSTOMERS_2 a été ajoutée en septembre 2025. Si vous avez installé votre environnement de salles blanches avant cette date, il se peut que cette table d’exemple ne soit pas installée. Pour savoir si CUSTOMERS_2 est installée, vous pouvez exécuter le code SQL suivant :

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

Si la réponse ne contient aucune ligne, alors vous ou une autre personne disposant du rôle ACCOUNTADMIN devez exécuter la commande suivante pour installer la table d’exemple :

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

Entrepôts virtuels

Snowflake Data Clean Rooms installe les entrepôts suivants dans votre compte. Vous pouvez modifier la taille de n’importe quel entrepôt si nécessaire. Nous vous recommandons d’utiliser des entrepôts XS pour les commandes générales d’édition, de création ou de suppression de salles blanches. Envisagez d’utiliser des entrepôts plus grands, ou des entrepôts optimisés pour Snowpark, lorsque vous exécutez des analyses volumineuses, comme des charges de travail de machine learning.

Apprenez à visualiser vos coûts d’utilisation d’entrepôt.

Nom de l’entrepôt.

Remarques

APP_WH

Entrepôt XSMALL qui est doté d’un accès par défaut à SAMOOHA_APP_ROLE.

SAMOOHA_TASK_WAREHOUSE

Entrepôt XSMALL utilisé pour des opérations telles que les mises à niveau automatiques.