Toegang tot Teradata configureren configure-access-to-teradata

De optie van de Toegang van Gegevens van de Campagne van het gebruik ​ Federated ​ (FDA) om informatie te verwerken die in externe gegevensbestanden wordt opgeslagen. Voer de onderstaande stappen uit om toegang tot Teradata te configureren.

  1. Installeer en vorm ​ de bestuurders van Teradata ​
  2. Vorm de Teradata ​ externe rekening ​ in Campagne
  3. Opstelling ​ extra configuratie ​ voor Teradata en de server van de Campagne

Teradata-configuratie teradata-config

U moet stuurprogramma's installeren voordat Teradata verbinding kan maken met Campagne.

  1. Installeer de ​ bestuurder ODBC voor Teradata ​.

    Het bestaat uit drie pakketten die in de volgende volgorde op Red Hat (of CentOS)/Suse kunnen worden geïnstalleerd:

    • TeraGSS
    • tdicu1510 (installeer het met setup_wrapper.sh)
    • tdodbc1510 (installeer het met setup_wrapper.sh)
  2. Vorm het ODBC bestuurder. De configuratie kan in de standaarddossiers worden uitgevoerd: /etc/odbc.ini voor algemene parameters en /etc/odbcinst.ini voor het verklaren van bestuurders:

    • /etc/odbc.ini

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

      "InstallDir"beantwoordt aan de plaats van het {dossier 0} 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. Geef de omgevingsvariabelen van de Adobe Campaign-server op:

    • LD_LIBRARY_PATH: /opt/teradata/client/15.10/lib64 en /opt/teradata/client/15.10/odbc_64/lib.
    • ODBCINI: plaats van het odbc.ini- dossier (bijvoorbeeld /etc/odbc.ini).
    • NLSPATH: plaats van het opermsgs.cat- dossier (https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=nl)
NOTE
Voor het verbinden met een externe Teradata-database in FDA zijn aanvullende configuratiestappen op de Adobe Campaign-server vereist. Meer informatie.

Externe Teradata-account teradata-external

Met de externe Teradata-account kunt u uw Campagne-instantie verbinden met uw externe Teradata-database.

  1. Klik in Campagne Explorer op Administration / Platform / External accounts .

  2. Klik op New en selecteer External database as Type .

  3. Als u de externe account van Teradata wilt configureren, moet u opgeven:

    • Type : kies het Teradata type.

    • Server: URL of naam van uw Teradata-server

    • Account: naam van de account die wordt gebruikt voor toegang tot de Teradata-database

    • Password: wachtwoord gebruikt om verbinding te maken met de Teradata-database

    • Database: Naam van de database (optioneel)

    • Options: opties die door Teradata moeten worden doorgegeven. Gebruik de volgende indeling: 'parameter=value'. Gebruik een puntkomma als scheidingsteken tussen waarden.

    • Timezone: tijdzone ingesteld in Teradata. Meer informatie

De connector ondersteunt de volgende opties:

Optie
Beschrijving
TD_MAX_SESSIONS
Geeft het maximumaantal aanmeldingssessies op dat de Teradata Parallelle Transporter kan verkrijgen voor een operatortaak.
TimeZoneName
Naam van de servertijdzone.
CharacterSet
Wordt gebruikt om Teradata-tekenset te configureren.
voor meer op dit, verwijs naar ​ deze pagina ​.
IANAppCodePage
Codepagina van ODBC-toepassing.
voor meer op dit, verwijs naar ​ deze pagina ​

Extra externe ODBC-accounts toevoegen add-external

NOTE
Deze optie is niet beschikbaar voor builds ouder dan versie 7.3.1.

Het stuurprogramma van Teradata biedt een eigen ODBC-bibliotheek, maar deze bibliotheek is mogelijk niet compatibel met andere externe ODBC-accounts.

Als u een andere externe account wilt configureren die ook ODBC gebruikt, bijvoorbeeld Snowflake, moet u een ODBCLib-optie toevoegen die is ingesteld op het pad van de standaard ODBC-bibliotheek (/usr/lib/x86_64-linux-gnu/libodbc.so bij Debian en /usr/lib64/libodbc.so bij RHEL/CentOS).

Query-streepjescodes

Wanneer meerdere Adobe Campaign-gebruikers verbinding maken met dezelfde externe FDA Teradata-account, kunt u op het tabblad Query banding een queryband instellen, dat wil zeggen een set sleutel-/waardeparen, voor een sessie.

Wanneer deze optie wordt gevormd, telkens als een gebruiker van de Campagne een vraag op het gegevensbestand van Teradata uitvoert, zal Adobe Campaign meta- gegevens verzenden, die uit een lijst van sleutels bestaan, verbonden aan deze gebruiker. Deze gegevens kunnen vervolgens door Teradata-beheerders worden gebruikt voor auditdoeleinden of voor het beheren van toegangsrechten.

