Tutorial: Erstellen und betreiben eines Clean Room unter Verwendung der Clean Rooms-UI und zweier Konten¶

Einführung¶

Eine Organisation kann auf diese Weise Daten für einen Kooperationspartner freigeben ohne den Schutz der Daten zu gefährden, indem streng kontrolliert wird, wie die Daten verarbeitet werden. Dieses Tutorial führt Sie durch den grundlegenden Ablauf bei der Verwendung der Clean Rooms-UI, um mit einem Snowflake Data Clean Room mit zwei Testkonten zu arbeiten, die die volle Funktionalität von Clean Rooms ermöglichen. Wenn Sie nur auf ein einziges Snowflake-Konto mit installierten Clean Rooms Zugriff haben, können Sie es stattdessen mit dem Tutorial für einzelne Konten probieren.

Lerninhalte¶

In diesem Tutorial lernen Sie, wie Sie die Clean Rooms-UI nutzen können, indem Sie die folgenden Aufgaben ausführen:

Hinzufügen von Teilnehmern zu einer Clean Rooms-Umgebung.
Erstellen eines Reinraums, einschließlich des Hinzufügens von Daten, des Festlegens von Verknüpfungsrichtlinien, des Definierens, welchen Typ von Analyse ein Teilnehmer auf den Daten ausführen kann, und Freigeben des Reinraums für einen Teilnehmer.
Installieren eines Clean Rooms, Hinzufügen von Daten und Definieren, wie diese Daten mit den Daten des Teilnehmers verknüpft werden.
Ausführen einer Analyse.
Aktivieren der Ergebnisse der Analyse.

Allgemeine Informationen zu Teilnehmern in Reinräumen¶

Clean Room-Teilnehmer sind entweder Anbieter oder Verbraucher:

Ein Anbieter ist das Konto, das den Clean Room erstellt und konfiguriert. In einem typischen Clean Room fügt der Anbieter alle SQL-Vorlagen hinzu, die der Verbraucher im Clean Room ausführen können. Der Anbieter fügt Daten hinzu, legt Nutzungsbeschränkungen fest und lädt Verbraucher ein, die dem Clean Room beitreten können, um die Vorlagen auszuführen.
Ein Verbraucher ist das Konto, das zur Teilnahme am Clean Room eingeladen wird. Verbraucher fügen ihre eigenen Daten hinzu und führen die Vorlagen für die Clean Room-Daten aus, gemäß den vom Anbieter festgelegten Beschränkungen.

Voraussetzungen¶

Sie müssen Zugriff auf zwei Snowflake-Umgebungen mit der installierten Snowflake Data Clean Rooms-UI haben: eine zur Verwendung als Anbieter und die andere zur Verwendung als Verbraucher. Sie müssen entweder die Umgebungen selbst installieren oder die IT-Administration bieten, Ihnen Zugriff auf die Clean Rooms-UI in einem Snowflake-Konto zu gewähren.
This tutorial uses a sample table named CUSTOMERS_2. Either search Snowsight for the table SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2, or run the following SQL command in your Snowflake account to confirm that you have this table installed:
```
SHOW TABLES LIKE 'CUSTOMERS_2' IN SCHEMA SAMOOHA_SAMPLE_DATABASE.DEMO;
```
Copy
Wenn die Antwort keine Zeilen enthält, müssen Sie oder jemand mit der ACCOUNTADMIN-Rolle den folgenden Befehl ausführen, um die Beispieltabelle zu installieren:
```
USE ROLE ACCOUNTADMIN;
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;
```
Copy

Anbieter: bei der Clean Rooms-UI anmelden¶

Melden Sie sich bei dem Clean Room an, in dem Sie als Anbieter einen Clean Room erstellen, konfigurieren und freigeben werden.

Melden Sie sich bei der Clean Rooms-UI an. Geben Sie Ihre Snowflake-Anmeldeinformationen für das Konto an, das als Anbieter fungieren wird.

Anbieter: Verbraucher als Teilnehmer hinzufügen¶

In diesem Abschnitt fügen Sie das Verbraucherkonto, das Sie für dieses Tutorial verwenden, als Teilnehmer hinzu. Administratoren müssen jemanden als Teilnehmer definieren, bevor andere Benutzer einen Reinraum mit diesem Teilnehmer gemeinsam nutzen können.

So fügen Sie den Verbraucher als Teilnehmer hinzu:

