Überblick über Snowflake Data Clean Rooms¶

Installation in einer Clean Room-Umgebung¶

Die Snowflake Data Clean Rooms-Umgebung wird einmal für ein ganzes Snowflake-Konto (nicht einmal pro Benutzer oder pro Clean Room) von Personen mit ACCOUNTADMIN-Berechtigungen auf dem Snowflake-Konto installiert.

Der Administrator konfiguriert die Umgebung, um festzulegen, welche Benutzer in dem Konto Clean Rooms erstellen und Abfragen durchführen können, welche Benutzer Zugriff auf die API haben, welche Konten zur Zusammenarbeit in einem Clean Room eingeladen werden können, welche Daten ein Ersteller eines Clean Room in den Clean Room importieren kann und welche Dienste von Drittanbietern (falls vorhanden) verwendet werden können, um Abfrageergebnisse aus einem in diesem Konto erstellten Clean Room zu exportieren.

Wenn für Ihr Konto bereits eine Clean Room-Umgebung installiert wurde, wenden Sie sich an Ihren Clean Room-Administrator, um Zugang zu erhalten. Wenn für Ihr Konto noch keine Clean Room-Umgebung installiert wurde, sollten Sie durchgehen, wie Sie die Umgebung installieren können.

Nach der Installation und Konfiguration der Umgebung erteilt der Administrator anderen Benutzern von Snowflake die Berechtigung, die Clean Room UI, API oder beide zu nutzen.

Clean Room erstellen¶

Der Snowflake-Kontoadministrator erteilt Benutzern in ihrem Snowflake-Konto die Berechtigung, Clean Rooms zu erstellen. Die Person, die einen Clean Room erstellt, wird als Anbieter für diesen Clean Room bezeichnet. Anbieter können Clean Rooms konfigurieren und für Benutzer in anderen Snowflake-Konten (oder sogar für Nicht-Snowflake-Benutzer) freigeben. Wenn ein Clean Room mit Ihnen geteilt wird, werden Sie als Verbraucher für diesen Clean Room bezeichnet.

Nach der Erstellung eines Clean Room importiert (verknüpft) der Anbieter Tabellen oder Ansichten in diesen, legt fest, welche Abfragen auf den Daten ausgeführt werden können, welche Spalten in den Daten verbunden werden können oder in den Ergebnissen erscheinen und was mit den Ergebnissen gemacht werden kann. (Sie können Variationen des Standard-Clean Room erstellen, wie später beschrieben.)

Der Anbieter lädt dann die Verbraucher ein, dem Clean Room beizutreten, ihre eigenen Tabellen und Ansichten zu importieren und eine der vom Anbieter angegebenen Abfragen auszuführen. Verbraucher müssen von einem Clean Room-Administrator vorab genehmigt werden, bevor sie in einen Clean Room eingeladen werden können.

Beitritt zu einem Clean Room¶

Nachdem Sie einen Clean Room erstellt und konfiguriert haben, sendet der Anbieter Einladungen an Benutzer in anderen Konten, um dem Clean Room beizutreten. Diese eingeladenen Benutzer werden Verbraucher oder manchmal Teilnehmer genannt. Verbraucher, die über die Clean Room UI eingeladen werden, erhalten per E-Mail eine Einladung, dem Clean Room beizutreten. Snowflake-Benutzer müssen die Clean Room-Umgebung installiert haben, um zum Beitritt zu einem Clean Room eingeladen zu werden, aber Sie können auch Nicht-Snowflake-Benutzer zum Beitritt zu einem Clean Room einladen. Ein Snowflake-Konto muss von einem Clean Room-Administrator zugelassen werden, bevor ein Ersteller eines Clean Room Benutzer in dieses Konto einladen kann.

(In der Clean Room UI werden sowohl „beitreten“ als auch „installieren“ verwendet, um zu beschreiben, wann ein Verbraucher eine Einladung zu einem Clean Room annimmt. Das liegt daran, dass ein Clean Room buchstäblich in der Clean Room-Umgebung des Verbrauchers installiert werden muss.)

