Configuration de l'accès à Azure Synapse configure-access-to-azure-synapse

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

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]

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

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"

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.

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

Dans le cas des iptables, exécutez la commande suivante :

iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT

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

Choisissez les fichiers suivants à installer :

your_language\your_architecture\msodbcsql.msi (i.e: English\X64\msodbcsql.msi)

Une fois votre pilote ODBC installé, vous pouvez le tester, si nécessaire. Pour plus d’informations à ce propos, consultez cette page.

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.

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.

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

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

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

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

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"

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.

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

Dans l’Explorateur Campaign, cliquez sur Administration '>' Plateforme '>' Comptes externes.

Cliquez sur Nouveau.

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

Sous Configuration, sélectionnez Azure Synapse Analytics dans la liste déroulante Type.

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

  

Cliquez sur Enregistrer.