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.
Le connecteur Google BigQuery est disponible pour les déploiements hébergés, hybrides et on-premise. Pour plus dʼinformations, consultez cette page.
Téléchargez le pilote ODBC pour Windows.
Configurez le pilote ODBC sous Windows. Pour plus d'informations à ce sujet, consultez cette page.
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.
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.
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.
Téléchargez l'archive Windows 64 bits (x86_64) à partir de cette page et extrayez-la dans le répertoire correspondant.
Exécutez le script google-cloud-sdk\install.sh
. Vous devez accepter le paramètre de variable de chemin.
Après l'installation, vérifiez que la variable de chemin ...\google-cloud-sdk\bin
est définie. Sinon, ajoutez-la manuellement.
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 :
Redémarrez Adobe Campaign Classic pour que les modifications soient prises en compte.
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 :
Avant d’installer ODBC, vérifiez que les packages suivants sont installés sur votre distribution Linux :
Pour Red Hat/CentOS :
yum update
yum upgrade
yum install -y grep sed tar wget perl curl
Sous Debian :
apt-get update
apt-get upgrade
apt-get install -y grep sed tar wget perl curl
Mise à jour du système avant installation :
Pour Red Hat/CentOS :
# install unixODBC driver manager
yum install -y unixODBC
Sous Debian :
# install unixODBC driver manager
apt-get install -y odbcinst1debian2 libodbc1 odbcinst unixodbc
Avant d’exécuter le script, vous pouvez obtenir plus d’informations en spécifiant « --help argument: ».
cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh --help
Accédez au répertoire où se trouve le script et exécutez le script suivant en tant qu’utilisateur ou utilisatrice racine :
cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh
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.
Avant d’installer ODBC, vérifiez que les packages suivants sont installés sur votre distribution Linux :
Pour Red Hat/CentOS :
yum update
yum upgrade
yum install -y python3
Sous Debian :
apt-get update
apt-get upgrade
apt-get install -y python3
Accédez au répertoire où se trouve le script et exécutez le script suivant :
cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_sdk-setup.sh
Vous devez créer un compte externe Google BigQuery pour connecter votre instance Adobe Campaign Classic à votre base de données Google BigQuery externe.
Dans l'Explorateur Adobe Campaign Classic, cliquez sur Administration '>' Plateforme '>' Comptes externes.
Cliquez sur Nouveau.
Sélectionnez Base de données externe en tant que Type de compte externe.
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. |