Tutoriel : premiers pas avec l’application Web d’une Snowflake Data Clean Room

Introduction

Une Snowflake Data Clean Room est un environnement sécurisé par chiffrement qui permet à des entités de collaborer sur des données sensibles. Elle permet à une entité de partager ses données avec un collaborateur tout en préservant la confidentialité des données en contrôlant étroitement ce qui peut en être fait.

Ce tutoriel vous guide à travers le flux de base de l’utilisation de l’application Web pour travailler avec Snowflake Data Clean Room.

Ce que vous apprendrez

Dans ce tutoriel, vous apprendrez à effectuer les opérations suivantes dans l’application Web :

  • 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.

  • Installer une salle blanche, y compris la manière d’ajouter des données et de définir comment ces données sont jointes à celles du collaborateur.

  • Exécuter une analyse, y compris comment créer une nouvelle analyse en fonction de ce qui est autorisé dans la salle blanche et spécifier les paramètres pertinents pour l’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 l’entité qui partage ses données avec d’autres collaborateurs de la salle blanche. Ils créent et configurent la salle blanche afin de préserver la confidentialité des données qu’ils partagent.

Un consommateur est l’entité qui utilise la salle blanche pour interagir avec les données partagées. Le consommateur peut analyser et interroger les données au sein de la salle blanche, y compris les joindre et les enrichir avec ses propres données.

Dans ce tutoriel, vous serez à la fois le fournisseur et le consommateur de la salle blanche.

Conditions préalables

Avant de réaliser ce tutoriel, un administrateur doit mettre en place l’environnement de la salle blanche et configurer le compte Snowflake qui lui est associé. Cette opération doit être effectuée à la fois pour le compte du fournisseur et pour le compte du consommateur. Pour plus de détails sur la manière d’effectuer ces actions, voir Premiers pas avec Snowflake Data Clean Rooms.

Pour agir en tant que consommateur dans le cadre de ce tutoriel, vous devez avoir accès à un deuxième compte Snowflake associé à une deuxième salle blanche. Cela vous permet d’imiter la façon dont un consommateur installe et utilise la salle blanche. Si vous n’avez pas de deuxième compte, vous pouvez toujours utiliser ce tutoriel pour apprendre à créer, configurer et partager une salle blanche.

Si vous n’êtes pas l’administrateur qui a configuré les salles blanches, un administrateur de salle blanche doit également vous ajouter en tant qu’utilisateur pour l’application Web. Vous devez être un utilisateur administrateur dans l’environnement de la salle blanche.

Connectez-vous à l’application Web en tant que fournisseur

Dans cette section, vous vous connecterez à la salle blanche où vous créerez, configurerez et partagerez une salle blanche en tant que fournisseur.

Pour vous connecter à l’application Web en tant que fournisseur :

  1. Accédez à la page de connexion Snowflake Data Clean Rooms.

    Pour ce tutoriel, vous devez être un utilisateur ayant le rôle d’administrateur.

  2. Saisissez votre adresse e-mail et sélectionnez Continue.

  3. Entrez votre mot de passe.

  4. Si vous êtes associé à plusieurs environnements de salles blanches, sélectionnez le compte Snowflake que vous souhaitez utiliser comme compte 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 :

  1. Dans la navigation de gauche, sélectionnez Collaborators.

  2. Sélectionnez l’onglet Snowflake Partners.

  3. Sélectionnez + Snowflake Partner.

  4. Dans le champ Company Name entrez Tutorial Consumer.

  5. Dans le champ Email Address , entrez l’adresse e-mail associée à votre utilisateur de salle blanche.

  6. Dans le champ Account Locator , entrez le localisateur de compte du compte Snowflake que vous utilisez pour simuler l’expérience du consommateur.

  7. Sélectionnez le cloud et la région du compte que vous utilisez pour simuler l’expérience du consommateur.

  8. Sélectionnez Add.

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 qui sont partagées 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 le type 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 :

  1. Dans la navigation de gauche, sélectionnez Clean Rooms.

  2. Sur la page Clean Rooms , sélectionnez + Clean Room.

  3. 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 :

  1. Dans la section Datasource, sélectionnez Snowflake.

  2. Dans la liste déroulante Tables sélectionnez la table DEMO.CUSTOMERS. Cette table est située dans la base de données SAMOOHA_SAMPLE_DATABASE.

  3. Sélectionnez Next.

Spécifier une politique de jointure

Une politique de jointure contrôle les colonnes d’une table partagée sur lesquelles un collaborateur peut effectuer une jointure.

Pour spécifier une politique de jointure :

  1. 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.

  2. 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.

