DocumentationComposition d’audiences fédérées Experience Platform

Configurer vos bases de données fédérées federated-db

Last update: Wed Nov 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

La composition d’audiences fédérées Experience Platform permet au client ou à la cliente de créer et d’enrichir des audiences à partir d’entrepôts de données tiers et d’importer les audiences dans Adobe Experience Platform.

Découvrez comment créer, configurer, tester et enregistrer la connexion à votre base de données externe sur cette page. Vous trouverez ci-dessous la liste des bases de données prises en charge et les paramètres détaillés à configurer pour chacune d’elles.

Bases de données prises en charge supported-db

Avec la composition d’audiences fédérées, vous pouvez vous connecter aux bases de données suivantes. La configuration de chaque base de données est présentée ci-dessous.

Amazon Redshift amazon-redshift

Utilisez des bases de données fédérées pour traiter les informations stockées dans une base de données externe. Suivez les étapes ci-dessous pour configurer l’accès à Amazon Redshift.

  1. Dans le menu Données fédérées, sélectionnez Bases de données fédérées.

  2. Cliquez sur Ajouter une base de données fédérée.

  3. Saisissez un nom pour votre base de données fédérée.

  4. Dans la liste déroulante Type, sélectionnez Amazon Redshift.

  5. Configurez les paramètres d’authentification Amazon Redshift :

    • Serveur  : ajoutez le nom du DNS.

    • Compte  : ajoutez le nom d’utilisateur ou d’utilisatrice.

    • Mot de passe  : ajoutez le mot de passe du compte.

    • Base de données  : nom de la base de données s’il n’est pas spécifié dans le DSN. Il peut rester vide s’il est spécifié dans le DSN

    • Schéma de travail  : nom du schéma de base de données à utiliser pour les tableaux de travail. En savoir plus dans la Documentation Amazon

      note note
      NOTE
      Vous pouvez utiliser n’importe quel schéma de la base de données, y compris les schémas utilisés pour le traitement temporaire des données, à condition que vous disposiez de l’autorisation requise pour vous connecter à ce schéma.
      Des schémas de travail distincts doivent être utilisés lors de la connexion de plusieurs sandbox à la même base de données.

  6. Sélectionnez l’option Tester la connexion pour vérifier votre configuration.

  7. Cliquez sur le bouton Déployer les fonctions pour créer les fonctions.

  8. Une fois la configuration terminée, cliquez sur Ajouter pour créer votre base de données fédérée.

Azure Synapse Analytics azure-synapse

Utilisez des bases de données fédérées pour traiter les informations stockées dans une base de données externe. Suivez les étapes ci-dessous pour configurer l’accès à Azure Synapse Analytics.

  1. Dans le menu Données fédérées, sélectionnez Bases de données fédérées.

  2. Cliquez sur Ajouter une base de données fédérée.

  3. Saisissez un nom pour votre base de données fédérée.

  4. Dans la liste déroulante Type, sélectionnez Azure Synapse Analytics.

  5. Configurez les paramètres d’authentification Azure Synapse Analytics :

    • Serveur  : saisissez l’URL du serveur Azure Synapse

    • Compte  : saisissez le nom d’utilisateur ou d’utilisatrice.

    • Mot de passe  : saisissez le mot de passe du compte.

    • Base de données (facultatif) : saisissez le nom de la base de données s’il n’est pas spécifié dans le DSN.

    • Options  : le connecteur prend en charge les options présentées dans le tableau ci-dessous.

  6. Sélectionnez l’option Tester la connexion pour vérifier votre configuration.

  7. Cliquez sur le bouton Déployer les fonctions pour créer les fonctions.

  8. Une fois la configuration terminée, cliquez sur Ajouter pour créer votre base de données fédérée.

Option
Description
Authentification
Type d’authentification pris en charge par le connecteur. Valeur actuelle prise en charge : ActiveDirectoryMSI. Pour plus d’informations, voir la documentation Microsoft SQL (exemple n° 8 de chaînes de connexion).

Google BigQuery google-big-query

