Konfigurera åtkomst till Teradata configure-access-to-teradata

Använd alternativet FDA (Federated Data Access) i kampanjen om du vill bearbeta information som lagras i en extern databas. Följ stegen nedan för att konfigurera åtkomst till Teradata.

  1. Installera och konfigurera Teradata-drivrutiner
  2. Konfigurera Teradatan externt konto i Campaign
  3. Konfigurera ytterligare konfiguration för Teradata- och kampanjservern

Teradata-konfiguration teradata-config

Du måste installera drivrutiner för att Teradatan ska kunna ansluta till Campaign.

  1. Installera ODBC-drivrutinen för Teradata.

    Den består av tre paket som kan installeras på Red Hat (eller CentOS)/Suse i följande ordning:

    • TeraGSS
    • tdicu1510 (installera den med setup_wrapper.sh)
    • tdodbc1510 (installera den med setup_wrapper.sh)
  2. Konfigurera ODBC-drivrutinen. Konfigurationen kan utföras i standardfilerna: /etc/odbc.ini för allmänna parametrar och /etc/odbcinst.ini för att deklarera drivrutiner:

    • /etc/odbc.ini

      code language-none
      [ODBC]
      InstallDir=/etc/
      

      "InstallDir" motsvarar platsen för filen 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. Ange miljövariablerna för Adobe Campaign-servern:

    • LD_LIBRARY_PATH: /opt/teradata/client/15.10/lib64 och /opt/teradata/client/15.10/odbc_64/lib.
    • ODBCINI: plats för filen odbc.ini (till exempel /etc/odbc.ini).
    • NLSPATH: plats för filen opermsgs.cat (https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=sv)
NOTE
För att ansluta till en extern Teradata-databas i FDA krävs ytterligare konfigurationssteg på Adobe Campaign-servern. Läs mer.

Teradatans externa konto teradata-external

Med det externa Teradatan kan du ansluta Campaign-instansen till din Teradatas externa databas.

  1. Klicka på Administration / Platform / External accounts i Campaign Explorer.

  2. Klicka på New och välj External database som Type.

  3. Om du vill konfigurera det externa kontot Teradata måste du ange:

    • Type: Välj typen Teradata.

    • Server: URL-adress eller namn på Teradata-servern

    • Account: Namn på det konto som används för att komma åt Teradata-databasen

    • Password: Lösenord som används för att ansluta till Teradata-databasen

    • Database: Namn på databasen (valfritt)

    • Options: Alternativ som ska skickas via Teradata. Använd följande format: 'parameter=value'. Använd semikolon som avgränsare mellan värden.

    • Timezone: Tidszonen har angetts i Teradata. Läs mer

Kopplingen stöder följande alternativ:

Alternativ
Beskrivning
TD_MAX_SESSIONS
Anger det maximala antalet inloggningssessioner som Teradata Parallel Transporter kan hämta för ett operatorjobb.
TimeZoneName
Namn på serverns tidszon.
CharacterSet
Används för att konfigurera teckenuppsättningen Teradata.
Mer information finns på den här sidan.
IANAAppCodePage
Kodsida för ODBC-program.
Mer information finns på sidan

Lägg till ytterligare ODBC-externa konton add-external

NOTE
Det här alternativet är inte tillgängligt för byggen som är äldre än 7.3.1-versionen.

Teradata-drivrutinen tillhandahåller ett eget ODBC-bibliotek, men det här biblioteket kanske inte är kompatibelt med andra ODBC-externa konton.

Om du vill konfigurera ett annat externt konto som även använder ODBC, t.ex. Snowflake, måste du lägga till ett ODBCLib-alternativ som anges i sökvägen till ODBC-standardbiblioteket (/usr/lib/x86_64-linux-gnu/libodbc.so på Debian och /usr/lib64/libodbc.so på RHEL/CentOS).

Frågeränder

När flera Adobe Campaign-användare ansluter till samma externa FDA-Teradata-konto kan du på fliken Query banding ställa in ett frågeband, dvs. en uppsättning nyckel/värde-par, för en session.

När det här alternativet är konfigurerat skickar Adobe Campaign metadata varje gång en Campaign-användare utför en fråga i Teradata-databasen, vilket består av en lista med nycklar som är kopplade till den här användaren. Dessa data kan sedan användas av Teradata-administratörer för revision eller för att hantera åtkomsträttigheter.

NOTE
Mer information om Query banding finns i Teradata-dokumentationen.

Så här konfigurerar du Query-ränder:

  1. Använd Default för att ange ett standardfrågeband som ska användas om en användare inte har något associerat frågeband. Om det här fältet lämnas tomt kommer användare utan frågeband inte att kunna använda Teradata.

  2. Använd fältet Users för att ange ett frågeband för varje användare. Du kan lägga till så många nyckel/värde-par du behöver, t.ex. priority=1;workload=high. Om användaren inte har något frågeband tilldelat används fältet Default.

  3. Markera rutan Active om du vill aktivera den här funktionen

Felsökning av externa konton external-account-troubleshooting

Om följande fel uppstår när anslutningen TIM-030008 Datum '2' testas: tecken som saknas (iRc=-53) kontrollerar du att ODBC-drivrutinen är korrekt installerad och att LD_LIBRARY_PATH (Linux)/PATH (Windows) är inställd för Campaign-servern.

Felet ODB-240000 ODBC-fel: [Microsoft][ODBC Driver Manager] Det gick inte att hitta datakällans namn och ingen standarddrivrutin har angetts. inträffar med Windows om du använder en 16.X-drivrutin. Adobe Campaign förväntar sig att teradatan får namnet {teradata} i odbcinst.ini.

  • Från och med Campaign 18.10 kan du lägga till ODBCDriverName="Teradata Database ODBC Driver 16.10" i alternativen för det externa kontot. Versionsnumret kan ändras. Du hittar det exakta namnet genom att köra odbcad32.exe och gå till fliken Drivrutiner.

  • Om du använder en äldre Campaign-version måste du kopiera Teradatan av odbcinst.ini som skapas av drivrutinsinstallationen till ett nytt avsnitt som kallas Teradata. I det här fallet kan du använda regedit. Om basen är i latin1 måste du lägga till APICharSize=1 i alternativen.

Ytterligare konfigurationer teradata-additional-configurations

Användarkonfiguration user-configuration

Följande rättigheter krävs för den externa databasen: skapa/släppa/köra anpassade procedurer, skapa/släpp/infoga/markera tabeller. Du kan också behöva skapa användarlägesfunktioner om du vill använda funktionen md5 och sha2 i din Adobe Campaign-instans.

Kontrollera att du har konfigurerat rätt tidszon. Den ska matcha vad som kommer att anges i det externa konto som skapas i Adobe Campaign-instansen.

Adobe Campaign kommer inte att ange skyddsläge (reserv) för de objekt som skapas i databasen. Du kan behöva ange ett standardvärde för den användare som Adobe Campaign ska använda för att ansluta till Teradata-databasen med följande fråga:

inaktivera standardåtergång
MODIFY USER $login$ AS NO FALLBACK;

MD5-installation md5-installation

Om du vill använda md5-funktioner i din Adobe Campaign-instans måste du installera funktionen för användarläge i din Teradata-databas från sidan (md5_20080530.zip).

SHA1 för den hämtade filen är som följer 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.

Så här installerar du md5:

  1. Zippa upp filen md5_20080530.zip.

  2. Gå till katalogen md5/src.

  3. Anslut till din Teradata-databas med bteq.

  4. Kör följande bteq-kommando:

    code language-none
    .run file = hash_md5.btq
    

SHA2-installation sha2-installation

Om du vill använda sha2-funktioner i din Adobe Campaign-instans måste du installera funktionen för användarläge i din Teradata-databas från sidan (teradata-udf-sha2-1.0.zip).

Sha1 för den hämtade filen är som följer e87438d37424836358bd3902cf1adeb629349780.

Så här installerar du SHA2:

  1. Zippa upp filen teradata-udf-sha2-1.0.zip.

  2. Gå till katalogen teradata-udf-sha2-1.0/src.

  3. Anslut till din Teradata-databas med bteq.

  4. Kör följande två bteq-kommandon:

    code language-none
    .run file = hash_sha256.sql
    .run file = hash_sha512.sql
    

UDF_UTF16TO8-installation UDF-UTF16TO8-installation

Om du vill använda udf_utf16to8-funktioner i din Adobe Campaign-instans installerar du funktionen för användarläge i din Teradata-databas från Unicode-verktygslådan för Teradata.

