Configuration de l'accès à BigQuery Google

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
REMARQUE

Le connecteur Google BigQuery est disponible pour les déploiements hybrides et on-premise. Pour plus d'informations à ce sujet, consultez cette page.

BigQuery Google sous Windows

Configuration du pilote sous Windows

  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

REMARQUE

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

Configuration du pilote sous Linux

  1. Avant d'installer le pilote ODBC, vous devez mettre à jour votre système. Sous Linux ou CentOS, exécutez la commande suivante :

    yum update
    # install unixODBC driver manager
    yum install unixODBC
    
  2. Vous devez ensuite installer le gestionnaire de pilotes unixODBC avec la commande suivante :

    # switch to root user
    sudo su
    

    Sous Debian :

    apt-get update
    apt-get upgrade
    # install unixODBC driver manager
    apt-get install unixODBC
    
  3. Téléchargez le pilote ODBC Linux Magnitude Simba (.tar.gz). Ensuite, transférez le fichier tarball vers un dossier temporaire sur votre ordinateur ou utilisez la commande wget :

    # in this example driver version is 2.3.1.1001
    wget https://storage.googleapis.com/simba-bq-release/odbc/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux.tar.gz
    
  4. Extrayez le fichier tarball principal comme suit, où TarballName correspond au nom du package tarball contenant le pilote :

    tar --directory=/tmp -zxvf [TarballName]
    
  5. Accédez au dossier que vous avez extrait et extrayez le fichier tarball interne correspondant à la version du pilote. Installez-le dans un autre dossier temporaire, BigQueryDriver dans l'exemple suivant :

    mkdir /tmp/BigQueryDriver/
    cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
    tar --directory=/tmp/BigQueryDriver/ -zxvf SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version].tar.gz
    
  6. Accédez à l'emplacement temporaire où le fichier tarball principal a été extrait, puis copiez les fichiers GoogleBigQueryODBC.did et setup/simba.googlebigqueryodbc.ini dans le nouveau dossier créé à l'étape précédente :

    cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
    cp GoogleBigQueryODBC.did /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
    cp setup/simba.googlebigqueryodbc.ini /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
    
  7. Créez le répertoire d'installation, comme suit :

    mkdir -p /opt/simba/googlebigqueryodbc/
    
  8. Copiez le contenu du répertoire dans le nouveau répertoire d'installation :

    cp -r /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/* /opt/simba/googlebigqueryodbc/
    
  9. Remplacez <INSTALLDIR> par /opt/simba/googlebigqueryodbc dans simba.googlebigqueryodbc.ini dans le répertoire d'installation :

    cd /opt/simba/googlebigqueryodbc/lib/
    sed -i 's/<INSTALLDIR>/\/opt\/simba\/googlebigqueryodbc/g' simba.googlebigqueryodbc.ini
    
  10. Remplacez DriverManagerEncoding par UTF-16 et SwapFilePath dans simba.googlebigqueryodbc.ini. Si nécessaire, vous pouvez également modifier les paramètres de connexion.

    Voici un exemple de fichier de configuration mis à jour à l'échelle du pilote :

    # /opt/simba/googlebigqueryodbc/lib/simba.googlebigqueryodbc.ini
    [Driver]
    DriverManagerEncoding=UTF-16
    ErrorMessagesPath=opt/simba/googlebigqueryodbc/ErrorMessages
    LogLevel=6
    LogPath=/tmp
    SwapFilePath=/tmp
    
  11. Si vous utilisez un fichier de pilotes système ou un fichier odbcinst.ini actuel, configurez /etc/odbcinst.ini pour qu'il pointe vers l'emplacement du pilote BigQuery Google /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb[Bitness].so.

    Par exemple :

    # /etc/odbcinst.ini
    # Make sure to use Simba ODBC Driver for Google BigQuery as a driver name.
    
    [ODBC Drivers]
    Simba ODBC Driver for Google BigQuery=Installed
    
    [Simba ODBC Driver for Google BigQuery]
    Description=Simba ODBC Driver for Google BigQuery(64-bit)
    Driver=/opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    
  12. Recherchez l'emplacement des bibliothèques du gestionnaire de pilotes unixODBC et ajoutez les chemins d'accès aux bibliothèques unixODBC et googlebigqueryodbc à la variable LD_LIBRARY_PATH environment.

    find / -name 'lib*odbc*.so*' -print
    #output:
    /usr/lib/x86_64-linux-gnu/libodbccr.so.2
    /usr/lib/x86_64-linux-gnu/libodbcinst.so.2.0.0
    /usr/lib/x86_64-linux-gnu/libodbccr.so.1
    .
    .
    /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    
    #the command would look like this
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/simba/googlebigqueryodbc:/usr/lib
    
  13. 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 Linux

REMARQUE

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 Linux 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. Si vous souhaitez éviter d'utiliser la variable PATH ou de déplacer le répertoire google-cloud-sdk vers un autre emplacement, utilisez la valeur de l'option bqpath lors de la configuration du Compte externe pour spécifier le chemin exact vers le répertoire bin de votre système.

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

Compte externe BigQuery Google

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 '>' Plate-forme '>' 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.

Sur cette page