Snowflake Data Clean Rooms-Umgebung installieren

Bevor Sie beginnen

  • Wenn die Snowflake Data Clean Room-Umgebung nicht für Ihr Konto installiert ist, folgen Sie den Installationsanweisungen auf dieser Seite.

  • Wenn die Clean Room-Umgebung für Ihr Konto installiert ist und Sie Zugriff darauf wünschen, bitten Sie einen Administrator, Ihnen die entsprechenden Berechtigungen zu erteilen, damit Sie Clean Room-Vorgänge in Ihrem Konto durchführen können.

Unterstützte Regionen

Snowflake Data Clean Rooms sind für Snowflake-Konten in den folgenden Cloudregionen verfügbar:

Cloudplattform

Unterstützte Regionen

Amazon Web Services (AWS)

  • South America (Sao Paulo)

  • US East (N. Virginia)

  • US East (Ohio)

  • US West (Oregon)

  • Canada (Central)

  • Europe (London)

  • EU (Irland)

  • EU (Frankfurt)

  • EU (Paris)

  • EU (Stockholm)

  • EU (Zürich)

  • Afrika (Kapstadt)

  • Asia Pacific (Mumbai)

  • Asia Pacific (Singapur)

  • Asia Pacific (Tokio)

  • Asia Pacific (Osaka)

  • Asia Pacific (Seoul)

  • Asia Pacific (Jakarta)

  • Asia Pacific (Sydney)

Microsoft Azure

  • Central US (Iowa)

  • East US 2 (Virginia)

  • Mexico Central (Querétaro)

  • South Central US (Texas)

  • West US 2 (Washington)

  • Canada Central (Toronto)

  • North Europe (Irland)

  • Sweden Central (Gävle)

  • Switzerland North (Zürich)

  • UAE North (Dubai)

  • UK South (London)

  • West Europe (Niederlande)

  • Central India (Pune)

  • Southeast Asia (Singapur)

  • Japan East (Tokio)

  • Korea Central (Seoul)

  • Australia East (New South Wales)

Google Cloud (GCP)

  • US Central1 (Iowa)

  • US East4 (N. Virginia)

  • Naher Osten Zentral 2 (Dammam)

  • Europa West (Frankfurt)

  • Europe West2 (London)

  • Europe West4 (Niederlande)

Anforderungen für die Installation von Snowflake Data Clean Rooms

Anforderungen an Konten, Installierer und Benutzer

Bei der Installation der Clean Rooms-Umgebung installieren Sie diese für alle potenziellen Benutzenden im Snowflake-Konto. Der Zugriff auf die Clean Rooms-Umgebung muss den Benutzenden jedoch explizit von einer Person mit Administratorrechten für Clean Rooms gewährt werden.

Hier sind die Voraussetzungen für die Installation von Snowflake Data Clean Rooms in Ihrem Snowflake-Konto:

Wenn Sie nicht alle diese Anforderungen erfüllen und ein Upgrade benötigen, wenden Sie sich an Snowflake Support.

Nicht unterstützte Parameter auf Kontoebene

Snowflake Data Clean Rooms unterstützt bestimmte Parameterwerte auf Kontoebene nicht. Die folgende Tabelle zeigt die erforderlichen Werte für diese Parameter:

Parametername

Erforderlicher Wert

Anmerkungen

DEFAULT_DDL_COLLATION

Keine Werte unterstützt, muss null sein

Sortierung auf Kontoebene wird nicht unterstützt.

QUOTED_IDENTIFIERS_IGNORE_CASE

false

Um einen Parameter in Ihrem Konto zu überprüfen, führen Sie folgenden SQL-Befehl aus, wobei Sie den Parameternamen durch <parameter_name> ersetzen:

SHOW PARAMETERS LIKE '<parameter_name>' IN ACCOUNT;

Beispiel:

SHOW PARAMETERS LIKE 'DEFAULT_DDL_COLLATION' IN ACCOUNT;

Anforderungen an Rolle und Benutzer

Hier sind die Rollenanforderungen an die Person, die die Clean Rooms-Umgebung installiert:

  • Sie benötigen eine ACCOUNTADMIN-Rolle in einem Snowflake-Konto, um die Clean Rooms-Umgebung in diesem Konto zu installieren.

  • Der Benutzer mit der Rolle ACCOUNTADMIN muss gültige Werte für Vorname, Nachname und E-Mail-Adresse für sein Benutzerobjekt definiert haben. Um dies zu überprüfen, führen Sie DESCRIBE USER aus.

