Datenangebote¶

Registrieren eines Datenangebots¶

1. Erstellen Sie eine Datenangebotsspezifikation für Ihre Daten. Geben Sie die folgenden Details zu Ihrem Datenangebot an:

   • Das Quellobjekt für jedes Datenset in Ihrem Datenangebot.

   • Welche Spalten in jedes Datenset aufgenommen werden sollen.

   • Der Typ jeder Spalte (Join oder anderweitig), der verwendet wird, um die Clean Room-Richtlinien zu füllen. In einigen Fällen geben Sie auch das Format einzelner Spalten an.

   • Beliebige Snowflake Datenschutzrichtlinien zur Anwendung auf Spalten in Ihrem Datenangebot.

   • Wie Benutzer auf die Daten zugreifen können: nur über die Vorlage oder auch über FreiformSQL-Abfrage.

2. Registriert das Datenangebot, indem REGISTER_DATA_OFFERING aufgerufen wird, wodurch eine Datenangebots-ID zurückgegeben wird.

   Durch diesen Schritt wird das Datenangebot verfügbar, um von jeder Rolle in Ihrem Konto, die Lesezugriff auf die Registry hat, mit einer beliebigen Zusammenarbeit verknüpft zu werden. Sie können dieselbe Datenangebots-ID zur Freigabe eines Datenangebots für mehrere Kooperationen verwenden.

Verknüpfen eines Datenangebots¶

Der Verknüpfungsprozess hängt davon ab, ob die Zusammenarbeit erstellt wurde:

• Wenn die Zusammenarbeit noch nicht erstellt wurde, kann der Datenanbieter die Datenangebots-ID an den Eigentümer der Zusammenarbeit abgeben, um ihn in die Spezifikation für die Zusammenarbeit aufzunehmen. Wenn ein Datenangebot in der Spezifikation für die Zusammenarbeit enthalten ist, wird die Datenangebots-ID in der Spezifikation für die Zusammenarbeit sichtbar und kann vom Datenanbieter vor der Teilnahme an der Zusammenarbeit überprüft werden.

• Wenn die Zusammenarbeit bereits erstellt wurde, tritt der Datenanbieter der Zusammenarbeit bei und ruft LINK_DATA_OFFERING mit der Datenangebots-ID, dem Namen der Zusammenarbeit und den Personen, für die die Daten freigegeben werden können, auf. Nach dem Verknüpfen eines Datenangebots kann es zu einer kurzen Verzögerung kommen, bevor es verfügbar ist. Rufen Sie VIEW_UPDATE_REQUESTS auf, wenn Sie sicherstellen möchten, dass die Anfrage zum Linkdatenangebot erfolgreich abgeschlossen wurde. Nach erfolgreicher Verknüpfung ist das Datenangebot sichtbar und kann beim Aufruf von VIEW_DATA_OFFERINGS verwendet werden.

Wenn Sie Daten verknüpfen, geben Sie an, welche Analysis Runner auf die Daten zugreifen können.

Ein Datenanbieter kann Datenangebote von einer Zusammenarbeit oder bestimmten Teilnehmern entfernen, indem er UNLINK_DATA_OFFERING aufruft.

Um die registrierten Datenangebote in Ihrem Konto anzuzeigen, rufen Sie VIEW_REGISTERED_DATA_OFFERINGS auf.

Unter Analyse ausführen erfahren Sie, wie Sie eine Analyse durchführen.

Umbenennen der Quellspalte¶

Die Spaltennamen in einem Datenangebot können umbenannt werden, bevor sie für den Leser der Analyse offengelegt werden. Die Umbenennung hängt von den category- und``column_type``-Werten ab, die die Spalte in der :ref:` Spezifikation des Datenangebots<label-dcr_collaboration_data_yaml>` definieren, wie in dieser Tabelle beschrieben:

Wenn die Spalte in der Quelltabelle beispielsweise user_email_address heißt, hängt es davon ab, wie sie in der Datenangebotsspezifikation definiert ist, unter welchem Namen sie einem Analysis Runner zur Verfügung gestellt wird.

...
schema_and_template_policies:
  user_email_address:
    category: join_standard
    column_type: hashed_email_sha256

SELECT HASHED_EMAIL_SHA256
FROM source_table[0];

Anwenden von Datenschutzrichtlinien auf Datenangebote¶

Daten, die in einem Clean Room freigegeben werden, sind auf mehrere Arten geschützt:

• Daten, die in der Clean Room-Umgebung registriert sind, werden als sichere Ansicht erstellt, in der alle Spalten weggelassen werden, die nicht in der Spezifikation des Datenangebots aufgeführt sind.

• Die sichere Ansicht wird nur für die in der Zusammenarbeitsspezifikation angegebenen Benutzer und Vorlagen freigegeben.

• Sie können Ihren Daten Snowflake-Richtlinien hinzufügen, um die Verwendung ihrer Daten weiter zu verwalten.

• Clean Room-Vorlagenrichtlinien werden ebenfalls auf Basis der Klassifizierung der Datenangebotsspalte angewendet.

Es gibt zwei Möglichkeiten, eine Snowflake-Datenschutzrichtlinie, z. B. eine Verknüpfungs-</user-guide/join-policies> oder Aggregationsrichtlinie:doc:</user-guide/aggregation-policies>, auf Ihre freigegebenen Daten anzuwenden:

• Wenden Sie die Richtlinie auf die Quelldaten an. Alle Richtlinien, die auf die Quelldaten angewendet werden, werden in den Datasets durchgesetzt, die im Rahmen einer Zusammenarbeit offengelegt wurden. Teilen Sie Ihre Richtlinie den Teilnehmern mit.

• Wenden Sie die Richtlinie auf das Datenangebot an, wenn Sie es in Freiform-Abfragen verwenden. Wenn Sie Freiform-Abfragen auf Ihren Datenangeboten zulassen, können Sie in der Spezifikation des Datenangebots Richtlinien angeben, die für diese Abfragen erzwungen werden sollen. Diese Richtlinien werden zusätzlich zu allen vorhandenen Snowflake-Richtlinien für Ihre Quelltabellen angewendet.

CREATE OR REPLACE AGGREGATION POLICY my_db.public.my_agg_policy AS ()
  RETURNS AGGREGATION_CONSTRAINT ->
    AGGREGATION_CONSTRAINT(MIN_GROUP_SIZE => 5);

# Tell data clean rooms to set your aggregation policy on the hashed_email column of
# the data offering
api_version: 2.0.0
spec_type: data_offering
version: 1
name: my_favorite_dataset
datasets:
  - alias: test_freeform_restricted_agg
    data_object_fqn: samooha_provider_sample_database.audience_overlap.customers
    allowed_analyses: template_and_freeform_sql
    object_class: custom
    freeform_sql_policies:
      aggregation_policy:
        name: my_db.public.my_agg_policy
        entity_keys:
          - hashed_email
...

SELECT *
FROM T1
JOIN T2
ON {{ t1_col | sqlsafe | join_policy }} = {{ t2_col | sqlsafe | join_policy }}

Organisieren von Datenangeboten mit Benennung von Pfaden¶

Sie können Namenspfade verwenden, um Datenangebote konzeptionell zu gruppieren. Dies ist besonders effektiv, da jedes Datenangebot eine oder mehrere Tabellen oder Ansichten repräsentiert. Der Zugriff auf einzelne Tabellen erfolgt mit der Syntax collaborator alias.data offering ID.dataset alias, wo die Datenangebots-ID eine Kombination aus dem vom Benutzenden bereitgestellten Namen und den Versionswerten ist. Der Alias ist eine einzelne Tabelle im Angebot.

Betrachten Sie den Namen, die Version und den Alias beim Registrieren Ihrer Datenangebote als Bereichssystem, mit dem Sie Ihre Daten nach Angebot und Alias organisieren können. Sie könnten zum Beispiel das folgende Datenangebot mit Verkaufsdaten registrieren, wobei jede Tabelle spezifisch für einen US-Bundesstaat ist:

api_version: 2.0.0
spec_type: data_offering
version: v0
name: examplecorp_sales_by_state
datasets:
 - alias: AL
   data_object_fqn: mydb.mysch.al_data
 - alias: NY
   data_object_fqn: mydb.mysch.ny_data
 - alias: CA
   data_object_fqn: mydb.mysch.ca_data

Der Analysis Runner referenziert diese Tabellen als``user_alias.offering_id.AL``,``user_alias.offering_id.NY`` und``user_alias.offering_id.CA``.