配置对Teradata的访问

使用Campaign 联合数据访问(FDA)选项处理存储在外部数据库中的信息。 请按照以下步骤配置对Teradata的访问。

  1. 安装和配置Teradata驱动程序
  2. 在Campaign中配置Teradata外部帐户
  3. 为Teradata和Campaign服务器设置其他配置

Teradata配置

您需要安装Teradata驱动程序才能与Campaign实施连接。

  1. 安装ODBC驱动程序以用于Teradata

    它由三个包组成,这些包可以按以下顺序安装在Red Hat(或CentOS)/Suse上:

    • TeraGSS
    • tdicu1510(使用setup_wrapper.sh安装)
    • tdobc1510(使用setup_wrapper.sh安装它)
  2. 配置ODBC驱动程序。 配置可以在标准文件中执行:/etc/odbc.ini​用于常规参数,/etc/odbcinst.ini用于声明驱动程序:

    • /etc/odbc.ini

      [ODBC]
      InstallDir=/etc/
      

      "InstallDir"对应于​odbcinst.ini​文件的位置。

    • /etc/odbcinst.ini

      [ODBC DRIVERS]
      teradata=Installed
      
      [teradata]
      Driver=/opt/teradata/client/15.10/lib64/tdata.so
      APILevel=CORE
      ConnectFunctions=YYY
      DriverODBCVer=3.51
      SQLLevel=1
      
  3. 指定Adobe Campaign服务器的环境变量:

    • LD_LIBRARY_PATH:/opt/teradata/client/15.10/lib64和/opt/teradata/client/15.10/odbc_64/lib。
    • 奥德布奇尼:odbc.ini文件的位置(例如/etc/odbc.ini)。
    • NLSPATH:opermsgs.cat文件的位置(/opt/teradata/client/15.10/msg/opermsgs.cat?lang=zh-Hans)
注意

在FDA中连接到Teradata外部数据库需要在Adobe Campaign服务器上执行其他配置步骤。 了解详情

Teradata外部帐户

利用Teradata外部帐户,可将Campaign实例连接到Teradata外部数据库。

  1. 在Campaign Explorer​中,单击​Administration / Platform / External accounts

  2. 单击​New​并选择​External database​作为​Type

  3. 要配置​Teradata​外部帐户,必须指定:

    • Type:选择类 Teradata 型。

    • Server:teradata服务器的URL或名称

    • Account:用于访问Teradata数据库的帐户名称

    • Password:用于连接到Teradata数据库的密码

    • Database:数据库的名称(可选)

    • Options:要通过Teradata传递的选项。使用以下格式:“parameter=value”。 使用半列作为值之间的分隔符。

    • Timezone:在Teradata中设置时区。了解详情

查询分段

当多个Adobe Campaign用户连接到同一FDATeradata外部帐户时,Query banding​选项卡允许您在会话中设置查询带(即一组键/值对)。

配置此选项后,每次Campaign用户对Teradata数据库执行查询时,Adobe Campaign都会发送元数据,元数据包含与该用户关联的键列表。 然后,Teradata管理员可以将此数据用于审核目的或管理访问权限。

注意

有关​Query banding​的更多信息,请参阅Teradata文档

要配置查询分段,请执行以下步骤:

  1. 使用​Default​输入默认查询带,当用户没有关联的查询带时,将使用该带。 如果此字段留空,则没有查询带的用户将无法使用Teradata。

  2. 使用​Users​字段为每个用户指定查询带。 您可以根据需要添加任意数量的键/值对,例如priority=1;workload=high。 如果用户未分配查询带,则将应用​Default​字段。

  3. 选中​Active​框以激活此功能

外部帐户疑难解答

如果在测试连接​TIM-030008日期“2”时出现以下错误:缺少字符(iRc=-53)​确保ODBC驱动程序安装正确,并为Campaign服务器设置LD_LIBRARY_PATH(Linux)/ PATH(Windows)。

错误​ODB-240000 ODBC错误:[Microsoft][ODBC Driver Manager]未找到数据源名称,且未指定默认驱动程序。 如果使用16.X驱动程序,则在Windows中发生。Adobe Campaign在odbcinst.ini中希望teradata名为“{teradata}”。

  • 从Campaign 18.10开始,您可以在外部帐户的选项中添加ODBCDriverName="Teradata数据库ODBC驱动程序16.10"。 版本号可以更改,通过运行odbcad32.exe并访问“Drivers(驱动程序)”选项卡,可以找到确切的名称。

  • 如果您使用的是旧版Campaign,则必须将驱动程序安装所创建odbcinst.ini的Teradata部分复制到名为Teradata的新部分。 Regedit可在此用例中使用。 如果您的基位位于latin1,则必须在选项中添加​APICharSize=1

其他配置

用户配置

外部数据库需要以下权限:创建/拖放/执行自定义过程,创建/拖放/插入/选择表。 如果要在Adobe Campaign实例上使用md5和sha2函数,则可能还必须创建用户模式函数。

确保配置正确的时区。 它应该与将在Adobe Campaign实例中创建的外部帐户中设置的内容相匹配。

