Configurare l’accesso alle Teradate configure-access-to-teradata
Utilizzare Campaign Federated Data Access (FDA) per elaborare le informazioni memorizzate in un database esterno. Per configurare l’accesso a Teradata, segui la procedura riportata di seguito.
- Installare e configurare Teradate
- Configurare la Teradata account esterno in Campaign
- Configurazione configurazione aggiuntiva per il server Teradata e Campaign
Configurazione teradata teradata-config
È necessario installare i driver per Teradata per implementare la connessione a Campaign.
-
Installare Driver ODBC per Teradata.
È costituito da tre pacchetti che possono essere installati su Red Hat (o CentOS)/Suse nell’ordine seguente:
- TeraGSS
- tdicu1510 (installarlo utilizzando setup_wrapper.sh)
- tdodbc1510 (installarlo utilizzando setup_wrapper.sh)
-
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
code language-none [ODBC] InstallDir=/etc/
"InstallDir" corrisponde alla posizione del odbcinst.ini file.
-
/etc/odbcinst.ini
code language-none [ODBC DRIVERS] teradata=Installed [teradata] Driver=/opt/teradata/client/17.10/lib64/tdataodbc_sb64.so APILevel=CORE ConnectFunctions=YYY DriverODBCVer=3.51 SQLLevel=1
-
-
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 (https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=it)
Teradata account esterno teradata-external
L’account esterno Teradata ti consente di collegare l’istanza Campaign al database esterno Teradata.
-
Da campagna Explorer, fai clic su Administration / Platform / External accounts.
-
Clic New e seleziona External database as Type.
-
Per configurare Teradata account esterno, è necessario specificare:
-
Type: scegli il Teradata tipo.
-
Server: URL o nome del server di Teradata
-
Account: nome dell’account utilizzato per accedere al database Teradata
-
Password: password utilizzata per la connessione al database Teradata
-
Database: nome del database (facoltativo)
-
Options: opzioni da trasmettere attraverso la Teradata. Utilizza il seguente formato: 'parameter=value'. Utilizzare un punto e virgola come separatore tra i valori.
-
Timezone: fuso orario impostato nella Teradata. Ulteriori informazioni
-
Il connettore supporta le seguenti opzioni:
Per ulteriori informazioni, consulta questa pagina.
Per ulteriori informazioni, consulta questa pagina
Aggiungi altri account esterni ODBC add-external
Il driver di Teradata fornisce una propria libreria ODBC, ma questa potrebbe non essere compatibile con altri account esterni ODBC.
Se si desidera configurare un altro account esterno che utilizza anche ODBC, ad esempio Snowflake, è necessario aggiungere un'opzione ODBCLib impostata al percorso della libreria ODBC predefinita (/usr/lib/x86_64-linux-gnu/libodbc.so
su Debian e /usr/lib64/libodbc.so
su RHEL/CentOS).
Query banding
Quando più utenti di Adobe Campaign si connettono allo stesso account esterno di Teradata FDA, il Query banding Questa scheda ti consente di impostare una banda di query, ovvero un set di coppie chiave/valore, in una sessione.
Quando questa opzione è configurata, ogni volta che un utente di Campaign esegue una query sul database delle Teradate, Adobe Campaign invia metadati, costituiti da un elenco di chiavi, associati a tale utente. Questi dati possono quindi essere utilizzati dagli amministratori di Teradate a scopo di audit o per gestire i diritti di accesso.
Per configurare l’assegnazione bande per le query, effettua le seguenti operazioni:
-
Utilizza il Default per immettere una banda di query predefinita che verrà utilizzata se a un utente non è associata alcuna banda di query. Se questo campo viene lasciato vuoto, gli utenti senza banda di query non potranno utilizzare Teradata.
-
Utilizza il Users per specificare una banda di query per ogni utente. Puoi aggiungere tutte le coppie chiave/valore necessarie, ad esempio priorità=1;carico di lavoro=alto. Se all’utente non è assegnata alcuna banda di query, il Default verrà applicato.
-
Controlla la Active per attivare questa funzione
Risoluzione dei problemi dell’account esterno external-account-troubleshooting
Se durante il test della connessione viene visualizzato il seguente errore TIM-030008 Data '2': caratteri mancanti (iRc=-53) verificare che il driver ODBC sia installato correttamente e che LD_LIBRARY_PATH (Linux) / PATH (Windows) sia impostato per il server Campaign.
L’errore Errore ODB-240000: [Microsoft][ODBC Driver Manager] Impossibile trovare il nome dell'origine dati. Nessun driver predefinito specificato. si verifica con Windows se si utilizza un driver 16.X. Adobe Campaign prevede che la teradata sia denominata "{teradata}' in odbcinst.ini.
-
A partire da Campaign 18.10, è possibile aggiungere ODBCDriverName="Teradata Database ODBC Driver 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 di Campaign precedente, 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 latino1, sarà necessario aggiungere APICharSize=1 nelle opzioni.
Configurazioni aggiuntive teradata-additional-configurations
Configurazione utente user-configuration
Nel database esterno sono necessari i seguenti diritti: crea/rilascia/esegui procedure personalizzate, crea/rilascia/inserisci/seleziona tabelle. Se desideri utilizzare le funzioni md5 e sha2 nell’istanza di Adobe Campaign, potrebbe essere necessario creare funzioni in modalità utente.
Assicurati di configurare il fuso orario corretto. Deve corrispondere a quanto verrà impostato nell’account esterno creato nell’istanza di Adobe Campaign.
Adobe Campaign non imposterà 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 Teradata utilizzando la seguente query:
MODIFY USER $login$ AS NO FALLBACK;
Installazione di MD5 md5-installation
Se desideri utilizzare le funzioni md5 nell’istanza di Adobe Campaign, dovrai installare la funzione modalità utente nel database di Teradata da questo pagina (md5_20080530.zip).
La sha1 del file scaricato è la seguente: 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.
Per installare md5:
-
Decomprimi il file md5_20080530.zip.
-
Vai alla directory md5/src.
-
Connettersi al database delle Teradate utilizzando bteq.
-
Esegui il seguente comando bteq:
code language-none .run file = hash_md5.btq
Installazione di SHA2 sha2-installation
Se desideri utilizzare le funzioni sha2 nell’istanza di Adobe Campaign, devi installare la funzione modalità utente nel database delle Teradate da questo pagina (teradata-udf-sha2-1.0.zip).
L’sha1 del file scaricato è il seguente e87438d37424836358bd3902cf1adeb629349780.
Per installare sha2:
-
Decomprimi il file teradata-udf-sha2-1.0.zip.
-
Vai alla directory teradata-udf-sha2-1.0/src.
-
Connettersi al database delle Teradate utilizzando bteq.
-
Esegui i due seguenti comandi bteq:
code language-none .run file = hash_sha256.sql .run file = hash_sha512.sql
Installazione di UDF_UTF16TO8 UDF-UTF16TO8-installation
Se si desidera utilizzare le funzioni udf_utf16to8 nell'istanza di Adobe Campaign, installare la funzione della modalità utente nel database delle Teradate dalla Kit di strumenti Unicode teradata.
Lo sha1 del file scaricato è il seguente: e58235f434f52c71316a577cb48e20b97d24f470.
Per installare udf_utf16to8:
-
Decomprimi il file utk_release1.7.0.0.zip.
-
Cercate udf_utf16to8.o nei file estratti e individuate la 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/.
-
Connettersi al database delle Teradate utilizzando bteq.
-
Digita il seguente comando bteq:
code language-none 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 campaign-server-linux
Per l'installazione del driver è necessario quanto segue:
Nomi di file e sha1:
-
tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f44fd
-
TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563
Se non è presente alcun pacchetto per la distribuzione Linux, puoi installarlo come descritto su CentOS 7 (ad esempio utilizzando il docker) e quindi copiare il contenuto di /opt/teradata sul server Adobe Campaign.
Installazione driver ODBC odbc-installation
Per installare il driver ODBC:
-
Estrai il file tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.
-
Passare alla directory tdodbc1620.
-
Potrebbe essere necessario correggere lo script di installazione:
code language-none "sed -i s/16.10/16.20/ setup_wrapper.sh".
-
Eseguire setup_wrapper.sh.
Installazione di strumenti e utilità di teradata teradata-tools-installation
Per installare gli strumenti:
-
Estrai il file TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.
-
Andare alla directory TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu.
-
Eseguire setup_wrapper.sh.
-
Andare alla directory TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2.
-
Eseguire setup_wrapper.sh.
-
Andare alla directory TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.
-
Eseguire setup_wrapper.sh.
-
Un file libtelapi.so deve essere disponibile in /opt/teradata/client/16.20/lib64.
Configurazione del server Campaign per Windows campaign-server-windows
È innanzitutto necessario scaricare Strumenti e utilità di Teradata per Windows. Puoi scaricarlo da questo pagina
Assicurarsi di installare il driver ODBC e la Teradata Parallel Transporter Base. Verrà installato telapi.dll utilizzato per eseguire il caricamento in massa sul database delle Teradate.
Assicurarsi che il percorso del driver e delle utilità sia nella variabile PATH che nlserver avrà durante l'esecuzione. Per impostazione predefinita, il percorso è C:\Program Files (x86)\Teradata\Client\15.10\bin su Windows 32 bit o C:\Program Files\Teradata\Client\15.10\bin su 64 bit).
Fuso orario timezone
La teradata utilizza un nome di fuso orario non standard. L'elenco è disponibile nella Teradata. Adobe Campaign tenterà di convertire il fuso orario specificato nella configurazione esterna in un formato comprensibile alle Teradate. Se non viene trovata alcuna corrispondenza, per la sessione verrà trovato il fuso orario GMT+X (o GMT-X) dell’armadio, con un avviso nel registro.
La conversione viene eseguita leggendo un file denominato teradata_timezones.txt che deve trovarsi nella seguente directory datakit: /usr/local/neolane/nl6/datakit in linux. Se modifichi questo file, assicurati di contattare il team di Adobe Campaign per apportare la modifica nel codice sorgente; in caso contrario, il file verrà sovrascritto durante il prossimo aggiornamento di Campaign.
Il fuso orario utilizzato per la connessione verrà 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 un'opzione denominata "TimeZoneName" all'account esterno. In tal caso, utilizzare il valore della Teradata, ad esempio "TimeZoneName=Europe Central".
Quando si utilizza il caricamento in massa o il "caricamento rapido" nei documenti delle Teradate, 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';