Tutorial: Erste Schritte mit der Web-App eines Snowflake Data Clean Room

Einführung

Ein Snowflake Data Clean Room ist eine kryptographisch sichere Umgebung, die eine Zusammenarbeit unter Einbeziehung sensibler Daten ermöglicht. 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 Workflow bei der Verwendung der Web-App für die Nutzung eines Snowflake Data Clean Room.

Lerninhalte

In diesem Tutorial erfahren Sie, wie Sie in der Web-App Folgendes tun können:

  • Hinzufügen eines Teilnehmers zu einer Reinraumumgebung.

  • 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 Reinraums, einschließlich des Hinzufügens von Daten und der Definition, wie diese Daten mit den Daten des Partners verknüpft werden.

  • Ausführen einer Analyse, einschließlich Erstellen einer neuen Analyse auf der Grundlage dessen, was im Reinraum zulässig ist, und Spezifizieren der relevanten Parameter für die Analyse.

  • Aktivieren der Ergebnisse der Analyse.

Allgemeine Informationen zu Teilnehmern in Reinräumen

Reinraum-Teilnehmer sind entweder Anbieter oder Verbraucher.

Ein Anbieter ist die Entität, die ihre Daten für anderen Reinraum-Teilnehmern freigibt. Sie erstellt und konfiguriert den Reinraum, um den Schutz der von ihr freigegebenen Daten sicherzustellen.

Ein Verbraucher ist die Entität, die den Reinraum nutzt, um mit den freigegebenen Daten zu interagieren. Der Verbraucher kann die Daten im Reinraum analysieren und abfragen, einschließlich deren Verknüpfung und Anreicherung mit eigenen Daten.

In diesem Tutorial agieren Sie sowohl als Anbieter als auch als Verbraucher des Reinraums.

Voraussetzungen

Bevor Sie dieses Tutorial ausführen können, muss ein Administrator die Reinraumumgebung einrichten und das damit verbundene Snowflake-Konto konfigurieren. Dies muss sowohl für das Konto des Anbieters als auch für das Konto des Verbrauchers erfolgen. Weitere Informationen zum Ausführen dieser Aktionen finden Sie unter Erste Schritte mit Snowflake Data Clean Rooms.

Um für die Zwecke dieses Tutorials als Verbraucher zu agieren, müssen Sie Zugriff auf ein zweites Snowflake-Konto haben, das mit einem zweiten Reinraum verbunden ist. Auf diese Weise können Sie nachahmen, wie ein Verbraucher den Reinraum installiert und nutzt. Wenn Sie kein zweites Konto haben, können Sie diese Tutorial trotzdem verwenden, um zu lernen, wie Sie einen Reinraum erstellen, konfigurieren und freigeben.

Wenn Sie nicht der Administrator sind, der die Reinräume einrichtet, muss ein Reinraum-Administrator auch Sie als Benutzer hinzufügen, damit Sie die Web-App verwenden können. Sie müssen ein Admin-Benutzer in der Reinraumumgebung sein.

Bei Web-App als Anbieter anmelden

In diesem Abschnitt melden Sie sich bei dem Reinraum an, in dem Sie als Anbieter einen Reinraum erstellen, konfigurieren und freigeben werden.

So melden Sie sich als Anbieter bei der Web-App an:

  1. Navigieren Sie zu der Anmeldeseite von Snowflake Data Clean Rooms.

    Für dieses Tutorial müssen Sie ein Benutzer mit der Admin-Rolle sein.

  2. Geben Sie Ihre E-Mail-Adresse ein, und wählen Sie Continue aus.

  3. Geben Sie Ihr Kennwort ein.

  4. Wenn Sie mit mehreren Reinraumumgebungen verbunden sind, wählen Sie das Snowflake-Konto aus, das Sie als Anbieterkonto verwenden möchten.

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:

  1. Wählen Sie im linken Navigationsbereich die Option Collaborators aus.

  2. Wählen Sie die Registerkarte Snowflake Partners aus.

  3. Wählen Sie + Snowflake Partner aus.

  4. Geben Sie in das Feld Company Name den Namen Tutorial Consumer ein.

  5. Geben Sie in das Feld Email Address die E-Mail ein, die mit Ihrem Reinraum-Benutzer verbunden ist.

  6. Geben Sie in das Feld Account Locator den Konto-Locator des Snowflake-Kontos ein, das Sie zur Simulation der Verbrauchererfahrung verwenden.

  7. Wählen Sie die Cloud und die Region des Kontos aus, das Sie zur Simulation der Verbrauchererfahrung verwenden.

  8. Wählen Sie Add aus.

Reinraum erstellen und freigeben

In diesem Abschnitt werden Sie Folgendes tun:

  • Erstellen eines Reinraums.

  • Hinzufügen von Daten zu dem Reinraum, der mit anderen Teilnehmern zusammen genutzt wird.

  • Definieren einer Verknüpfungsrichtlinie, die steuert, auf welchen Spalten ein Teilnehmer seine eigenen Daten verknüpfen kann.

  • Definieren, welchen Typ von Analyse ein Teilnehmer im Reinraum ausführen darf.

  • Reinraum für den Verbraucher freigeben.

Erstellungsprozess starten

So beginnen Sie mit der Einrichtung eines Reinraums:

  1. Wählen Sie im linken Navigationsbereich die Option Clean Rooms aus.

  2. Wählen Sie auf der Seite Clean Rooms die Option + Clean Room aus.

  3. Nennen Sie Ihren Reinraum Tutorial. Sie werden Ihren Teilnehmern erlauben, eine Zielgruppenüberschneidungsanalyse im Reinraum durchzuführen.

Daten zu Ihrem Reinraum hinzufügen

So fügen Sie Daten zu Ihrem Reinraum hinzu:

  1. Wählen Sie im Abschnitt Datasource die Option Snowflake aus.

  2. Wählen Sie in der Dropdown-Liste Tables die Option DEMO.CUSTOMERS aus. Diese Tabelle befindet sich unter der Datenbank SAMOOHA_SAMPLE_DATABASE.

  3. Wählen Sie Next aus.

Verknüpfungsrichtlinie spezifizieren

Eine Verknüpfungsrichtlinie steuert, mit welcher Spalten einer freigegebenen Tabelle ein Teilnehmer eine Verknüpfung vornehmen kann.

So spezifizieren Sie eine Verknüpfungsrichtlinie:

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

  2. Wählen Sie Next aus.

Analysevorlage konfigurieren

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

So wählen Sie aus, welche Analysevorlage für Teilnehmer im Reinraum verfügbar ist, und konfigurieren diese Vorlage:

  1. Wählen Sie die Vorlage Audience Overlap & Segmentation aus. Die Teilnehmer sind damit auf die Ausführung von Analysen zur Zielgruppeüberschneidung und -segmentierung.

  2. Wählen Sie in der Dropdownliste Tables die Option DEMO.CUSTOMERS aus. Teilnehmer können nur die Daten in der Tabelle DEMO.CUSTOMERS analysieren.

  3. Wählen Sie in der Dropdown-Liste Segmentation & Activation Columns die folgenden Spalten aus:

    • AGE_BAND

    • DEVICE_TYPE

    • EDUCATION_LEVEL

    • STATUS

    Als Verbraucher können Sie anhand dieser Spalten filtern und Segmente erstellen.

  4. Aktivieren Sie den Umschalter Allow categorical value previews during filtering.

  5. Wählen Sie Next aus.

Reinraum für Verbraucher freigeben

Jetzt, wo Sie den Reinraum erstellt und konfiguriert haben, können Sie ihn für einen Teilnehmer freigeben, damit dieser ihn zur Durchführung von Analysen verwenden kann.

So geben Sie einen Reinraum frei:

  1. Verwenden Sie die Dropdown-Liste Select Collaborator, um Tutorial Consumer auszuwählen.

  2. Wählen Sie Finish aus.

  3. Sie müssen warten, bis der Reinraum erstellt ist, bevor Sie mit diesem Tutorial fortfahren können. Wählen Sie in regelmäßigen Abständen Refresh aus, bis die Kachel Tutorial von Processing auf Edit wechselt.

Herzlichen Glückwunsch! Sie haben eine Snowflake Data Clean Room erstellt und freigegeben.

Zusammenfassung

In diesem Abschnitt haben Sie gelernt, wie Sie einen Reinraum als Anbieter installieren, konfigurieren und freigeben.

Im nächsten Teil dieses Tutorials wechseln Sie zur Rolle des Verbrauchers, der dem Reinraum beitritt und ihn zur Datenanalyse nutzt.

Bei Web-App als Verbraucher anmelden

In diesem Abschnitt wechseln Sie von der Rolle des Anbieters, der den Reinraum erstellt und freigegeben hat, zu der des Verbrauchers, der den Reinraum installiert. Sie installieren den Reinraum in einem anderen Konto, um nachzuahmen, wie ein Verbraucher den Reinraum in seinem eigenen Konto installieren und nutzen würde.

