Show Menu
SUJETS×

Configuration des connecteurs FDA

En fonction des bases de données externes auxquelles vous souhaitez pouvoir accéder depuis Adobe Campaign, certains paramétrages spécifiques sont nécessaires. Ces paramétrages concernent essentiellement l’installation de pilotes et la déclarations de variables d’environnement propres à chaque SGBDR sur le serveur Adobe Campaign.
Pour plus d’informations sur les connecteurs hérités tels que Teradata, Hadoop 2.1 ou Netezza, consultez cette page .
En règle générale, il est nécessaire d’installer la couche cliente correspondant à la base de données externe utilisée sur le serveur Adobe Campaign.
Les versions compatibles sont répertoriées dans la Matrice de compatibilité Campaign .

Configurer l’accès à Azure Synapse

Compte externe Azure Synapse

Le compte externe Azure vous permet de connecter l’instance Campaign à la base de données externe Azure Synapse. Pour créer votre compte externe Azure Synapse :
  1. Dans Campaign Classic, configurez votre compte externe Azure Synapse. Dans l’ Explorateur , 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 Azure Synapse. Vous devez indiquer les informations suivantes :
    • Type  : Azure Synapse Analytics
    • Serveur  : URL du serveur Azure Synapse
    • Compte  : nom de l’utilisateur
    • Mot de passe  : mot de passe du compte utilisateur
    • Base de données  : nom de la base de données

Azure Synapse sous CentOS

Prérequis:
  • Vous aurez besoin des privilèges racine pour installer un pilote ODBC.
  • Les pilotes ODBC Red Hat Enterprise fournis par Microsoft peuvent également être utilisés avec CentOS pour se connecter à SQL Server.
  • La version 13.0 fonctionnera avec Red Hat 6 et 7.
Pour configurer Azure Synapse sous CentOS :
  1. Installez tout d’abord le pilote ODBC. Vous pouvez le trouver sur cette page .
    Il s’agit uniquement de la version 13 du pilote ODBC.
    sudo su
    curl https://packages.microsoft.com/config/rhel/6/prod.repo > /etc/yum.repos.d/mssql-release.repo
    exit
    # Uninstall if already installed Unix ODBC driver
    sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
    
    sudo ACCEPT_EULA=Y yum install msodbcsql
    
    sudo ACCEPT_EULA=Y yum install mssql-tools
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
    source ~/.bashrc
    
    # the Microsoft driver expects unixODBC to be here /usr/lib64/libodbc.so.1, so add soft links to the '.so.2' files
    cd /usr/lib64
    sudo ln -s libodbccr.so.2   libodbccr.so.1
    sudo ln -s libodbcinst.so.2 libodbcinst.so.1
    sudo ln -s libodbc.so.2     libodbc.so.1
    
    # Set the path for unixODBC
    export ODBCINI=/usr/local/etc/odbc.ini
    export ODBCSYSINI=/usr/local/etc
    source ~/.bashrc
    
    #Add a DSN information to /etc/odbc.ini
    sudo vi /etc/odbc.ini
    
    #Add the following:
    [Azure Synapse Analytics]
    Driver      = ODBC Driver 13 for SQL Server
    Description = Azure Synapse Analytics DSN
    Trace       = No
    Server      = [insert your server here]
    
    
  2. Si nécessaire, vous pouvez installer les en-têtes de développement unixODBC en exécutant la commande suivante :
    sudo yum install unixODBC-devel
    
    
  3. Après avoir installé les pilotes, vous pouvez tester et vérifier votre pilote ODBC, et interroger votre base de données, si nécessaire. Exécutez la commande suivante :
    /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1"
    
    
  4. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Azure Synapse. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .
  5. Comme Azure Synapse Analytics communique par le biais du port TCP 1433, vous devez l’ouvrir sur votre pare-feu. Utilisez la commande suivante :
    firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="[server_ip_here]/32" port port="1433" protocol="tcp" accept'
    # you can ping your hostname and the ping command will translate the hostname to IP address which you can use here
    
    
    Pour autoriser la communication du côté d'Azure Synapse Analytics, vous devrez peut-être ajouter votre adresse IP publique à la liste autorisée. Pour ce faire, voir la documentation Azure .
  6. Dans le cas des iptables, exécutez la commande suivante :
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    
    