Wählen Sie im linken Navigationsbereich die Option Collaborators aus.
Wählen Sie die Registerkarte Snowflake Partners aus.
Wählen Sie + Snowflake Partner aus.
Geben Sie in das Feld Company Name den Namen Tutorial Consumer ein.
Geben Sie in das Feld Email Address die E-Mail ein, die mit Ihrem Reinraum-Benutzer verbunden ist.
Geben Sie im Feld Account Locator den Konto-Locator des Snowflake-Kontos ein, das Sie als Verbraucher verwenden.
Wählen Sie die Cloud und die Region des Kontos aus, das Ihr Verbraucherkonto hostet.
Wählen Sie Add aus.

Anbieter: Reinraum erstellen und freigeben¶

In diesem Abschnitt werden Sie Folgendes tun:

Erstellen eines Reinraums.
Hinzufügen von Daten zum Clean Room, die für andere Teilnehmer freigegeben werden.
Definieren einer Verknüpfungsrichtlinie, die steuert, welche Spalten ein Teilnehmer mit den eigenen Daten verknüpfen kann.
Definieren, welche Typen von Analyse ein Teilnehmer im Clean Room ausführen darf.
Reinraum für den Verbraucher freigeben.

Erstellungsprozess starten¶

So beginnen Sie mit der Einrichtung eines Reinraums:

So beginnen Sie mit der Einrichtung eines Reinraums:

Wählen Sie im linken Navigationsbereich die Option Clean Rooms aus.
Wählen Sie auf der Seite Clean Rooms die Option + Clean Room aus.
Nennen Sie Ihren Reinraum Tutorial.

Sie werden Ihren Teilnehmern erlauben, eine Zielgruppenüberschneidungsanalyse im Clean Room durchzuführen.

Daten zu Ihrem Reinraum hinzufügen¶

So fügen Sie Daten zu Ihrem Reinraum hinzu:

Wählen Sie im Abschnitt Datasource die Option Snowflake aus.
Wählen Sie in der Dropdown-Liste Tables die Tabelle SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS aus.
Wählen Sie Next aus.

Bemerkung

Wenn eine hier hinzugefügte Tabelle gelöscht, umbenannt, verschoben oder mit restriktiven Berechtigungen hinzugefügt wird, kann die Tabelle nicht mehr im Clean Room verwendet werden, es sei denn, Sie stellen die alte Tabelle an demselben Speicherort mit demselben Namen und denselben Berechtigungen wieder her.

Verknüpfungsrichtlinie spezifizieren¶

Eine Verknüpfungsrichtlinie legt fest, welche Spalten Ihrer Daten ein Teilnehmer verknüpfen kann.

So spezifizieren Sie eine Verknüpfungsrichtlinie:

Wählen Sie in der Dropdown-Liste Join Columns die folgenden Spalten aus:
- HASHED_EMAIL
- HASHED_FIRST_NAME
- HASHED_LAST_NAME
- HASHED_PHONE
Ein Teilnehmer kann seine Daten nur über diese Spalten verknüpfen.
Wählen Sie Next aus.

Analysevorlage konfigurieren¶

Analysevorlagen steuern, wie ein Teilnehmer auf die freigegebenen Daten in einem Clean Room zugreifen kann. Teilnehmer können nur Analysen und Abfragen ausführen, die der Vorlage entsprechen.

Wählen und konfigurieren Sie eine Analysevorlage für Clean Room-Teilnehmer:

Wählen Sie die Vorlage Audience Overlap & Segmentation aus.

Teilnehmer können nur die von Ihnen ausgewählten Analysen ausführen.
Wählen Sie in der Dropdown-Liste Tables DEMO.CUSTOMERS aus.

Teilnehmer können nur die Daten in der Tabelle DEMO.CUSTOMERS analysieren.
From the Segmentation & Attribute Columns drop-down list, select the following columns:
- AGE_BAND
- DEVICE_TYPE
- EDUCATION_LEVEL
- STATUS
Ein Verbraucher kann mithilfe dieser Spalten Segmente filtern und erstellen.
Aktivieren Sie Allow categorical value previews during filtering.
Wählen Sie Next aus.

Verbraucher: bei der Clean Rooms-UI anmelden¶

In diesem Abschnitt sind Sie nicht mehr Anbieter, der den Clean Room erstellt und freigegeben hat, sondern agieren als Verbraucher, um den Clean Room zu installieren und auszuführen.

Melden Sie sich bei der Clean Rooms-UI an. Geben Sie die Anmeldeinformationen des Snowflake-Kontos für das Konto an, das als Verbraucher fungiert.

Verbraucher: Clean Room installieren und konfigurieren¶

In diesem Abschnitt führen Sie folgende Aktionen aus:

