Cloud-übergreifende automatische Ausführung in Snowflake Data Clean Rooms verwalten¶

Account administrator actions¶

Um die Cloud-übergreifende automatische Ausführung für ein Konto über die API zu aktivieren, müssen Administratoren sowohl im Anbieter- als auch im Verbraucherkonto den folgenden Beispielcode unter Verwendung der ACCOUNTADMIN-Rolle ausführen. Sie müssen ihn nur einmal pro Konto ausführen.

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();

Provider and consumer actions¶

Nachdem die Cloud-übergreifende automatische Ausführung für ein Konto aktiviert wurde, können Sie die Cloud-übergreifende automatische Ausführung bei der Erstellung oder Installation eines Clean Rooms aktivieren:

1. Der Anbieter veröffentlicht den Clean Room wie gewohnt, indem er provider.create_or_update_cleanroom_listing aufruft.

2. Der Verbraucher installiert den Clean Room durch Aufruf von consumer.install_cleanroom. Wenn sich der Verbraucher in einer anderen Cloudregion als der Anbieter befindet, schlägt consumer.install_cleanroom mit der Meldung fehl, dass die Replikation der Cloud-übergreifenden automatischen Ausführung installiert wird.

3. Der Verbraucher ruft weiterhin consumer.install_cleanroom auf, bis der Erfolg zurückgegeben wird. Die Installation dauert einige Minuten.

   At this point, the consumer has basic clean room functionality. To support client custom template requests, provider-run analyses, and provider activation, follow this additional step:

4. The provider calls provider.mount_request_logs_for_all_consumers until the procedure reports success to enable communication from the consumer to the provider.

Codebeispiel für vollständige Einrichtung:

1. Anbieter: Der Anbieter erstellt, teilt und veröffentlicht einen Clean Room auf die übliche Weise.

   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. Verbraucher: Der Verbraucher installiert den Clean Room.

   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.
   -- The consumer can run analyses, but client custom templates, provider run, and provider analysis
   -- aren't supported until the provider takes the action shown in the next step.
   ...
   

   Copy

3. Provider: After the consumer installs the clean room, the provider must mount the requests share to enable request-based actions between the provider and consumer. Request-based actions include provider requests to run an analysis and consumer requests to add a template to the clean room.

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

   Copy

   Sämtliche Anbieter-/Verbraucher-Funktionen sind jetzt verfügbar.