Configurare l’accesso alle Teradate

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 alle Teradate.

  1. Installa e configura driver di Teradata
  2. Configura la Teradata account esterno in Campaign
  3. Configurazione configurazione aggiuntiva per il server Teradata e Campaign

Configurazione teradata

Per implementare la connessione a Campaign, devi installare i driver per la Teradata.

  1. Installare il driver ODBC per Teradata.

    È composto da tre pacchetti che possono essere installati su Red Hat (o CentOS)/Suse nel seguente ordine:

    • TeraGSS
    • tdicu1510 (installalo utilizzando setup_wrapper.sh)
    • tdodbc1510 (installalo utilizzando setup_wrapper.sh)
  2. Configurare il driver ODBC. La configurazione può essere eseguita nei file standard: /etc/odbc.ini per i parametri generali e /etc/odbcinst.ini per la dichiarazione dei driver:

    • /etc/odbc.ini

      [ODBC]
      InstallDir=/etc/
      

      "InstallDir" corrisponde alla posizione del file odbcinst.ini.

    • /etc/odbcinst.ini

      [ODBC DRIVERS]
      teradata=Installed
      
      [teradata]
      Driver=/opt/teradata/client/15.10/lib64/tdata.so
      APILevel=CORE
      ConnectFunctions=YYY
      DriverODBCVer=3.51
      SQLLevel=1
      
  3. Specifica le variabili di ambiente del server Adobe Campaign:

    • LD_LIBRARY_PATH: /opt/teradata/client/15.10/lib64 e /opt/teradata/client/15.10/odbc_64/lib.
    • ODBCINI: posizione del file odbc.ini (ad esempio /etc/odbc.ini).
    • NLSPATH: posizione del file opermsgs.cat (/opt/teradata/client/15.10/msg/opermsgs.cat?lang=it)
NOTA

La connessione a un database esterno di Teradata in FDA richiede passaggi di configurazione aggiuntivi sul server Adobe Campaign. Ulteriori informazioni.

Account esterno teradata

L’account esterno Teradata ti consente di collegare l’istanza Campaign al database esterno Teradata.

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

  2. Fare clic su New e selezionare External database come Type.

  3. Per configurare l’account esterno Teradata, devi specificare:

    • Type: Scegli il Teradata tipo.

    • Server: URL o nome del server Teradata

    • Account: Nome dell’account utilizzato per accedere al database delle Teradate

    • Password: Password utilizzata per la connessione al database delle Teradate

    • Database: Nome del database (facoltativo)

    • Options: Opzioni da passare attraverso le Teradate. Utilizza il formato seguente: 'parameter=value'. Utilizzare una semicolonna come separatore tra i valori.

    • Timezone: Fuso orario impostato in Teradata. Ulteriori informazioni

Proiezione query

Quando più utenti Adobe Campaign si collegano allo stesso account esterno della Teradata FDA, la scheda Query banding ti consente di impostare una banda di query, ovvero un set di coppie chiave/valore, su una sessione.

Quando questa opzione è configurata, ogni volta che un utente di Campaign esegue una query sul database di Teradata, Adobe Campaign invia metadati, costituiti da un elenco di chiavi associate a questo utente. Questi dati possono quindi essere utilizzati dagli amministratori delle Teradate a scopo di controllo o per gestire i diritti di accesso.

NOTA

Per ulteriori informazioni su Query banding, consulta la documentazione sulle Teradate.

Per configurare la banding delle query, effettua le seguenti operazioni:

  1. Utilizzare Default per immettere una banda di query predefinita che verrà utilizzata se un utente non ha una banda di query associata. Se questo campo viene lasciato vuoto, gli utenti senza banda di query non saranno in grado di utilizzare la Teradata.

  2. Utilizza il campo Users per specificare una banda di query per ogni utente. È possibile aggiungere tutte le coppie chiave/valore necessarie, ad esempio priority=1;carico di lavoro=alto. Se all’utente non è assegnata alcuna banda di query, viene applicato il campo Default .

  3. Seleziona la casella Active per attivare questa funzione

Risoluzione dei problemi degli account esterni

