Configurare l’accesso alle Teradate configure-access-to-teradata
Utilizza l'opzione Federated Data Access (FDA) di Campaign per elaborare le informazioni archiviate in un database esterno. Per configurare l’accesso a Teradata, segui la procedura riportata di seguito.
- Installa e configura driver di Teradata
- Configura l'account esterno della Teradata in Campaign
- Configura 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 il driver ODBC per la 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 file odbcinst.ini.
-
/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: percorso del file odbc.ini (ad esempio /etc/odbc.ini).
- NLSPATH: percorso 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.
-
Dalla campagna Explorer, fare clic su Administration / Platform / External accounts.
-
Fare clic su New e selezionare External database come Type.
-
Per configurare l'account esterno Teradata, è necessario specificare:
-
Type: scegliere il tipo Teradata.
-
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 passare 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, la scheda Query banding 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:
-
Utilizzare Default per immettere una banda di query predefinita che verrà utilizzata se a un utente non è associata alcuna banda. Se questo campo viene lasciato vuoto, gli utenti senza banda di query non potranno utilizzare Teradata.
-
Utilizzare il campo 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, verrà applicato il campo Default.
-
Seleziona la casella Active per attivare questa funzione
Risoluzione dei problemi dell’account esterno external-account-troubleshooting
Se durante il test della connessione TIM-030008 Date '2' viene visualizzato il seguente errore: 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.
Errore Errore ODB-240000 ODBC: [Nome origine dati Microsoft][ODBC Driver Manager] non trovato e nessun driver predefinito specificato. si verifica con Windows se si utilizza un driver 16.X. Adobe Campaign prevede che la teradata sia denominata '{teradata}' nel file 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 Adobe Campaign, devi installare la funzione modalità utente nel database Teradata da questa 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 Adobe Campaign, devi installare la funzione modalità utente nel database Teradata da questa 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 Adobe Campaign, installare la funzione modalità utente nel database delle Teradate dal kit dello strumento Unicode per le Teradate.
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 questa 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
Teradata utilizza un nome di fuso orario non standard. L'elenco è disponibile nel sito Teradate. 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';