Configurare l’accesso all’Azure synapse configure-access-to-azure-synapse

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

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

Azure synapse su CentOS azure-centos

CAUTION
  • Per installare un driver ODBC sono necessari i privilegi radice.
  • I driver ODBC Red Hat Enterprise forniti da Microsoft possono essere utilizzati anche con CentOS per la connessione a SQL Server.
  • La versione 13.0 funziona con Red Hat 6 e 7.

Per configurare l’Azure synapse su CentOS, effettua le seguenti operazioni:

  1. Installare innanzitutto il driver ODBC. Puoi trovarlo in questa pagina.

    note note
    NOTE
    Questo è esclusivo per la versione 13 del driver ODBC.
    code language-none
    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 le intestazioni di sviluppo unixODBC eseguendo il comando seguente:

    code language-none
    sudo yum install unixODBC-devel
    
  3. Dopo aver installato i driver, è possibile testare e verificare il driver ODBC ed eseguire una query sul database, se necessario. Esegui il comando seguente:

    code language-none
    /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 l'account esterno Azure Synapse. Per ulteriori informazioni su come configurare l'account esterno, consulta questa sezione.

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

    code language-none
    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
    
    note note
    NOTE
    Per consentire la comunicazione dal lato di Analytics per l’Azure synapse, potrebbe essere necessario aggiungere l’IP pubblico al inserisco nell'elenco Consentiti di. A tale scopo, fare riferimento alla documentazione di Azure.
  6. Nel caso di iptables, esegui il seguente comando:

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

Azure synapse su Windows azure-windows

NOTE
Questo è esclusivo per la 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 l'Azure synapse su Windows:

  1. Installare innanzitutto il driver ODBC di Microsoft. Puoi trovarlo in questa pagina.

  2. Scegliere i seguenti file da installare:

    code language-none
    your_language\your_architecture\msodbcsql.msi (i.e: English\X64\msodbcsql.msi)
    
  3. Una volta installato il driver ODBC, è possibile eseguirne il test, 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é Analytics di Azure synapse comunica tramite la porta TCP 1433, è necessario aprire questa porta in Windows Defender Firewall. Per ulteriori informazioni, consulta Documentazione di Windows.

Azure synapse su Debian azure-debian

Prerequisiti:

  • Per installare un driver ODBC sono necessari i privilegi radice.

  • Per installare il pacchetto msodbcsql è necessario Curl. Se non è installato, eseguire il comando seguente:

    code language-none
    sudo apt-get install curl
    

Per configurare l’Azure synapse su Debian:

  1. Installare innanzitutto il driver ODBC di Microsoft per SQL Server. Utilizzare i comandi seguenti per installare il driver ODBC 13.1 per SQL Server:

    code language-none
    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 si verifica l'errore seguente "Impossibile trovare il driver di metodo /usr/lib/apt/methods/https" durante la chiamata all'aggiornamento sudo apt-get, eseguire il comando:

    code language-none
    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à BCP (Bulk Copy Program) e per eseguire le query.

    code language-none
    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 le intestazioni di sviluppo unixODBC eseguendo il comando seguente:

    code language-none
    sudo yum install unixODBC-devel
    
  5. Dopo aver installato i driver, è possibile testare e verificare il driver ODBC ed eseguire una query sul database, se necessario. Esegui il comando seguente:

    code language-none
    /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 iptables su Debian in modo da garantire la connessione con Analytics di Azure synapse, abilita la porta TCP 1433 in uscita per il tuo nome host con il seguente comando:

    code language-none
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    
    note note
    NOTE
    Per consentire la comunicazione dal lato di Analytics per l’Azure synapse, potrebbe essere necessario aggiungere l’IP pubblico al inserisco nell'elenco Consentiti di. A tale scopo, fare riferimento alla documentazione di Azure.

Azure synapse account esterno azure-external

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

Per creare il tuo account esterno Azure Synapse, segui la procedura seguente:

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

  2. Fai clic su New.

  3. Seleziona External database come Type del tuo account esterno.

  4. In Configuration, selezionare Azure Synapse Analytics dal menu a discesa Type.

  5. Configurare l'account esterno Azure Synapse:

    • Per l’autenticazione standard, devi specificare:

      • Server: URL del server di Azure synapse

      • Account: nome dell'utente

      • Password: password dell'account utente

      • Database: nome del database

    • Per l'autenticazione delle identità gestite assegnate dal sistema, è necessario specificare:

      • Server: URL del server di Azure synapse

      • Database: nome del database

      • Options: aggiungere la seguente sintassi Authentication=ActiveDirectoryMsi

  6. Fai clic su Save.

Il connettore supporta le seguenti opzioni:

Opzione
Descrizione
Autenticazione
Tipo di autenticazione supportato dal connettore. Valore attualmente supportato: ActiveDirectoryMSI.
Per ulteriori informazioni, fare riferimento al documento SQL (esempio di stringhe di connessione n°8).
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1