Snowflake Data Clean Rooms : Connecteurs de fournisseurs d’identité et de données¶

Conditions préalables¶

1. Avant de configurer le connecteur Acxiom, vous devez contacter Acxiom pour obtenir de l’aide sur l’installation de leur application native.

2. Avant qu’un administrateur de salle blanche ne configure le connecteur, le propriétaire de l’application native Acxiom doit :

   1. Connectez-vous à Snowsight.

   2. Assumer le rôle qui possède les droits de propriété sur l’application native Acxiom. Par exemple, si le rôle acxiom_admin_role est le propriétaire de l’application native Acxiom, exécutez :

      USE ROLE acxiom_admin_role;
      

      Copy

   3. Exécutez la commande suivante pour accorder l’accès Snowflake Data Clean Rooms au rôle d’application realid_app_role Acxiom :

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

      Copy

Configurez l’ID du connecteur Acxiom Real¶

Pour configurer le connecteur Acxiom Real ID :

1. Connectez-vous à votre environnement de salle blanche dans l’application Web.

2. Dans la navigation de gauche, sélectionnez Connectors.

3. Sélectionnez l’onglet Identity & Data Providers.

4. Développez Acxiom - Real ID.

5. Dans le champ Application Database, entrez le nom de la base de données de l’application qui a été installée par l’application native Acxiom.

6. Dans la liste déroulante Warehouse, sélectionnez la taille de l’entrepôt. Nous recommandons DCR_WH_XLarge, mais vous pouvez lire les Conseils d’Acxiom sur la taille et les performances des entrepôts. Pour plus d’informations sur la création d’un entrepôt avec Snowflake Data Clean Rooms, voir Ajouter des options d’entrepôt.

7. Sélectionnez Save.

Conditions préalables¶

1. Vous devez avoir installé l’application native d’Acxiom Real ID, comme décrit précédemment.

2. Vous devez installer l’application Transcoding d’Acxiom Real ID.

3. Contactez vos collaborateurs pour obtenir l’ID et le secret du client générés pour eux lors de l’installation de l’application native Acxiom Real ID Transcoding.

4. Avant qu’un administrateur de salle blanche ne configure le connecteur, le propriétaire de l’application native Acxiom doit :

   1. Connectez-vous à Snowsight.

   2. Assumer le rôle qui possède les droits de propriété sur l’application native Acxiom. Par exemple, si le rôle acxiom_admin_role est le propriétaire de l’application native Acxiom, exécutez :

      USE ROLE acxiom_admin_role;
      

      Copy

   3. Exécutez la commande suivante pour accorder l’accès Snowflake Data Clean Rooms au rôle d’application realid_app_role Acxiom :

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

      Copy

Configurer le connecteur Transcoding d’Acxiom Real ID¶

Pour configurer le connecteur Transcoding d’Acxiom Real ID :

1. Connectez-vous à votre environnement de salle blanche dans l’application Web.

2. Dans la navigation de gauche, sélectionnez Connectors.

3. Sélectionnez l’onglet Identity & Data Providers.

4. Développez Acxiom Real ID Transcoding.

5. Dans le champ Application Database, entrez le nom de la base de données de l’application qui a été installée par l’application native Acxiom.

6. Dans le champ Client ID, entrez l’ID client fourni par Acxiom lorsque vous avez installé l’application native.

7. Dans le champ Client Secret, entrez le secret client fourni par Acxiom lors de l’installation de l’application native.

8. Dans la liste déroulante Warehouse, sélectionnez la taille de l’entrepôt. Nous recommandons DCR_WH_Medium, mais vous pouvez lire les Conseils d’Acxiom sur la taille et les performances des entrepôts. Pour plus d’informations sur la création d’un entrepôt avec Snowflake Data Clean Rooms, voir Ajouter des options d’entrepôt.

9. Dans la section Acxiom Collaborator, sélectionnez un ou plusieurs collaborateurs avec l’ID du client et le secret du client qui a été généré pour eux lors de l’installation de l’application native Acxiom Real ID Transcoding. Si votre collaborateur n’apparaît pas dans la liste, vous devez les ajouter à l’environnement de la salle blanche.

10. Sélectionnez Save.

Étape 1 : Installer l’application native Merkury Identity Connector¶

1. Installez l’application native Merkury Identity Connector : contactez Merkury à l’adresse IDConnector@dentsu.com pour ajouter le listing à votre compte.

2. Accordez les privilèges au rôle SAMOOHA_APP_ROLE :

   1. Connectez-vous à Snowsight .

   2. Endossez le rôle ayant les droits de propriété sur l’application native Merkury. Par exemple, si le rôle ACCOUNTADMIN est propriétaire de l’application native Merkury, exécutez USE ROLE ACCOUNTADMIN;

   3. Exécutez la commande suivante pour accorder à Snowflake Data Clean Rooms l’accès au rôle d’application DCR_DB_ROLE :

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

   Copy

Étape 2 : Configurer l’application native Merkury Identity Connector¶

1. Connectez-vous à votre salle blanche dans l’application Web.

2. Dans la navigation de gauche, sélectionnez Connectors.

3. Sélectionnez l’onglet Identity & Data Providers.

4. Développez Merkury Identity Connector.

5. Dans le champ Application database, saisissez le nom de la base de données de l’application qui a été installée par l’application native Merkury Identity.

6. Authentifiez-vous

Cache pour identité TransUnion TruAudience¶

Snowflake maintient un cache qui mappe les IDs du collaborateur TransUnion aux valeurs de la table source qui identifient de manière unique les enregistrements. Par exemple, le cache peut mapper chaque ID de collaborateur à une valeur dans la colonne user_id de la table source. Le cache est stocké dans la table SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS. Cette table contient les colonnes suivantes :

Colonne	Type de données	Description
inputid	VARCHAR	Valeur de la colonne sélectionnée comme Unique Record Column pendant l’intégration.
collaborationid	VARCHAR	ID de collaboration TransUnion généré sur la base de l’ID d’entrée et d’autres paramètres d’intégration.
lastprocessed	TIMESTAMP_NTZ	Horodatage lorsque TransUnion a généré l” ID de collaboration.

Vous pouvez effectuer les actions suivantes sur un cache :

Supprimer le cache

TRUNCATE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS;

Copy

Supprimer des enregistrements spécifiques du cache

Vous pouvez supprimer des enregistrements spécifiques du cache en les spécifiant sous la forme d’une liste de valeurs séparées par des virgules entre guillemets simples. Par exemple, pour supprimer les enregistrements avec les IDs d’entrée de 123456 et abcedf, exécutez :

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

Copy

Supprimer plusieurs enregistrements en fonction des IDs d’entrée dans un ensemble de données distinct

Vous pouvez supprimer plusieurs enregistrements du cache lorsque les IDs d’entrée sont présents dans une colonne d’une autre table. Par exemple, si les IDs d’entrée à supprimer sont répertoriés dans la colonne user_id de la table my_db.my_schema.ref_table, exécutez :

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

Ajouter tous les enregistrements d’un lot

Vous pouvez ajouter tous les enregistrements d’un lot présent dans la vue de TransUnion sur le cache.

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

Fusionner tous les enregistrements d’un lot

Vous pouvez fusionner tous les enregistrements d’un lot présent dans la vue de TransUnion sur le cache en écrasant les enregistrements d’ID d’entrée existants avec les nouveaux IDs de collaboration correspondants et les nouveaux horodatages de dernier traitement.

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

Ajouter des IDs de collaborateur pour les enregistrements des ID d’entrée

Vous pouvez ajouter des IDs de collaborateur pour les enregistrements d’ID d’entrée présents sous forme de colonne dans un ensemble de données et également présents dans un lot spécifique.

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