Installieren des Reinraums, der Ihnen vom Anbieterkonto zur Verfügung gestellt wurde.
Hinzufügen von Daten zum Reinraum, damit sie mit den Daten des Anbieters verknüpft werden können.
Hinzufügen einer Verknüpfungsrichtlinie, um zu definieren, wie die Verbraucherdaten und die Anbieterdaten zusammenhängen.
Definieren der Spalten, die Analysten verwenden können, um Segmente zu erstellen, Ergebnisse zu filtern und Aktivierungsdaten anzureichern.

Installationsprozess starten¶

So starten Sie die Installation eines Reinraums, der vom Anbieterkonto freigegeben wurde:

Wählen Sie im linken Navigationsbereich die Option Clean Rooms aus.
Wählen Sie die Registerkarte Invited aus.
Suchen Sie die Kachel Tutorial, und wählen Sie Join aus.

Verbraucherdaten zum Reinraum hinzufügen¶

So fügen Sie Daten zum Reinraum hinzu:

Wählen Sie im Abschnitt Datasource die Option Snowflake aus.
Wählen Sie über die Dropdown-Liste Tables DEMO.CUSTOMERS.DEMO.CUSTOMERS_2 aus und speichern Sie die Tabelle.
- Wenn diese Tabelle nicht in Ihrer Liste enthalten ist, lesen Sie den Abschnitt „Voraussetzungen“ in der Einführung des Tutorial, um zu erfahren, wie Sie sie installieren.
Wählen Sie Next aus.

Bemerkung

Wenn eine hier hinzugefügte Tabelle gelöscht, umbenannt, verschoben oder mit restriktiven Berechtigungen hinzugefügt wird, kann die Tabelle nicht mehr im Clean Room verwendet werden, es sei denn, Sie stellen die alte Tabelle an demselben Speicherort mit demselben Namen und denselben Berechtigungen wieder her.

Verknüpfungsrichtlinie definieren¶

Als Nächstes geben Sie an, welche Verbraucherspalten in diesem Clean Room in einer Analyse oder Abfrage verknüpft werden können:

Wählen Sie im Bereich Specify Join Policies im Abschnitt Join Policies Spalten aus Ihren Daten (beschriftet mit My Columns) und gleichwertige Spalten aus der Tabelle des Anbieters (beschriftet mit Collaborator Columns) aus.
Stellen Sie sicher, dass die Inhalte der Spalten aus der Tabelle des Verbrauchers (My Columns) und der Spalten aus der Tabelle des Anbieters (Collaborator Columns) übereinstimmen (die Spaltennamen müssen nicht übereinstimmen).

Zum Beispiel sollte die Spalte HASHED_EMAIL des Verbrauchers mit der Spalte HASHED_EMAIL des Anbieters verknüpft werden. Alle verknüpften Spalten müssen in der von Ihnen ausgewählten Analyse übereinstimmen.
Wählen Sie Next aus, um zum Bereich Configure Analysis & Query zu navigieren.

Segmentierungs- und Aktivierungsspalten definieren¶

Wenn Sie während der Installation des Clean Room Segmentierungs- und Aktivierungsspalten auswählen, legen Sie fest, welche Spalten für Benutzende, die Analysen im Clean Room durchführen, verfügbar sind. Analysten können Segmente nur auf der Grundlage dieser Spalten erstellen. Wenn Sie Aktivierungsdaten an den Anbieter zurücksenden, können Analysten die Ergebnisse der Analyse nur dann mit Daten anreichern, wenn diese aus einer dieser Spalten stammen.

So definieren Sie die Segmentierungs- und Aktivierungsspalten:

Wählen Sie DEMO.CUSTOMERS_2 aus der Tables-Dropdown-Liste aus und speichern Sie die Tabelle.
From the Segmentation & Attribute Columns drop-down list, select and then save the following columns:
- INCOME_BRACKET
- REGION_CODE
- STATUS
Wählen Sie Finish aus, um den Clean Room zu installieren.

Die Installation dauert ein paar Minuten.
Wählen Sie alle paar Minuten Refresh aus, um nach Änderungen zu suchen.

Wenn sich die Kachelbeschriftung von Processing in eine Run-Schaltfläche ändert, ist der Clean Room installiert und Sie können eine Analyse ausführen.

Verbraucher: Analyse ausführen¶

In diesem Schritt führen Sie im Clean Room eine Analyse zur Zielgruppenüberschneidung und -segmentierung aus. Sie müssen zunächst die Daten auswählen, die für die Analyse verwendet werden sollen.