Azure Synapse sous Windows

Il s’agit uniquement de la version 13 du pilote ODBC, mais Adobe Campaign Classic peut également utiliser les pilotes SQL Server Native Client 11.0 et 10.0.
Pour configurer Azure Synapse sous Windows :
  1. Installez tout d’abord le pilote ODBC Microsoft. Vous pouvez le trouver sur cette page .
  2. Choisissez les fichiers suivants à installer :
    your_language\your_architecture\msodbcsql.msi (i.e: English\X64\msodbcsql.msi)
    
    
  3. Une fois votre pilote ODBC installé, vous pouvez le tester, si nécessaire. Pour plus d’informations à ce propos, consultez cette page .
  4. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Azure Synapse. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .
  5. Comme Azure Synapse Analytics communique par le biais du port TCP 1433, vous devez ouvrir ce port sur le pare-feu Windows Defender. Pour plus d’informations à ce propos, consultez la documentation Windows .

Azure Synapse sous Debian

Prérequis:
  • Vous aurez besoin des privilèges racine pour installer un pilote ODBC.
  • Curl est nécessaire pour installer le package msodbcsql. Si vous ne l’avez pas installé, exécutez la commande suivante :
    sudo apt-get install curl
    
    
Pour configurer Azure Synapse sous Debian :
  1. Installez tout d’abord le pilote ODBC Microsoft pour SQL Server. Utilisez les commandes suivantes pour installer le pilote ODBC 13.1 for SQL Server :
    sudo su
    curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
    curl https://packages.microsoft.com/config/debian/8/prod.list > /etc/apt/sources.list.d/mssql-release.list
    exit
    sudo apt-get update
    sudo ACCEPT_EULA=Y apt-get install msodbcsql
    
    
  2. Si vous obtenez l’erreur suivante « The method driver /usr/lib/apt/methods/https could not be found » lors de l’appel de la commande sudo apt-get update , exécutez la commande :
    sudo apt-get install apt-transport-https ca-certificates
    
    
  3. Vous devez maintenant installer mssql-tools à l’aide des commandes suivantes. Les outils Mssq sont nécessaires pour exploiter l’utilitaire BCP (programme de copie en masse) et pour exécuter des requêtes.
    sudo ACCEPT_EULA=Y apt-get install mssql-tools
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
    source ~/.bashrc
    
    
  4. Si nécessaire, vous pouvez installer les en-têtes de développement unixODBC en exécutant la commande suivante :
    sudo yum install unixODBC-devel
    
    
  5. Après avoir installé les pilotes, vous pouvez tester et vérifier votre pilote ODBC, et interroger votre base de données, si nécessaire. Exécutez la commande suivante :
    /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1"
    
    
  6. Dans Campaign Classic, vous pouvez maintenant configurer votre compte externe Azure Synapse. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .
  7. Pour configurer les iptables sous Debian afin d’assurer la connexion avec Azure Synapse Analytics, activez le port TCP 1433 sortant pour votre hostname à l’aide de la commande suivante :
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    
    
    Pour autoriser la communication du côté d'Azure Synapse Analytics, vous devrez peut-être ajouter votre adresse IP publique à la liste autorisée. Pour ce faire, voir la documentation Azure .

Configurer l’accès à Snowflake

Le connecteur Snowflake est disponible pour les déploiements hébergés et on-premise. Voir à ce propos cette page .

Compte externe Snowflake

