Überblick über Snowflake Data Clean Rooms¶

Installation in einer Clean Room-Umgebung¶

The Snowflake Data Clean Room environment is installed once for an entire Snowflake account (not once per user or per clean room) by someone with ACCOUNTADMIN privileges on the Snowflake account.

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¶

A Snowflake account administrator grants permission to users in their Snowflake account to be able to create clean rooms. The account that creates a clean room is called a provider for that clean room. Providers can configure and share clean rooms with users in other Snowflake accounts (or even non-Snowflake users). When a clean room is shared with you, you are called a consumer for that clean room.

After creating a clean room, the provider links (imports) tables or views into it, specifies what queries can be run against their data, which columns in their data can be joined or appear in the results, and what can be done with the results.

The provider then invites consumers to join the clean room, link their own tables and views, and run one of the queries specified by the provider. Consumers must be pre-approved by a clean rooms administrator before they can be invited to a clean room.

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

Daten, die in einen Clean Room importiert werden, können von keiner der beiden Parteien – weder vom Anbieter oder noch Verbraucher – direkt abgefragt oder angezeigt werden. Sie können nur über eine Vorlage im Clean Room aufgerufen werden. Eine Vorlage ist eine SQL-Abfrage, die vom Anbieter oder Verbraucher im Clean Room installiert wurde, und es muss von der anderen Partei die Erlaubnis erteilt werden, sie im Clean Room zu verwenden.

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 um die Berechtigung bitten, eine bestimmte Vorlage im Clean Room auszuführen.

Vorlagen¶

Every clean room has one or more templates installed. A template is a JinjaSQL query that typically includes run-time parameters provided by the template runner. These parameters enable users to specify column or table names or WHERE clause filters. You cannot simply run arbitrary SQL queries in a clean room (unless a provider grants that ability); most clean room usage is limited to templates submitted by the provider or consumer and approved by the other party.

Snowflake bietet einige Bestandsvorlagen für gängige Anwendungsfälle, z. B. für Vorlagen mit Zielgruppenüberschneidung sowie Vorlagen für Reichweite und Häufigkeit. Sie können auch kundenspezifische Vorlagen erstellen, die Sie in Ihrem Clean Room verwenden. Snowflake Data Clean Rooms unterstützt alle gültigen JinjaSQL-Vorlagen.

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 beiden Parteien benutzerdefinierten Python-Code einzuschließen, der von der ausgeführten Abfrage aufgerufen werden kann. Dieser Code filtert oder manipuliert normalerweise die Daten auf irgendeine Weise, während die Abfrage ausgeführt wird. Er kann keine externen Aktionen wie das Speichern einer Datei oder das Exportieren von Daten 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 collaborators are classified as either a provider or a consumer for a given clean room. A provider is the account that creates a clean room; a consumer is an account that is shared a clean room. You cannot invite someone in the same account where you created a clean room to act as a consumer for that clean room. All users in the same Snowflake account have the same clean room role (provider or consumer) for the same clean rooms in that account.

The provider and consumer roles apply at the Snowflake account level, not the individual user level. That is, if you create clean room cleanroom1 using Snowflake account ABC, then share cleanroom1 with account XYZ, all ABC users with access to cleanroom1 are providers, and all XYZ users with access to cleanroom1 are consumers.

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.

The clean rooms UI is accessed at a separate URL from Snowsight. You can find the login URL here.

Permissions and access: You must be granted access to use the clean room UI by a clean room administrator. The clean rooms UI uses your Snowflake credentials.

Try out the clean rooms UI tutorial or read more about the clean rooms UI.

API¶

Snowflake provides a number of stored procedures to create, manage, and run clean rooms. These procedures can be called through Snowsight notebooks or worksheets or any interface where you can run stored procedures in your Snowflake account. The API does not enable clean room account administration; to administer a clean room account you must use the clean rooms UI.

Permissions and access: In order to use the API you must be granted access to use the SAMOOHA_APP_ROLE by the a clean rooms administrator for your Snowflake account.

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: