Configurare l'accesso Azure synapse

Utilizzate l'opzione Campaign Federated Data Access (FDA) per elaborare le informazioni memorizzate in un database esterno. Seguite i passaggi riportati di seguito per configurare l'accesso a Microsoft Azure synapse Analytics.

1. Configurare Azure synapse su CentOS, Windows o Debian
2. Configurare account Azure synapse esterno in Campaign

Azure synapse su CentOS

Per configurare Azure synapse su CentOS, attenetevi alla procedura seguente:

1. Innanzitutto, installare il driver ODBC. È possibile trovarlo in questa pagina.

   NOTA

   Questo è esclusivo della versione 13 del driver 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. Se necessario, è possibile installare intestazioni di sviluppo univxODBC eseguendo il comando seguente:

   sudo yum install unixODBC-devel
   

3. Dopo aver installato i driver, è possibile verificare e verificare il driver ODBC ed eseguire una query sul database, se necessario. Eseguite il comando seguente:

   /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1"
   

4. In Campaign, puoi quindi configurare il tuo account esterno Azure Synapse. Per ulteriori informazioni sulla configurazione dell'account esterno, consultare questa sezione.

5. Poiché Azure synapse Analytics comunica attraverso la porta TCP 1433, è necessario aprire questa porta sul firewall. Usa il comando seguente:

   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
   

   NOTA

   Per consentire la comunicazione da lato di Azure synapse Analytics, potrebbe essere necessario aggiungere l'IP pubblico al inserire nell'elenco Consentiti di . A tal fine, fare riferimento alla documentazione di Azure.

6. Nel caso di iptables, eseguire il comando seguente:

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

Azure synapse in Windows

Per configurare Azure synapse in Windows:

1. Innanzitutto, installare il driver Microsoft ODBC. È possibile trovarlo in questa pagina.

2. Scegliete i file seguenti da installare:

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

3. Una volta installato il driver ODBC, è possibile verificarlo se necessario. Per ulteriori informazioni, consulta questa pagina.

4. In Campaign Classic, puoi quindi configurare il tuo account esterno Azure Synapse. Per ulteriori informazioni sulla configurazione dell'account esterno, consultare questa sezione.

5. Poiché Azure synapse Analytics comunica attraverso la porta TCP 1433, è necessario aprire questa porta su Windows Defender Firewall. Per ulteriori informazioni, consultare la documentazione di Windows.

Azure synapse su Debian

Prerequisiti:

• Per installare un driver ODBC è necessario disporre dei privilegi di root.

• Curl è necessario per installare il pacchetto msobcsql. Se non è installato, eseguite il comando seguente:

  sudo apt-get install curl
  

Per configurare Azure synapse su Debian:

1. Innanzitutto, installate il driver Microsoft ODBC per SQL Server. Utilizzare i comandi seguenti per installare ODBC Driver 13.1 per 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. Se viene visualizzato il seguente errore "Impossibile trovare il driver del metodo /usr/lib/apt/methods/https" durante la chiamata a sudo apt-get update, eseguire il comando:

   sudo apt-get install apt-transport-https ca-certificates
   

3. È ora necessario installare mssql-tools con i seguenti comandi. Gli strumenti Mssq sono necessari per utilizzare l'utilità del programma di copia in blocco (o BCP) e per eseguire query.

   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. Se necessario, è possibile installare intestazioni di sviluppo univxODBC eseguendo il comando seguente:

   sudo yum install unixODBC-devel
   

5. Dopo aver installato i driver, è possibile verificare e verificare il driver ODBC ed eseguire una query sul database, se necessario. Eseguite il comando seguente:

   /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1"
   

6. In Campaign Classic, ora puoi configurare il tuo account esterno Azure Synapse. Per ulteriori informazioni sulla configurazione dell'account esterno, consultare questa sezione.

7. Per configurare iptables su Debian per garantire la connessione con Azure synapse Analytics, abilita la porta TCP 1433 in uscita per il tuo nome host con il seguente comando:

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

   NOTA

   Per consentire la comunicazione da lato di Azure synapse Analytics, potrebbe essere necessario aggiungere l'IP pubblico al inserire nell'elenco Consentiti di . A tal fine, fare riferimento alla documentazione di Azure.

account esterno Azure synapse

L'account esterno Azure Synapse consente di collegare l'istanza Campaign al database esterno Azure synapse.

Per creare un account esterno Azure Synapse, procedere come segue:

1. Da Campaign Explorer, fare clic su Administration '>' Platform '>' External accounts.

2. Fai clic su New.

3. Selezionare External database come account esterno Type.

   

4. Configurate l'account esterno Azure Synapse, dovete specificare:

   • Type: Azure synapse Analytics

   • Server: URL del server Azure synapse

   • Account: Nome dell’utente

   • Password: Password account utente

   • Database: Nome del database