NOTE
Voor meer informatie over Query banding, verwijs naar de ​ documentatie van Teradata ​.

Voer de onderstaande stappen uit om querybanding te configureren:

  1. Gebruik Default om een standaardvraagband in te gaan die zal worden gebruikt als een gebruiker geen bijbehorende vraagband heeft. Als dit veld leeg blijft, kunnen gebruikers zonder queryband Teradata niet gebruiken.

  2. Gebruik het veld Users om een queryband voor elke gebruiker op te geven. U kunt zoveel sleutel-/waardeparen toevoegen als u nodig hebt, bijvoorbeeld priority=1;workload=high. Als aan de gebruiker geen queryband is toegewezen, wordt het veld Default toegepast.

  3. Schakel het selectievakje Active in om deze functie te activeren

Problemen met externe accounts oplossen external-account-troubleshooting

Als de volgende fout terwijl het testen van de verbinding TIM-030008 Datum "2"verschijnt: het ontbreken karakter (iRc=-53) zorgt ervoor dat de bestuurder ODBC correct geïnstalleerd is en dat LD_LIBRARY_PATH (Linux) / PATH (Vensters) voor de server van de Campagne wordt geplaatst.

The error ODB-240000 ODBC error: [Microsoft][ODBC Driver Manager] Data source name not found and no default driver specified. treedt op bij Windows als u een 16.X-stuurprogramma gebruikt. Adobe Campaign verwacht dat de teradata '{teradata}' in odbcinst.ini worden genoemd.

  • Vanaf Campagne 18.10 kunt u ODBCDriverName="Teradata Database ODBC Driver 16.10" toevoegen in de opties van de externe account. Het versienummer kan veranderen, de nauwkeurige naam kan worden gevonden door odbcad32.exe in werking te stellen en tot de Drivers tabel toegang te hebben.

  • Als u een oudere versie van de Campagne gebruikt, zult u het Teradata gedeelte van odbcinst.ini moeten kopiëren die door de bestuurdersinstallatie aan een nieuwe sectie wordt gecreeerd genoemd Teradata. In dit geval kan Regedit worden gebruikt. Als uw basis in latin1 is, zult u APICharSize=1 in de opties moeten toevoegen.

Aanvullende configuraties teradata-additional-configurations

Gebruikersconfiguratie user-configuration

De volgende rechten zijn vereist voor de externe database: aangepaste procedures maken/neerzetten/uitvoeren, tabellen maken/neerzetten/invoegen/selecteren. Het kan ook zijn dat u functies voor de gebruikersmodus moet maken als u de functies md5 en sha2 op uw Adobe Campaign-instantie wilt gebruiken.

Zorg ervoor om de correcte tijdzone te vormen. Deze moet overeenkomen met wat wordt ingesteld in de externe account die wordt gemaakt in de Adobe Campaign-instantie.

Adobe Campaign stelt geen beveiligingsmodus (fallback) in voor de objecten die worden gemaakt in de database. Mogelijk moet u een standaard instellen voor de gebruiker die Adobe Campaign gebruikt om verbinding te maken met de Teradata-database met behulp van de volgende query:

standaard fallback uitschakelen
MODIFY USER $login$ AS NO FALLBACK;

MD5-installatie md5-installation

Als u md5 functies in uw instantie van Adobe Campaign wilt gebruiken, zult u de functie van de gebruikerswijze op uw gegevensbestand van Teradata van deze ​ pagina ​ (md5_20080530.zip) moeten installeren.

De sha1 van het gedownloade bestand is als volgt 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.

Om md5 te installeren:

  1. Pak het bestand md5_20080530.zip uit.

  2. Ga naar de map md5/src.

  3. Maak verbinding met uw Teradata-database met behulp van bteq.

  4. Voer de volgende opdracht bteq uit:

    code language-none
    .run file = hash_md5.btq
    

SHA2-installatie sha2-installation

Als u sha2 functies in uw instantie van Adobe Campaign wilt gebruiken, zult u de functie van de gebruikerswijze op uw gegevensbestand van Teradata van deze ​ pagina ​ (teradata-udf-sha2-1.0.zip) moeten installeren.

De sha1 van het gedownloade bestand is als volgt: e87438d37424836358bd3902cf1adeb629349780.

Om sha2 te installeren:

  1. Pak het zip-bestand teradata-udf-sha2-1.0.zip uit.

  2. Ga naar de map teradata-udf-sha2-1.0/src.

  3. Maak verbinding met uw Teradata-database met behulp van bteq.

  4. Voer de twee volgende bitmapopdrachten uit:

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

UDF_UTF16TO8-installatie UDF-UTF16TO8-installation

Als u udf_utf16to8 functies in uw instantie van Adobe Campaign wilt gebruiken, installeer de functie van de gebruikerswijze op uw gegevensbestand van Teradata van de het toolkit van Teradata unicode.

