Zugriff auf Teradata konfigurieren configure-access-to-teradata

Verwenden Sie die Option 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.

  1. Installieren und Konfigurieren von Teradata-Treibern
  2. Konfigurieren des externen Teradata 1} in Campaign
  3. Einrichten von zusätzlichen Konfigurationen für Teradata und Campaign-Server

Teradata-Konfiguration teradata-config

Sie müssen Treiber installieren, damit Teradata die Verbindung zu Campaign herstellen kann.

  1. 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)
  2. Konfigurieren Sie den ODBC-Treiber. Die Konfiguration kann in den Standarddateien ausgeführt werden: /etc/odbc.ini für allgemeine Parameter und /etc/odbcinst.ini zur Deklarierung der Treiber:

    • /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
      
  3. 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)
NOTE
Die Verbindung zu einer externen Teradata-Datenbank über die FDA-Option erfordert zusätzliche Konfigurationsschritte auf dem Adobe Campaign-Server. Weitere Informationen.

Externes Teradata-Konto teradata-external

Mit dem externen Teradata-Konto können Sie Ihre Campaign-Instanz mit Ihrer externen Teradata-Datenbank verbinden.

  1. Klicken Sie in Campaign Explorer auf Administration / Plattform / Externe Konten.

  2. Klicken Sie auf Neu und wählen Sie Externe Datenbank als Typ aus.

  3. Zum Konfigurieren des externen Teradata-Kontos müssen Sie Folgendes angeben:

    • Typ: Wählen Sie den Typ Teradata aus.

    • Server: URL oder Name Ihres Teradata-Servers

    • Konto: Name des Kontos, über das auf die Teradata zugegriffen wird

    • Passwort: Passwort, mit dem eine Verbindung zur Teradata-Datenbank hergestellt wird

    • Datenbank: Name der Datenbank (optional)

    • Optionen: Optionen, die durch Teradata weitergegeben werden sollen. Verwenden Sie das folgende Format: 'parameter=value'. Verwenden Sie ein Semikolon als Trennzeichen zwischen Werten.

    • Zeitzone: Zeitzone, die in Teradata festgelegt ist. Weitere Informationen

Der Connector unterstützt die folgenden Optionen:

Option
Beschreibung
TD_MAX_SESSIONS
Gibt die maximale Anzahl von Anmeldungssitzungen an, die der Teradata Parallel Transporter für einen Operatorauftrag abrufen kann.
TimeZoneName
Name der Zeitzone des Servers.
CharacterSet
Wird zum Konfigurieren eines Teradata-Zeichensatzes verwendet.
Weiterführende Informationen hierzu finden Sie auf dieser Seite.
IANAAppCodePage
ODBC-Anwendungs-Code-Seite.
Weitere Informationen hierzu finden Sie auf dieser Seite

Zusätzliche externe ODBC-Konten hinzufügen add-external

NOTE
Diese Option ist nicht für Builds verfügbar, die älter als Version 7.3.1 sind.

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 unter Debian und /usr/lib64/libodbc.so unter RHEL/CentOS) festgelegt ist.

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.

NOTE
Weitere Informationen zu Query Banding finden Sie im Teradata-Handbuch.

Gehen Sie wie folgt vor, um Query Banding zu konfigurieren:

  1. Verwenden Sie den Standard , um einen standardmäßigen Query Banding einzugeben, der verwendet wird, wenn einem Benutzer kein Query Banding zugeordnet ist. Wenn kein Standardwert für Query Banding definiert ist, können Benutzer ohne Query Banding Teradata nicht verwenden.

  2. Verwenden Sie das Feld Benutzer , 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 das Feld Default angewendet.

  3. 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 der teradata in odbcinst.ini den Namen "{teradata}" erhält.

  • 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 liegt, müssen Sie APICharSize=1 in die Optionen einfügen.

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:

Standard-Fallback deaktivieren
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:

  1. Entpacken Sie die Datei md5_20080530.zip.

  2. Wechseln Sie zum Verzeichnis „md5/src“.

  3. Stellen Sie mit BTEQ eine Verbindung zu Ihrer Teradata-Datenbank her.

  4. 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:

  1. Entpacken Sie die Datei teradata-udf-sha2-1.0.zip.

  2. Wechseln Sie zum Verzeichnis „teradata-udf-sha2-1.0/src“.

  3. Stellen Sie mit BTEQ eine Verbindung zu Ihrer Teradata-Datenbank her.

  4. 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 das Teradata unicode-Toolkit.

Der SHA-1-Wert der heruntergeladenen Datei lautet wie folgt: e58235f434f52c71316a577cb48e20b97d24f470.

Installieren von udf_utf16to8:

  1. Entpacken Sie die Datei utk_release1.7.0.0.zip.

  2. 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/.

  3. Stellen Sie mit BTEQ eine Verbindung zu Ihrer Teradata-Datenbank her.

  4. 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:

  • Teradata-ODBC-Treiber, den Sie auf dieser Seite finden

  • Teradata-Tools und -Dienstprogramme (für Massenladevorgänge), die Sie auf dieser Seite finden

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:

  1. Entpacken Sie die Datei tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.

  2. Wechseln Sie zum Verzeichnis „tdodbc1620“.

  3. Möglicherweise müssen Sie das Setup-Skript korrigieren:

    code language-none
    "sed -i s/16.10/16.20/ setup_wrapper.sh".
    
  4. Führen Sie setup_wrapper.sh aus.

Installation von teradata und Dienstprogrammen teradata-tools-installation

Installieren der Tools:

  1. Entpacken Sie die Datei TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.

  2. Wechseln Sie zum Verzeichnis „TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu“.

  3. Führen Sie setup_wrapper.sh aus.

  4. Wechseln Sie zum Verzeichnis „TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2“.

  5. Führen Sie setup_wrapper.sh aus.

  6. Wechseln Sie zum Verzeichnis „TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase“.

  7. Führen Sie setup_wrapper.sh aus.

  8. 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';
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1