Utilisez des bases de données fédérées pour traiter les informations stockées dans une base de données externe. Suivez les étapes ci-dessous pour configurer l’accès à Google BigQuery.

  1. Dans le menu Données fédérées, sélectionnez Bases de données fédérées.

  2. Cliquez sur Ajouter une base de données fédérée.

  3. Saisissez un nom pour votre base de données fédérée.

  4. Dans la liste déroulante Type, sélectionnez Google BigQuery.

  5. Configurez les paramètres d’authentification Google BigQuery :

    • Compte de service  : saisissez l’adresse e-mail de votre compte de service. Pour plus d’informations à ce propos, consultez la documentation Google Cloud.

    • Projet  : saisissez l’ID de votre projet. Pour plus d’informations à ce propos, consultez la documentation Google Cloud.

    • Jeu de données  : saisissez le nom de votre jeu de données. Pour plus d’informations à ce propos, consultez la documentation Google Cloud.

    • Chemin d’accès au fichier de clé  : chargez votre fichier de clé sur le serveur. Seuls les fichiers .json sont pris en charge.

    • Options  : le connecteur prend en charge les options présentées dans le tableau ci-dessous.

  6. Sélectionnez l’option Tester la connexion pour vérifier votre configuration.

  7. Cliquez sur le bouton Déployer les fonctions pour créer les fonctions.

  8. Une fois la configuration terminée, cliquez sur Ajouter pour créer votre base de données fédérée.

Option
Description
ProxyType
Type de proxy utilisé pour se connecter à BigQuery par le biais des connecteurs ODBC et SDK.
HTTP (par défaut), http_no_tunnel, socks4 et socks5 sont actuellement pris en charge.
ProxyHost
Nom d’hôte ou adresse IP où le proxy peut être atteint.
ProxyPort
Numéro de port sur lequel le proxy s’exécute, par exemple 8080
ProxyUid
Nom d’utilisateur utilisé pour le proxy authentifié
ProxyPwd
Mot de passe ProxyUid
bqpath
Notez que cela s’applique uniquement à l’outil de chargement en masse (SDK Cloud).
Pour éviter d’utiliser la variable PATH ou si le répertoire google-cloud-sdk doit être déplacé vers un autre emplacement, vous pouvez spécifier avec cette option le chemin exact du répertoire bin du sdk cloud sur le serveur.
GCloudConfigName
Notez que cela s’applique uniquement à partir de la version 7.3.4 et à l’outil de chargement en masse (SDK Cloud).
Le SDK Google Cloud utilise des configurations pour charger les données dans les tableaux BigQuery. La configuration nommée accfda stocke les paramètres pour le chargement des données. Cependant, cette option permet aux personnes de spécifier un nom différent pour la configuration.
GCloudDefaultConfigName
Notez que cela s’applique uniquement à partir de la version 7.3.4 et à l’outil de chargement en masse (SDK Cloud).
La configuration active du SDK Google Cloud ne peut pas être supprimée sans transférer au préalable la balise active vers une nouvelle configuration. Cette configuration temporaire est nécessaire pour recréer la configuration principale de chargement des données. Le nom par défaut de la configuration temporaire est default, et peut être modifié si nécessaire.
GCloudRecreateConfig
Notez que cela s’applique uniquement à partir de la version 7.3.4 et à l’outil de chargement en masse (SDK Cloud).
Lorsqu’il est défini sur false, le mécanisme de chargement en masse évite de tenter de recréer, de supprimer ou de modifier les configurations du SDK Google Cloud. Au lieu de cela, il procède au chargement des données à l’aide de la configuration existante sur la machine. Cette fonctionnalité est utile lorsque d’autres opérations dépendent des configurations du SDK Google Cloud.
Si la personne active cette option de moteur sans une configuration appropriée, le mécanisme de chargement en masse émet un message d’avertissement : No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option. Pour éviter d’autres erreurs, le mécanisme de chargement en masse par défaut du tableau ODBC est rétabli.

Snowflake snowflake

