Analyse exécutée par le fournisseur¶

Voici les étapes à suivre pour permettre l’exécution d’une analyse par le fournisseur dans une nouvelle clean room :

1. Le fournisseur crée et configure une clean room en utilisant l’un des modèles pris en charge.

2. Dans l’étape Share Clean Room de la configuration de la salle blanche, le fournisseur active Enable run analysis & query à côté 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 pour tous 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. La salle blanche est désormais disponible pour les analyses exécutées par le fournisseur (après le délai de la configuration initiale) et exécutées par le consommateur (sans délai).

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

Le fournisseur peut activer et désactiver à la fois l’analyse du fournisseur et celle du consommateur dans une salle blanche en effectuant les appels d’API appropriés.

Toutefois, chaque fois que le fournisseur modifie le paramètre d’analyse exécutée par le fournisseur, 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 fiable 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.

Voici le déroulement général de la création d’une nouvelle clean room permettant des analyses effectuées par le fournisseur :

1. Fournisseur

   1. Créez et configurez votre clean room, vos données et vos politiques de manière standard.

   2. Ajoutez des consommateurs de la manière habituelle.

   3. Activez l’analyse exécutée par le fournisseur pour des comptes de consommateurs spécifiques dans la salle blanche en appelant provider.enable_provider_run_analysis. Appelez cette procédure uniquement 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 séparément, ou ses données ne seront pas accessibles pour les analyses effectuées par le fournisseur dans cette salle blanche.

   4. Publier la clean room.

   5. Faites savoir à vos consommateurs que la clean room est disponible, le nom de la clean room, et les modèles que vous voulez exécuter dans la clean room.

2. Consommateur

   1. Installez la salle blanche et liez vos données de manière standard.

   2. Définissez les politiques de jointure et de colonne sur vos données. Si vous ne définissez pas les deux politiques dans une salle blanche, le fournisseur ne peut pas exécuter un modèle en utilisant vos données. Cela diffère des analyses exécutées par les consommateurs, où l’absence totale d’une politique signifie que toutes les colonnes sont approuvées pour ce type de politique.

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

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

   1. Les analyses exécutées par le fournisseur se produisent sur le compte du consommateur et sont facturées au consommateur. Si vous souhaitez limiter le type ou les tailles d’entrepôt disponibles pour un fournisseur lors de l’exécution d’un modèle, appelez consumer.set_provider_run_configuration.

   2. Informez le fournisseur que vous avez installé la clean room et approuvé les analyses effectuées par le fournisseur.

3. Fournisseur

   1. Une fois que le consommateur a installé la salle blanche, vous devez permettre à vos 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. Si un nouveau compte consommateur installe la salle blanche ultérieurement et que vous souhaitez utiliser ses données dans ce modèle, vous devez réexécuter cette procédure pour pouvoir accéder aux données.

      • Si le fournisseur et le consommateur se trouvent dans des régions Cloud différentes, le fournisseur et le consommateur doivent activer l’exécution automatique inter-cloud.

   2. Exécutez l’analyse en appelant provider.submit_analysis_request avec le nom du modèle, les noms des tables et les arguments du modèle. Vous pouvez éventuellement spécifier une taille et un type d’entrepôt, comme indiqué plus loin dans cette rubrique.

      • Enregistrez l’ID de réponse, qui est nécessaire pour vérifier l’état et les résultats de l’analyse.

   3. Vérifiez le statut de l’analyse en appelant provider.check_analysis_status. Lorsque le statut est indiqué comme étant COMPLETED, appelez provider.get_analysis_result pour obtenir les résultats de l’analyse.

Astuce

Si vous modifiez le paramètre de l’analyse du cycle du fournisseur pour votre clean room, vous devez désinstaller puis réinstaller la clean room pour que la modification prenne effet.

Spécification des limites des entrepôts et sélection du type d’entrepôt

Voici comment un consommateur définit une limite de taille et de type d’entrepôt, et comment un fournisseur choisit un entrepôt lors de l’exécution d’une analyse :

1. Le consommateur appelle consumer.set_provider_run_configuration et spécifient les tailles et les types d’entrepôt qu’un fournisseur peut utiliser pour un modèle spécifié.

   CALL samooha_by_snowflake_local_db.consumer.set_provider_run_configuration(
     $cleanroom_name,
     {
       $template1: {
         'warehouse_type': 'STANDARD',
         'warehouse_size': ['MEDIUM', 'LARGE']}
     });
   

   Copy

2. Le fournisseur appelle provider.view_warehouse_sizes_for_template pour voir quels tailles et types d’entrepôt sont autorisés pour les analyses exécutées par le fournisseur sur ce modèle.

   CALL samooha_by_snowflake_local_db.provider.view_warehouse_sizes_for_template(
     $cleanroom_name,
     $template_name,
     $consumer_account_loc
   );
   

   Copy

3. Le fournisseur spécifie la taille et le type d’entrepôt à utiliser dans sa requête d’exécution d’analyse. Un fournisseur ne peut spécifier que les tailles et les types d’entrepôt que le consommateur autorise pour ce modèle.

   CALL samooha_by_snowflake_local_db.provider.submit_analysis_request(
     $cleanroom_name,
     $consumer_locator_id,
     $template1,
     ['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS'],
     ['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS'],
     object_construct(
       'dimensions', ['c.REGION_CODE'],
       'measure_type', ['AVG'],
       'measure_column', ['c.DAYS_ACTIVE'],
       'warehouse_type', 'STANDARD',      -- Any other value would cause the request to fail.
       'warehouse_size', 'LARGE'          -- Only MEDIUM and LARGE supported.
     )
   );
   

   Copy

Installez et exécutez l’exemple de code

Vous pouvez télécharger et installer un exemple complet de clean room qui permet d’effectuer une analyse pour le compte d’un fournisseur. Pour exécuter cet exemple, vous avez besoin de deux comptes Snowflake dans la même organisation et la même région d’hébergement Cloud avec l’environnement Clean Room installé.

1. :download :Téléchargez le notebook d'exemples </samples/clean-rooms/provider-analysis-notebook.ipynb>.

2. Installez le notebook à la fois dans vos comptes de fournisseur et de consommateur.

   Pour charger un notebook, procédez comme suit :

   1. Dans le menu de navigation, sélectionnez Projects » Notebooks.

   2. Sélectionnez + Notebook » Import .ipynb file.

   3. Sélectionnez le fichier .ipynb que vous avez téléchargé.

   4. Nommez le fichier comme vous le souhaitez et choisissez une base de données et un schéma.

   5. Conservez l’entrepôt par défaut APP_WH.

   6. Sélectionnez Create.

   7. Ouvrez le carnet dans le compte fournisseur et complétez la partie fournisseur pour créer la clean room.

   8. Ouvrez le Notebooks dans le compte du consommateur et complétez la partie consommateur pour installer et configurer la clean room et exécuter le modèle.