Pour sélectionner le modèle d’analyse disponible pour les collaborateurs dans la salle blanche et configurer le modèle :

  1. Sélectionnez le modèle Audience Overlap & Segmentation. Les collaborateurs seront limités à l’exécution d’analyses de segmentation et sur le chevauchement des audiences.

  2. Dans la liste déroulante Tables sélectionnez DEMO.CUSTOMERS. Les collaborateurs ne peuvent analyser que les données de la table DEMO.CUSTOMERS.

  3. Dans la liste déroulante Segmentation & Activation Columns sélectionnez les colonnes suivantes :

    • AGE_BAND

    • DEVICE_TYPE

    • EDUCATION_LEVEL

    • STATUS

    En tant que consommateur, vous pourrez filtrer et créer des segments à l’aide de ces colonnes.

  4. Basculez sur Allow categorical value previews during filtering.

  5. Sélectionnez Next.

Partager une salle blanche avec le consommateur

Maintenant que vous avez créé et configuré la salle blanche, vous pouvez la partager avec un collaborateur afin qu’il puisse l’utiliser pour effectuer des analyses.

Partager une salle blanche :

  1. Utilisez la liste déroulante Select Collaborator pour sélectionner Tutorial Consumer.

  2. Sélectionnez Finish.

  3. Vous devez attendre que la salle blanche soit créée avant de poursuivre ce tutoriel. Sélectionnez périodiquement Refresh jusqu’à ce que la vignette Tutorial passe de Processing à Edit.

Félicitations ! Vous avez créé et partagé une Snowflake Data Clean Room.

Ce que vous avez appris

Dans cette section, vous avez appris à installer, configurer et partager une salle blanche en tant que fournisseur.

Dans la prochaine partie de ce tutoriel, vous passerez au consommateur qui rejoint la salle blanche et l’utilise pour analyser des données.

Connectez-vous à l’application Web en tant que consommateur

Dans cette section, vous passez du statut de fournisseur qui a créé et partagé la salle blanche à celui de consommateur qui installe la salle blanche. Vous installez la salle blanche dans un compte différent pour imiter la façon dont un consommateur installerait et utiliserait la salle blanche dans son propre compte.

Pour vous connecter à l’application Web en tant que consommateur :

  1. Accédez à la page de connexion Snowflake Data Clean Rooms.

  2. Saisissez votre adresse e-mail et sélectionnez Continue.

  3. Entrez votre mot de passe.

  4. Si vous êtes associé à plusieurs environnements de salle blanche, sélectionnez le compte Snowflake que vous souhaitez utiliser comme compte consommateur.

Installer et configurer la salle blanche

Dans cette section, vous allez :

  • 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 :

  1. Dans la navigation de gauche, sélectionnez Clean Rooms.

  2. Sélectionnez l’onglet Invited.

  3. 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 :

  1. Dans la section Datasource, sélectionnez Snowflake.

  2. Dans la liste déroulante Tables sélectionnez la table DEMO.CUSTOMERS. Cette table est située dans la base de données SAMOOHA_SAMPLE_DATABASE.

  3. Sélectionnez Next.

Définir une politique de jointure

Les consommateurs utilisent une politique de jointure pour spécifier quelles colonnes sont jointes dans une analyse ou une requête, définissant ainsi la relation entre les tables du fournisseur et celles du consommateur.

Pour définir une politique de jointure :

  1. Assurez-vous que les colonnes de la table du consommateur (My Columns) et celles de la table du fournisseur (Collaborator Columns ) correspondent. Par exemple, la colonne HASHED_EMAIL du consommateur doit être associée à la colonne HASHED_EMAIL du fournisseur. Lors de la création de la salle blanche, vous avez spécifié que les collaborateurs ne peuvent se joindre qu’à ces colonnes.

  2. Sélectionnez Next.

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 des analyses dans la salle blanche. Les analystes ne peuvent créer un segment que sur la base de ces colonnes. Lorsqu’ils renvoient 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 :

  1. Dans la liste déroulante Tables sélectionnez la table DEMO.CUSTOMERS.

  2. Dans la liste déroulante Segmentation & Activation Columns sélectionnez les colonnes suivantes :

    • INCOME_BRACKET

    • REGION_CODE

    • STATUS

  3. Sélectionnez Finish.

  4. Vous devez attendre que la salle blanche soit installée avant de poursuivre ce tutoriel. Sélectionnez périodiquement Refresh jusqu’à ce que la vignette Tutorial passe de Processing à Run.

Effectuer une analyse

Dans cette section, vous effectuerez une analyse de chevauchement et de segmentation de l’audience dans la salle blanche.

