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) |
|
Microsoft Azure |
|
Google Cloud (GCP) |
|
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:
Das Konto muss die erforderliche Snowflake Edition sein:
Um Zusammenarbeiten zu erstellen und Eigentümer zu werden, benötigen Sie die Standard Edition oder höher.
Um einer Zusammenarbeit als Analysis Runner beizutreten, benötigen Sie die Standard Edition oder höher.
Um einer Zusammenarbeit als Datenanbieter beizutreten oder Daten für einen anderen Teilnehmer zu aktivieren, benötigen Sie die Enterprise Edition oder höher.
Der Installierende muss diese Rolle und die Benutzeranforderungen erfüllen.
Leserkonten werden nicht unterstützt, da Leserkonten die Datenfreigabe nicht zulassen, die für die Installation und Ausführung der Clean Room-Anwendung erforderlich ist.
Sie müssen die Bedingungen für die Datenfreigabe akzeptieren. Wenn Sie die Bedingungen für die kundengesteuerte Datenfreigabefunktion von Snowflake nicht akzeptiert haben, wenden Sie sich bitte an den Snowflake-Support. Snowflake Data Clean Rooms nutzen Freigabeangebote, die Teil des Snowflake-Service sind und Ihren Servicebedingungen mit Snowflake unterliegen, einschließlich der Snowflake-Bedingungen für kundengesteuerte Datenfreigabefunktionen und der Snowflake-Richtlinie zur akzeptablen Nutzung (Acceptable Use Policy).
Sie dürfen keine nicht unterstützten Parameter auf Kontoebene festgelegt haben. Weitere Informationen finden Sie in der Liste der nicht unterstützten Einstellungen auf Kontoebene.
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 |
|
Um einen Parameter in Ihrem Konto zu überprüfen, führen Sie folgenden SQL-Befehl aus, wobei Sie den Parameternamen durch <parameter_name> ersetzen:
Beispiel:
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:
Setzen Sie Ihre aktuelle Rolle auf ACCOUNTADMIN
Installieren Sie die Anwendung Snowflake Data Clean Rooms vom Snowflake Marketplace
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:
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.
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=TRUEund 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.
Bestätigen Sie, dass Sie auf die API zugreifen können:
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.