v7

Configuration de l'accès à Azure Synapse

Utilisez l’option Campaign Federated Data Access (FDA) pour traiter les informations stockées dans des bases de données externes. Suivez les étapes ci-dessous pour configurer l’accès à Microsoft Azure Synapse Analytics.

1. Configuration d’Azure synapse sur CentOS, Windows ou Debian
2. Configuration du compte externe Azure Synapse dans Campaign

Azure Synapse sous CentOS

Pour configurer Azure Synapse sur CentOS, procédez comme suit :

1. Installez tout d’abord le pilote ODBC. Vous pouvez le trouver sur cette page.

   REMARQUE

   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 , 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
   

   REMARQUE

   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

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

Conditions préalables requises:

• 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
   

   REMARQUE

   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.

Compte externe Azure Synapse

Le compte externe Azure Synapse vous permet de connecter l’instance Campaign à la base de données externe Azure Synapse.

Pour créer votre compte externe Azure Synapse, procédez comme suit :

1. Dans l’Explorateur Campaign, 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. Sous Configuration, sélectionnez Azure Synapse Analytics dans la liste déroulante Type.

   

5. Configuration du compte externe Azure Synapse :

   • Pour l’authentification standard, vous devez indiquer les informations suivantes :

     • Serveur : URL du serveur Azure Synapse

     • Compte : nom de l'utilisateur

     • Mot de passe : mot de passe du compte d’utilisateur

     • Base de données : nom de la base de données

     

   • Pour l’authentification d’identité gérée par le système, vous devez indiquer les informations suivantes :

     • Serveur : URL du serveur Azure Synapse

     • Base de données : nom de la base de données

     • Options : ajoutez la syntaxe suivante Authentication=ActiveDirectoryMsi

     

6. Cliquez sur Enregistrer.

Le connecteur prend en charge les options suivantes :