NOTE
L’accès sécurisé à votre entrepôt de données Snowflake externe par le biais d’un lien privé est pris en charge. Notez que votre compte Snowflake doit être hébergé sur Amazon Web Services (AWS) et situé dans la même région que votre environnement de composition d’audiences fédérées. Veuillez contacter votre représentant ou représentante Adobe pour obtenir de l’aide sur la configuration de l’accès sécurisé à votre compte Snowflake.

Utilisez des bases de données fédérées pour traiter les informations stockées dans une base de données externe. Suivez les étapes ci-dessous pour configurer l’accès à Snowflake.

  1. Dans le menu Données fédérées, sélectionnez Bases de données fédérées.

  2. Cliquez sur Ajouter une base de données fédérée.

  3. Saisissez un nom pour votre base de données fédérée.

  4. Dans la liste déroulante Type, sélectionnez Snowflake.

  5. Configurer les paramètres d’authentification Snowflake

    • Serveur  : saisissez le nom de votre serveur.

    • Utilisateur ou utilisatrice  : saisissez votre nom d’utilisateur ou d’utilisatrice.

    • Mot de passe  : saisissez le mot de passe de votre compte.

    • Base de données (facultatif) : saisissez le nom de votre base de données s’il n’est pas spécifié dans le DSN.

    • Schéma de travail (facultatif) : saisissez le nom du schéma de base de données à utiliser pour les tableaux de travail.

      note note
      NOTE
      Vous pouvez utiliser n’importe quel schéma de la base de données, y compris les schémas utilisés pour le traitement temporaire des données, à condition que vous disposiez de l’autorisation requise pour vous connecter à ce schéma.
      Des schémas de travail distincts doivent être utilisés lors de la connexion de plusieurs sandbox à la même base de données.

    • Clé privée  : cliquez sur le champ Clé privée pour sélectionner vos fichiers .pem dans votre dossier de paramètres régionaux.

    • Options  : le connecteur prend en charge les options présentées dans le tableau ci-dessous.

  6. Sélectionnez l’option Tester la connexion pour vérifier votre configuration.

  7. Cliquez sur le bouton Déployer les fonctions pour créer les fonctions.

  8. Une fois la configuration terminée, cliquez sur Ajouter pour créer votre base de données fédérée.

Le connecteur prend en charge les options suivantes :

Option
Description
workschema
Schéma de base de données à utiliser pour les tables de travail.
warehouse
Nom de l'entrepôt par défaut à utiliser. Il remplace la valeur par défaut de l'utilisateur.
NomFuseauHoraire
Vide par défaut. Le serveur applicatif du fuseau horaire est utilisé. Il est possible d’utiliser cette option pour forcer le paramètre de session TIMEZONE.
Pour en savoir plus à ce sujet, consultez cette page.
WeekStart
Paramètre de session WEEK_START. Par défaut, cette valeur est définie sur 0.
Pour en savoir plus à ce sujet, consultez cette page.
UseCachedResult
Paramètre de session USE_CACHED_RESULTS. Par défaut, cette valeur est définie sur TRUE. Cette option peut être utilisée pour désactiver les résultats mis en cache de Snowflake.
Pour en savoir plus à ce sujet, consultez cette page.
bulkThreads
Nombre de threads à utiliser pour le chargeur en masse de Snowflake ; plus de threads signifient de meilleures performances pour les chargements en masse plus volumineux. Par défaut, cette valeur est définie sur 1. Le nombre peut être ajusté en fonction du nombre de threads de la machine.
chunkSize
Détermine la taille de fichier du bloc de chargeur en masse. Par défaut, cette valeur est définie sur 128 Mo. Peut être modifiée pour des performances plus optimales, lorsqu’elle est utilisée avec bulkThreads. Plus de threads actifs simultanément signifie de meilleures performances.
Pour en savoir plus à ce sujet, consultez la documentation Snowflake.
StageName
Nom de l’étape interne préconfigurée. Elle sera utilisée en chargement massif au lieu de créer une nouvelle étape temporaire.