So konfigurieren eine Analyse und führen diese aus:

Suchen Sie auf der Registerkarte Joined die Clean Room-Kachel und wählen Sie dann Run aus.
Wählen Sie Audience Overlap & Segmentation » Proceed aus.
Wählen Sie in My Tables die Option CUSTOMERS aus.
Wählen Sie in Collaborator’s Tables die Option CUSTOMERS aus.
Definieren Sie unter Required Parameters » My Join Columns die folgenden Verknüpfungen:
1. Wählen Sie über die Dropdown-Liste HASHED_EMAIL aus und speichern Sie dann die Tabelle.
2. Wählen Sie + Join Column aus, und wählen Sie dann HASHED_FIRST_NAME und HASHED_LAST_NAME aus.
3. Wählen Sie + Join Column und dann HASHED_PHONE aus.
Wenn Sie eine Analyse im Clean Room ausführen, enthalten die Ergebnisse Datensätze, auf die einer der folgenden Punkte zutrifft:
- HASHED_EMAIL des Verbrauchers stimmt mit HASHED_EMAIL des Anbieters überein.
- HASHED_FIRST_NAME des Verbrauchers stimmt mit HASHED_FIRST_NAME des Anbieters überein und HASHED_LAST_NAME des Verbrauchers stimmt mit HASHED_LAST_NAME des Anbieters überein.
- HASHED_PHONE des Verbrauchers stimmt mit HASHED_PHONE des Anbieters überein.
Führen Sie im Abschnitt User Segmentation die folgenden Schritte aus:
1. Wählen Sie in der Dropdownliste My Columns die Option INCOME_BRACKET aus.
2. Wählen Sie in der Dropdownliste Collaborator Columns die Option AGE_BAND aus.
Die Ergebnisse der Analyse werden in diese Segmente gruppiert.
Verwenden Sie im Abschnitt Filters die Dropdown-Listen, um CUSTOMERS.STATUS = GOLD anzugeben.

Dies beschränkt die Analyseergebnisse auf Ergebnisse mit STATUS = GOLD.
Wählen Sie Run aus.

Sie können optional eine andere Warehouse-Größe für die Ausführung der Analyse wählen, indem Sie die Dropdown-Auswahl Warehouse ändern.
Führen Sie auf der Seite Analyses & Queries folgenden Schritt aus, wenn der Status Ihrer Analyse Completed lautet:
1. Wählen Sie die Analyse aus, um Ihre Ergebnisse zu sehen.
2. Scrollen Sie zum Abschnitt Results der Seite. Sie können die Ergebnisse umschalten, um entweder die Überschneidungs- oder die Nicht-Überschneidungsraten zu sehen.
3. Um die Segmentierungsgruppen Ihrer Analyse anzuzeigen, wählen Sie Download aus und öffnen Sie dann die kommagetrennte Datei.
Fahren Sie mit dem nächsten Schritt fort, um die angereicherten Ergebnisse zu aktivieren (an das Snowflake-Konto des Verbrauchers zu senden).

Verbraucher: Ergebnisse aktivieren¶

In diesem Schritt aktivieren Sie die Ergebnisse Ihrer Analyse im Snowflake-Konto des Anbieters. Diese Ergebnisse werden mit Daten aus den Tabellen des Verbrauchers und Anbieters angereichert.

So aktivieren Sie die Ergebnisse der Analyse:

Wählen Sie im Abschnitt Results die Option Activate aus.
Wählen Sie den Namen des Anbieterkontos aus, das Sie für die Freigabe des Reinraums verwendet haben.
Geben Sie im Segment Name My test segment oder einen anderen eindeutigen Namen für dieses Resultset an.
Wählen Sie in der Dropdownliste ID Columns die Option HASHED_EMAIL aus.
Wählen Sie in der Dropdownliste Attribute Columns die Option Select All aus.

Wenn der Anbieter sich die Ergebnisse der Analyse ansieht, werden die übereinstimmenden Datensätze mit den in diesen Spalten gefundenen zusätzlichen Daten angereichert.

Die verfügbaren Spalten sind die gleichen wie die Segmentierungs- und Aktivierungsspalten, die Sie als Verbraucher bei der Installation des Clean Room ausgewählt haben.
Wählen Sie Push Data aus.

Herzlichen Glückwunsch! Sie haben nun einen Reinraum in einem Verbraucherkonto installiert und konfiguriert, eine Analyse ausgeführt und die Ergebnisse zur Aktivierung an das Anbieterkonto zurückgeschickt.

