Analyses menées par les fournisseurs¶

Vue d’ensemble¶

La configuration par défaut de la salle blanche permet uniquement au consommateur d’effectuer une analyse dans la salle blanche. Toutefois, le fournisseur peut demander l’autorisation au consommateur d’exécuter un modèle spécifique dans une salle blanche spécifique à l’aide des données du consommateur. L’analyse effectuée par le fournisseur peut être activée et exécutée en utilisant l’UI des salles blanches ou le code.

Le schéma suivant montre le flux de données et les principaux composants d’une analyse de base effectuée par un fournisseur.

1. Dans une analyse de base effectuée par le fournisseur, le consommateur et le fournisseur lient tous deux leurs données dans la salle blanche. Les données sources sont liées à la salle blanche en tant que vues privées dans le compte où résident les données.

2. Lorsque le fournisseur effectue une analyse, les données du fournisseur sont partagées avec l’application de salle blanche du compte du consommateur. L’analyse s’effectue sur le compte du consommateur.

3. Les résultats chiffrés sont temporairement enregistrés dans la DB du consommateur, dans le compte de ce dernier.

4. Les résultats chiffrés sont copiés dans le partage de résultats de l’analyse sur le compte du fournisseur (également appelé partage de gouvernance) et sont déchiffrés. Comme l’analyse s’exécute sur le compte du consommateur, celui-ci est facturé pour l’analyse.

Pour plus d’informations, voir Snowflake Data Clean Rooms : objets installés.

-- Estimate the number of credits consumed in the past 5 days.
SELECT * FROM TABLE(SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.PRA_CONSUMPTION_UDTF(-5));

Analyses effectuées par les fournisseurs dans l’UI¶

Voici comment activer l’analyse par le fournisseur dans une nouvelle salle blanche en utilisant l’UI des salles blanches :

1. Le fournisseur crée et configure une salle blanche, en utilisant l’un des:ref:modèles pris en charge <label-dcr_templates_that_support_provider_analysis>. La configuration de la salle blanche s’effectue à l’étape Share Clean Room.

2. Dans l’étape Share Clean Room de la configuration de la salle blanche, le fournisseur sélectionne Enable run analysis & query en regard de son propre compte pour lui permettre d’exécuter tous les modèles dans cette salle blanche qui prennent en charge l’analyse du fournisseur.

   • Ce paramètre ne peut pas être modifié après la création d’une salle blanche ; si vous souhaitez modifier l’autorisation d’un compte spécifique pour exécuter des requêtes dans une salle blanche publiée, vous devez supprimer la salle blanche et en créer une nouvelle.

3. Le consommateur rejoint et configure la salle blanche comme d’habitude pour tous les modèles de la salle blanche, y compris les modèles qui prennent en charge l’analyse du fournisseur. Si le consommateur ne souhaite pas permettre à un fournisseur d’exécuter un modèle spécifique, il peut omettre les détails requis pour ce modèle.

   • Lorsque le consommateur rejoint la salle blanche, il est averti avant de rejoindre que l’analyse exécutée par le fournisseur est activée pour cette salle blanche.

   • Le consommateur peut exécuter des requêtes dès qu’il rejoint la salle blanche, mais il y a un délai de 30 minutes avant que le fournisseur puisse exécuter le modèle. Ce délai de configuration ne concerne que l’étape initiale pour rejoindre la salle blanche ; si le fournisseur ajoute ultérieurement d’autres modèles exécutés par le fournisseur, le fournisseur peut les exécuter dès que le consommateur configure sa salle blanche pour ce modèle.

4. Une fois l’étape de jointure terminée, la salle blanche est disponible pour les analyses effectuées par le fournisseur et les analyses effectuées par le consommateur.

   Important :

   • Les fournisseurs doivent attendre environ 10 minutes après l’installation de la salle blanche par le consommateur avant de pouvoir effectuer une analyse. Le délai correspond à la configuration d’arrière-plan supplémentaire requise pour les analyses effectuées par le fournisseur.

   • Le consommateur est facturé pour toutes les analyses dans cette salle blanche, qu’elles soient effectuées par le fournisseur ou par le consommateur.

Analyses effectuées par les fournisseurs dans l’API¶

Voici comment activer l’analyse par le fournisseur dans une nouvelle salle blanche à l’aide de l’API des salles blanches :