Pour exécuter une analyse :

  1. Dans la navigation de gauche, sélectionnez Clean Rooms.

  2. Sélectionnez l’onglet Joined.

  3. Trouvez la vignette Tutorial et sélectionnez Run.

  4. Sélectionnez la vignette Audience Overlap & Segmentation puis Proceed..

  5. Dans My Tables, sélectionnez Customers.

  6. Dans Collaborator Table, sélectionnez Customers.

  7. Dans My Join Columns, définissez les jointures suivantes :

    1. Dans la liste déroulante, sélectionnez 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 :

    • L” HASHED_EMAIL de la table du consommateur correspond à l” HASHED_EMAIL de la table 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.

  8. Dans la section User Segmentation, procédez comme suit :

    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 seront regroupés en fonction de ces segments.

  9. Dans la section Filters , utilisez les listes déroulantes pour définir DEMO.CUSTOMERS.STATUS = GOLD. Veillez à utiliser le code couleur pour sélectionner la colonne dans le compte du consommateur (My Columns).

    Le STATUS d’un enregistrement dans la table des consommateurs doit être GOLD pour être inclus dans les résultats de l’analyse.

  10. Sélectionnez Run.

  11. Utilisez la section Results pour voir vos résultats. Vous pouvez alterner la métrique de vos résultats entre le taux de correspondance et le nombre de chevauchements.

  12. Pour voir les groupes de segmentation de votre analyse, sélectionnez Download et ouvrez le fichier délimité par des virgules.

  13. Passez à l’étape suivante du tutoriel pour renvoyer les résultats enrichis au fournisseur pour activation.

Activer les résultats

Dans cette section, vous activerez les résultats de votre analyse en les renvoyant vers le compte Snowflake du fournisseur. Ces résultats seront enrichis par les données des tables des consommateurs et des fournisseurs.

Pour activer les résultats de l’analyse :

  1. Dans la section Results sélectionnez Activate.

  2. Sélectionnez le nom du compte fournisseur que vous avez utilisé pour partager la salle blanche.

  3. Dans le champ Segment Name indiquez Provider Snowflake Account.

  4. Dans la liste déroulante ID Columns sélectionnez HASHED_EMAIL.

  5. 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.

    Vous remarquerez que les colonnes disponibles sont les mêmes que les colonnes de segmentation et d’activation que vous avez sélectionnées en tant que fournisseur lors de la configuration de la salle blanche ainsi 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.

  6. 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.

Voir les données d’activation en tant que fournisseur

Dans cette section, vous reprenez le rôle du fournisseur pour voir les résultats de l’activation du consommateur. Les données d’activation du consommateur sont stockées dans la table SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY du compte Snowflake du fournisseur.

Avant d’utiliser Snowsight pour interroger cette table, vous devez vous connecter à l’environnement de salle blanche pour créer le pipeline entre le compte du consommateur et le compte du fournisseur.

Pour se connecter à l’environnement de la salle blanche en tant que fournisseur :

  1. Accédez à la page de connexion Snowflake Data Clean Rooms.

  2. Saisissez votre adresse e-mail et sélectionnez Continue.

  3. Entrez votre mot de passe.

  4. Si vous êtes associé à plusieurs environnements de salles blanches, sélectionnez le compte Snowflake que vous avez utilisé comme compte fournisseur pour ce tutoriel.

Une fois le pipeline construit avec succès, vous pouvez voir les données d’activation à l’aide d’une requête SQL ou de l’explorateur d’objets de la base de données Snowsight :

  1. Connectez-vous à Snowsight pour le compte du fournisseur. Vous vous connectez au compte Snowflake et non à l’environnement de la salle blanche.

  2. Dans la navigation de gauche, sélectionnez Data » Database.

  3. Accédez à SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.

  4. Sélectionnez Data Preview pour voir les données d’activation.

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 :

  1. Connectez-vous à Snowsight pour le compte du fournisseur. Vous vous connectez au compte Snowflake et non à l’environnement de la salle blanche.

  2. Ouvrez Projects » Worksheets.

  3. Sélectionnez + » SQL Worksheet.

  4. 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 :

    DELETE FROM samooha_by_snowflake_local_db.public.provider_activation_summary
   WHERE segment = 'Provider Snowflake Account';
    Copy

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 :

  1. Accédez à la page de connexion Snowflake Data Clean Rooms.

  2. Saisissez votre adresse e-mail et sélectionnez Continue.

  3. Entrez votre mot de passe.

  4. Sélectionnez le compte Snowflake que vous avez utilisé comme compte fournisseur.

  5. Dans la navigation de gauche, sélectionnez Clean Rooms.

  6. Dans l’onglet Created trouvez la vignette Tutorial et sélectionnez l’icône Plus (Trois points verticaux indiquant plus d'options).

  7. Sélectionnez Delete.

  8. Sélectionnez Proceed.

En savoir plus

Félicitations ! Vous avez utilisé l’application Web 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 :

Langage: Français