De sha1 van het gedownloade bestand is als volgt: e58235f434f52c71316a577cb48e20b97d24f470.

U installeert als volgt udf_utf16to8:

  1. Pak het zip-bestand utk_release1.7.0.0.zip uit.

  2. Zoek naar udf_utf16to8.o in de gehaalde dossiers en navigeer aan de folder die het dossier bevat. De naam moet utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01 Teradata UDFs/suselinux-x8664/udf_installation/ zijn.

  3. Maak verbinding met uw Teradata-database met behulp van bteq.

  4. Typ de volgende opdracht in het vak 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));
    

Configuratie van de campagnereserver voor Linux campaign-server-linux

Voor de installatie van het stuurprogramma is het volgende vereist:

  • De Bestuurder van Teradata ODBC, die in deze ​ pagina ​ kan worden gevonden

  • Teradata Hulpmiddelen en Hulpmiddelen (die voor de bulklading worden gebruikt), die in deze ​ pagina ​ kunnen worden gevonden

Bestandsnamen en sha1:

  • tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f 44fd

  • TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563

Als er geen pakket voor uw distributie van Linux is, kunt u installeren zoals verklaard op CentOS 7 (bijvoorbeeld gebruikend docker) en dan de inhoud van /opt/teradata op uw server van Adobe Campaign kopiëren.

Installatie van ODBC-stuurprogramma odbc-installation

ODBC-stuurprogramma installeren:

  1. Extraheer het bestand tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.

  2. Ga naar de directory tdodbc1620.

  3. Mogelijk moet u het setscript herstellen:

    code language-none
    "sed -i s/16.10/16.20/ setup_wrapper.sh".
    
  4. Voer setup_wrapper.sh uit.

Installatie van Teradata-gereedschappen en -hulpprogramma's teradata-tools-installation

Gereedschappen installeren:

  1. Extraheer het bestand TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.

  2. Ga naar de map TeradataToolsAndUtilitiesBase/Linux/i386-x864/tdicu.

  3. Voer setup_wrapper.sh uit.

  4. Ga naar de map TeradataToolsAndUtilitiesBase/Linux/i386-x864/cliv2.

  5. Voer setup_wrapper.sh uit.

  6. Ga naar de map TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.

  7. Voer setup_wrapper.sh uit.

  8. Een bestand libtelapi.so moet beschikbaar zijn in /opt/teradata/client/16.20/lib64.

Configuratie van de campagneserver voor Windows campaign-server-windows

U moet eerst Teradata Tools en Extra's voor Windows downloaden. U kunt het van deze ​ pagina ​ downloaden

Installeer het ODBC-stuurprogramma en de Teradata Parallel Transporter Base. Het installeert telapi.dll dat wordt gebruikt voor het laden van grote hoeveelheden in de Teradata-database.

Zorg ervoor dat het pad van het stuurprogramma en de hulpprogramma's zich in de PATH-variabele bevindt die de server tijdens de uitvoering zal hebben. Standaard is het pad C:\Program Files (x86)\Teradata\Client\15.10\bin op Windows 32 bits of C:\Program Files\Teradata\Client\15.10\bin op 64 bits).

Tijdzone timezone

Teradata gebruikt tijdzonenaam die niet standaard is, kunt u de lijst op de ​ plaats van Teradata ​ vinden. Adobe Campaign zal proberen de tijdzone die in de externe configuratie wordt gegeven om te zetten in iets wat Teradata begrijpt. Als er geen overeenkomst wordt gevonden, wordt de dichtstbijzijnde GMT+X (of GMT-X)-tijdzone gevonden voor de sessie, met een waarschuwing in het logbestand.

De conversie is voltooid en er wordt een bestand met de naam teradata_timezones.txt gelezen dat zich in de volgende gegevensdirectory moet bevinden: /usr/local/neolane/nl6/datakit onder Linux. Als u dit bestand bewerkt, moet u contact opnemen met het Adobe Campaign-team om de wijziging in de broncode door te voeren anders wordt dit bestand overschreven tijdens de volgende campagneupdate.

De tijdzone die wordt gebruikt om te verbinden zal worden vermeld wanneer het runnen van nlserver met - verbose schakelaar, bijvoorbeeld:

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

Als de gebruikte tijdzone niet de juiste is, kan een optie met de naam "TimeZoneName" worden toegevoegd aan de externe account. In dat geval gebruikt u de Teradata-waarde, bijvoorbeeld "TimeZoneName=Europe Central".

Bij het gebruik van bulkload of 'fast load' in Teradata-documenten kan Campagne de tijdzone niet aangeven. Daarom wordt geadviseerd om de standaardtijdzone van de gebruiker te plaatsen die de Campagne zal gebruiken om te verbinden:

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