Gestion de la réplication automatique dans le Cloud Snowflake Data Clean Rooms¶

Administrateurs de compte¶

Pour activer l’exécution automatique inter-Cloud pour un compte en utilisant l’API, les administrateurs des comptes de fournisseur et de consommateur doivent exécuter l’exemple de code suivant à l’aide du rôle ACCOUNTADMIN. Vous devez exécuter cette opération une seule fois par compte.

USE ROLE ACCOUNTADMIN;
-- Optionally check first to see if cross-cloud is enabled on the account.
CALL samooha_by_snowflake_local_db.library.is_laf_enabled_on_account();

-- If not, enable it.
CALL samooha_by_snowflake_local_db.library.enable_laf_on_account();

Fournisseurs et consommateurs¶

Après l’activation de l’exécution automatique inter-Cloud pour un compte, voici comment l’activer lors de la création ou de l’installation d’une salle blanche :

1. Le fournisseur publie la salle blanche de manière normale en appelant provider.create_or_update_cleanroom_listing.

2. Le consommateur installe la salle blanche en appelant consumer.install_cleanroom. Si le consommateur se trouve dans une région cloud différente de celle du fournisseur, consumer.install_cleanroom échoue avec un message indiquant que la réplication de l’exécution automatique inter-Cloud est en cours d’installation.

3. Le consommateur continue d’appeler consumer.install_cleanroom jusqu’à ce qu’il confirme la réussite de l’installation. L’installation prend plusieurs minutes.

À ce stade, le consommateur dispose des fonctionnalités de base de la salle blanche. Si le consommateur souhaite pouvoir effectuer des requêtes de modèle client, être autorisé par le fournisseur à effectuer des analyses et activer les actions entre lui-même et le fournisseur,voici la marche à suivre :

1. Le fournisseur appelle provider.mount_request_logs_for_all_consumers pour permettre la communication du consommateur au fournisseur.

Exemple de code de configuration complet :

1. Le fournisseur : le fournisseur crée, partage et publie une clean room de manière standard.

   USE WAREHOUSE APP_WH;
   USE ROLE SAMOOHA_APP_ROLE;
   
   SET cleanroom_name = 'LAF example';
   SET consumer_locator = '<CONSUMER_LOCATOR>';
   SET consumer_account_name = '<CONSUMER_DATA_SHARING_ACCOUNT_ID>';
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.cleanroom_init($cleanroom_name);
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.set_default_release_directive(
     $cleanroom_name,
     'V1_0', '0');
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.add_consumers(
     $cleanroom_name,
     $consumer_locator,
     $consumer_account_name);
   
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.create_or_update_cleanroom_listing($cleanroom_name);
   

   Copy

2. Consommateur : le consommateur installe la salle blanche.

   USE WAREHOUSE APP_WH;
   USE ROLE samooha_app_role;
   
   SET cleanroom_name = 'LAF example';
   SET provider_locator = '<PROVIDER_LOCATOR>';
   
   -- Initial call starts the process and returns a cross-cloud/region replication failure.
   -- Continue to call this procedure until it returns a success message.
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.consumer.install_cleanroom(
     $cleanroom_name,
     $provider_locator);
   
   -- Continue with standard clean room configuration and use.
   -- Consumer can run analyses, but requests to submit a template aren't
   -- supported until the provider calls ``provider.mount_request_logs_for_all_consumers``.
   ...
   

   Copy

3. Fournisseur : une fois que le consommateur a installé la salle blanche, le fournisseur doit monter le partage de requêtes s’il souhaite activer les actions basées sur les requêtes entre le fournisseur et le consommateur. Les actions basées sur les requêtes comprennent les requêtes du fournisseur pour exécuter une analyse et les requêtes du consommateur afin d’ajouter un modèle à la salle blanche.

   -- Call mount_request_logs_for_all_consumers until it reports success.
   provider.mount_request_logs_for_all_consumers($cleanroom_name);
   

   Copy

   La fonctionnalité complète fournisseur/consommateur est désormais disponible.