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

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

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

NOTA

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

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

In questa pagina