So melden Sie sich als Verbraucher bei der Web-App an:

  1. Navigieren Sie zu der Anmeldeseite von Snowflake Data Clean Rooms.

  2. Geben Sie Ihre E-Mail-Adresse ein, und wählen Sie Continue aus.

  3. Geben Sie Ihr Kennwort ein.

  4. Wenn Sie mit mehreren Reinraumumgebungen verbunden sind, wählen Sie das Snowflake-Konto aus, das Sie als Verbraucherkonto verwenden möchten.

Reinraum installieren und konfigurieren

In diesem Abschnitt werden Sie Folgendes tun:

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

  1. Wählen Sie im linken Navigationsbereich die Option Clean Rooms aus.

  2. Wählen Sie die Registerkarte Invited aus.

  3. Suchen Sie die Kachel Tutorial, und wählen Sie Join aus.

Verbraucherdaten zum Reinraum hinzufügen

So fügen Sie Daten zum Reinraum hinzu:

  1. Wählen Sie im Abschnitt Datasource die Option Snowflake aus.

  2. Wählen Sie in der Dropdown-Liste Tables die Option DEMO.CUSTOMERS aus. Diese Tabelle befindet sich unter der Datenbank SAMOOHA_SAMPLE_DATABASE.

  3. Wählen Sie Next aus.

Verknüpfungsrichtlinie definieren

Verbraucher verwenden eine Verknüpfungsrichtlinie, um anzugeben, welche Spalten in einer Analyse oder Abfrage verknüpft werden, und definieren so die Beziehung zwischen Anbietertabellen und Verbrauchertabellen.

So definieren Sie eine Verknüpfungsrichtlinie:

  1. Stellen Sie sicher, dass die Spalten aus der Tabelle des Verbrauchers (My Columns) und die Spalten aus der Tabelle des Anbieters (Collaborator Columns) übereinstimmen. Zum Beispiel sollte die Spalte HASHED_EMAIL des Verbrauchers mit der Spalte HASHED_EMAIL des Anbieters verknüpft werden. Sie haben beim Erstellen des Reinraums festgelegt, dass Teilnehmer Verknüpfungen nur über diese Spalten vornehmen dürfen.

  2. Wählen Sie Next aus.

Segmentierungs- und Aktivierungsspalten definieren

Wenn Sie während der Installation des Reinraums Segmentierungs- und Aktivierungsspalten auswählen, legen Sie fest, welche Spalten für Benutzer, die Analysen im Reinraum durchführen, verfügbar sind. Analysten können ein Segment 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:

  1. Wählen Sie in der Dropdown-Liste Tables die Option DEMO.CUSTOMERS aus.

  2. Wählen Sie in der Dropdown-Liste Segmentation & Activation Columns die folgenden Spalten aus:

    • INCOME_BRACKET

    • REGION_CODE

    • STATUS

  3. Wählen Sie Finish aus.

  4. Sie müssen warten, bis der Reinraum installiert ist, bevor Sie mit diesem Tutorial fortfahren können. Wählen Sie in regelmäßigen Abständen Refresh aus, bis die Kachel Tutorial von Processing auf Run wechselt.

Analyse ausführen

In diesem Abschnitt werden Sie im Reinraum eine Analyse zur Zielgruppenüberschneidung- und -segmentierung durchführen.

So führen Sie eine Analyse aus:

  1. Wählen Sie im linken Navigationsbereich die Option Clean Rooms aus.

  2. Wählen Sie die Registerkarte Joined aus.

  3. Suchen Sie die Kachel Tutorial, und wählen Sie Run aus.

  4. Wählen Sie die Kachel Audience Overlap & Segmentation und dann die Option Proceed aus.

  5. Wählen Sie in My Tables die Option Customers aus.

  6. Wählen Sie in Collaborator Table die Option Customers aus.

  7. Definieren Sie unter My Join Columns die folgenden Verknüpfungen:

    1. Wählen Sie in der Dropdown-Liste die Option HASHED_EMAIL aus.

    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 Reinraum ausführen, enthalten die Ergebnisse Datensätze, auf die einer der folgenden Punkte zutrifft:

    • HASHED_EMAIL in der Tabelle des Verbrauchers stimmt mit HASHED_EMAIL in der Tabelle 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.

  8. Gehen Sie im Abschnitt User Segmentation wie folgt vor:

    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.

  9. Verwenden Sie im Abschnitt Filters die Dropdown-Listen, um DEMO.CUSTOMERS.STATUS = GOLD zu definieren. Achten Sie auf die Farbcodierung, um die Spalte im Verbraucherkonto (My Columns) auszuwählen.

    Der STATUS eines Datensatzes in der Verbrauchertabelle muss GOLD sein, um in die Analyseergebnisse aufgenommen zu werden.

  10. Wählen Sie Run aus.

  11. Verwenden Sie den Bereich Results, um Ihre Ergebnisse zu sehen. Sie können Ihre Ergebnismetrik zwischen Übereinstimmungsrate und Überlappungszahl umschalten.

  12. Um die Segmentierungsgruppen Ihrer Analyse anzuzeigen, wählen Sie Download aus und öffnen Sie die kommagetrennte Datei.

  13. Fahren Sie mit dem nächsten Schritt des Tutorials fort, um die angereicherten Ergebnisse zur Aktivierung an den Anbieter zurückzusenden.