Nach dem Beitritt zu einem Clean Room importiert (verknüpft) ein Verbraucher alle Daten, die für die Vorlagen in diesem Clean Room benötigt werden, gibt an, wie auf seine Daten zugegriffen werden kann, z. B. welche Spalten verknüpft oder projiziert werden können, stellt alle vorlagenspezifischen Filter oder andere Parameter bereit und führt dann die Vorlage aus. Verbraucher können eine wiederholte Ausführung der Vorlage angeben, falls gewünscht. Die Ergebnisse können im Browser angezeigt oder heruntergeladen werden. Wenn der Anbieter die Aktivierung aktiviert hat und der Verbraucher zustimmt, kann der Verbraucher die Ergebnisse an die genehmigten Speicherorte exportieren (sein eigenes Snowflake-Konto oder einen vom Anbieter bestimmten Aktivierungskonnektor eines Drittanbieters).

In einen Clean Room importierte Daten können weder vom Anbieter noch vom Verbraucher direkt abgefragt oder eingesehen werden, sondern sind nur über eine Vorlage in diesem Clean Room zugänglich. Bei einer Vorlage handelt es sich um eine SQL-Abfrage, die vom Anbieter oder Verbraucher im Clean Room installiert wurde und deren Verwendung im Clean Room von der anderen Partei genehmigt werden muss.

Jede Partei legt außerdem Zugriffsregeln für ihre eigenen Daten fest, z. B. welche Spalten verknüpft, projiziert oder exportiert werden können und welche Vorlagen im Clean Room ausgeführt werden können. Jede Partei kann ihre Daten jederzeit aus dem Clean Room löschen.

Standardmäßig kann nur ein Verbraucher Vorlagen in einem Clean Room ausführen, aber der Anbieter kann den Verbraucher auffordern, eine bestimmte Vorlage im Clean Room auszuführen.

Abfragen ausführen¶

In jedem Clean Room ist eine oder mehrere Vorlagen installiert. Eine Vorlage ist eine SQL-Abfrage, die Laufzeitparameter enthalten kann, die von der Person bereitgestellt werden, die die Vorlage ausführt. Mit diesen Parametern können Benutzer angeben, welche Tabellen im Clean Room in der Abfrage verwendet werden, welche Spalten in der Abfrage verwendet werden, welche WHERE-Klauselfilter verwendet werden und mehr. Sie können nicht einfach beliebige SQL-Abfragen in einem Clean Room ausführen, sondern müssen eine Vorlage erstellen, die eine SQL-Abfrage ergibt, und die andere Partei um die Berechtigung bitten, diese Vorlage auszuführen.

Snowflake bietet eine Reihe von Standardvorlagen zur Verwendung in der Webanwendung. Diese Vorlagen ermöglichen gängige Anwendungsfälle wie z. B. Überlappung der Zielgruppe, Zielgruppen-Lookalikes, Bestandsprognosen und beliebige SQL-Abfragen. Entwickler können auch benutzerdefinierte Vorlagen zur Verwendung in ihren Clean Rooms erstellen.

Die Vorlagen können in der Clean Room UI oder im Code ausgeführt werden. Die Ergebnisse der Vorlagen können eingesehen oder heruntergeladen werden, oder sie können an den Anbieter, den Verbraucher oder einen zugelassenen Dritten weitergegeben werden, wenn Aktivierung in diesem Clean Room erlaubt ist.

Clean Room-Variationen¶

Der gängigste Clean Room ist, wie oben beschrieben, einer, bei dem ein Anbieter Daten importiert und eine oder mehrere spezifische Abfragen angibt, die auf den Daten ausgeführt werden können, und angibt, wie die Ergebnisse gemeinsam genutzt werden können. Der Verbraucher importiert seine eigenen Daten und führt die zulässigen Abfragen auf den kombinierten Daten aus. Ein Anbieter kann jedoch mehrere Variationen des Standard-Clean Room zulassen:

• Erlauben Sie dem Anbieter, seine eigenen Abfragen auf Verbraucherdaten durchzuführen.. Standardmäßig kann nur der Verbraucher Abfragen in einem Clean Room durchführen. Wenn diese Funktion für einen Clean Room aktiviert ist, kann ein Anbieter vom Verbraucher die Berechtigung anfordern, eine bestimmte Abfrage im Clean Room durchzuführen.

• Erlauben Sie den Export der Abfrageergebnisse (aktiviert) auf das Snowflake-Konto der Person, die die Abfrage durchführt, oder auf ein von Snowflake genehmigtes Konto eines Drittanbieters, wie Meta Ads Manager oder The Trade Desk. Der Export von Daten außerhalb des Clean Room unterliegt immer der Zustimmung aller Parteien, die die abgefragten Daten freigegeben haben.

