Tutoriel : Créer et exécuter une salle blanche à l’aide de l’UI des salles blanches et de deux comptes¶

Introduction¶

Les salles blanches permettent aux utilisateurs de partager des données avec un collaborateur tout en préservant la confidentialité des données grâce à un contrôle strict de ce qui peut être fait avec celles-ci. Ce tutoriel vous guide à travers le processus de base de l’utilisation de l’UI des salles blanches pour travailler avec une Snowflake Data Clean Room et deux comptes de test, pour une fonctionnalité complète des salles blanches. Si vous avez accès à un seul compte Snowflake avec des salles blanches installées, vous pouvez essayer le tutoriel pour un seul compte à la place.

Ce que vous apprendrez¶

Dans ce tutoriel, vous apprendrez à utiliser l’UI des salles blanches en effectuant les tâches suivantes :

Ajouter un collaborateur à votre environnement de salle blanche.
Créer une salle blanche, y compris comment ajouter des données, spécifier des politiques de jointure, définir le type d’analyse qu’un collaborateur peut effectuer sur les données et partager la salle blanche avec un collaborateur.
Installez une salle blanche, ajoutez des données et définissez comment ces données sont jointes à celles du collaborateur.
Effectuez une analyse.
Activez les résultats de l’analyse.

À propos des collaborateurs de la salle blanche¶

Les collaborateurs de la salle blanche sont soit des fournisseurs, soit des consommateurs.

Un fournisseur est le compte qui crée et configure la salle blanche. Dans une salle blanche typique, le fournisseur ajoute tous les modèles SQL que le consommateur peut exécuter dans la salle blanche. Le fournisseur ajoute des données, y définit des restrictions d’utilisation et invite les consommateurs, qui peuvent rejoindre la salle blanche pour exécuter les modèles.
Un consommateur est le compte invité à participer à la salle blanche. Le consommateur ajoute ses propres données et exécute les modèles sur les données de la salle blanche, en fonction des limitations fixées par le fournisseur.

Conditions préalables¶

