Utilisation de Snowflake Data Clean Rooms dans l’application Web

L’application Web d’une Snowflake Data Clean Room fournit une UI intuitive qui permet aux utilisateurs professionnels de créer et d’utiliser des salles blanches sans se soucier de la complexité du code.

Cette rubrique fournit une introduction aux tâches que vous effectuez lorsque vous travaillez dans une salle blanche. Elle décrit les actions du fournisseur qui crée et partage une salle blanche ainsi que du consommateur qui utilise cette salle blanche.

Créer une salle blanche en tant que fournisseur

La page Clean Rooms de l’application Web vous permet, en tant que fournisseur, de gérer le cycle de vie d’une salle blanche, y compris la création et le partage. Créer et partager une chambre propre :

  1. Connectez-vous à votre environnement de salle blanche dans l’application Web.

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

  3. Sélectionnez + Clean Room. Le processus de création comprend 4 étapes :

    1. Utilisez l’étape Add Data pour nommer la salle blanche et sélectionner les tables partagées avec le consommateur.

    2. Utilisez l’étape Specify Join Policies pour enrichir vos données avec des données tierces et sélectionnez les colonnes sur lesquelles le consommateur peut s’associer.

    3. Utilisez l’étape Configure Analysis & Query pour définir les analyses que le consommateur peut effectuer dans la salle blanche et sélectionner les tables et les colonnes qu’il peut utiliser dans son analyse.

    4. Utilisez l’étape Share Clean Room pour inviter les consommateurs à utiliser la salle blanche pour collaborer. Vous pouvez également utiliser l’option Enable Run Analysis & Query permettant de spécifier quels collaborateurs peuvent exécuter des analyses dans la salle blanche.

Exécuter une analyse en tant que fournisseur

Un fournisseur peut configurer une salle blanche afin de pouvoir y effectuer ses propres analyses. Lors de la configuration d’une salle blanche pour exécuter des analyses de fournisseur, ce dernier peut spécifier si le consommateur peut également exécuter des analyses dans la salle blanche. Si le fournisseur précise que les consommateurs ne peuvent pas effectuer d’analyses, les consommateurs agissent uniquement en tant que fournisseurs de données dans la salle blanche.

Les fournisseurs utilisent l’option Enable Run Analysis & Query pendant l’étape de création Share Clean Room d’une salle blanche pour spécifier qui peut exécuter une analyse. Pour configurer la salle blanche afin que le fournisseur puisse exécuter une analyse, le fournisseur active cette option pour son propre compte, qui est répertorié avec les consommateurs.

Lorsque le fournisseur souhaite effectuer une analyse, il peut effectuer l’une des opérations suivantes :

  • Sélectionnez Clean Rooms à partir de la navigation de gauche, trouvez la vignette pour la salle blanche sur l’onglet Created et sélectionnez Run.

  • Sélectionnez Analyses & Queries à partir de la navigation de gauche, exécutez une analyse existante ou créez-en une nouvelle comme le ferait un consommateur.

Pour les deux méthodes de démarrage d’une analyse, le fournisseur peut sélectionner le collaborateur disposant des données qu’il souhaite inclure dans son analyse.

Important

Si un consommateur autorise un fournisseur à exécuter une analyse sur un modèle, c’est le consommateur, et non le fournisseur, qui est facturé pour les crédits consommés par l’analyse du fournisseur. Une fois que le consommateur a autorisé le fournisseur à effectuer des analyses, il doit désinstaller la salle blanche pour éviter d’encourir des frais.

Si un consommateur souhaite obtenir une estimation du nombre de crédits consommés par le fournisseur au cours d’une période donnée, il peut exécuter la requête suivante, où -5 renvoie une estimation des 5 derniers jours de consommation de calcul par le fournisseur :

SELECT * FROM table(samooha_by_snowflake_local_db_dev.public.udtf(-5));
Copy

Si vous êtes un consommateur qui souhaite suivre les analyses effectuées par le fournisseur, consultez Surveiller les analyses effectuées par les fournisseurs.

Transférer les résultats d’analyse exécutés par le fournisseur vers le compte Snowflake

Un fournisseur peut transmettre les résultats d’une analyse exécutée par un fournisseur à son compte Snowflake, où ils peuvent être utilisés pour l’activation.

