Aktivieren der Legacy Snowflake Data Clean Rooms UI

Übersicht

Snowflake Data Clean Rooms können in zwei verschiedenen Umgebungen verwendet werden:

  • Die Clean Rooms-UI: Eine grafische, codelose, browserbasierte Umgebung, die das Erstellen und Ausführen von Analysen erleichtert.

  • Die Clean Rooms-API: Eine Reihe von gespeicherten Prozeduren, mit denen Clean Rooms erstellt und verwaltet und Analysen ausgeführt werden.

Diese Umgebungen bieten ähnliche, aber nicht genau gleichwertige Funktionen. Ein Administrator für Clean Rooms installiert eine oder beide Komponenten in einem Snowflake-Konto und kann dann Benutzern einzeln Zugriff auf jede Umgebung gewähren.

Anforderungen an das Aktivieren von Clean Room UI für Snowflake Data Clean Rooms

Anforderungen an Konten, Installierer und Benutzer

Nachdem Sie die Clean Room-Umgebung installiert haben, muss den Benutzern explizit von einem Clean Room-Administrator der Zugriff auf die Clean Room-Umgebung gewährt werden.

Hier sind die Anforderungen für die Aktivierung von|samooha-clean-room-plural| UI in Ihrem Snowflake-Konto:

  • Das Konto muss die Schlüsselpaar-Authentifizierung zulassen, die von dem Dienstkonto zur Authentifizierung verwendet wird.

  • Das Snowflake-Konto muss ein Capacity-Konto sein: Dies ist ein Konto, das im Voraus eine Capacity-Verpflichtung eingeht. Snowflake On-Demand-Konten können nicht auf die Clean Rooms-UI zugreifen.

  • **Sie müssen eine mehrstufige Authentifizierung (MFA) mit einer unterstützten Authentifikator-App verwenden.

Rollenanforderungen

Hier sind die Rollenanforderungen an die Person, die die Clean Rooms-UI aktiviert:

  • Sie müssen über eine ACCOUNTADMIN-Rolle in einem Snowflake-Konto verfügen und die Clean Rooms-Umgebung bereits in diesem Konto installiert haben.

  • 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.

Die Clean Rooms-UI aktivieren

Die Clean Rooms-UI bietet eine einfache No-Code-Umgebung, um Ihr Clean Rooms-Konto zu verwalten, Clean Rooms zu erstellen und Analysen auszuführen. Es bietet auch einige zusätzliche Funktionen, die in der Clean Rooms-API nicht verfügbar sind, wie z. B. geplante Abfragen, die Aktivierung durch Drittanbieter und nützliche vordefinierte Vorlagen.

Hier erfahren Sie, wie Sie die Clean Room UI in Ihrem Snowflake-Konto aktivieren:

  1. Konfigurieren Sie Ihre Netzwerkrichtlinien, um der Clean Room UI den Zugriff auf Ihr Snowflake-Konto zu ermöglichen. (Nur erforderlich, wenn Ihr Snowflake-Konto eine Netzwerkrichtlinie zur Kontrolle des Netzwerk-Datenverkehrs verwendet.)

  2. Schließen Sie die UI-Einrichtung ab. Dieser Schritt konfiguriert einen Dienstbenutzer [*], der die Clean Rooms-UI nutzt, mit Snowflake zu kommunizieren.

    1. Melden Sie sich bei der Clean Room UI mit Ihren Snowflake-Anmeldeinformationen an.

    2. Öffnen Sie Admin » Snowflake Admin » Connect to Snowflake account.

    3. Wählen Sie unter Enable the Data Clean Rooms UI die Option Quick Setup oder Manual Setup aus.

      • Quick Setup: Damit wird ein Dienstbenutzer für Sie erstellt. Geben Sie einen eindeutigen Dienstbenutzernamen für dieses Konto an.

      • Manual Setup: Wenn Sie den Dienstbenutzer selbst erstellen oder einen vorhandenen Dienstbenutzer wiederverwenden möchten, wählen Sie diese Option aus. Beachten Sie, dass Clean Rooms die Kontrolle über den Dienstbenutzer übernehmen und diesen ändern. Stellen Sie also sicher, dass der Dienstbenutzer nicht für etwas anderes verwendet wird. Erfahren Sie, wie Sie einen Dienstbenutzer erstellen.

    4. Geben Sie Ihren eindeutigen Dienstbenutzernamen ein und wählen Sie Finish aus.

  3. Zusätzlichen Benutzern Zugriff auf die UI gewähren Verwalten Sie Benutzer der Clean Room-UI, indem Sie die entsprechenden Berechtigungen zur Durchführung und Verwaltung von Clean Room-Vorgängen über die UI erteilen