Se durante il test della connessione viene visualizzato il seguente errore TIM-030008 Date '2': caratteri mancanti (iRc=-53) assicurati che il driver ODBC sia installato correttamente e che LD_LIBRARY_PATH (Linux) / PATH (Windows) sia impostato per il server Campaign.

Errore ODB-240000 ODBC: [Microsoft][ODBC Driver Manager] Nome origine dati non trovato e nessun driver predefinito specificato. si verifica con Windows se si utilizza un driver 16.X. Adobe Campaign prevede che la teradata venga denominata '{teradata}' in odbcinst.ini.

  • A partire da Campaign 18.10, è possibile aggiungere ODBCDRiverName="Driver ODBC del database di Teradata 16.10" nelle opzioni dell’account esterno. Il numero di versione può cambiare, il nome esatto può essere trovato eseguendo odbcad32.exe e accedendo alla scheda Driver.

  • Se utilizzi una versione precedente di Campaign, dovrai copiare la sezione Teradata di odbcinst.ini creata dall’installazione del driver in una nuova sezione denominata Teradata. In questo caso è possibile utilizzare Regedit. Se la base è in latin1, è necessario aggiungere APICharSize=1 nelle opzioni.

Configurazioni aggiuntive

Configurazione utente

Nel database esterno sono necessari i seguenti diritti: creare/rilasciare/eseguire procedure personalizzate, creare/rilasciare/inserire/selezionare tabelle. È inoltre possibile creare funzioni di modalità utente se si desidera utilizzare le funzioni md5 e sha2 nell’istanza Adobe Campaign.

Assicurati di configurare il fuso orario corretto. Deve corrispondere a ciò che verrà impostato nell’account esterno creato nell’istanza di Adobe Campaign.

Adobe Campaign non imposta una modalità di protezione (fallback) sugli oggetti che creerà nel database. Potrebbe essere necessario impostare un valore predefinito per l’utente che Adobe Campaign utilizzerà per connettersi al database di Teradata utilizzando la seguente query:

disattiva fallback predefinito
MODIFY USER $login$ AS NO FALLBACK;

Installazione MD5

Se desideri utilizzare le funzioni md5 nella tua istanza di Adobe Campaign, dovrai installare la funzione di modalità utente nel database delle Teradate da questa pagina (md5_20080530.zip).

Lo sha1 del file scaricato è il seguente 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.

Per installare md5:

  1. Decomprimi il file md5_20080530.zip.

  2. Vai alla directory md5/src .

  3. Connettiti al database delle Teradate utilizzando bteq.

  4. Esegui il seguente comando bteq:

    .run file = hash_md5.btq
    

Installazione SHA2

Se desideri utilizzare le funzioni sha2 nella tua istanza di Adobe Campaign, dovrai installare la funzione di modalità utente nel database di Teradata da questa pagina (teradata-udf-sha2-1.0.zip).

Lo sha1 del file scaricato è il seguente e87438d37424836358bd3902cf1adeb629349780.

Per installare sha2:

  1. Decomprimi il file teradata-udf-sha2-1.0.zip.

  2. Vai alla directory teradata-udf-sha2-1.0/src .

  3. Connettiti al database delle Teradate utilizzando bteq.

  4. Esegui i due seguenti comandi bteq:

    .run file = hash_sha256.sql
    .run file = hash_sha512.sql
    

Installazione di UDF_UTF16TO8

Se desideri utilizzare le funzioni udf_utf16to8 nell'istanza di Adobe Campaign, dovrai installare la funzione di modalità utente nel database delle Teradate dal kit di strumenti unicode di Teradata di questa pagina (utk_release1.7.0.0.zip).

Lo sha1 del file scaricato è il seguente e58235f434f52c71316a577cb48e20b97d24f470.