Important

Le consommateur qui fournit ses données à une salle blanche configurée pour une analyse effectuée par un fournisseur doit consentir à la capacité du fournisseur à transmettre les résultats au compte Snowflake du fournisseur. Pour donner ce consentement en tant que consommateur, procédez comme suit :

  1. Commencez l’installation de la salle blanche qui est configuré pour les analyses exécutées par le fournisseur.

  2. Continuez le processus d’installation jusqu’à ce que vous arriviez à l’étape Configure Analysis & Query.

  3. Dans la section Activation Settings, sélectionnez Allow activation for clean room provider.

Pour transmettre les résultats d’une analyse effectuée par un fournisseur à votre compte Snowflake, procédez comme suit :

  1. Après avoir exécuté l’analyse du fournisseur, sélectionnez Activate dans la section Results.

  2. Sélectionnez le nom de votre compte Snowflake.

  3. Sélectionnez Push Data.

Pour plus d’informations sur l’affichage des données transmises lorsqu’elles deviennent disponibles dans le compte Snowflake, consultez Afficher les résultats de l’analyse dans le compte Snowflake du fournisseur.

Limitations des analyses menées par les fournisseurs

Lors de l’utilisation de l’application Web pour exécuter une analyse, le fournisseur présente les limitations suivantes :

  • Tous les modèles ne sont pas pris en charge. Actuellement, les modèles Audience Overlap & Segmentation et de requête SQL sont pris en charge.

  • Si les collaborateurs sont dans des clouds ou des régions différents :

    • Les consommateurs doivent activer l’exécution automatique inter-cloud sur leur compte.

    • Les résultats d’une analyse menée par un fournisseur sont renvoyés en fonction de la fréquence d’actualisation combinée entre les deux parties. Les fournisseurs et les consommateurs doivent se coordonner pour que la fréquence d’actualisation de l’application du fournisseur et de la liste du consommateur soit similaire (par exemple, les deux ont une fréquence de 15 minutes). Cela garantit que les résultats sont renvoyés rapidement.

Installer une salle blanche en tant que consommateur

La page Clean Rooms de l’application Web vous permet, en tant que consommateur, d’installer des salles blanches qui ont été partagées avec vous par un fournisseur. Pour installer une salle blanche :

  1. Connectez-vous à votre environnement de salle blanche dans l’application Web.

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

  3. Dans l’onglet Invited, trouvez la salle blanche et sélectionnez Join.

  4. Sélectionnez les tables que vous souhaitez utiliser pour collaborer avec les données du fournisseur.

  5. Utilisez le champ Join Policies pour définir la relation entre vos données et celles du fournisseur.

  6. Sélectionnez Next.

Exécuter une analyse en tant que consommateur

En tant que consommateur, vous pouvez utiliser la page Clean Rooms ou la page Analyses & Queries permettant d’exécuter des analyses dans une salle blanche installée.

Sélectionnez la page Clean Rooms pour créer et exécuter une nouvelle analyse basée sur les types d’analyses que le fournisseur a mis à disposition dans la salle blanche.

  1. Connectez-vous à votre environnement de salle blanche dans l’application Web.

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

  3. Dans l’onglet Joined, trouvez la salle blanche dans la liste et sélectionnez Run.

  4. Sélectionnez le type d’analyse, puis sélectionnez Proceed.

  5. Ajoutez des filtres à l’analyse. Il y a deux raisons pour lesquelles les valeurs de filtre peuvent ne pas être disponibles :

    • La colonne contient plus de 20 valeurs distinctes.

    • La salle blanche a été récemment installée et n’a pas terminé de traiter les valeurs d’aperçu de la colonne. Vous pouvez réexécuter l’analyse lorsque ces valeurs sont disponibles.

  6. Sélectionnez Run.

  7. En option : développez la section Save Analysis & Query pour enregistrer l’analyse en vue d’une utilisation ultérieure.