• Erlauben Sie den Parteien, benutzerdefinierten Python-Code einzubinden, der über die Abfrage, die sie ausführen, aufgerufen werden kann. Dieser Code filtert oder manipuliert die Daten in der Regel während der Ausführung der Abfrage. Er kann keine externen Aktionen wie das Speichern einer Datei, den Export von Daten oder andere Aktionen ausführen.

• Erlauben Sie der Abfrage den Zugriff auf Daten in anderen Clean Rooms, vorbehaltlich der Zustimmung der Anbieter aller Clean Rooms, auf die zugegriffen wird.

• Verketten Sie mehrere Abfragen miteinander.

Allgemeine Informationen zu Anbietern und Verbrauchern¶

Clean Room-Teilnehmer werden entweder als Anbieter oder als Verbraucher für einen bestimmten Clean Room eingestuft. Der Anbieter ist das Konto, das einen Clean Room erstellt; der Verbraucher ist das Konto, für das ein Clean Room freigegeben wird. Sie können niemanden in demselben Konto, in dem Sie einen Clean Room erstellt haben, dazu einladen, als Verbraucher für diesen Clean Room zu fungieren. Alle Benutzer desselben Snowflake-Kontos haben die gleiche Clean Room-Rolle (Anbieter oder Verbraucher) für dieselben Clean Rooms in diesem Konto.

Ob Sie Anbieter oder Verbraucher sind, hängt allein davon ab, ob Sie einen Clean Room erstellt haben oder einer für Sie freigegeben wurde, und nicht von Snowflake-Rollen oder anderen Berechtigungen.

Hier finden Sie weitere Informationen über die Anbieter- und Verbraucherrollen.

Clean Room UI¶

Snowflake Data Clean Rooms kann in einem Browser verwaltet und ausgeführt werden. Sie können die Clean Room UI verwenden, um Clean Rooms als Anbieter oder Verbraucher zu erstellen, zu verwalten und zu nutzen, oder um verschiedene Features auf Kontoebene zu konfigurieren, wie z. B. verwaltete Konten, Drittanbieter-Konnektoren und Features für UI-Benutzer.

Berechtigungen und Zugang: Um die Clean Room UI nutzen zu können, :ref:`muss Ihnen ein Clean Room-Administrator Zugriff gewähren <label-cleanrooms_get_started_add_users>.

Die Clean Room UI erfordert eine E-Mail-Adresse, einen Namen und ein Kennwort, um sich anzumelden. Die E-Mail-Adresse muss nicht mit der E-Mail-Adresse Ihres Snowflake-Kontos übereinstimmen, sondern wird vom Clean Room-Administrator festgelegt. Ihren Benutzernamen und Ihr Kennwort wählen Sie selbst.

Der Zugriff auf die Clean Room UI erfolgt über eine separate URL von Snowsight, der Snowflake-Webanwendung. Die URL ist spezifisch für jedes Konto.

Um ein Gefühl für die Verwendung der Clean Room UI zu bekommen, probieren Sie das Clean Room UI-Tutorial aus oder machen Sie sich mit der Clean Room UI vertraut.

API¶

Snowflake bietet eine Reihe von gespeicherten Prozeduren zur Erstellung oder Ausführung von Clean Rooms. Diese Prozeduren können über Snowsight-Notebooks oder -Arbeitsblätter oder jede andere Befehlszeilenschnittstelle aufgerufen werden, über die Sie gespeicherte Prozeduren in Ihrem Snowflake-Konto ausführen können.

Mit diesen Prozeduren können Sie die meisten Aktionen durchführen, die für die Erstellung, Verwaltung oder Nutzung eines Clean Room als Anbieter oder Verbraucher erforderlich sind. Die API ermöglicht keine administrativen Aktionen. Um einen Clean Room zu verwalten, müssen Sie die Webanwendung verwenden. Lesen Sie die Referenzdokumentation für die API.

Berechtigungen und Zugriff: Um die API nutzen zu können, muss Ihnen vom Clean Room-Administrator Ihres Snowflake-Kontos Zugriff auf die samooha_app_role gewährt werden.

Lesen Sie mehr über die Clean Room API oder probieren Sie das API-Tutorial aus.

Ist die Clean Room-Umgebung in Ihrem Snowflake-Konto installiert?¶

So erkennen Sie, ob die Clean Room UI oder API in Ihrem Konto installiert ist: