Snowflake Data Clean Rooms: Konnektoren für Identitäts- und Datenanbieter¶

Voraussetzungen¶

1. Bevor Sie den Acxiom Connector konfigurieren, müssen Sie sich an Acxiom wenden, um Hilfe bei der Installation ihrer Native App zu erhalten.

2. Bevor ein Reinraumadministrator den Konnektor konfiguriert, muss der Eigentümer der Acxiom Native App:

   1. Melden Sie sich bei Snowsight an.

   2. Übernehmen Sie die Rolle, die Eigentümerrechte für die Acxiom Native App hat. Wenn zum Beispiel die Rolle acxiom_admin_role der Eigentümer der nativen App Acxiom ist, führen Sie aus:

      USE ROLE acxiom_admin_role;
      

      Copy

   3. Führen Sie den folgenden Befehl aus, um Snowflake Data Clean Rooms Zugriff auf die Acxiom realid_app_role-Anwendungsrolle zu gewähren:

      GRANT APPLICATION ROLE <acxiom_app_database>.realid_app_role
        TO ROLE samooha_app_role;
      

      Copy

Acxiom Real ID Connector konfigurieren¶

So konfigurieren Sie den Acxiom Real-ID-Konnektor:

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

2. Wählen Sie im linken Navigationsbereich die Option Connectors aus.

3. Wählen Sie die Registerkarte Identity & Data Providers aus.

4. Erweitern Sie Acxiom - Real ID.

5. Geben Sie in das Feld Application Database den Namen der Anwendungsdatenbank ein, die von der Acxiom Native App installiert wurde.

6. Wählen Sie in der Dropdown-Liste Warehouse die Größe des Warehouses aus. Wir empfehlen DCR_WH_XLarge, aber Sie können auch die Acxiom-Anleitung zu Warehouse-Größe und -Leistung lesen. Weitere Informationen zum Hochladen eines Warehouses für die Verwendung mit Snowflake Data Clean Rooms finden Sie unter Verwenden eines anderen Warehouse.

7. Wählen Sie Save aus.

Voraussetzungen¶

1. Sie müssen die native App Acxiom Real-ID installiert haben, wie zuvor beschrieben zuvor beschrieben.

2. Sie müssen die Anwendung Acxiom Real ID Transcoding installieren.

3. Wenden Sie sich an Ihre Teilnehmer, um den Client-ID und das Client-Geheimnis zu erhalten, die für sie bei der Installation der Acxiom Real ID Transcoding Native App generiert wurden.

4. Bevor ein Reinraumadministrator den Konnektor konfiguriert, muss der Eigentümer der Acxiom Native App:

   1. Melden Sie sich bei Snowsight an.

   2. Übernehmen Sie die Rolle, die Eigentümerrechte für die Acxiom Native App hat. Wenn zum Beispiel die Rolle acxiom_admin_role der Eigentümer der nativen App Acxiom ist, führen Sie aus:

      USE ROLE acxiom_admin_role;
      

      Copy

   3. Führen Sie den folgenden Befehl aus, um Snowflake Data Clean Rooms Zugriff auf die Acxiom realid_app_role-Anwendungsrolle zu gewähren:

      GRANT APPLICATION ROLE <acxiom_app_database>.realid_app_role TO ROLE samooha_app_role;
      

      Copy

Acxiom Real ID Transcoding-Konnektor konfigurieren¶

So konfigurieren Sie den Acxiom Real ID Transcoding-Konnektor:

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

2. Wählen Sie im linken Navigationsbereich die Option Connectors aus.

3. Wählen Sie die Registerkarte Identity & Data Providers aus.

4. Erweitern Sie Acxiom Real ID Transcoding.

5. Geben Sie in das Feld Application Database den Namen der Anwendungsdatenbank ein, die von der Acxiom Native App installiert wurde.

6. Geben Sie in das Feld Client ID die Client-ID ein, die von Acxiom bei der Installation der nativen App bereitgestellt wurde.

7. Geben Sie in das Feld Client Secret das Clientgeheimnis ein, das Sie von Acxiom bei der Installation der Native App erhalten haben.

8. Wählen Sie in der Dropdown-Liste Warehouse die Größe des Warehouses aus. Wir empfehlen DCR_WH_Medium, aber Sie können auch die Acxiom-Anleitung zu Warehouse-Größe und -Leistung lesen. Weitere Informationen zum Hochladen eines Warehouses für die Verwendung mit Snowflake Data Clean Rooms finden Sie unter Verwenden eines anderen Warehouse.

9. Wählen Sie im Abschnitt Acxiom Collaborator einen oder mehrere Teilnehmer zusammen mit der Client-ID und dem Client-Geheimnis aus, das für sie bei der Installation der nativen App Acxiom Real ID Transcoding generiert wurde. Wenn Ihr Teilnehmer nicht in der Liste erscheint, müssen Sie ihn zur Reinraumumgebung hinzufügen.

10. Wählen Sie Save aus.

Schritt 1: Installieren Sie die Native App Merkury Identity Connector¶

1. Installieren Sie die Native App „Merkury Identity Connector“: Kontaktieren Sie Merkury unter IDConnector@dentsu.com, um das Freigabeangebot zu Ihrem Konto hinzuzufügen.

2. Berechtigungen für die SAMOOHA_APP_ROLE-Rolle erteilen:

   1. Melden Sie sich bei Snowsight an.

   2. Übernehmen Sie die Rolle, die Eigentümerrechte an der Merkury Native App hat. Wenn zum Beispiel die Rolle ACCOUNTADMIN der Eigentümer der Merkury Native App ist, führen Sie USE ROLE ACCOUNTADMIN; aus

   3. Führen Sie den folgenden Befehl aus, um Snowflake Data Clean Rooms Zugriff auf die Anwendungsrolle Merkury DCR_DB_ROLE zu gewähren:

   GRANT APPLICATION ROLE <merkury_app_database>.DCR_DB_ROLE TO ROLE samooha_app_role;
   

   Copy

Schritt 2: Konfigurieren Sie die Native App Merkury Identity Connector¶

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

2. Wählen Sie im linken Navigationsbereich die Option Connectors aus.

3. Wählen Sie die Registerkarte Identity & Data Providers aus.

4. Erweitern Sie Merkury Identity Connector.

5. Geben Sie in das Feld Application database den Namen der Anwendungsdatenbank ein, die von der Merkury Identity Native App installiert wurde.

6. Authentifizieren Sie sich.

Cache für TransUnion TruAudience Identity¶

Snowflake unterhält einen Cache, der TransUnion-Teilnehmer-IDs den Werten in der Quelltabelle zuordnet, die die Datensätze eindeutig identifizieren. Der Cache könnte zum Beispiel jede Teilnehmer-ID einem Wert in der Spalte user_id der Quelltabelle zuordnen. Der Cache wird in der Tabelle SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS gespeichert. Diese Tabelle enthält folgende Spalten:

Spalte	Datentyp	Beschreibung
inputid	VARCHAR	Wert aus der Spalte, die während der Integration als Unique Record Column ausgewählt wurde.
collaborationid	VARCHAR	TransUnion-Zusammenarbeits-ID, die auf der Grundlage der Eingabe-ID und anderer Parameter für die Integration erstellt wurde.
lastprocessed	TIMESTAMP_NTZ	Zeitstempel, zu dem TransUnion die Zusammenarbeits-ID erstellt hat.

Sie können die folgenden Aktionen für einen Cache durchführen:

Den Cache löschen

TRUNCATE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS;

Copy

Bestimmte Datensätze aus dem Cache löschen

Sie können bestimmte Datensätze aus dem Cache löschen, indem Sie sie als durch Kommas getrennt Liste von Werten in einfachen Anführungszeichen angeben. Um zum Beispiel die Datensätze mit den Eingaben IDs von 123456 und abcedf zu löschen, führen Sie Folgendes aus:

DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS
  WHERE inputid IN ('123456', 'abcedf');

Copy

Löschen Sie mehrere Datensätze basierend auf den Eingabe-IDs in einem separaten Datenset

Sie können mehrere Datensätze aus dem Cache löschen, wenn die Eingabe-IDs in einer Spalte einer anderen Tabelle vorhanden sind. Wenn zum Beispiel die zu löschenden Eingabe-IDs in der Spalte user_id der Tabelle my_db.my_schema.ref_table aufgeführt sind, führen Sie Folgendes aus:

DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS
  WHERE INPUTID IN (
    SELECT user_id as INPUTID
    FROM my_db.my_schema.ref_table
  );

Copy

Alle Datensätze aus einem Batch hinzufügen

Sie können alle Datensätze aus einem Batch, der in der Ansicht TransUnionvorhanden ist, in den Cache aufnehmen.

INSERT INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS (
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
SELECT
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
FROM <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW
WHERE BATCHID = '<BATCH_ID>';

Copy

Alle Datensätze aus einem Batch zusammenführen

Sie können alle Datensätze aus einem Batch, der in der Ansicht TransUnion vorhanden ist, mit dem Cache zusammenführen, indem Sie die vorhandenen Eingaben-ID-Datensatz mit den entsprechenden neuen Zusammenarbeit-IDs und den neuen Zeitstempeln der letzten Verarbeitung überschreiben.

MERGE INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS CT
USING <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW OT
  ON
    CT.INPUTID = OT.INPUTID
    AND OT.BATCHID = '<BATCH_ID>'
WHEN MATCHED THEN
  UPDATE SET
    CT.COLLABORATIONID = OT.COLLABORATIONID,
    CT.LASTPROCESSED = OT.LASTPROCESSED
WHEN NOT MATCHED THEN
  INSERT (
    INPUTID,
    COLLABORATIONID,
    LASTPROCESSED
  ) VALUES (
      OT.INPUTID,
      OT.COLLABORATIONID,
      OT.LASTPROCESSED
  );

Copy

Teilnehmer-IDs für Eingaben-ID-Datensätze hinzufügen

Sie können Teilnehmer-IDs für Eingabe-ID-Datensätze hinzufügen, die als Spalte in einem Datensatz und auch in einem bestimmten Batch vorhanden sind.

INSERT INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS (
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
)
  SELECT
    INPUTID,
    COLLABORATIONID,
    LASTPROCESSED
  FROM <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW
  WHERE INPUTID IN (
    SELECT <column_name_containing_input_ids_to_be_added> as INPUTID
    FROM <dataset_fqtn_containing_input_ids_to_be_added>
    )
    AND BATCHID = '<BATCH_ID>';

Copy