Vous devez avoir accès à deux environnements Snowflake avec l’UI Snowflake Data Clean Rooms installée : l’un à utiliser comme fournisseur et l’autre à utiliser comme consommateur. Vous devez soit installer les environnements vous-même, ou demander à un administrateur de vous donner accès à l’UI des salles blanches dans un compte Snowflake.
Ce tutoriel utilise un exemple de table nommé CUSTOMERS_2. Recherchez soit Snowsight pour la table SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2, ou exécutez la commande SQL suivante dans votre compte Snowflake pour confirmer que vous avez installé cette table :
```
SHOW TABLES LIKE 'CUSTOMERS_2' IN SCHEMA SAMOOHA_SAMPLE_DATABASE.DEMO;
```
Si la réponse ne comporte pas de lignes, alors vous, ou quelqu’un avec le rôleACCOUNTADMIN 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;
```

Fournisseur : se connecter à l’UI des salles blanches¶

Connectez-vous à la salle blanche où vous créerez, configurerez et partagerez une salle blanche en tant que fournisseur.

Connectez-vous à l’UI des salles blanches. Fournissez les identifiants de connexion de votre compte Snowflake pour le compte qui servira de fournisseur.

Fournisseur : ajouter le consommateur en tant que collaborateur¶

Dans cette section, vous ajouterez le compte du consommateur que vous utilisez pour ce tutoriel en tant que collaborateur. Les administrateurs doivent définir quelqu’un comme collaborateur avant que d’autres utilisateurs puissent partager une salle blanche avec ce collaborateur.

Pour ajouter le consommateur en tant que collaborateur :

Dans la navigation de gauche, sélectionnez Collaborators.
Sélectionnez l’onglet Snowflake Partners.
Sélectionnez + Snowflake Partner.
Dans le champ Company Name entrez Tutorial Consumer.
Dans le champ Email Address , entrez l’adresse e-mail associée à votre utilisateur de salle blanche.
Dans le champ Account Locator, saisissez le localisateur de compte du compte Snowflake que vous utilisez en tant que consommateur.
Sélectionnez le cloud et la région du compte qui héberge votre compte de consommateur.
Sélectionnez Add.

Fournisseur : Créer et partager une salle blanche¶

Dans cette section, vous ferez ce qui suit :

Créer une salle blanche.
Ajouter des données à la salle blanche partagée avec les collaborateurs.
Définir une politique de jointure, qui contrôle les colonnes sur lesquelles un collaborateur peut joindre ses propres données.
Définir les types d’analyse qu’un collaborateur peut effectuer dans la salle blanche.
Partager la salle blanche avec le consommateur.

Lancer le processus de création¶

Pour commencer le processus de création d’une salle blanche :

Pour commencer le processus de création d’une salle blanche :

Dans la navigation de gauche, sélectionnez Clean Rooms.
Sur la page Clean Rooms , sélectionnez + Clean Room.
Nommez votre salle blanche Tutorial.

Vous permettrez à des collaborateurs d’effectuer une analyse de chevauchement d’audience dans la salle blanche.

Ajouter des données à votre salle blanche¶

Pour ajouter des données à votre salle blanche :

Dans la section Datasource, sélectionnez Snowflake.
Dans la liste déroulante Tables, sélectionnez la table SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS
Sélectionnez Next.

Note

Si une table ajoutée ici est supprimée, renommée, déplacée ou si des autorisations restrictives ont été ajoutées, la table ne sera plus utilisable dans la salle blanche, sauf si vous restaurez l’ancienne table au même emplacement et avec le même nom et les mêmes autorisations.

Spécifier une politique de jointure¶

Une politique de jointure spécifie les colonnes de vos données sur lesquelles un collaborateur peut effectuer une jointure.

Pour spécifier une politique de jointure :

Dans la liste déroulante Join Columns sélectionnez les colonnes suivantes :
- HASHED_EMAIL
- HASHED_FIRST_NAME
- HASHED_LAST_NAME
- HASHED_PHONE
Un collaborateur ne peut joindre ses données qu’avec ces colonnes.
Sélectionnez Next.

Configurer un modèle d’analyse¶

Les modèles d’analyse contrôlent la manière dont un collaborateur peut accéder aux données partagées dans une salle blanche. Les collaborateurs ne peuvent exécuter que des analyses et des requêtes conformes au modèle.

Sélectionnez et configurez un modèle d’analyse pour les collaborateurs de la salle blanche :

Sélectionnez le modèle Audience Overlap & Segmentation.

Les collaborateurs sont limités à la seule exécution des analyses que vous sélectionnez.
Dans la liste déroulante Tables, sélectionnez DEMO.CUSTOMERS.

Les collaborateurs ne peuvent analyser que les données de la table DEMO.CUSTOMERS.
Dans la liste déroulante Segmentation & Attribute Columns sélectionnez les colonnes suivantes :
- AGE_BAND
- DEVICE_TYPE
- EDUCATION_LEVEL
- STATUS
Un consommateur peut filtrer et créer des segments à l’aide de ces colonnes.
Activez Allow categorical value previews during filtering.
Sélectionnez Next.

Consommateur : Se connecter à l’UI des salles blanches¶

Dans cette section, vous passez du statut de fournisseur qui a créé et partagé la salle blanche à celui de consommateur pour installer et gérer la salle blanche.

Connectez-vous à l’UI des salles blanches. Fournissez les identifiants de connexion du compte Snowflake pour le compte qui agit en tant que consommateur.

Consommateur Installer et configurer la salle blanche¶

Dans cette section, vous effectuerez les actions suivantes :

Installer la salle blanche qui vous a été communiquée depuis le compte du fournisseur.
Ajouter des données à la salle blanche afin qu’elles puissent être jointes à celles du fournisseur.
Ajouter une politique de jointure pour définir la manière dont les données du consommateur et les données du fournisseur sont liées.
Définir les colonnes que les analystes peuvent utiliser pour créer des segments, filtrer les résultats et enrichir les données d’activation.

Lancer le processus d’installation¶

Pour commencer l’installation d’une salle blanche qui a été partagée par le compte du fournisseur :

Dans la navigation de gauche, sélectionnez Clean Rooms.
Sélectionnez l’onglet Invited.
Trouvez la vignette Tutorial et sélectionnez Join.

Ajouter les données du consommateur à la salle blanche¶

Pour ajouter des données à la salle blanche :

Dans la section Datasource, sélectionnez Snowflake.
À partir de la liste déroulante Tables, sélectionnez puis enregistrez SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2.
- Si cette table ne figure pas dans votre liste, consultez la section Conditions préalables dans l’introduction du tutoriel pour savoir comment l’installer.
Sélectionnez Next.

Note

Si une table ajoutée ici est supprimée, renommée, déplacée ou si des autorisations restrictives ont été ajoutées, la table ne sera plus utilisable dans la salle blanche, sauf si vous restaurez l’ancienne table au même emplacement et avec le même nom et les mêmes autorisations.

Définir une politique de jointure¶

Ensuite, indiquez quelles colonnes de consommateurs peuvent être jointes dans une analyse ou une requête dans cette salle blanche :

Dans le volet Specify Join Policies, de la section Join Policies, choisissez des colonnes dans vos données (étiquetées My Columns) et les colonnes équivalentes de la table du fournisseur (étiquetées Collaborator Columns).
Assurez-vous que les colonnes de la table du consommateur (My Columns) et les colonnes de la table du fournisseur (Collaborator Columns) aient des contenus analogues (les noms des colonnes ne doivent pas nécessairement correspondre).

Par exemple, la colonne HASHED_EMAIL du consommateur doit être associée à la colonne HASHED_EMAIL du fournisseur. Toutes les colonnes jointes doivent correspondre à l’analyse que vous sélectionnez.
Sélectionnez Next pour naviguer vers le volet Configure Analysis & Query.

Définir les colonnes de segmentation et d’activation¶

Lorsque vous sélectionnez les colonnes de segmentation et d’activation au cours du processus d’installation de la salle blanche, vous définissez les colonnes disponibles pour les utilisateurs qui effectuent une analyse dans la salle blanche. Les analystes peuvent créer des segments uniquement sur la base de ces colonnes. Lorsque vous renvoyez les données d’activation au fournisseur, les analystes ne peuvent pas enrichir les résultats de l’analyse avec des données qui ne proviennent pas de l’une de ces colonnes.

Pour définir les colonnes de segmentation et d’activation :

Sélectionnez et enregistrez la table DEMO.CUSTOMERS_2 de la liste déroulante Tables.
Dans la liste déroulante Segmentation & Attribute Columns, sélectionnez et enregistrez les colonnes suivantes :
- INCOME_BRACKET
- REGION_CODE
- STATUS
Sélectionnez Finish pour installer la salle blanche.

L’installation prend quelques minutes pour se terminer.
Sélectionnez Refresh toutes les quelques minutes pour vérifier les changements.

Lorsque l’étiquette de la vignette change de Processing vers un bouton Run, la salle blanche est installée et vous pouvez exécuter une analyse.

Consommateur : Exécuter une analyse¶

Dans cette étape, vous effectuez une analyse de chevauchement et de segmentation de l’audience dans la salle blanche. Vous devez d’abord sélectionner les données à utiliser dans l’analyse.

Pour configurer et exécuter une analyse :

Dans l’onglet Joined, recherchez la vignette de la salle blanche et sélectionnez Run.
Sélectionnez Audience Overlap & Segmentation » Proceed.
Dans My Tables, sélectionnez CUSTOMERS.
Dans Collaborator’s Tables, sélectionnez CUSTOMERS.
Dans Required Parameters » My Join Columns, définissez les jointures suivantes :
1. Dans la liste déroulante, sélectionnez puis enregistrez HASHED_EMAIL.
2. Sélectionnez + Join Column, puis HASHED_FIRST_NAME et HASHED_LAST_NAME.
3. Sélectionnez + Join Column, puis sélectionnez HASHED_PHONE.
Lorsque vous effectuez une analyse en salle blanche, les résultats comprennent des enregistrements où l’un des éléments suivants est vrai :
- Le HASHED_EMAIL du consommateur correspond au HASHED_EMAIL du fournisseur.
- Le HASHED_FIRST_NAME du consommateur correspond au HASHED_FIRST_NAME du fournisseur et le HASHED_LAST_NAME du consommateur correspond au HASHED_LAST_NAME du fournisseur.
- Le HASHED_PHONE du consommateur correspond au HASHED_PHONE du fournisseur.
Dans la section User Segmentation, effectuez les étapes suivantes :
1. Dans la liste déroulante My Columns sélectionnez INCOME_BRACKET.
2. Dans la liste déroulante Collaborator Columns sélectionnez AGE_BAND.
Les résultats de l’analyse sont regroupés en fonction de ces segments.
Dans la section Filters, utilisez les listes déroulantes pour définir CUSTOMERS.STATUS = GOLD.

Cela limite les résultats d’analyse aux résultats où STATUS = GOLD.
Sélectionnez Run.

Vous pouvez éventuellement sélectionner une autre taille d’entrepôt pour exécuter l’analyse en modifiant la liste déroulante Warehouse.
Sur la page Analyses & Queries, lorsque l’état de votre analyse est Completed :
1. Sélectionnez l’analyse pour voir vos résultats.
2. Faites défiler jusqu’à la section Results de la page. Vous pouvez modifier les résultats pour voir les taux de chevauchement ou sans chevauchement.
3. Pour voir les groupes de segmentation de votre analyse, sélectionnez Download et ouvrez le fichier délimité par des virgules.
Passez à l’étape suivante pour activer (envoyer) les résultats enrichis au compte Snowflake du consommateur.

Consommateur : Activer les résultats¶

Dans cette étape, vous activerez les résultats de votre analyse sur le compte Snowflake du fournisseur. Ces résultats sont enrichis par les données des tables des consommateurs et des fournisseurs.

Pour activer les résultats de l’analyse :

Dans la section Results, sélectionnez Activate.
Sélectionnez le nom du compte fournisseur que vous avez utilisé pour partager la salle blanche.
Dans le champ Segment Name, spécifiez My test segment, ou un autre nom unique pour ce jeu de résultats.
Dans la liste déroulante ID Columns sélectionnez HASHED_EMAIL.
Dans la liste déroulante Attribute Columns sélectionnez Select All.

Lorsque le fournisseur consultera les résultats de l’analyse, les enregistrements correspondants seront enrichis des données supplémentaires trouvées dans ces colonnes.

Les colonnes disponibles sont les mêmes que les colonnes de segmentation et d’activation que vous avez sélectionnées en tant que consommateur lors de l’installation de la salle blanche.
Sélectionnez Push Data.

Félicitations ! Vous avez maintenant installé et configuré une salle blanche dans un compte du consommateur, effectué une analyse et transmis les résultats au compte du fournisseur pour activation.

Fournisseur : Voir les données activées¶

Dans l’étape précédente, vous avez activé le compte Snowsight du fournisseur. Les données d’activation du fournisseur sont stockées dans la table SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY du compte Snowflake du fournisseur.

Condition préalable

La première fois qu’un consommateur active des données sur le compte d’un fournisseur, le fournisseur doit se connecter à l’UI des salles blanches pendant environ 30 minutes après que le consommateur a activé les données. Cela n’est nécessaire qu’une seule fois par salle blanche par compte de consommateur. Les activations ultérieures par le même consommateur dans la même salle blanche n’ont pas besoin d’effectuer cette étape. Pour activer les données sur le compte du fournisseur, vous devez créer un pipeline entre le compte de consommateur et le compte de fournisseur.

Après cette étape préalable, vous pouvez afficher les données activées dans votre compte fournisseur à l’aide de Snowsight ou de SQL :

Connectez-vous à Snowsight pour le compte du fournisseur. (Utilisez l”UI Snowflake, et non l’UI des salles blanches.)
Dans le menu de navigation, sélectionnez Catalog » Database Explorer.
Accédez à SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.
Sélectionnez Data Preview pour voir les données d’activation.

Connectez-vous à Snowsight pour le compte du fournisseur. Vous vous connectez au compte Snowflake et non à l’environnement de la salle blanche.
Dans le menu de navigation, sélectionnez Projects » Worksheets.
Sélectionnez + SQL Worksheet.
Dans la nouvelle feuille de calcul, collez et exécutez l’instruction suivante pour répertorier des données d’activation transmises par l’environnement de la salle blanche du consommateur. Remplacez le nom du segment que vous avez saisi lors de l’exécution de l” activation dans l’UI des salles blanches.
```
SELECT *
   FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```

Nettoyage¶

Vous pouvez supprimer la salle blanche et les données d’activation que vous avez créées pour ce tutoriel afin de nettoyer votre environnement de production.

Supprimer les données d’activation¶

Pour supprimer les données d’activation du compte Snowflake du fournisseur :

Connectez-vous à Snowsight pour le compte du fournisseur. Vous vous connectez au compte Snowflake et non à l’environnement de la salle blanche.
Dans le menu de navigation, sélectionnez Projects » Worksheets.
Sélectionnez + SQL Worksheet.
Dans la nouvelle feuille de calcul, collez et exécutez l’instruction suivante pour supprimer les données d’activation créées pour ce tutoriel. Remplacez le nom de votre segment personnalisé à l’emplacement indiqué :
```
DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```

Supprimer la salle blanche¶

La suppression d’une salle blanche dans le compte fournisseur la supprime à la fois du compte de fournisseur et du compte de consommateur.

Pour supprimer une salle blanche :

Connectez-vous à l’UI des salles blanches.
Dans la navigation de gauche, sélectionnez Clean Rooms.
Dans l’onglet Created trouvez la vignette Tutorial et sélectionnez l’icône Plus ().
Sélectionnez Delete.
Sélectionnez Proceed.

En savoir plus¶

Félicitations ! Vous avez maintenant utilisé l’UI des salles blanches pour créer et partager une salle blanche en tant que fournisseur. Vous avez également joué le rôle du consommateur qui utilise la salle blanche pour analyser des données dans un environnement préservant la confidentialité.

Vous pouvez utiliser les ressources suivantes pour en savoir plus :

Pour des informations générales, voir Vue d’ensemble des Snowflake Data Clean Rooms.
Pour plus d’informations sur l’UI des salles blanches, consultez Vue d’ensemble de l’UI des salles blanches.
Pour des informations sur l’utilisation des APIs du développeur dans le but d’utiliser un Snowflake Data Clean Room de manière programmatique, voir Guide du développeur Snowflake Data Clean Rooms.