Per installare udf_utf16to8:

  1. Decomprimi il file utk_release1.7.0.0.zip.

  2. Cerca l'udf_utf16to8.o nei file estratti e passa alla directory che contiene il file. Deve essere denominato utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01 Teradata UDFs/suselinux-x8664/udf_installation/.

  3. Connettiti al database delle Teradate utilizzando bteq.

  4. Digitare il seguente comando bteq:

    REPLACE FUNCTION udf_utf16to8 (
    inputString VARCHAR(8000) CHARACTER SET UNICODE
    ) RETURNS VARCHAR(16000) CHARACTER SET LATIN
    LANGUAGE C
    NO SQL
    EXTERNAL NAME 'CO!i18n103!udf_utf16to8.o!F!udf_utf16to8'
    PARAMETER STYLE SQL;
    
    -- Test: should return 410042
    SELECT CAST(Char2HexInt(UDF_UTF16to8(_UNICODE'004100000042'XC)) AS VARCHAR(100));
    

Configurazione del server Campaign per Linux

Per l'installazione del driver è necessario quanto segue:

  • Driver ODBC Teradata, disponibile in questa pagina

  • Strumenti e utility teradata (utilizzati per il caricamento in serie), che si trova in questa pagina

Nomi di file e sha1:

  • tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f4 4fd

  • TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563

Se non c'è alcun pacchetto per la distribuzione Linux, è possibile installare come spiegato su un CentOS 7 (per esempio utilizzando docker) e quindi copiare il contenuto di /opt/teradata sul server Adobe Campaign.

Installazione driver ODBC

Per installare il driver ODBC:

  1. Estrai il file tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.

  2. Vai alla directory tdodbc1620.

  3. Potrebbe essere necessario correggere lo script di installazione:

    "sed -i s/16.10/16.20/ setup_wrapper.sh".
    
  4. Esegui setup_wrapper.sh.

Installazione di strumenti e utility di teradata

Per installare Strumenti:

  1. Estrai il file TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.

  2. Vai alla directory TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu.

  3. Esegui setup_wrapper.sh.

  4. Vai alla directory TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2 .

  5. Esegui setup_wrapper.sh.

  6. Vai alla directory TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.

  7. Esegui setup_wrapper.sh.

  8. Un file libtelapi.so dovrebbe essere disponibile in /opt/teradata/client/16.20/lib64.

Configurazione del server Campaign per Windows

Prima di tutto è necessario scaricare strumenti e utilità di Teradata per Windows. Puoi scaricarlo da questa pagina

Assicurati di installare il driver ODBC e la base del trasportatore parallelo Teradata. Verrà installato telapi.dll utilizzato per eseguire il caricamento in massa sul database delle Teradate.

Assicurati che il percorso del driver e delle utility sia nella variabile PATH che nlserver avrà durante l'esecuzione. Per impostazione predefinita, il percorso è C:\Program Files (x86)\Teradata\Client\15.10\bin on Windows 32 bits or C:\Program Files\Teradata\Client\15.10\bin on 64 bit).

Fuso orario

La teradata utilizza un nome di fuso orario non standard. È possibile trovare l'elenco nel sito Teradate. Adobe Campaign cercherà di convertire il fuso orario specificato nella configurazione esterna in qualcosa che le Teradate possano comprendere. Se non viene trovata una corrispondenza, verrà trovato il fuso orario GMT+X (o GMT-X) più vicino per la sessione, con un avviso nel registro.

La conversione viene eseguita leggendo un file denominato teradata_timezones.txt che dovrebbe trovarsi nella seguente directory del datakit: /usr/local/neolane/nl6/datakit sotto linux. Se modifichi questo file, contatta il team Adobe Campaign per apportare la modifica al codice sorgente, altrimenti il file verrà sovrascritto durante il prossimo aggiornamento di Campaign.

Il fuso orario utilizzato per la connessione viene indicato quando si esegue nlserver con lo switch -verbose, ad esempio:

15:04:04 >   ODB-240007 Teradata: will use 'Europe Central' as session time zone.

Se il fuso orario utilizzato non è quello corretto, è possibile aggiungere sull’account esterno un’opzione denominata "TimeZoneName". In questo caso, utilizza il valore della Teradata, ad esempio "TimeZoneName=Europe Central".

Quando si utilizza il caricamento in serie o il "caricamento rapido" nei documenti di Teradata, Campaign non può indicare il fuso orario. Pertanto, si consiglia di impostare il fuso orario predefinito dell’utente che Campaign utilizzerà per connettersi:

MODIFY USER $login$ AS TIME ZONE = 'Europe Central';

In questa pagina