Adobe Campaign不会对它将在数据库中创建的对象设置保护模式(回退)。 您可能需要对用户设置一个默认值,Adobe Campaign将使用该用户通过以下查询连接到Teradata数据库:

禁用默认回退
MODIFY USER $login$ AS NO FALLBACK;

MD5安装

如果要在Adobe Campaign实例中使用md5函数,则必须从此page(md5_20080530.zip)在Teradata数据库上安装用户模式函数。

下载文件的sha1如下所示:65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e。

要安装md5,请执行以下操作:

  1. 解压缩md5_20080530.zip文件。

  2. 转到md5/src目录。

  3. 使用两者连接到Teradata数据库。

  4. 运行以下beq命令:

    .run file = hash_md5.btq
    

SHA2安装

如果要在Adobe Campaign实例中使用sha2函数,则必须从此page(teradata-udf-sha2-1.0.zip)在Teradata数据库上安装用户模式函数。

下载文件的sha1如下所示e87438d37424836358bd3902cf1adeb629349780。

要安装sha2,请执行以下操作:

  1. 解压缩teradata-udf-sha2-1.0.zip文件。

  2. 转到teradata-udf-sha2-1.0/src目录。

  3. 使用两者连接到Teradata数据库。

  4. 运行以下两个beq命令:

    .run file = hash_sha256.sql
    .run file = hash_sha512.sql
    

UDF_UTF16TO8安装

如果要在Adobe Campaign实例中使用udf_utf16to8函数,则必须从此(utk_release1.7.0.0.zip)的​Teradataunicode工具包(utk_release1.7.0.0.zip)在Teradata数据库上安装用户模式函数。

下载文件的sha1如下所示e58235f434f52c71316a577cb48e20b97d24f470。

要安装udf_utf16to8,请执行以下操作:

  1. 解压缩utk_release1.7.0.0.zip文件。

  2. 在提取的文件中查找udf_utf16to8.o,然后导航到包含该文件的目录。 它应命名为utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01TeradataUDFs/suselinux-x8664/udf_installation/。

  3. 使用两者连接到Teradata数据库。

  4. 键入以下beq命令:

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

Linux的Campaign服务器配置

安装驱动程序时需要满足以下条件:

  • TeradataODBC驱动程序,可在此中找到

  • Teradata工具和实用程序(用于批量加载),可在此page中找到

文件名和sha1:

  • tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f44fd

  • TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563

如果您的Linux分发没有包,您可以按照CentOS 7中的说明(例如使用docker)进行安装,然后在Adobe Campaign服务器上复制/opt/teradata的内容。

ODBC驱动程序安装

要安装ODBC驱动程序,请执行以下操作:

  1. 提取tdodbc1620__linux_indep.16.20.00.00-1.tar.gz文件。

  2. 转到tdobc1620目录。

  3. 您可能需要修复设置脚本:

    "sed -i s/16.10/16.20/ setup_wrapper.sh".
    
  4. 运行setup_wrapper.sh。

Teradata工具和实用程序安装

要安装工具,请执行以下操作:

  1. 提取TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz文件。

  2. 转到TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu目录。

  3. 运行setup_wrapper.sh。

  4. 转到TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2目录。

  5. 运行setup_wrapper.sh。

  6. 转到TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tpbase目录。

  7. 运行setup_wrapper.sh。

  8. libtelapi.so文件应在/opt/teradata/client/16.20/lib64中可用。

Windows的Campaign服务器配置

您首先需要下载适用于Windows的Teradata工具和实用程序。 可以从此page下载它

确保安装ODBC驱动程序和Teradata并行传输器库。 它将安装用于对Teradata库进行批量加载的telapi.dll。

确保驱动程序和实用程序的路径位于nlserver在执行期间将具有的PATH变量中。 默认情况下,路径为C:\Program Files (x86)\Teradata\Client\15.10\bin on Windows 32 bits or C:\Program Files\Teradata\Client\15.10\bin on 64 bit)。

时区

Teradata使用的时区名称不是标准名称,您可以在Teradata站点上找到该列表。 Adobe Campaign将尝试将外部配置中给定的时区转换为一些Teradata了解的时区。 如果找不到通信,则会在会话中找到其他时区的GMT+X(或GMT-X)时区,并在日志中显示警告。

转换完成后,将读取名为datakit目录中的teradata_timezones.txt文件:在linux下为/usr/local/neolane/nl6/datakit。 如果编辑此文件,请确保联系Adobe Campaign团队以在源代码中进行更改,否则下次更新Campaign时会覆盖此文件。

使用 — verbose开关运行nlserver时,将指示用于连接的时区,例如:

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

如果使用的时区不正确,则可以在外部帐户中添加名为“TimeZoneName”的选项。 在这种情况下,请使用Teradata值,例如“TimeZoneName=Europe Central”。

在Teradata文档中使用批量加载或“快速加载”时,Campaign无法指示时区。 因此,建议设置Campaign用于连接的用户的默认时区:

MODIFY USER $login$ AS TIME ZONE = 'Europe Central';

在此页面上