Fehlerbehebung bei der Installation

Verwenden Sie diesen Abschnitt, um Probleme zu beheben, die nach Abschluss der Schritte in diesem Thema auftreten können.

Symptom: Unzureichende Berechtigungen

Lösung: Stellen Sie sicher, dass die mit der Clean Rooms-UI verknüpften IP-Adressen von Ihren Netzwerkrichtlinien zugelassen werden. Eine Auflistung dieser IP-Adressen finden Sie unter Clean RoomsUI – Hosting-Standorte und IP-Adressen.

Symptom: Die Installation ist erfolgreich, aber die Clean Rooms-UI funktioniert nicht richtig.

Lösung #1: Verwenden Sie den Befehl DESCRIBE USER, um zu überprüfen, ob der Snowflake-Benutzer, den Sie zur Konfiguration von Snowflake verwendet haben, einen gültigen Vornamen, Nachnamen und eine gültige E-Mail-Adresse hat. Wenn dem Benutzer eine dieser Angaben fehlt, führen Sie den Befehl ALTER USER aus, um sie anzugeben.

Lösung 2: Versuchen Sie, Snowflake Native App für Snowflake Data Clean Rooms zu deinstallieren, und installieren Sie sie dann erneut.

  • Um die App zu deinstallieren, siehe Deinstallation einer Snowflake Native App. Wenn Sie die Anwendung mit ihrem Standardnamen installiert haben, heißt sie SAMOOHA_BY_SNOWFLAKE.

  • Um die App neu zu installieren:

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

    2. Wählen Sie im linken Navigationsbereich Snowflake Admin.

    3. Wählen Sie Login to Snowflake aus, und authentifizieren Sie sich als Snowflake-Benutzer mit der Rolle ACCOUNTADMIN.

    4. Verwenden Sie den Befehl DESCRIBE USER, um zu bestätigen, dass der Snowflake-Benutzer mit der Rolle ACCOUNTADMIN, die Sie gerade zur Authentifizierung verwendet haben, einen gültigen Vornamen, Nachnamen und eine gültige E-Mail-Adresse hat. Wenn dem Benutzer eine dieser Angaben fehlt, führen Sie den Befehl ALTER USER aus, um sie anzugeben.

    5. Um die Snowflake Native App zu installieren, wählen Sie Install.

    6. Akzeptieren Sie den Standardnamen der Anwendung während des Installationsvorgangs.

Manuelles Erstellen eines UI-Dienstbenutzers

Bei der Installation der Clean Rooms-UI können Sie den Dienstbenutzer entweder durch die Installation für Sie erstellen lassen oder Sie können einen Dienstbenutzer angeben, den Sie erstellen. Hier erfahren Sie, wie Sie einen Dienstbenutzer in Snowsight erstellen:

Melden Sie sich mit Ihren Snowflake-Administrator-Anmeldeinformationen bei Snowsight an und erstellen Sie einen Benutzer, wie im Folgenden SQL-Beispiel:

-- Create the user.
-- Clean rooms will set the type to SERVICE for you.

USE ROLE USERADMIN;
CREATE USER <SERVICE-USER-USERNAME>;

Wichtig

Clean Rooms ändern die Authentifizierungskontrollen, Netzwerkrichtlinien und andere Attribute dieses Service-Benutzers. Sie können diesen Benutzer nicht mehr selbst verwenden, nachdem Sie ihn an die Clean Room-Umgebung übergeben haben.