Configurare l'accesso all'Azure synapse

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

  1. Configura Azure synapse su CentOS, Windows o Debian
  2. Configura l’Azure synapse account esterno in Campaign

azure synapse su CentOS

ATTENZIONE
  • Per installare un driver ODBC, è necessario disporre dei privilegi di radice.
  • I driver ODBC Red Hat Enterprise forniti da Microsoft possono essere utilizzati anche con CentOS per connettersi a SQL Server.
  • La versione 13.0 funzionerà con Red Hat 6 e 7.

Per configurare l’Azure synapse su CentOS, segui i passaggi seguenti:

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

    NOTA

    Questa versione è esclusiva 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 unixODBC eseguendo il seguente comando:

    sudo yum install unixODBC-devel
    
  3. Dopo aver installato i driver, è possibile testare e verificare il driver ODBC ed eseguire query sul database, se necessario. Esegui 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 su come configurare l'account esterno, consulta 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 dal lato di Azure synapse Analytics, potrebbe essere necessario aggiungere l’IP pubblico all’inserire nell'elenco Consentiti. A tale scopo, consulta la documentazione di Azure.

  6. In caso di tabelle, esegui il comando seguente:

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

azure synapse su Windows

NOTA

Questa versione è esclusiva della versione 13 del driver ODBC, ma Adobe Campaign Classic può anche utilizzare i driver del client nativo di SQL Server 11.0 e 10.0.

Per configurare l'Azure synapse su Windows:

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

  2. Scegliere 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 l’account esterno Azure Synapse. Per ulteriori informazioni su come configurare l'account esterno, consulta questa sezione.

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

azure synapse su Debian

Prerequisiti:

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

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

    sudo apt-get install curl
    

Per configurare l'Azure synapse su Debian:

  1. Innanzitutto, installare il driver Microsoft ODBC per SQL Server. Utilizzare i seguenti comandi 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 ottieni il seguente errore "Impossibile trovare il driver del metodo /usr/lib/apt/methods/https" quando chiami sudo apt-get update, esegui 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 serie (o BCP) e per eseguire le 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 unixODBC eseguendo il seguente comando:

    sudo yum install unixODBC-devel
    
  5. Dopo aver installato i driver, è possibile testare e verificare il driver ODBC ed eseguire query sul database, se necessario. Esegui 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 possibile configurare l’account esterno Azure Synapse. Per ulteriori informazioni su come configurare l'account esterno, consulta questa sezione.

  7. Per configurare le tabelle IP 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 dal lato di Azure synapse Analytics, potrebbe essere necessario aggiungere l’IP pubblico all’inserire nell'elenco Consentiti. A tale scopo, consulta la documentazione di Azure.

azure synapse account esterno

L’account esterno Azure Synapse ti consente di collegare l’istanza Campaign al database esterno dell’Azure synapse.

Per creare l’account esterno Azure Synapse, effettua le seguenti operazioni:

  1. Dalla campagna Explorer, fai clic su Administration '>' Platform '>' External accounts.

  2. Fai clic su New.

  3. Seleziona External database come account esterno Type.

  4. Configura l’account esterno Azure Synapse , devi specificare:

    • Type: azure synapse Analytics

    • Server: URL del server di Azure synapse

    • Account: Nome dell’utente

    • Password: Password account utente

    • Database: Nome del database

In questa pagina