DocumentationCampaignDocumentation de Campaign Classic v7

Configuration de l'accès à BigQuery Google configure-fda-google-big-query

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Utilisez l'option Adobe Campaign Classic Federated Data Access (FDA) pour traiter les informations stockées dans une base de données externe. Suivez les étapes ci-dessous pour Configuration de l'accès à Google BigQuery.

  1. Configuration de Google BigQuery sous Windows ou Linux
  2. Configuration du compte externe Google BigQuery dans Adobe Campaign Classic
  3. Configuration du chargement en masse du connecteur Google BigQuery sous Windows ou Linux
NOTE
Le connecteur Google BigQuery est disponible pour les déploiements hébergés, hybrides et on-premise. Pour plus dʼinformations, consultez cette page.

BigQuery Google sous Windows google-windows

Configuration du pilote sous Windows driver-window

  1. Téléchargez le pilote ODBC pour Windows.

  2. Configurez le pilote ODBC sous Windows. Pour plus d'informations à ce sujet, consultez cette page.

  3. Pour que le connecteur Google BigQuery fonctionne, Adobe Campaign Classic requiert les paramètres de connexion suivants :

    • Projet  : permet de créer ou utiliser un projet existant.

      Pour plus d'informations, consultez cette page.

    • Compte Service  : permet de créer un compte de service.

      Pour plus d'informations, consultez cette page.

    • Chemin d'accès au fichier de clé  : le compte Service nécessite un fichier de clé pour une connexion Google BigQuery via ODBC.

      Pour plus d'informations, consultez cette page.

    • Jeu de données  : le jeu de données est facultatif pour une connexion ODBC. Comme chaque requête doit fournir le jeu de données dans lequel se trouve la table, la spécification d'un jeu de données est obligatoire pour le connecteur FDA Google BigQuery dans Adobe Campaign Classic.

      Pour plus d'informations, consultez cette page.

  4. Dans Adobe Campaign Classic, vous pouvez ensuite configurer votre compte externe Google BigQuery. Pour plus d'informations sur la configuration de votre compte externe, voir cette section.

Configuration du chargement en masse sous Windows bulk-load-window

NOTE
Pour que le SDK Google Cloud fonctionne, vous devez installer Python.
Nous vous recommandons d'utiliser Python3 ; voir cette page.

L'utilitaire de chargement en masse permet un transfert plus rapide grâce au SDK Google Cloud.

  1. Téléchargez l'archive Windows 64 bits (x86_64) à partir de cette page et extrayez-la dans le répertoire correspondant.

  2. Exécutez le script google-cloud-sdk\install.sh. Vous devez accepter le paramètre de variable de chemin.

  3. Après l'installation, vérifiez que la variable de chemin ...\google-cloud-sdk\bin est définie. Sinon, ajoutez-la manuellement.

  4. Dans le fichier ..\google-cloud-sdk\bin\bq.cmd, ajoutez la variable locale CLOUDSDK_PYTHON, qui redirigera vers l'emplacement de l'installation Python.

    Par exemple :

  5. Redémarrez Adobe Campaign Classic pour que les modifications soient prises en compte.

BigQuery Google sous Linux google-linux

Configuration du pilote sous Linux driver-linux

Avant de configurer le pilote, notez que le script et les commandes doivent être exécutés par l’utilisateur racine. Il est également recommandé d’utiliser Google DNS 8.8.8.8 lors de l’exécution du script.

Pour effectuer la configuration de Google BigQuery sur Linux, procédez comme suit :

  1. Avant d’installer ODBC, vérifiez que les packages suivants sont installés sur votre distribution Linux :

    • Pour Red Hat/CentOS :

      code language-none 
      yum update
yum upgrade
yum install -y grep sed tar wget perl curl

    • Sous Debian :

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y grep sed tar wget perl curl

  2. Mise à jour du système avant installation :

    • Pour Red Hat/CentOS :

      code language-none 
      # install unixODBC driver manager
yum install -y unixODBC

    • Sous Debian :

      code language-none 
      # install unixODBC driver manager
apt-get install -y odbcinst1debian2 libodbc1 odbcinst unixodbc

  3. Avant d’exécuter le script, vous pouvez obtenir plus d’informations en spécifiant « --help argument: ».

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh --help

  4. Accédez au répertoire où se trouve le script et exécutez le script suivant en tant qu’utilisateur ou utilisatrice racine :

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh

Configuration du chargement en masse sous Linux bulk-load-linux

NOTE
Pour que le SDK Google Cloud fonctionne, vous devez installer Python.
Nous vous recommandons d'utiliser Python3 ; voir cette page.

L'utilitaire de chargement en masse permet un transfert plus rapide grâce au SDK Google Cloud.

  1. Avant d’installer ODBC, vérifiez que les packages suivants sont installés sur votre distribution Linux :

    • Pour Red Hat/CentOS :

      code language-none 
      yum update
yum upgrade
yum install -y python3

    • Sous Debian :

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y python3

  2. Accédez au répertoire où se trouve le script et exécutez le script suivant :

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_sdk-setup.sh

Compte externe BigQuery Google google-external

Vous devez créer un compte externe Google BigQuery pour connecter votre instance Adobe Campaign Classic à votre base de données Google BigQuery externe.

  1. Dans l'Explorateur Adobe Campaign Classic, cliquez sur Administration '>' Plateforme '>' Comptes externes.

  2. Cliquez sur Nouveau.

  3. Sélectionnez Base de données externe en tant que Type de compte externe.

  4. Configurez le compte externe Google BigQuery. Vous devez indiquer les informations suivantes :

    • Type: Google BigQuery

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

    • Projet  : nom de votre projet. Pour plus d'informations à ce propos, consultez la documentation Google Cloud.

    • Chemin d'accès au fichier de clé  :

      • Télécharger le fichier de clé sur le serveur  : sélectionnez Cliquer ici pour effectuer le téléchargement si vous choisissez de télécharger la clé via Adobe Campaign Classic.

      • Saisir manuellement le chemin d'accès au fichier de clé  : copiez/collez votre chemin absolu dans ce champ si vous choisissez d'utiliser une clé préexistante.

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

Le connecteur prend en charge les options suivantes :

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.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1