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

Allgemeine Informationen zur Cloud-übergreifenden automatischen Auftragsausführung

In der standardmäßigen Clean Room-Umgebung kann ein Clean Room nur mit Konten in derselben Cloud-Region geteilt werden. Das heißt, Anbieter und Verbraucher müssen sich in der gleichen Region befinden.

Wenn Sie mit einem Teilnehmer zusammenarbeiten möchten, dessen Konto sich in einer anderen Region befindet als Ihr Konto, müssen Sie die Cloud-übergreifende automatische Ausführung für Ihre Clean Room-Umgebung und Ihren Clean Room aktivieren, wie auf dieser Seite gezeigt.

Sie können Ihre eigene Cloud-Region bestimmen, indem Sie SELECT CURRENT_REGION(); ausführen.

Bemerkung

Cloud-übergreifende automatische Ausführung wird manchmal auch als LAF bezeichnet, was für Automatische Ausführung von Datenangeboten steht.

Cloud-übergreifende automatische Ausführung aktivieren

Sie können die Cloud-übergreifende automatische Ausführung entweder über die API oder dieUI aktivieren. Beachten Sie jedoch die Einschränkungen für die regionsübergreifende Zusammenarbeit.

Voraussetzungen

Um die Cloud-übergreifende automatische Ausführung für ein Konto zu aktivieren, muss ein Organisationsadministrator diese zunächst für das Konto aktivieren, indem er SYSTEM$ENABLE_GLOBAL_DATA_SHARING_FOR_ACCOUNT aufruft. Dies gilt sowohl für Anbieter als auch für Verbraucher.

Erfahren Sie mehr über Automatische Ausführung und Verwalten von Berechtigungen für die automatische Auftragsausführung.

Die Cloud-übergreifende automatische Ausführung in der UI aktivieren

Ein Clean Rooms-Administrator aktiviert die Cloud-übergreifende automatische Ausführung auf Kontoebene für alle neuen und bestehenden Clean Rooms mit diesen Schritten:

  1. Melden Sie sich bei der Clean Rooms-UI mit Ihrem Administratorkonto an.

  2. Navigieren Sie zu Admin > Snowflake Admin.

  3. Aktivieren Sie den Umschalter Cross-Cloud Auto-Fulfillment.

  4. Anbieter oder Verbraucher müssen keine zusätzlichen Schritte ausführen, wenn sie einen Clean Room in der UI erstellen oder einem Clean Room beitreten. Wenn Sie jedoch später einen Clean Room in der API erstellen oder einem Clean Room beitreten, müssen Sie den API-Anweisungen für Anbieter und Verbraucher folgen.

Die Cloud-übergreifende automatische Ausführung in der API aktivieren

Folgen Sie diesen Anweisungen, um einen Clean Room in der API zu erstellen oder zu installieren, auch wenn Sie die Cloud-übergreifende automatische Ausführung bereits in der UI aktiviert haben.

Kontoadministratoren

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

Anbieter und Verbraucher

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. Wenn der Verbraucher Unterstützung für Kundenvorlagenanfragen, vom Anbieter durchgeführte Analysen und Anbieteraktivierung wünscht, führt er die folgenden zusätzlichen Schritte aus:

  1. Der Anbieter ruft provider.mount_request_logs_for_all_consumers auf, um die Kommunikation vom Verbraucher zum Anbieter zu ermöglichen.

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.
    -- 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. Anbieter: Nachdem der Verbraucher den Clean Room installiert hat, muss der Anbieter die Freigabe der Anfragen einbinden, wenn er anfragebasierte Aktionen zwischen dem Anbieter und dem Verbraucher ermöglichen möchte. 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.

Aktualisierungshäufigkeit für regionsübergreifende Konten

Anforderungen und Daten zwischen dem Anbieter und Verbraucher in unterschiedlichen Cloudregionen unterliegen den Einstellungen für die Replikationshäufigkeit.

Anfragen und Daten vom Anbieter zum Verbraucher

Alle Daten und Anfragen des Anbieters an den Verbraucher werden mit der Aktualisierungsrate des Kontos aktualisiert (standardmäßig alle 24 Stunden). Dazu gehören das Erstellen oder Aktualisieren eines Clean Rooms, das Ändern von Anbieterdaten, Anfragen zu Berechtigungen (z. B. vom Anbieter durchgeführte Analysen) und Genehmigungen für Anfragen (z. B. Verbrauchervorlagen).

Die Häufigkeit der Anfragen vom Anbieter an den Verbraucher wird von Ihrem Zeitplan für das Aktualisieren der Replikation des Kontos bestimmt.

Anfragen und Daten vom Verbraucher zum Anbieter

Die folgende Tabelle zeigt die Aktualisierungshäufigkeit von Daten und Anfragen vom Verbraucher an den Anbieter:

Daten

Aktualisierungsrate

Anfragen, Genehmigungen und Änderungen wie die folgenden:

  • Anfragen an den Anbieter (z. B. eine Anfrage zum Hinzufügen einer Vorlage)

  • Genehmigungen an den Anbieter (z. B. eine Genehmigung für vom Anbieter durchgeführte Analysen)

  • Änderungen an verknüpften Verbraucherdaten.

  • Clean Rooms, die nach dem 24. Juli 2025 erstellt wurden: 10 Minuten

  • Ältere Clean Rooms: 1 Stunde

Anbieter-Aktivierungsdaten:

  • Clean Rooms, die nach dem 24. Juli 2025 erstellt wurden: 10 Minuten

  • Ältere Clean Rooms: 15 Minuten

Anbieter-Clean Room-Daten, wie z. B. die folgenden:

  • Anbieter-Datensets

  • Vom Anbieter ausgeführte Anfragen

  • Clean Room-Richtlinien

  • Anbieter-Clean Room-Metadaten

Sie können die Aktualisierungshäufigkeit für Anfragen und Daten von Verbrauchern an Anbieter ändern.

Kosten im Zusammenhang mit der regionsübergreifenden Zusammenarbeit

Für Teilnehmer, die sich in einer anderen Region befinden, fallen zusätzliche Kosten an. Weitere Informationen darüber, wie diese Kosten entstehen, finden Sie unter Kosten automatische Ausführung.

Einschränkungen bei der regionsübergreifenden Zusammenarbeit

Bei der regionsübergreifenden Zusammenarbeit gibt es folgende Beschränkungen:

  • Bei Verwendung der Clean Rooms-UI müssen Teilnehmer die gleiche UI-Hosting-Region verwenden. Wenn beispielsweise die UI-Hostregion für ein Konto „Amazon Web Services: US East (N. Virginia)“ und die UI-Hostregion für ein anderes Konto „Amazon Web Services: Asia Pacific (Mumbai)“ ist, können diese Konten nicht in der UI zusammenarbeiten. Sie können jedoch unter Verwendung der API zusammenarbeiten, wenn beide Konten und der Clean Room für die Cloud-übergreifende automatische Ausführung konfiguriert sind, wie auf dieser Seite beschrieben.

  • Ein Anbieter kann im Reinraum keine differentielle Privatsphäre verwenden.

  • Mitarbeiter können keine externen Tabellen und Iceberg-Tabellen mit Reinräumen verknüpfen.

  • Ein Verbraucher kann keine Multi-Anbieter-Analyse durchführen.

  • Teilnehmer können keine Maskierungsrichtlinien oder Zeilenzugriffsrichtlinien verwenden.