1. Fournisseur

   1. Crée et configure la salle blanche, ainsi que les données et les politiques de manière standard.

   2. Ajoute des consommateurs de la manière standard.

   3. Active l’analyse effectuée par le fournisseur pour des comptes de consommateur spécifiques dans la salle blanche en appelant provider.enable_provider_run_analysis.

      Important :

      • Le fournisseur doit appeler provider.enable_provider_run_analysis après avoir ajouté des consommateurs à une salle blanche, mais avant qu’un consommateur n’installe la salle blanche. Chaque compte de consommateur doit approuver cette demande pour que ses données soient accessibles pour les analyses effectuées par le fournisseur dans cette salle blanche.

      • Toutefois, chaque fois que le fournisseur modifie le paramètre d’analyse pour une salle blanche, la salle blanche doit être réinstallée par tous les consommateurs pour que le changement prenne effet. Comme il peut être difficile de forcer tous les collaborateurs à réinstaller une salle blanche, il est plus facile pour le fournisseur de supprimer une salle blanche publiée et partagée lors de la modification des autorisations d’analyse, puis de créer une nouvelle salle blanche avec les autorisations souhaitées.

   4. Publie la salle blanche.

   5. Permet au consommateur de savoir que la salle blanche est disponible, de connaître le nom de la salle blanche et les modèles que vous souhaitez exécuter dans la salle blanche.

2. Consommateur

   1. Installe la salle blanche et les liens dans les données de la manière standard.

   2. Définit les politiques de jointure et de colonne nécessaires sur ses données.

   3. Autorisez l’analyse effectuée par le fournisseur pour des modèles spécifiques dans la salle blanche en appelant consumer.enable_templates_for_provider_run (pour plusieurs modèles) ou consumer.approve_template (pour un modèle).

      Note

      Si le fournisseur modifie un modèle après que le consommateur l’a approuvé, ce dernier doit approuver à nouveau le modèle. Jusqu’à ce que le modèle soit réapprouvé, l’ancienne version mise en cache du modèle approuvé sera exécutée par le fournisseur.

   4. (Facultatif) Un consommateur peut limiter le type d’entrepôt ou les tailles disponibles pour les analyses effectuées par le fournisseur : voir Restriction des limites de taille et de type de l’entrepôt.

   5. Indique au fournisseur qu’il a installé la salle blanche et approuvé les analyses qu’il a effectuées.

3. Fournisseur

   1. Une fois que le consommateur a installé la salle blanche, le fournisseur permet aux analyses d’accéder aux données du consommateur en activant le partage de données du consommateur au compte du fournisseur. Le processus pour cela diffère selon si le fournisseur et le consommateur se trouvent dans la même région Cloud ou s’ils se trouvent dans des régions Cloud différentes :

      • Si le fournisseur et le consommateur se trouvent dans la même région Cloud, le fournisseur appelle provider.mount_request_logs_for_all_consumers une fois. Si un nouveau compte de consommateur installe la salle blanche ultérieurement et que le fournisseur souhaite utiliser des données du consommateur dans ce modèle, il doit réexécuter cette procédure pour pouvoir accéder à ces données.

      • Si le fournisseur et le consommateur se trouvent dans des régions Cloud différentes, le fournisseur et le consommateur doivent activer exécution automatique inter-cloud. Lorsqu’un fournisseur effectue une analyse sur ces régions, la requête peut prendre un certain temps, car les données de la requête sont envoyées de la région du fournisseur à la région du consommateur et inversement.

   2. Appelle provider.view_warehouse_sizes_for_template pour voir si le consommateur a limité le type et la taille de l’entrepôt utilisé pour l’analyse. Si le consommateur dispose de tailles d’entrepôt limitées pour les analyses effectuées par le fournisseur, ce dernier doit spécifier des valeurs warehouse_type et warehouse_size autorisées dans la requête d’analyse à l’étape suivante. Si le consommateur n’a pas spécifié de limites d’entrepôt, ces champs sont facultatifs dans la requête d’analyse. Pour plus d’informations, voir Restriction des limites de taille et de type de l’entrepôt.

   3. Exécute l’analyse en appelant provider.submit_analysis_request avec le nom du modèle, les noms des tables et les arguments du modèle. Si le consommateur a spécifié des limites pour la taille ou le type d’entrepôt, le fournisseur doit également spécifier la taille et le type de l’entrepôt dans la requête d’analyse.

      • Enregistrer l’ID de la demande renvoyé par provider.submit_analysis_request ; l’ID est nécessaire pour vérifier le statut et les résultats de l’analyse.

   4. Vérifie le statut de l’analyse en appelant provider.check_analysis_status. Lorsque le statut est signalé comme COMPLETED, appeler provider.get_analysis_result pour obtenir les résultats de l’analyse.