Zugriff auf Teradata konfigurieren configure-access-to-teradata
Verwenden von Campaign Federated Data Access (FDA), um in externen Datenbanken gespeicherte Informationen zu verarbeiten. Gehen Sie wie folgt vor, um den Zugriff auf Teradata zu konfigurieren.
- Installieren und Konfigurieren Teradata
- Konfigurieren des Teradata externes Konto in Campaign
- Einrichten zusätzliche Konfiguration für Teradata und Campaign-Server
Teradata-Konfiguration teradata-config
Sie müssen Treiber installieren, damit Teradata die Verbindung zu Campaign herstellen kann.
-
Installieren Sie den ODBC-Treiber für Teradata.
Er besteht aus drei Packages, die in der folgenden Reihenfolge auf Red Hat (oder CentOS)/Suse installiert werden können:
- TeraGSS
- tdicu1510 (Installation mit setup_wrapper.sh)
- tdodbc1510 (Installation mit setup_wrapper.sh)
-
Konfigurieren Sie den ODBC-Treiber. Die Konfiguration kann in den Standarddateien vorgenommen werden: /etc/odbc.ini für allgemeine Parameter und /etc/odbcinst.ini zur Deklarierung von Treibern:
-
/etc/odbc.ini
code language-none [ODBC] InstallDir=/etc/"InstallDir" entspricht dem Pfad der Datei 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
-
-
Spezifizieren Sie die Umgebungsvariablen des Adobe Campaign-Servers:
- LD_LIBRARY_PATH: /opt/teradata/client/15.10/lib64 und /opt/teradata/client/15.10/odbc_64/lib.
- ODBCINI: Pfad der odbc.ini-Datei (z. B. /etc/odbc.ini).
- NLSPATH: Pfad der opermsgs.cat-Datei (https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=de)
Externes Teradata-Konto teradata-external
Mit dem externen Teradata-Konto können Sie Ihre Campaign-Instanz mit Ihrer externen Teradata-Datenbank verbinden.
-
Von Campaign Explorer klicken Administration / Plattform / Externe Konten.
-
Klicken Sie auf Neu und wählen Sie Externe Datenbank als Typ aus.
-
Zum Konfigurieren des externen Teradata-Kontos müssen Sie Folgendes angeben:
-
Typ: Wählen Sie die Teradata Typ.
-
Server: URL oder Name Ihres Teradata-Servers
-
Konto: Name des Kontos, über das auf die Teradata zugegriffen wird
-
Passwort: Kennwort für die Verbindung mit der Teradata-Datenbank
-
Datenbank: Name der Datenbank (optional)
-
Optionen: Optionen, die über Teradata weitergeleitet werden. Verwenden Sie das folgende Format: 'parameter=value'. Verwenden Sie ein Semikolon als Trennzeichen zwischen Werten.
-
Zeitzone: In Teradata festgelegte Zeitzone. Weitere Informationen
-
Der Connector unterstützt die folgenden Optionen:
Weiterführende Informationen hierzu finden Sie auf dieser Seite.
Weitere Informationen hierzu finden Sie unter diese Seite
Zusätzliche externe ODBC-Konten hinzufügen add-external
Der Teradata-Treiber stellt eine eigene ODBC-Bibliothek bereit, diese Bibliothek ist jedoch möglicherweise nicht mit anderen externen ODBC-Konten kompatibel.
Wenn Sie ein anderes externes Konto konfigurieren möchten, das auch ODBC verwendet, z. B. Snowflake, müssen Sie eine ODBCLib-Option hinzufügen, die auf den Pfad der standardmäßigen ODBC-Bibliothek (/usr/lib/x86_64-linux-gnu/libodbc.so auf Debian und /usr/lib64/libodbc.so auf RHEL/CentOS).
Query Banding
Wenn sich mehrere Adobe Campaign-Benutzer mit demselben externen FDA-Teradata-Konto verbinden, können Sie im Tab Query Banding einen Satz von Schlüssel/Wert-Paaren für eine Sitzung festlegen.
Wenn diese Option konfiguriert ist, sendet Adobe Campaign jedes Mal, wenn ein Campaign-Benutzer eine Abfrage in der Teradata durchführt, Metadaten, die aus einer Schlüsselliste bestehen und diesem Benutzer zugeordnet sind. Diese Daten können dann von Teradata-Administratoren für Prüfzwecke oder zur Verwaltung von Zugriffsrechten verwendet werden.
Gehen Sie wie folgt vor, um Query Banding zu konfigurieren:
-
Verwenden Sie die Standard , um einen Standardwert für Query Banding einzugeben, der verwendet wird, wenn einem Benutzer kein Query Banding zugeordnet ist. Wenn dieses Feld leer gelassen wird, können Benutzer ohne Query Banding Teradata nicht verwenden.
-
Verwenden Sie die Benutzer -Feld, um einen Query Banding für jeden Benutzer anzugeben. Sie können so viele Schlüssel/Wert-Paare hinzufügen, wie Sie benötigen, z. B. priority=1;workload=high. Wenn dem Benutzer kein Query Banding zugewiesen ist, wird die Standard wird angewendet.
-
Markieren Sie die Option Aktiv, um diese Funktion zu aktivieren.
Fehlerbehebung bei externen Konten external-account-troubleshooting
Wenn beim Testen der Verbindung der Fehler TIM-030008 Datum '2': fehlende Zeichen (iRc = -53) auftritt, stellen Sie sicher, dass der ODBC-Treiber korrekt installiert ist und LD_LIBRARY_PATH (Linux)/PATH (Windows) für den Campaign-Server festlegt wurde.
Der Fehler ODB-240000 ODBC-Fehler: [Microsoft][ODBC Driver Manager]-Datenquellenname nicht gefunden und kein Standardtreiber angegeben. tritt unter Windows auf, wenn Sie einen 16.X-Treiber verwenden. Adobe Campaign erwartet, dass die teradata ""heißt{teradata}" in odbcinst.ini.
-
Ab Campaign 18.10 können Sie ODBCDriverName="Teradata Database ODBC Driver 16.10" in den Optionen des externen Kontos hinzufügen. Die Versionsnummer kann sich ändern. Sie können den genauen Namen finden, indem Sie odbcad32.exe ausführen und auf die Registerkarte Treiber zugreifen.
-
Wenn Sie eine ältere Campaign-Version verwenden, müssen Sie den von der Treiberinstallation erstellten Teradata von odbcinst.ini in einen neuen Abschnitt mit dem Namen Teradata kopieren. In diesem Fall kann Regedit verwendet werden. Wenn Ihre Basis in latin1 ist, müssen Sie APICharSize=1 in den Optionen.
Zusätzliche Konfigurationen teradata-additional-configurations
Benutzerkonfiguration user-configuration
Für die externe Datenbank sind folgende Berechtigungen erforderlich: Erstellen/Ablegen/Ausführen benutzerdefinierter Verfahren, Erstellen/Ablegen/Einfügen/Auswählen von Tabellen. Möglicherweise müssen Sie auch Benutzermodusfunktionen erstellen, wenn Sie die Funktionen md5 und sha2 in Ihrer Adobe Campaign-Instanz verwenden möchten.
Stellen Sie sicher, dass Sie die richtige Zeitzone konfigurieren. Sie sollte mit der Zeitzone übereinstimmen, die in dem externen Konto eingestellt wird, das in der Adobe Campaign-Instanz erstellt wurde.
Adobe Campaign legt keinen Schutzmodus (Fallback) für die Objekte fest, die in der Datenbank erstellt werden. Möglicherweise müssen Sie einen Standardwert für den Benutzer festlegen, über den sich Adobe Campaign mit der Teradata-Datenbank verbindet. Folgende Abfrage wird dabei verwendet:
MODIFY USER $login$ AS NO FALLBACK;MD5-Installation md5-installation
Wenn Sie MD5-Funktionen in Ihrer Adobe Campaign-Instanz verwenden möchten, müssen Sie die Benutzermodusfunktion in Ihrer Teradata-Datenbank von dieser Seite aus installieren (md5_20080530.zip).
Der sha1-Wert der heruntergeladenen Datei lautet wie folgt: 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.
Installieren von MD5:
-
Entpacken Sie die Datei md5_20080530.zip.
-
Wechseln Sie zum Verzeichnis „md5/src“.
-
Stellen Sie mit BTEQ eine Verbindung zu Ihrer Teradata-Datenbank her.
-
Führen Sie den folgenden bteq-Befehl aus:
code language-none .run file = hash_md5.btq
SHA2-Installation sha2-installation
Wenn Sie SHA-2-Funktionen in Ihrer Adobe Campaign-Instanz verwenden möchten, müssen Sie die Benutzermodusfunktion in Ihrer Teradata-Datenbank von dieser Seite aus installieren (teradata-udf-sha2-1.0.zip).
Der SHA-1-Wert der heruntergeladenen Datei lautet wie folgt: e87438d37424836358bd3902cf1adeb629349780.
Installieren von SHA-2:
-
Entpacken Sie die Datei teradata-udf-sha2-1.0.zip.
-
Wechseln Sie zum Verzeichnis „teradata-udf-sha2-1.0/src“.
-
Stellen Sie mit BTEQ eine Verbindung zu Ihrer Teradata-Datenbank her.
-
Führen Sie die beiden folgenden BTEQ-Befehle aus:
code language-none .run file = hash_sha256.sql .run file = hash_sha512.sql
UDF_UTF16TO8-Installation UDF-UTF16TO8-installation
Wenn Sie udf_utf16to8-Funktionen in Ihrer Adobe Campaign-Instanz verwenden möchten, installieren Sie die Benutzermodusfunktion in Ihrer Teradata über die Teradata Unicode-Toolkit.
Der SHA-1-Wert der heruntergeladenen Datei lautet wie folgt: e58235f434f52c71316a577cb48e20b97d24f470.
Installieren von udf_utf16to8:
-
Entpacken Sie die Datei utk_release1.7.0.0.zip.
-
Suchen Sie in den extrahierten Dateien nach udf_utf16to8.o und navigieren Sie zum Verzeichnis, das die Datei enthält. Es sollte diesen Namen aufweisen: utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01 Teradata UDFs/suselinux-x8664/udf_installation/.
-
Stellen Sie mit BTEQ eine Verbindung zu Ihrer Teradata-Datenbank her.
-
Geben Sie den folgenden BTEQ-Befehl ein:
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));
Campaign-Serverkonfiguration für Linux campaign-server-linux
Für die Treiberinstallation ist Folgendes erforderlich:
Dateinamen und SHA-1:
-
tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f44fd
-
TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563
Wenn für Ihre Linux-Distribution kein Paket vorhanden ist, können Sie die Installation wie beschrieben auf einem CentOS 7 vornehmen (z. B. mit Docker) und dann den Inhalt von „/opt/teradata“ auf Ihren Adobe Campaign-Server kopieren.
ODBC-Treiberinstallation odbc-installation
Installieren des ODBC-Treibers:
-
Entpacken Sie die Datei tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.
-
Wechseln Sie zum Verzeichnis „tdodbc1620“.
-
Möglicherweise müssen Sie das Setup-Skript korrigieren:
code language-none "sed -i s/16.10/16.20/ setup_wrapper.sh". -
Führen Sie setup_wrapper.sh aus.
Installation von teradata und Dienstprogrammen teradata-tools-installation
Installieren der Tools:
-
Entpacken Sie die Datei TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.
-
Wechseln Sie zum Verzeichnis „TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu“.
-
Führen Sie setup_wrapper.sh aus.
-
Wechseln Sie zum Verzeichnis „TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2“.
-
Führen Sie setup_wrapper.sh aus.
-
Wechseln Sie zum Verzeichnis „TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase“.
-
Führen Sie setup_wrapper.sh aus.
-
In „/opt/teradata/client/16.20/lib64“ sollte die Datei libtelapi.so verfügbar sein.
Campaign-Serverkonfiguration für Windows campaign-server-windows
Zunächst müssen Sie Teradata-Tools und Dienstprogramme für Windows herunterladen. Sie können sie von dieser Seite herunterladen.
Installieren Sie unbedingt den ODBC-Treiber und die Teradata Parallel Transporter Base. telapi.dll wird installiert, was für Massenladevorgänge in die Teradata-Datenbank verwendet wird.
Stellen Sie sicher, dass der Pfad des Treibers und der Dienstprogramme in der PATH-Variablen steht, die während der Ausführung von nlserver verwendet wird. Der Standardpfad lautet „C:\Program Files (x86)\Teradata\Client\15.10\bin“ unter Windows 32 Bit oder „C:\Program Files\Teradata\Client\15.10\bin“ unter Windows 64 Bit.
Zeitzone timezone
Teradata verwendet Zeitzonennamen, die nicht dem Standard entsprechen. Sie finden die Liste auf der Teradata-Website. Adobe Campaign versucht, die in der externen Konfiguration angegebene Zeitzone so umzuwandeln, dass sie von Teradata verstanden wird. Wenn keine Entsprechung gefunden wird, wird nach der nächstgelegenen GMT+X- (oder GMT-X)-Zeitzone für die Sitzung gesucht und eine Warnung im Protokoll vermerkt.
Die Konvertierung erfolgt durch Lesen einer Datei namens teradata_timezones.txt, die sich im folgenden datakit-Verzeichnis befinden sollte: /usr/local/neolane/nl6/datakit under Linux. Wenn Sie diese Datei bearbeiten, wenden Sie sich an das Adobe Campaign-Team, um die Änderungen im Quellcode vorzunehmen. Andernfalls wird diese Datei bei der nächsten Campaign-Aktualisierung überschrieben.
Die für die Verbindung verwendete Zeitzone wird angezeigt, wenn nlserver mit -verbose ausgeführt wird, z. B.:
15:04:04 > ODB-240007 Teradata: will use 'Europe Central' as session time zone.
Wenn die verwendete Zeitzone nicht die richtige ist, kann eine Option mit dem Namen "TimeZoneName" im externen Konto hinzugefügt werden. Verwenden Sie in diesem Fall den Wert von Teradata, z. B. "TimeZoneName=Europe Central".
Bei Massenladevorgängen oder Schnellladevorgängen (Fast Load) in Teradata-Dokumenten kann Campaign die Zeitzone nicht angeben. Es wird daher empfohlen, die Standardzeitzone des Benutzers festzulegen, über den Campaign die Verbindung herstellt:
MODIFY USER $login$ AS TIME ZONE = 'Europe Central';