Anbieter: die aktivierten Daten anzeigen¶

In the previous step you activated to the provider’s Snowsight account. Provider activation data is stored in the SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY table of the provider’s Snowflake account.

Voraussetzung

Wenn ein Verbraucher zum ersten Mal Daten für das Konto eines Anbieters aktiviert, muss sich der Anbieter bei der Clean Rooms-UI für etwa 30 Minuten anmelden, nachdem der Verbraucher die Daten aktiviert hat. Dies ist nur einmal pro Clean Room pro Verbraucherkonto erforderlich. Bei späteren Aktivierungen durch denselben Verbraucher im selben Clean Room ist dieser Schritt nicht erforderlich. Um Daten für das Konto des Anbieters zu aktivieren, müssen Sie eine Pipeline zwischen dem Verbraucherkonto und dem Konto des Anbieter erstellen.

Nachdem Sie diesen Schritt durchgeführt haben, können Sie die aktivierten Daten entweder mit Snowsight oder mit SQL in Ihrem Anbieterkonto anzeigen:

Melden Sie sich bei Snowsight für das Anbieterkonto an. (Verwenden Sie die Snowflake-UI, nicht die Clean Room-UI-Umgebung.)
Wählen Sie im Navigationsmenü die Option Catalog » Database Explorer aus.
Navigieren Sie zu SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.
Wählen Sie Data Preview aus, um die Aktivierungsdaten anzuzeigen.

Melden Sie sich bei Snowsight für das Anbieterkonto an. Sie melden sich beim Snowflake-Konto an, nicht bei der Reinraumumgebung.
Wählen Sie im Navigationsmenü die Option Projects » Worksheets aus.
Wählen Sie + SQL Worksheet aus.
Fügen Sie in das neue Arbeitsblatt die folgende Anweisung ein und führen Sie sie aus, um die Aktivierungsdaten aufzulisten, die aus der Clean Room-Umgebung des Verbrauchers übertragen wurden. Ersetzen Sie den Segmentnamen, den Sie eingegeben haben, als Sie die Aktivierung in der Clean Rooms-UI ausgeführt haben.
```
SELECT *
   FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```
Copy

Bereinigen¶

Sie können die Reinraum- und Aktivierungsdaten löschen, die Sie für dieses Tutorial erstellt haben, um Ihre Produktionsumgebung zu bereinigen.

Aktivierungsdaten löschen¶

So löschen Sie die Aktivierungsdaten aus dem Snowflake-Konto des Anbieters:

Melden Sie sich bei Snowsight für das Anbieterkonto an. Sie melden sich beim Snowflake-Konto an, nicht bei der Reinraumumgebung.
Wählen Sie im Navigationsmenü die Option Projects » Worksheets aus.
Wählen Sie + SQL Worksheet aus.
Fügen Sie in das neue Arbeitsblatt folgende Anweisung ein und führen Sie sie aus, um die für dieses Tutorial erstellten Aktivierungsdaten zu löschen. Ersetzen Sie Ihren kundenspezifischen Segmentnamen an der angegebenen Stelle:
```
DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```
Copy

Reinraum löschen¶

Wenn Sie einen Reinraum im Anbieterkonto löschen, wird er sowohl aus dem Anbieterkonto als auch aus dem Verbraucherkonto entfernt.

So löschen Sie einen Reinraum:

Melden Sie sich bei der Clean Rooms-UI an.
Wählen Sie im linken Navigationsbereich die Option Clean Rooms aus.
Suchen Sie die Kachel Tutorial auf der Registerkarte Created und wählen Sie das Mehr-Symbol () aus.
Wählen Sie Delete aus.
Wählen Sie Proceed aus.

Mehr erfahren¶

Herzlichen Glückwunsch! Sie haben nun die Clean Rooms-UI verwendet, um einen Clean Room als Anbieter zu erstellen und freizugeben. Sie haben auch die Rolle des Verbrauchers angenommen, der den Reinraum zur Analyse von Daten in einer die Privatsphäre schützenden Umgebung nutzt.

Sie können die folgenden Quellen nutzen, um noch mehr zu erfahren:

Allgemeine Informationen dazu finden Sie unter Allgemeine Informationen zu Snowflake Data Clean Rooms.
Weitere Informationen zur Clean Rooms-UI finden Sie unter, siehe Überblick – Clean Rooms-UI.
Informationen darüber, wie Sie mit den Entwickler-APIs einen Snowflake Data Clean Room programmgesteuert nutzen können, finden Sie unter Snowflake Data Clean Rooms-Entwicklerhandbuch.