Vertica Analytics vertica-analytics

Utilisez des bases de données fédérées pour traiter les informations stockées dans une base de données externe. Suivez les étapes ci-dessous pour configurer l’accès à Vertica Analytics.

  1. Dans le menu Données fédérées, sélectionnez Bases de données fédérées.

  2. Cliquez sur Ajouter une base de données fédérée.

  3. Saisissez un nom pour votre base de données fédérée.

  4. Dans la liste déroulante Type, sélectionnez Vertica Analytics.

  5. Configurez les paramètres d’authentification Vertica Analytics :

    • Serveur  : ajoutez l’URL du serveur Vertica Analytics.

    • Compte  : ajoutez le nom d’utilisateur ou d’utilisatrice.

    • Mot de passe  : ajoutez le mot de passe du compte.

    • Base de données (facultatif) : saisissez le nom de votre base de données s’il n’est pas spécifié dans le DSN.

    • Schéma de travail (facultatif) : saisissez le nom du schéma de base de données à utiliser pour les tableaux de travail.

      note note
      NOTE
      Vous pouvez utiliser n’importe quel schéma de la base de données, y compris les schémas utilisés pour le traitement temporaire des données, à condition que vous disposiez de l’autorisation requise pour vous connecter à ce schéma.
      Des schémas de travail distincts doivent être utilisés lors de la connexion de plusieurs sandbox à la même base de données.

    • Options  : le connecteur prend en charge les options présentées dans le tableau ci-dessous.

  6. Sélectionnez l’option Tester la connexion pour vérifier votre configuration.

  7. Cliquez sur le bouton Déployer les fonctions pour créer les fonctions.

  8. Une fois la configuration terminée, cliquez sur Ajouter pour créer votre base de données fédérée.

Le connecteur prend en charge les options suivantes :

Option
Description
NomFuseauHoraire
Vide par défaut. Le serveur applicatif du fuseau horaire est utilisé. Il est possible d’utiliser cette option pour forcer le paramètre de session TIMEZONE.

Databricks databricks

Utilisez des bases de données fédérées pour traiter les informations stockées dans une base de données externe. Suivez les étapes ci-dessous pour configurer l’accès à Databricks.

  1. Dans le menu Données fédérées, sélectionnez Bases de données fédérées.

  2. Cliquez sur Ajouter une base de données fédérée.

  3. Saisissez un nom pour votre base de données fédérée.

  4. Dans la liste déroulante Type, sélectionnez Databricks.

  5. Configurez les paramètres d’authentification de Databricks :

    • Serveur  : ajoutez le nom du serveur Databricks.

    • Chemin HTTP  : ajoutez le chemin à votre cluster ou à votre entrepôt de données. En savoir plus

    • Mot de passe  : ajoutez le jeton d’accès du compte. En savoir plus

    • Catalogue  : ajoutez le champ du catalogue Databricks.

    • Schéma de travail  : nom du schéma de base de données à utiliser pour les tableaux de travail.

      note note
      NOTE
      Vous pouvez utiliser n’importe quel schéma de la base de données, y compris les schémas utilisés pour le traitement temporaire des données, à condition que vous disposiez de l’autorisation requise pour vous connecter à ce schéma.
      Des schémas de travail distincts doivent être utilisés lors de la connexion de plusieurs sandbox à la même base de données.

    • Options  : le connecteur prend en charge les options présentées dans le tableau ci-dessous.

  6. Sélectionnez l’option Tester la connexion pour vérifier votre configuration.

  7. Cliquez sur le bouton Déployer les fonctions pour créer les fonctions.

  8. Une fois la configuration terminée, cliquez sur Ajouter pour créer votre base de données fédérée.

Le connecteur prend en charge les options suivantes :

Option
Description
NomFuseauHoraire
Vide par défaut. Le serveur applicatif du fuseau horaire est utilisé. Il est possible d’utiliser cette option pour forcer le paramètre de session TIMEZONE.
recommendation-more-help
fadff0d9-29d0-4d44-99a6-2499b0b7778b