La page Analyses & Queries permet d’exécuter des analyses existantes ou de créer et d’exécuter une nouvelle analyse.

  1. Connectez-vous à votre environnement de salle blanche dans l’application Web.

  2. Dans la navigation de gauche, sélectionnez Analyses & Queries.

  3. Effectuez au choix :

    • Pour exécuter une analyse existante, utilisez les filtres pour trouver l’analyse et l’exécuter.

    • Sélectionnez + New Analysis & Query pour créer et exécuter une nouvelle analyse basée sur les types d’analyses que le fournisseur a mis à disposition dans la salle blanche.

Sélectionner un entrepôt pour une analyse

Vous pouvez sélectionner l’entrepôt que vous souhaitez utiliser pour exécuter une analyse. Augmenter la taille ou changer le type de l’entrepôt peut accélérer l’analyse.

Note

Le type de modèle détermine le type d’entrepôt que vous pouvez sélectionner pour l’analyse. Par exemple, certains modèles (comme Audience Overlap) n’autorisent que les entrepôts classiques tandis que d’autres modèles (comme Audience Lookalike Modeling) n’autorisent que les entrepôts optimisés pour le snowpark.

L’option permettant de sélectionner un autre entrepôt apparaît à côté du bouton Run sur un modèle. Cette option n’apparaît pas pour tous les modèles.

Gardez à l’esprit que l’augmentation de la taille d’un entrepôt ou l’utilisation d’un entrepôt optimisé pour Snowpark peut augmenter le coût d’exécution de l’analyse. Pour plus d’informations sur la façon dont la consommation de crédit augmente à mesure que vous utilisez un entrepôt plus grand, consultez Taille d’entrepôt et Facturation des entrepôts optimisés pour Snowpark.

Pour une description des entrepôts disponibles, voir Entrepôts virtuels.

Si vous êtes un administrateur qui souhaite créer des options d’entrepôt supplémentaires, consultez Ajouter des options d’entrepôt.

Voir les détails d’une salle blanche

Vous pouvez obtenir des détails sur une salle blanche, notamment :

  • Un onglet Collaborator Summary qui répertorie les modèles de la salle blanche ainsi que les tables et les colonnes de jointure de votre collaborateur.

  • Un onglet My Summary qui répertorie vos tables et vos colonnes de jointure.

  • Un onglet Table Relations qui répertorie la relation entre vos tables et les tables de votre collaborateur (c’est-à-dire comment les tables sont jointes).

  • Un onglet Data Stats qui fournit les métriques suivantes pour vos tables :

    • Mon tableau : indique combien d’identificateurs distincts appartiennent à un certain groupe. Notez que les statistiques sont mises à jour toutes les 24 heures, il peut donc y avoir un délai entre la modification de la salle blanche et la visualisation des statistiques mises à jour. Notez également que les colonnes contenant plus de 20 valeurs distinctes ne sont pas affichées.

    • Statistiques de chevauchement : une salle blanche avec les modèles Audience Overlap & Segmentation ou de requête SQL afficheront des statistiques de chevauchement au consommateur. Ces statistiques décrivent le nombre d’identificateurs distincts (colonnes de jointure) appartenant à un certain groupe en fonction des colonnes d’attribut activées dans le modèle. Vous pouvez sélectionner jusqu’à 2 colonnes d’attributs pour voir les répartitions des statistiques. Les données sont générées après l’installation initiale et sont actualisées chaque fois qu’un utilisateur se connecte à l’application Web de la salle blanche. Notez que dans la visualisation du graphique à barres, seules les 5 premières lignes de données sont tracées en fonction du tri par défaut fourni. Les statistiques qui prennent plus de 10 minutes à s’exécuter pour une vue détaillée particulière ne seront pas disponibles.

Pour accéder aux détails de cette salle blanche, procédez comme suit :

  1. Connectez-vous à votre environnement de salle blanche dans l’application Web.

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

  3. Cliquez sur la vignette de la salle blanche.

Les détails de la salle blanche sont également disponibles dans la section Clean Rooms Details lorsque vous exécutez une analyse.

Télécharger et partager les résultats

Un utilisateur qui souhaite partager les résultats agrégés qu’il a générés dans la salle blanche peut télécharger les résultats de l’analyse de la salle blanche sous forme de fichier .csv, puis partager ces résultats avec d’autres personnes en dehors de Snowflake, y compris le partage avec un collaborateur de la salle blanche par e-mail.

Langage: Français