Configurer l’accès à Teradata configure-access-to-teradata
Utilisez l’option Campaign Federated Data Access (FDA) pour traiter les informations stockées dans des bases de données externes. Suivez les étapes ci-dessous pour configurer l’accès à Teradata.
- Installation et configuration des pilotes Teradata
- Configuration du compte externe Teradata dans Campaign
- Configuration supplémentaire pour Teradata et le serveur Campaign
Configuration de Teradata teradata-config
Vous devez installer des pilotes pour que Teradata puisse établir une connexion à Campaign.
-
Installez le pilote ODBC pour Teradata.
Il est constitué de trois packages pouvant être installés sur Red Hat (ou CentOS)/Suse dans l’ordre suivant :
- TeraGSS
- tdicu1510 (installez-le via setup_wrapper.sh)
- tdodbc1510 (installez-le via setup_wrapper.sh)
-
Configurez le pilote ODBC. La configuration peut être réalisée dans les fichiers standard : /etc/odbc.ini pour les paramètres généraux et /etc/odbcinst.ini pour la déclaration des pilotes :
-
/etc/odbc.ini
code language-none [ODBC] InstallDir=/etc/« InstallDir » correspond à l’emplacement du fichier 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
-
-
Définissez les variables d’environnement du serveur Adobe Campaign :
- LD_LIBRARY_PATH : /opt/teradata/client/15.10/lib64 et /opt/teradata/client/15.10/odbc_64/lib.
- ODBCINI : emplacement du fichier odbc.ini (par exemple /etc/odbc.ini).
- NLSPATH : emplacement du fichier opermsgs.cat (https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=fr)
Compte externe Teradata teradata-external
Le compte externe Teradata vous permet de connecter votre instance Campaign à votre base de données externe Teradata.
-
Dans l’Explorateur Campaign, cliquez sur Administration / Plateforme / Comptes externes.
-
Cliquez sur Nouveau, puis sélectionnez Base de données externe comme Type.
-
Pour configurer le compte externe Teradata, vous devez indiquer les informations suivantes :
-
Type : Choisissez le type Teradata.
-
Serveur : URL ou nom de votre serveur Teradata
-
Compte : Nom du compte utilisé pour accéder à la base de données Teradata
-
Mot de passe : Mot de passe utilisé pour se connecter à la base de données Teradata
-
Base de données : nom de la base de données (facultatif)
-
Options : Options à transmettre à l’aide de Teradata. Utilisez le format suivant : 'parameter=value'. Utilisez un point-virgule comme séparateur entre les valeurs.
-
Fuseau horaire : Fuseau horaire défini dans Teradata. En savoir plus
-
Le connecteur prend en charge les options suivantes :
Pour plus d’informations à ce sujet, consultez cette page.
Pour plus d’informations à ce sujet, consultez cette page
Ajout de comptes externes ODBC supplémentaires add-external
Le pilote Teradata fournit sa propre bibliothèque ODBC, mais cette bibliothèque peut ne pas être compatible avec d’autres comptes externes ODBC.
Si vous souhaitez configurer un autre compte externe qui utilise également ODBC, par exemple Snowflake, vous devez ajouter une option ODBCLib définie sur le chemin d’accès de la bibliothèque ODBC par défaut (/usr/lib/x86_64-linux-gnu/libodbc.so sous Debian et /usr/lib64/libodbc.so sous RHEL/CentOS).
Query banding
Si plusieurs utilisateurs Adobe Campaign se connectent au même compte externe FDA Teradata, l’onglet Tranches de requête vous permet de définir une tranche de requête, c’est-à-dire un ensemble de paires clé/valeur, sur une session.
Lorsque cette option est configurée, chaque fois qu'un utilisateur Campaign effectue une requête sur la base de données Teradata, Adobe Campaign envoie des métadonnées, composées d'une liste de clés, associées à cet utilisateur. Ces données peuvent ensuite être utilisées par les administrateurs Teradata à des fins d’audit ou pour gérer les droits d’accès.
Pour configurer le query banding, procédez comme suit :
-
Utilisez l’option Par défaut pour saisir un query band par défaut qui sera utilisé si un utilisateur n’a pas de query band associé. Si ce champ est vide, les utilisateurs sans query band ne pourront pas utiliser Teradata.
-
Utilisez le champ Utilisateurs pour spécifier un query band pour chaque utilisateur. Vous pouvez ajouter autant de paires clé/valeur que nécessaire, par exemple priority=1;workload=high. Si aucun query band n’est affecté à l’utilisateur, le champ Par défaut est appliqué.
-
Cochez la case Actif pour activer cette fonction.
Résolution des problèmes liés au compte externe external-account-troubleshooting
Si l’erreur suivante s’affiche lors du test de la connexion TIM-030008 Date ’2’ : caractère(s) manquant(s) (iRc=-53) assurez-vous que le pilote ODBC est correctement installé et que LD_LIBRARY_PATH (Linux) / PATH (Windows) est défini pour le serveur Campaign.
L’erreur ODB-240000 ODBC : nom de source de données [Microsoft][ODBC Driver Manager] introuvable et aucun pilote par défaut spécifié. survient avec Windows si vous utilisez un pilote 16.X. Adobe Campaign s’attend à ce que les données Teradata soient nommées ’{teradata}’ dans odbcinst.ini.
-
À compter de Campaign 18.10, vous pouvez ajouter ODBCDriverName="Teradata Database ODBC Driver 16.10" dans les options du compte externe. Le numéro de version peut changer, le nom exact peut être trouvé en exécutant odbcad32.exe et en accédant à l’onglet Pilotes.
-
Si vous utilisez une ancienne version de Campaign, vous devrez copier la section Teradata d’odbcinst.ini créée par l'installation du pilote dans une nouvelle section appelée Teradata. Regedit peut être utilisé dans ce cas. Si votre base est en latin1, vous devrez ajouter APICharSize=1 dans les options.
Configurations supplémentaires teradata-additional-configurations
Configuration utilisateur user-configuration
Les droits suivants sont obligatoires sur la base de données externe : créer/déposer/exécuter des procédures personnalisées, créer/déposer/insérer/sélectionner des tables. Vous devrez peut-être également créer des fonctions de mode utilisateur si vous souhaitez utiliser les fonctions md5 et sha2 sur votre instance d’Adobe Campaign.
Assurez-vous de configurer le fuseau horaire approprié. Il doit correspondre à ce qui sera défini dans le compte externe créé dans l’instance d’Adobe Campaign.
Adobe Campaign ne définit pas de mode de protection (fallback) sur les objets qu’il va créer dans la base de données. Vous devrez peut-être définir une valeur par défaut pour l’utilisateur qu’Adobe Campaign utilisera pour se connecter à la base de données Teradata à l’aide de la requête suivante :
MODIFY USER $login$ AS NO FALLBACK;Installation de MD5 md5-installation
Si vous souhaitez utiliser les fonctions md5 dans votre instance d’Adobe Campaign, vous devez installer la fonction de mode utilisateur sur votre base de données Teradata à partir de cette page (md5_20080530.zip).
La fonction sha1 du fichier téléchargé se présente comme suit : 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.
Pour installer md5 :
-
Décompressez le fichier md5_20080530.zip.
-
Accédez au répertoire md5/src.
-
Connectez-vous à votre base de données Teradata à l’aide de bteq.
-
Exécutez la commande bteq suivante :
code language-none .run file = hash_md5.btq
Installation SHA2 sha2-installation
Si vous souhaitez utiliser les fonctions sha2 dans votre instance d’Adobe Campaign, vous devrez installer la fonction de mode utilisateur sur votre base de données Teradata à partir de cette page (teradata-udf-sha2-1.0.zip).
La fonction sha1 du fichier téléchargé se présente comme suit : e87438d37424836358bd3902cf1adeb629349780.
Pour installer sha2 :
-
Décompressez le fichier teradata-udf-sha2-1.0.zip.
-
Accédez au répertoire teradata-udf-sha2-1.0/src.
-
Connectez-vous à votre base de données Teradata à l’aide de bteq.
-
Exécutez les deux commandes bteq suivantes :
code language-none .run file = hash_sha256.sql .run file = hash_sha512.sql
Installation de UDF_UTF16TO8 UDF-UTF16TO8-installation
Si vous souhaitez utiliser les fonctions udf_utf16to8 dans votre instance d’Adobe Campaign, installez la fonction de mode utilisateur sur votre base de données Teradata à partir de la boîte à outils Teradata Unicode.
La fonction sha1 du fichier téléchargé se présente comme suit : e58235f434f52c71316a577cb48e20b97d24f470.
Pour installer udf_utf16to8 :
-
Décompressez le fichier utk_release1.7.0.0.zip.
-
Recherchez udf_utf16to8.o dans les fichiers extraits et accédez au répertoire qui contient le fichier. Il doit être nommé utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01 Teradata UDFs/suselinux-x8664/udf_installation/.
-
Connectez-vous à votre base de données Teradata à l’aide de bteq.
-
Saisissez la commande bteq suivante :
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));
Configuration du serveur Campaign pour Linux campaign-server-linux
Les éléments suivants sont requis pour l’installation du pilote :
Noms de fichiers et sha1 :
-
tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f44fd
-
TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563
S’il n’existe aucun package pour votre distribution Linux, vous pouvez suivre la procédure d’installation de CentOS 7 (par exemple en utilisant docker), puis copier le contenu de /opt/teradata sur votre serveur Adobe Campaign.
Installation du pilote ODBC odbc-installation
Pour installer le pilote ODBC :
-
Extrayez le fichier tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.
-
Accédez au répertoire tdodbc1620.
-
Vous devrez peut-être corriger le script de configuration :
code language-none "sed -i s/16.10/16.20/ setup_wrapper.sh". -
Exécutez setup_wrapper.sh.
Installation des outils et utilitaires Teradata teradata-tools-installation
Pour installer les outils :
-
Extrayez le fichier TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.
-
Accédez au répertoire TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu.
-
Exécutez setup_wrapper.sh.
-
Accédez au répertoire TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2.
-
Exécutez setup_wrapper.sh.
-
Accédez au répertoire TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.
-
Exécutez setup_wrapper.sh.
-
Un fichier libtelapi.so doit être disponible dans /opt/teradata/client/16.20/lib64.
Configuration du serveur Campaign pour Windows campaign-server-windows
Vous devez d’abord télécharger les outils et utilitaires Teradata pour Windows. Vous pouvez les télécharger à partir de cette page
Assurez-vous d’installer le pilote ODBC et la base de transport parallèle Teradata. Elle installera le fichier telapi.dll utilisé pour charger en masse la base de données Teradata.
Assurez-vous que le chemin d’accès du pilote et des utilitaires se trouve dans la variable PATH dont nlserver disposera pendant l’exécution. Par défaut, le chemin d’accès est C:\Program Files (x86)\Teradata\Client\15.10\bin sur Windows 32 bits or C:\Program Files\Teradata\Client\15.10\bin sur 64 bits).
Time zone timezone
Teradata utilise un nom de fuseau horaire qui n’est pas standard. Vous pouvez trouver la liste sur le site Teradata. Adobe Campaign essaiera de convertir le fuseau horaire donné dans la configuration externe en un élément que Teradata comprend. Si aucune correspondance n’est trouvée, le fuseau horaire GMT+X (ou GMT-X) le plus proche sera trouvé pour la session et un avertissement sera ajouté au journal.
La conversion est effectuée via la lecture du fichier appelé teradata_timezones.txt qui doit se trouver dans le répertoire de données suivant : /usr/local/neolane/nl6/datakit sous Linux. Si vous modifiez ce fichier, veillez à contacter l’équipe d’Adobe Campaign pour apporter la modification au code source, sans quoi, ce fichier sera remplacé lors de la prochaine mise à jour de Campaign.
Le fuseau horaire utilisé pour la connexion est indiqué lors de l’exécution de nlserver avec le commutateur -verbose, par exemple :
15:04:04 > ODB-240007 Teradata: will use 'Europe Central' as session time zone.
Si le fuseau horaire utilisé n’est pas correct, une option nommée « TimeZoneName » peut être ajoutée sur le compte externe. Dans ce cas, utilisez la valeur Teradata, par exemple « TimeZoneName=Europe Central ».
Lors de l’utilisation du chargement en masse, ou « chargement rapide » dans les documents Teradata, Campaign ne peut pas indiquer le fuseau horaire. Par conséquent, il est recommandé de définir le fuseau horaire par défaut de l’utilisateur que Campaign utilisera pour se connecter :
MODIFY USER $login$ AS TIME ZONE = 'Europe Central';