Show Menu
ARGOMENTI×

Configurazione dei connettori FDA

A seconda dei database esterni a cui si desidera accedere da Adobe Campaign, sarà necessario eseguire determinate configurazioni specifiche. Tali configurazioni prevedono essenzialmente l'installazione di driver e la dichiarazione di variabili di ambiente appartenenti a ciascun RDBMS sul server di Adobe Campaign .
Per ulteriori informazioni sui connettori legacy quali Teradata, Hadoop 2.1 o Netezza, fare riferimento a questa pagina .
Come regola generale, è necessario installare il livello client corrispondente nel database esterno sul server del Adobe Campaign .
Le versioni compatibili sono elencate in Matrice compatibilità campagna.

Configurare l'accesso ad Azure Synapse

Account esterno della sincronizzazione di Azure

L'account Azure esterno consente di collegare l'istanza Campaign al database esterno di Azure Synapse. Per creare un account esterno Azure Synapse esterno:
  1. In Campaign Classic, configura il tuo account Azure Synapse esterno. Dal Explorer , fare clic su Administration / Platform / External accounts .
  2. Clic New .
  3. Selezionate External database come account esterno Type .
  4. Configurate l'account Azure Synapse esterno, dovete specificare:
    • Type : Azure Synapse Analytics
    • Server : URL del server Azure Synapse
    • Account : Nome dell’utente
    • Password : Password account utente
    • Database : Nome del database

Azure Synapse su CentOS

Prerequisiti:
  • 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:
  1. Innanzitutto, installare il driver ODBC. Potete trovarlo in questa pagina .
    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 Classic, potete quindi configurare il vostro account Azure Synapse esterno. Per ulteriori informazioni sulla configurazione dell'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
    
    
    Per consentire la comunicazione dal lato di Azure Synapse Analytics, potrebbe essere necessario aggiungere l'IP pubblico al elenco consentiti . 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

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 su Windows:
  1. Innanzitutto, installare il driver Microsoft ODBC. Potete 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. For more on this, refer to this page .
  4. In Campaign Classic, potete quindi configurare il vostro account Azure Synapse esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .
  5. Poiché Azure Synapse Analytics comunica attraverso la porta TCP 1433, è necessario aprire questa porta su Windows Defender Firewall. For more on this, refer to Windows documentation .

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" quando si chiama 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 Azure Synapse esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .
  7. Per configurare le 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 comando seguente:
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    
    
    Per consentire la comunicazione dal lato di Azure Synapse Analytics, potrebbe essere necessario aggiungere l'IP pubblico al elenco consentiti . A tal fine, fare riferimento alla documentazione di Azure.

Configurare l'accesso a Snowflake

Snowflake il connettore è disponibile per le distribuzioni in hosting e in sede. For more on this, refer to this article .

Conto esterno fiocco di neve

L'account Snowflake esterno consente di collegare l'istanza Campaign al database esterno Snowflake.
  1. In Campaign Classic, configura il tuo account Snowflake esterno. Dal Explorer , fare clic su Administration / Platform / External accounts .
  2. Clic New .
  3. Selezionate External database come account esterno Type .
  4. Configurate l'account Snowflake esterno, dovete specificare:
    • Type : Snowflake
    • Server : URL del Snowflake server
    • Account : Nome dell’utente
    • Password : Password account utente
    • Database : Nome del database
  5. Fare clic sulla Parameters scheda e quindi sul Deploy functions pulsante per creare le funzioni.
Il connettore supporta le seguenti opzioni:
Opzione
Descrizione
schema di lavoro
Schema del database da utilizzare per le tabelle di lavoro
warehouse
Nome del magazzino predefinito da utilizzare. Sostituirà l'impostazione predefinita dell'utente.
TimeZoneName
Per impostazione predefinita vuota, ovvero viene utilizzato il fuso orario del sistema del server app Campaign Classic. L’opzione può essere utilizzata per forzare il parametro di sessione TIMEZONE.
For more on this, refer to this page .
WeekStart
parametro di sessione WEEK_START. Per impostazione predefinita, è impostato su 0.
Per ulteriori informazioni, consultare questa pagina .
UseCachedResult
parametro di sessione USE_CACHED_RESULTS. Per impostazione predefinita, è impostato su TRUE. Questa opzione può essere utilizzata per disattivare i risultati di Snowflake memorizzati nella cache.
Per ulteriori informazioni, consultare questa pagina .

Fiocco di neve su CentOS

  1. Scaricare i driver ODBC per Snowflake. Fate clic qui per iniziare a scaricare.
  2. È quindi necessario installare i driver ODBC su CentOs con il seguente comando:
    rpm -Uvh unixodbc
    rpm -Uvh snowflake-odbc-2.20.2.x86_64.rpm
    
    
  3. Dopo aver scaricato e installato i driver ODBC, è necessario riavviare Campaign Classic. A questo scopo, eseguite il comando seguente:
    /etc/init.d/nlserver6 stop
    /etc/init.d/nlserver6 start
    
    
  4. In Campaign Classic, potete quindi configurare il vostro account Snowflake esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .

Fiocco di neve su Debian

  1. Scaricare i driver ODBC per Snowflake. Fai clic qui per iniziare a scaricare.
  2. È quindi necessario installare i driver ODBC su Debian con il seguente comando:
    apt-get install unixodbc
    apt-get install snowflake-odbc-x.xx.x.x86_64.deb
    
    
  3. Dopo aver scaricato e installato i driver ODBC, è necessario riavviare Campaign Classic. A questo scopo, eseguite il comando seguente:
    systemctl stop nlserver.service
    systemctl start nlserver.service
    
    
  4. In Campaign Classic, potete quindi configurare il vostro account Snowflake esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .

Snowflake on Windows

  1. Scaricare il driver ODBC per Windows . Per installare il driver, è necessario disporre dei privilegi di amministratore. For more on this, refer to this page
  2. Configurare il driver ODBC. For more on this, refer to this page
  3. In Campaign Classic, potete quindi configurare il vostro account Snowflake esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .

Configurare l'accesso a Hadoop 3.0

Account esterno Hadoop

L'account Hadoop esterno consente di collegare l'istanza Campaign al database esterno di Hadoop.
  1. In Campaign Classic, configura il tuo account Hadoop esterno. Dal Explorer , fare clic su Administration / Platform / External accounts .
  2. Clic New .
  3. Selezionate External database come account esterno Type .
  4. Configurate l'account Hadoop esterno, dovete specificare:
    • Type : ODBC (Sybase ASE, Sybase IQ)
    • Server : Nome del DNS
    • Account : Nome dell’utente
    • Password : Password account utente
    • Database : Nome del database se non specificato in DSN. Può essere lasciato vuoto se specificato nel DSN
    • Time zone : Fuso orario server
Il connettore supporta le seguenti opzioni ODBC:
Nome
Valore
ODBCMgr
iODBC
warehouse
1/2/4
Il connettore supporta anche le seguenti opzioni Hive:
Nome
Valore
Descrizione
bulkKey
BLOB di Azure o chiave di accesso DataLake
Per wasb:// o wasbs:// caricatori di massa (ad es. se lo strumento di caricamento di massa inizia con wasb:// o wasbs://).
È la chiave di accesso per il blob o DataLake bucket per il caricamento di massa.
hdfsPort
numero di porta
impostato per impostazione predefinita su 8020
Per il carico in massa HDFS (ad esempio, se lo strumento di caricamento in blocco inizia con webhdfs:// o webhdfss://).
buketsNumber
20
Numero di bucket durante la creazione di una tabella cluster.
fileFormat
PARQUET
Formato file predefinito per le tabelle di lavoro.

Configurazione di Hadoop 3.0

La connessione a un database esterno Hadoop in FDA richiede le seguenti configurazioni sul server del Adobe Campaign . Questa configurazione è disponibile per Windows e Linux.
  1. Scaricate i driver ODBC per Hadoop a seconda della versione del sistema operativo in uso. I driver si trovano in questa pagina .
  2. È quindi necessario installare i driver ODBC e creare un DSN per la connessione Hive. Le istruzioni sono disponibili in questa pagina
  3. Dopo aver scaricato e installato i driver ODBC, è necessario riavviare Campaign Classic. A questo scopo, eseguite il comando seguente:
    systemctl stop nlserver.service
    systemctl start nlserver.service
    
    
  4. In Campaign Classic, potete quindi configurare il vostro account Hadoop esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .

Configurare l'accesso a Oracle

Conto esterno Oracle

L'account Oracle esterno consente di collegare l'istanza Campaign al database esterno di Hadoop.
  1. In Campaign Classic, configura il tuo account oracle esterno. Dal Explorer , fare clic su Administration / Platform / External accounts .
  2. Clic New .
  3. Selezionate External database come account esterno Type .
  4. Configurate l'account Oracle esterno, dovete specificare:
    • Type : Oracle
    • Server : Nome del DNS
    • Account : Nome dell’utente
    • Password : Password account utente
    • Time zone : Fuso orario server

Oracle su Linux

La connessione a un database Oracle esterno in FDA richiede configurazioni aggiuntive nel server del Adobe Campaign .
  1. Installare il client completo Oracle corrispondente alla versione di Oracle in uso.
  2. Aggiungete le definizioni TNS all'installazione. Per eseguire questa operazione, specificateli in un file tnsnames.ora nell'archivio /etc/oracle. Se il repository non esiste, crearlo.
    Quindi create una nuova variabile di ambiente TNS_ADMIN: esportare TNS_ADMIN=/etc/oracle e riavviare il computer.
  3. Integrare Oracle nel server del Adobe Campaign (nlserver). A questo scopo, verificate che il file customer.sh sia presente nella cartella "nl6" della struttura ad albero del server di Adobi Campaign e che includa i collegamenti alle librerie Oracle.
    Ad esempio, per un client nella versione 11.2:
    export ORACLE_HOME=/usr/lib/oracle/11.2
    export TNS_ADMIN=/etc/oracle
    export LD_LIBRARY_PATH=$ORACLE_HOME/client64/lib:$LD_LIBRARY_PATH
    
    
    Questi valori (in particolare ORACLE_HOME) dipendono dai repository di installazione. Prima di fare riferimento a tali valori, verificate la struttura ad albero.
  4. Installare le librerie necessarie per Oracle:
    • libclntsh.so
      cd /usr/lib/oracle/<version>/client<architecture>/lib
      ln -s libclntsh.so.<version> libclntsh.so
      
      
    • libaio1
      aptitude install libaio1
      or
      yum install libaio1
      
      
  5. In Campaign Classic, potete quindi configurare il vostro account Oracle esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .

Oracle su Windows

La connessione a un database Oracle esterno in FDA richiede configurazioni aggiuntive nel server del Adobe Campaign .
  1. Installare il client Oracle.
  2. Nella cartella C:Oracle, create un file tnsnames.ora contenente la definizione TNS.
  3. Aggiungere una variabile di ambiente TNS_ADMIN con C:Oracle come valore e riavviare il computer.
  4. In Campaign Classic, potete quindi configurare il vostro account Oracle esterno. Per ulteriori informazioni sulla configurazione dell'account esterno, consulta questa sezione .