Le compte externe Snowflake vous permet de connecter l’instance Campaign à la base de données externe Snowflake.
  1. Dans Campaign Classic, configurez votre compte externe Snowflake. Dans l’ Explorateur , 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. Pour configurer le compte externe Snowflake , vous devez indiquer les informations suivantes :
    • Type : Snowflake
    • Serveur  : URL du serveur Snowflake
    • Compte  : nom de l’utilisateur
    • Mot de passe  : mot de passe du compte utilisateur
    • Base de données  : nom de la base de données
  5. Cliquez sur l’onglet Paramètres , puis sur le bouton Déployer les fonctions pour créer des fonctions.
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.
TimeZoneName
Vide par défaut. C’est le fuseau horaire système du serveur applicatif Campaign Classic qui est utilisé. Il est possible d’utiliser cette option pour forcer le paramètre de session TIMEZONE.
Pour plus d’informations à ce sujet, consultez cette page .
WeekStart
Paramètre de session WEEK_START. Par défaut, cette valeur est définie sur 0.
Pour plus d’informations à ce sujet, consultez cette page .
UseCachedResult
Paramètre de session USE_CACHED_RESULTS. Par défaut, cette valeur est définie sur TRUE. Il est possible d’utiliser cette option pour désactiver les résultats de Snowflake mis en mémoire cache.
Pour plus d’informations à ce sujet, voir cette page .

Snowflake sous CentOS

  1. Téléchargez les pilotes ODBC pour Snowflake. Cliquez ici pour lancer le téléchargement.
  2. Vous devez ensuite installer les pilotes ODBC sur CentOs à l’aide de la commande suivante :
    rpm -Uvh unixodbc
    rpm -Uvh snowflake-odbc-2.20.2.x86_64.rpm
    
    
  3. Après avoir téléchargé et installé les pilotes ODBC, vous devez redémarrer Campaign Classic. Pour cela, exécutez la commande suivante :
    /etc/init.d/nlserver6 stop
    /etc/init.d/nlserver6 start
    
    
  4. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Snowflake. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .

Snowflake sous Debian

  1. Téléchargez les pilotes ODBC pour Snowflake. Cliquez ici pour lancer le téléchargement.
  2. Vous devez ensuite installer les pilotes ODBC sous Debian à l’aide de la commande suivante :
    apt-get install unixodbc
    apt-get install snowflake-odbc-x.xx.x.x86_64.deb
    
    
  3. Après avoir téléchargé et installé les pilotes ODBC, vous devez redémarrer Campaign Classic. Pour cela, exécutez la commande suivante :
    systemctl stop nlserver.service
    systemctl start nlserver.service
    
    
  4. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Snowflake. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .

Snowflake sous Windows

  1. Téléchargez le pilote ODBC pour Windows . Notez la nécessité de disposer de privilèges de niveau administrateur pour installer le pilote. Voir à ce propos cette page
  2. Configurez le pilote ODBC. Voir à ce propos cette page
  3. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Snowflake. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .

Configurer l’accès à Hadoop 3.0

Compte externe Hadoop

Le compte externe Hadoop vous permet de connecter votre instance Campaign à votre base de données externe Hadoop.
  1. Dans Campaign Classic, configurez votre compte externe Hadoop. Dans l’ Explorateur , 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. Pour configuer le compte externe Hadoop , vous devez indiquer les informations suivantes :
    • Type  : ODBC (Sybase ASE, Sybase IQ)
    • Serveur  : nom du DNS
    • Compte  : nom de l’utilisateur
    • Mot de passe  : mot de passe du compte utilisateur
    • 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
    • Fuseau horaire  : fuseau horaire du serveur
