Tutorial: Erstellen und Betreiben eines Clean Room unter Verwendung der Clean Rooms-UI und eines einzelnen Kontos¶

Einführung¶

Dieses Tutorial führt Sie durch die grundlegenden Schritte zur Erstellung und Nutzung eines Clean Room unter Verwendung der Clean Rooms-UI. 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.

Lerninhalte¶

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

Hinzufügen eines Teilnehmers zu einer Reinraumumgebung. Für dieses Tutorial fügen Sie sich selbst als Teilnehmer hinzu.
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.

In diesem Tutorial agieren Sie sowohl als Anbieter als auch als Verbraucher im Clean Room. In einem realen Clean Room würden Anbieter und Verbraucher getrennte Konten verwenden.

Voraussetzungen¶

Sie müssen Zugriff auf eine Snowflake-Umgebung haben, in der die Snowflake Data Clean Rooms-UI installiert ist. 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.
Dieses Tutorial verwendet eine Beispieltabelle namens DEMO_CUSTOMERS_2. Durchsuchen Sie entweder Snowsight nach der Tabelle SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2 oder führen Sie folgenden SQL-Befehl in Ihrem Snowflake-Konto aus, um zu bestätigen, dass Sie diese Tabelle installiert haben:
```
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

Bemerkung

In diesem Tutorial wird für den Anbieter und für den Verbraucher im Clean Room ein einziges Konto verwendet. Diese Art von Clean Room, ein interner Test-Clean Room, dient nur zu Testzwecken und kann später nicht mehr in der Produktion verwendet oder mit anderen Konten geteilt werden. Clean Rooms für interne Tests unterstützen die meisten, aber nicht alle Clean Room-Features. Wenn Sie versuchen möchten, Clean Rooms mit zwei separaten Snowflake-Konten zu verwenden, verwenden Sie das Tutorial für zwei Konten.

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

Melden Sie sich bei der Clean Rooms-UI an. Geben Sie Ihre Snowflake-Kontoanmeldeinformationen für ein Konto an, in dem Sie als Anbieter von Clean Rooms agieren können. Ein Anbieter hat die Berechtigung, einen Clean Room zu erstellen.

Anbieter: Reinraum erstellen und freigeben¶

In diesem Abschnitt werden Sie als Anbieter die folgenden Aktionen durchführen:

Erstellen eines Reinraums.
Hinzufügen von Daten zu dem Reinraum, der mit anderen Teilnehmern zusammen genutzt wird.
Definieren einer Verknüpfungsrichtlinie, die steuert, mit welchen Spalten ein Teilnehmer die eigenen Daten verknüpfen kann.
Definieren, welche Typen von Analysen ein Teilnehmer im Clean Room ausführen darf.
Reinraum für den Verbraucher freigeben.

Erstellungsprozess starten¶

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 mit demselben Speicherort, 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.
Wählen Sie in der Dropdown-Liste Segmentation & Activation Columns die folgenden Spalten aus:
- 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.

Überwachen des Status des Clean Room¶

Es dauert ein paar Minuten, bis der Clean Room erstellt ist. Während dieser Zeit wird die Beschriftung Processing auf der Clean Room-Kachel in der Created-Registerkarte angezeigt.

So suchen Sie nach Statusänderungen:

Wählen Sie alle paar Minuten Refresh aus

Wenn sich die Kachelbeschriftung von Processing in die Edit-Schaltfläche ändert, können Sie mit den Verbraucherschritten fortfahren.

Verbraucher: Reinraum installieren und konfigurieren¶

In diesem Schritt agieren Sie nicht mehr als der Anbieter, der den Clean Room erstellt und freigibt, sondern als der Verbraucher, der den Clean Room installiert und auszuführt. Da es sich um einen Clean Room für interne Tests handelt, verwenden Sie für Anbieter und Verbraucher dasselbe Snowflake-Konto.

Als Verbraucher führen Sie folgende Schritte aus:

Installieren des Clean Room, den der Anbieter für Sie freigegeben hat.
Hinzufügen von Daten zum Clean Room, 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.

Als Verbraucher den Clean Room installieren¶

Die Installation über die UI umfasst das Verknüpfen, Konfigurieren und anschließende Installieren des Clean Room.

So konfigurieren den Clean Room:

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.

Wenn sich der Clean Room nicht in Ihrer Invited-Registerkarte befindet, wählen Sie Refresh aus. Wenn er immer noch nicht angezeigt wird, prüfen Sie, ob der Clean Room auf der Registerkarte Created eine Edit-Schaltfläche hat. Wenn es keine Schaltfläche zum Bearbeiten gibt, haben Sie den Clean Room nicht als Anbieter erstellt.

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 SAMOOHA_SAMPLE_DATABASE.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 mit demselben Speicherort, 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 die Daten 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.
Wählen Sie in der Dropdown-Liste Segmentation & Activation Columns die folgenden Spalten aus und speichern Sie diese:
- 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: die Ergebnisse an das Verbraucherkonto senden¶

In diesem Schritt aktivieren Sie die Ergebnisse Ihrer Analyse, indem Sie sie an das Snowflake-Konto des Verbrauchers übermitteln. 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 für die Analyse die Option Activate aus.
Wählen Sie im Abschnitt Activation Hub den Namen Ihres Kontos aus.

In diesem Abschnitt werden Konten und Dienste aufgelistet, für die Sie Daten aktivieren können. Die Liste kann Aktivierungskonnektoren von Drittanbietern enthalten, die Daten an Services außerhalb von Snowflake senden.
Geben Sie im Feld Segment Name My test segment oder einen anderen eindeutigen Namen für dieses Resultset ein.

Kopieren und speichern Sie den Segmentnamen, den Sie hier angeben.
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 Sie sich die Ergebnisse der Analyse ansehen, werden die übereinstimmenden Datensätze mit Daten aus Verbraucher- und Anbietertabellen 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 Clean Room in einem Verbraucherkonto installiert und konfiguriert, eine Analyse ausgeführt und die Ergebnisse zur Aktivierung an das Verbraucherkonto übermittelt.

Die aktivierten Daten anzeigen¶

Im vorherigen Schritt haben Sie Daten für das Snowsight-Konto des Verbrauchers aktiviert. So können Sie die aktivierten Daten entweder mit der Snowflake-Webanwendung oder mit Code anzeigen:

Melden Sie sich bei an Snowsight mit demselben Konto an, in dem Sie den Clean Room ausgeführt haben. Verwenden Sie die Snowflake-UI, nicht die Clean Rooms-UI.
Wählen Sie im Navigationsmenü die Option Catalog » Database Explorer aus.
Suchen Sie nach SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.
Navigieren Sie zu PUBLIC » Tables » CONSUMER_DIRECT_ACTIVATION_SUMMARY.
Wählen Sie Data Preview aus, um die Aktivierungsdaten anzuzeigen.
- Wenn Sie dort keine Daten sehen, bestätigen Sie, dass Sie dasselbe Snowflake-Konto verwenden, das Sie zur Aktivierung Ihrer Daten verwendet haben.

Melden Sie sich bei an Snowsight mit demselben Konto an, in dem Sie den Clean Room ausgeführt haben. Verwenden Sie die Snowflake-UI, nicht die Clean Rooms-UI.
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.CONSUMER_DIRECT_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```
Copy
Wenn Sie keine Daten sehen, bestätigen Sie, dass Sie dasselbe Snowflake-Konto verwenden, das Sie zur Aktivierung Ihrer Daten verwendet haben, und dass Sie den Segmentnamen verwenden, den Sie bei der Aktivierung der Ergebnisse angegeben haben.

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. Melden Sie sich bei der Snowflake-UI an, nicht bei der Clean Rooms-UI.
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 für dieses Tutorial erstellten Aktivierungsdaten zu löschen. Ersetzen Sie an der angegebenen Stelle Ihren kundenspezifischen Segmentnamen:
```
DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.CONSUMER_DIRECT_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:

Wählen Sie in der Clean Rooms-UI im linken Navigationsbereich Clean Rooms aus.
Suchen Sie auf der Created-Registerkarte die Clean Room-Kachel.
Wählen Sie » Delete » 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 Clean Room zur Analyse von Daten in einer die Privatsphäre schützenden Umgebung nutzt.

Weitere Informationen zu Snowflake Data Clean Rooms finden Sie in den folgenden Ressourcen:

Allgemeine Informationen dazu finden Sie unter Überblick über 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.