SHA1 för den hämtade filen är som följer e58235f434f52c71316a577cb48e20b97d24f470.

Så här installerar du udf_utf16to8:

  1. Zippa upp filen utk_release1.7.0.0.zip.

  2. Leta efter filen udf_utf16to8.o i de extraherade filerna och navigera till katalogen som innehåller filen. Den ska ha namnet utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01 Teradata UDFs/suselinux-x8664/udf_installation/.

  3. Anslut till din Teradata-databas med bteq.

  4. Skriv i följande bteq-kommando:

    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));
    

Kampanjserverkonfiguration för Linux campaign-server-linux

Följande krävs för drivrutinsinstallationen:

  • ODBC-drivrutin för teradata, som finns på sidan

  • Verktyg och verktyg för teradata (används för massinläsning), som finns på sidan

Filnamn och SHA1:

  • tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f4 4fd

  • TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563

Om det inte finns något paket för din Linux-distribution kan du installera enligt anvisningarna på en CentOS 7 (t.ex. med docker) och sedan kopiera innehållet i /opt/teradata på din Adobe Campaign-server.

Installation av ODBC-drivrutin odbc-installation

Så här installerar du ODBC-drivrutinen:

  1. Extrahera filen tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.

  2. Gå till katalogen tdodbc1620.

  3. Du kan behöva åtgärda installationsskriptet:

    code language-none
    "sed -i s/16.10/16.20/ setup_wrapper.sh".
    
  4. Kör setup_wrapper.sh.

Installation av verktyg och verktyg för teradata teradata-tools-installation

Så här installerar du verktyg:

  1. Extrahera filen TeradataToolsAndUtilitiesBase_linux_indep.16.20.01.00.tar.gz.

  2. Gå till katalogen TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu.

  3. Kör setup_wrapper.sh.

  4. Gå till katalogen TeradataToolsAndUtilitiesBase/Linux/i386-x864/cliv2.

  5. Kör setup_wrapper.sh.

  6. Gå till katalogen TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.

  7. Kör setup_wrapper.sh.

  8. En libtelapi.so-fil ska vara tillgänglig i /opt/teradata/client/16.20/lib64.

Kampanjserverkonfiguration för Windows campaign-server-windows

Du måste först ladda ned Teradata Tools and Utilities för Windows. Du kan hämta den från sidan

Installera ODBC-drivrutinen och Teradata Parallel Transporter Base. Den installerar telapi.dll som används för massinläsning på Teradata-databasen.

Kontrollera att sökvägen till drivrutinen och verktygen finns i den PATH-variabel som ingen lserver kommer att ha under körningen. Som standard är sökvägen C:\Program filer (x86)\Teradata\Client\15.10\bin i Windows 32 bitar eller C:\Program Files\Teradata\Client\15.10\bin i 64 bitar).

Tidszon timezone

Teradata använder ett namn på en tidszon som inte är standard finns i listan på Teradata-webbplatsen. Adobe Campaign kommer att försöka konvertera tidszonen som anges i den externa konfigurationen till något som Teradatan förstår. Om ingen korrespondens hittas kommer tidszonen GMT+X (eller GMT-X) som stängs att hittas för sessionen, med en varning i loggen.

Konverteringen är klar med läsningen av en fil med namnet teradata_timezone.txt som ska finnas i följande datakatalog: /usr/local/neolane/nl6/datakit under linux. Om du redigerar den här filen måste du kontakta Adobe Campaign-teamet för att ändra källkoden, annars skrivs den här filen över vid nästa Campaign-uppdatering.

Tidszonen som används för att ansluta anges när en lserver körs med växeln -verbose, till exempel:

15:04:04 >   ODB-240007 Teradata: will use 'Europe Central' as session time zone.

Om den tidszon som används inte är korrekt kan ett alternativ med namnet"TimeZoneName" läggas till på det externa kontot. I så fall använder du Teradata Value, till exempel"TimeZoneName=Europe Central".

När massinläsning eller"snabb inläsning" används i Teradata-dokument kan Campaign inte ange tidszonen. Därför rekommenderar vi att du anger standardtidszonen för användaren som ska användas i Campaign för att ansluta:

MODIFY USER $login$ AS TIME ZONE = 'Europe Central';
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1