配置对Teradata的访问权限 configure-access-to-teradata

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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

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

teradata配置 teradata-config

您需要安装驱动程序，以便实现Teradata与Campaign的连接。

  1. 为Teradata🔗安装ODBC驱动程序。

    它由三个软件包组成，这些软件包可按以下顺序安装在Red Hat（或CentOS）/Suse上：

    • TeraGSS
    • tdicu1510（使用setup_wrapper.sh安装）
    • tdodbc1510（使用setup_wrapper.sh安装）

  2. 配置ODBC驱动程序。 可以在标准文件中执行配置： /etc/odbc.ini ​用于常规参数，/etc/odbcinst.ini用于声明驱动程序：

    • /etc/odbc.ini

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

      “InstallDir”对应于​ 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. 指定Adobe Campaign服务器的环境变量：

    • LD_LIBRARY_PATH： /opt/teradata/client/15.10/lib64和/opt/teradata/client/15.10/odbc_64/lib。
    • ODBCINI： odbc.ini文件的位置(例如/etc/odbc.ini)。
    • NLSPATH： opermsgs.cat文件的位置(https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=zh-Hans)
NOTE
连接到FDA中的Teradata外部数据库需要在Adobe Campaign服务器上执行其他配置步骤。 了解详情。

teradata外部帐户 teradata-external

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

  1. 在营销活动​ 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中设置的时区。 了解详情

连接器支持以下选项：

选项
说明
TD_MAX_SESSIONS
指定Teradata并行传输程序可以为操作员作业获取的最大登录会话数。
时区名称
服务器时区的名称。
字符集
用于配置Teradata字符集。
有关详情，请参阅本页。
IANAAppCodePage
ODBC应用程序代码页。
有关详情，请参阅本页

添加其他ODBC外部帐户 add-external

NOTE
此选项不适用于低于7.3.1版本的内部版本。

teradata驱动程序提供自己的ODBC库，但此库可能与其他ODBC外部帐户不兼容。

如果要配置另一个也使用ODBC的外部帐户，例如Snowflake，则需要将一个ODBCLib选项集添加到默认ODBC库的路径中（ Debian上为/usr/lib/x86_64-linux-gnu/libodbc.so，RHEL/CentOS上为/usr/lib64/libodbc.so）。

查询分段

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

配置此选项后，每次Campaign用户在Teradata数据库上执行查询时，Adobe Campaign都将发送与此用户关联的元数据，其中包括键列表。 然后，Teradata管理员可以使用此数据来进行审核或管理访问权限。

NOTE
有关​ Query banding ​的详细信息，请参阅Teradata文档。

要配置查询分段，请执行以下步骤：

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

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

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

外部帐户疑难解答 external-account-troubleshooting

如果在测试连接​ 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并访问“驱动程序”选项卡，可以找到确切的名称。

  • 如果您使用的是较旧的Campaign版本，则必须将驱动程序安装创建的odbcinst.ini的Teradata部分复制到名为Teradata的新部分。 在这种情况下，可以使用Regedit。 如果您的基数是latin1，则必须在选项中添加​ APICharSize=1。

其他配置 teradata-additional-configurations

用户配置 user-configuration

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

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

Adobe Campaign不会对其将在数据库中创建的对象设置保护模式（回退）。 您可能需要在Adobe Campaign将用于使用以下查询连接到Teradata数据库的用户上设置默认值：

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

MD5安装 md5-installation

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

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

要安装md5，请执行以下操作：

  1. 解压缩md5_20080530.zip文件。

  2. 转到md5/src目录。

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

  4. 运行以下bteq命令：

    code language-none 
    .run file = hash_md5.btq

SHA2安装 sha2-installation

如果要在Adobe Campaign实例中使用sha2函数，则必须从此页面 (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. 使用bteq连接到Teradata数据库。

  4. 运行以下两个bteq命令：

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

UDF_UTF16TO8安装 UDF-UTF16TO8-installation

如果要在Adobe Campaign实例中使用udf_utf16to8函数，请从​ Teradataunicode工具包 ​在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. 使用bteq连接到Teradata数据库。

  4. 键入以下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));

适用于Linux的Campaign服务器配置 campaign-server-linux

驱动程序安装需要以下内容：

  • 可在此页中找到的ODBC驱动程序Teradata

  • 可在此页中找到的Teradata工具和实用工具（用于批量加载）

文件名和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-installation

要安装ODBC驱动程序：

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

  2. 转到tdodbc1620目录。

  3. 您可能需要修复安装脚本：

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

  4. 运行setup_wrapper.sh。

teradata工具和实用程序安装 teradata-tools-installation

要安装工具，请执行以下操作：

  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/tptbase目录。

  7. 运行setup_wrapper.sh。

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

适用于Windows的Campaign服务器配置 campaign-server-windows

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

确保安装ODBC驱动程序和Teradata并行传输程序基础。 它将安装用于在Teradata数据库上进行批量加载的telapi.dll。

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

时区 timezone

teradata使用非标准的时区名称，您可以在Teradata站点上找到该列表。 Adobe Campaign将尝试将外部配置中给定的时区转换为Teradata能够理解的时区。 如果未找到通信，则会找到会话的最接近GMT+X（或GMT-X）时区，日志中会显示警告。

完成转换后，将读取名为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';
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1