Ergebnisse aktivieren

In diesem Abschnitt aktivieren Sie die Ergebnisse Ihrer Analyse, indem Sie sie an das Snowflake-Konto des Anbieters zurücksenden. Diese Ergebnisse werden mit Daten aus den Tabellen der Verbraucher und Anbieter angereichert.

So aktivieren Sie die Ergebnisse der Analyse:

  1. Wählen Sie im Bereich Results die Option Activate aus.

  2. Wählen Sie den Namen des Anbieterkontos aus, das Sie für die Freigabe des Reinraums verwendet haben.

  3. Geben Sie im Feld Segment Name Provider Snowflake Account an.

  4. Wählen Sie in der Dropdownliste ID Columns die Option HASHED_EMAIL aus.

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

    Sie werden feststellen, dass die verfügbaren Spalten die gleichen sind wie die Segmentierungs- und Aktivierungsspalten, die Sie als Anbieter bei der Konfiguration des Reinraums ausgewählt haben, sowie die Segmentierungs- und Aktivierungsspalten, die Sie als Verbraucher bei der Installation des Reinraums ausgewählt haben.

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

Aktivierungsdaten als Anbieter anzeigen

In diesem Abschnitt wechseln Sie zurück in die Rolle des Anbieters, um die Ergebnisse der Aktivierung durch den Verbraucher zu sehen. Die Aktivierungsdaten des Verbrauchers werden in der Tabelle SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY des Snowflake-Kontos des Anbieters gespeichert.

Bevor Sie Snowsight verwenden, um diese Tabelle abzufragen, müssen Sie sich bei der Reinraumumgebung anmelden, um die Pipeline zwischen Verbraucherkonto und Anbieterkonto zu erstellen.

So melden Sie sich als Anbieter bei der Reinraumumgebung an:

  1. Navigieren Sie zu der Anmeldeseite von Snowflake Data Clean Rooms.

  2. Geben Sie Ihre E-Mail-Adresse ein, und wählen Sie Continue aus.

  3. Geben Sie Ihr Kennwort ein.

  4. Wenn Sie mit mehreren Reinraumumgebungen verbunden sind, wählen Sie das Snowflake-Konto aus, das Sie als Anbieterkonto für dieses Tutorial verwendet haben.

Nachdem die Pipeline erfolgreich erstellt wurde, können Sie die Aktivierungsdaten mit einer SQL-Abfrage oder mit dem Datenbank-Objekt-Explorer in Snowsight anzeigen:

  1. Melden Sie sich bei Snowsight für das Anbieterkonto an. Sie melden sich beim Snowflake-Konto an, nicht bei der Reinraumumgebung.

  2. Wählen Sie im linken Navigationsbereich die Option Data » Database aus.

  3. Navigieren Sie zu SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.

  4. Wählen Sie Data Preview aus, um die Aktivierungsdaten anzuzeigen.

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:

  1. Melden Sie sich bei Snowsight für das Anbieterkonto an. Sie melden sich beim Snowflake-Konto an, nicht bei der Reinraumumgebung.

  2. Öffnen Sie Projects » Worksheets.

  3. Wählen Sie + » SQL Worksheet aus.

  4. 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:

    DELETE FROM samooha_by_snowflake_local_db.public.provider_activation_summary
   WHERE segment = 'Provider Snowflake Account';
    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:

  1. Navigieren Sie zu der Anmeldeseite von Snowflake Data Clean Rooms.

  2. Geben Sie Ihre E-Mail-Adresse ein, und wählen Sie Continue aus.

  3. Geben Sie Ihr Kennwort ein.

  4. Wählen Sie das Snowflake-Konto aus, das Sie als Anbieterkonto verwendet haben.

  5. Wählen Sie im linken Navigationsbereich die Option Clean Rooms aus.

  6. Suchen Sie die Kachel Tutorial auf der Registerkarte Created und wählen Sie das Mehr-Symbol (Drei vertikale Punkte, die weitere Optionen anzeigen) aus.

  7. Wählen Sie Delete aus.

  8. Wählen Sie Proceed aus.

Mehr erfahren

Herzlichen Glückwunsch! Sie haben nun die Web-App verwendet, um einen Reinraum 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:

Sprache: Deutsch