Le connecteur prend en charge les options ODBC suivantes :
Nom
Valeur
ODBCMgr
iODBC
warehouse
1/2/4
Le connecteur prend également en charge les options Hive suivantes :
Nom
Valeur
Description
bulkKey
Clé d’accès Azure Blob ou DataLake.
Pour les chargeurs en masse wasb:// ou wasbs:// (c.-à-d. si l’outil de chargement en masse a pour préfixe wasb:// ou wasbs://).
Il s’agit de la clé d’accès pour le compartiment de blob ou de DataLake servant au chargement en masse.
hdfsPort
Numéro de port
défini par défaut sur 8020
Pour le chargement HDFS en masse (c.-à-d. si l’outil de chargement en masse a pour préfixe webhdfs:// ou webhdfss://).
bucketsNumber
20
Nombre de compartiments lors de la création d’une table regroupée.
fileFormat
PARQUET
Format de fichier par défaut pour les tables de travail.

Configuration de Hadoop 3.0

La connexion à une base de données externe Hadoop dans FDA requiert les paramétrages suivants sur le serveur Adobe Campaign. Notez que cette configuration est possible pour Windows et Linux.
  1. Téléchargez les pilotes ODBC pour Hadoop en fonction de votre version de système d’exploitation. Les pilotes se trouvent dans cette page .
  2. Vous devez ensuite installer les pilotes ODBC et créer un DSN pour votre connexion Hive. Les instructions se trouvent dans cette page
  3. Après avoir téléchargé et installé les pilotes ODBC, vous devez redémarrer Campaign Classic. Pour cela, exécutez la commande suivante :
    systemctl stop nlserver.service
    systemctl start nlserver.service
    
    
  4. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Hadoop. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .

Configurer l’accès à Oracle

Compte externe Oracle

Le compte externe Oracle vous permet de connecter votre instance Campaign à votre base de données externe Hadoop.
  1. Dans Campaign Classic, configurez votre compte externe oracle. Dans l’ Explorateur , 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. Pour configurer le compte externe Oracle , vous devez indiquer les informations suivantes :
    • Type  : Oracle
    • Serveur  : nom du DNS
    • Compte  : nom de l’utilisateur
    • Mot de passe  : mot de passe du compte utilisateur
    • Fuseau horaire  : fuseau horaire du serveur

Oracle sous Linux

La connexion à une base de données externe Oracle en FDA requiert les paramétrages additionnels ci-dessous sur le serveur Adobe Campaign.
  1. Installez le client complet Oracle correspondant à votre version d’Oracle.
  2. Ajoutez vos définitions TNS à votre installation. Pour cela, indiquez-les dans un fichier tnsnames.ora dans le répertoire /etc/oracle. Si ce répertoire n’existe pas, créez-le.
    Créez alors une nouvelle variable d’environnement TNS_ADMIN : export TNS_ADMIN=/etc/oracle et redémarrez la machine.
  3. Intégrez Oracle à votre serveur Adobe Campaign (nlserver). Pour cela, vérifiez que le fichier customer.sh est bien présent dans le dossier "nl6" de l’arborescence du serveur Adobe Campaign et que ce dernier comprend bien les liens vers les bibliothèques Oracle.
    Par exemple pour un client 11.2 :
    export ORACLE_HOME=/usr/lib/oracle/11.2
    export TNS_ADMIN=/etc/oracle
    export LD_LIBRARY_PATH=$ORACLE_HOME/client64/lib:$LD_LIBRARY_PATH
    
    
    Ces valeurs (notamment ORACLE_HOME), dépendent de vos répertoires d’installation. Vérifiez bien votre arborescence avant de référencer ces valeurs.
  4. Installez les librairies nécessaires à Oracle :
    • libclntsh.so
      cd /usr/lib/oracle/<version>/client<architecture>/lib
      ln -s libclntsh.so.<version> libclntsh.so
      
      
    • libaio1
      aptitude install libaio1
      or
      yum install libaio1
      
      
  5. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Oracle. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .

Oracle sous Windows

La connexion à une base de données externe Oracle en FDA requiert les paramétrages additionnels ci-dessous sur le serveur Adobe Campaign.
  1. Installez le client Oracle.
  2. Dans le dossier C:Oracle, créez un fichier tnsnames.ora contenant vos définitions TNS.
  3. Ajoutez une variable d’environnement TNS_ADMIN avec pour valeur C:Oracle et redémarrez la machine.
  4. Dans Campaign Classic, vous pouvez ensuite configurer votre compte externe Oracle. Pour plus d’informations sur la configuration de votre compte externe, voir cette section .