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

Aktionen des Kontoadministrators¶

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 SQL-Code 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 LAF is enabled on the account.
CALL samooha_by_snowflake_local_db.library.is_laf_enabled_on_account();

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

Aktionen von Anbietern und Verbrauchern¶

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.

   Zu diesem Zeitpunkt verfügt der Verbraucher über die grundlegende Funktionalität für Clean Rooms. Führen Sie zur Unterstützung von Kundenvorlagenanfragen, vom Anbieter durchgeführten Analysen und Anbieteraktivierungen den folgenden zusätzlichen Schritt aus:

4. Der Anbieter ruft provider.mount_request_logs_for_all_consumers auf, bis die Prozedur erfolgreich ist. Dies bedeutet, dass die Kommunikation vom Verbraucher zum Anbieter aktiviert ist.

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. Anbieter: Nachdem der Verbraucher den Clean Room installiert hat, muss der Anbieter die Freigabe der Anfragen einbinden, um anfragebasierte Aktionen zwischen dem Anbieter und dem Verbraucher zu ermöglichen. Zu den anfragebasierten Aktionen gehören Anbieteranfragen zur Durchführung einer Analyse und Verbraucheranfragen zum Hinzufügen einer Vorlage zum 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.