Installieren der Snowflake Data Clean Rooms-Umgebung

Gehen Sie folgendermaßen vor, um eine Clean Rooms-Umgebung in Ihrem Snowflake-Konto zu installieren.

Sie müssen immer die native App installieren (Schritt 1), aber danach können Sie die Clean Rooms API zur Verwendung von Code (Schritt 2) aktivieren.

1. Native Anwendung installieren

Installieren Sie die native Anwendung vom Marketplace:

  1. Setzen Sie Ihre aktuelle Rolle auf ACCOUNTADMIN

  2. Installieren Sie die Anwendung Snowflake Data Clean Rooms vom Snowflake Marketplace

  3. Wählen Sie Open aus und akzeptieren die Standardoptionen.

Die Installation dauert einige Minuten. Wenn Sie fertig sind, fahren Sie mit Schritt 2 fort.

2. Die Clean Rooms-API installieren

Die Clean Rooms-API ist erforderlich, um Clean Rooms entweder über die UI oder die API zu nutzen.

Hier sind die Schritte zur Installation der Clean Rooms-API in Ihrem Snowflake-Konto:

  1. Nachdem Sie die native Anwendung installiert haben, starten Sie sie in Snowflake. Wählen Sie im Navigationsmenü die Option Catalog » Apps » Snowflake Data Clean Rooms aus. Klicken Sie auf die Open in Worksheet-Schaltfläche oben rechts. Dies öffnet ein Arbeitsblatt mit SQL-Befehlen.

  2. Führen Sie die SQL-Befehle aus, um die Clean Rooms-APImit den folgenden Hinweisen installieren:

    • Wenn Sie die native Anwendung während der Installation umbenannt haben, müssen Sie das Skript wie in den Skriptkommentaren angegeben ändern.

    • Wenn Sie sich das komplette Installationsskript ansehen möchten, bevor Sie es ausführen, entfernen Sie die Kommentare in der Skriptzeile DRY_RUN=TRUE und führen Sie alle Befehle bis einschließlich dieser Zeile aus, um den Inhalt des Skripts anzuzeigen. Beachten Sie, dass Sie das Installationsskript, das durch diesen Befehl offengelegt wird, nicht manuell ausführen sollten, da dies zu einer unvollständigen Installation führen könnte.

    • Beachten Sie, dass die Installation einige Minuten dauert.

  3. Bestätigen Sie, dass Sie auf die API zugreifen können:

    USE ROLE SAMOOHA_APP_ROLE;
    USE WAREHOUSE app_wh;
    CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.CHECK_MOUNT_STATUS();
    

    Wenn FALSE zurückgegeben wird, bestätigen Sie, dass Sie SAMOOHA_APP_ROLE verwenden. Wenn dies der Fall ist, versuchen Sie erneut, den Befehl zum Einbinden des Skripts über die ACCOUNTADMIN-Rolle auszuführen.

Nächste Schritte

Nachdem Sie die Clean Room-Umgebung erfolgreich in Ihrem Konto installiert haben, können Sie mit Folgendem fortfahren:

  • Entwickler hinzufügen. Gewähren Sie Zugriff auf Rollen in Ihrem Snowflake-Konto, damit sie basierend auf bestimmten Berechtigungen auf die Clean Room-Umgebung zugreifen können.

  • Cloud-übergreifende automatische Ausführung aktivieren. Standardmäßig können Clean Rooms nur für Teilnehmer in derselben zugrunde liegenden Cloudregion freigegeben werden. Um die Zusammenarbeit mit Teilnehmern in verschiedenen Cloudregionen zu ermöglichen, müssen Sie Cross-Cloud Auto-Fulfillment für Ihr Konto aktivieren.

  • Aktivieren Sie die automatische Aktualisierung der Clean Room-Version. Aktivieren Sie, dass die Clean Rooms-API-Umgebung immer automatisch aktualisiert wird, sobald Snowflake eine neue Version veröffentlicht. Sie können Updates auch manuell installieren, aber wir empfehlen, automatische Updates zu aktivieren.