2.15 - Presto 连接器和链接属性 - Teradata QueryGrid

Teradata® QueryGrid™ 安装和用户指南

Product
Teradata QueryGrid
Release Number
2.15
Release Date
2021 年 3 月
Content Type
安装
用户指南
管理
配置
Publication ID
B035-5991-031K-CHS
Language
中文 (简体)
QueryGrid 门户组件中创建链接和相关属性时,将创建配置名称值对 (NVP)。NVP 执行以下操作:
  • 指定目标连接器组件的行为
  • 配置数据的转换方式
  • 配置基础链接数据传输层
  • 影响发起程序连接器的执行方式

链接是包括发起连接器和目标连接器的命名配置。如果为链接和连接器设置了相同的属性,则链接设置将覆盖连接器设置。

属性可能仅用于发起连接器、仅目标连接器或两者。

“基本”选项卡

名称 缺省 说明 可覆盖?

属性名称

连接器类型
服务器 None 作为 JDBC 连接字符串的一部分,用于连接到目标数据库。此为目标主机的 IP 地址或 DNS 名称。对于 AWS CFT,请使用 PrestoCoordinatorURL(在创建 CloudFormation 堆栈后作为输出值提供)的 IP 部分。   目标
端口 8090 有时设置为 8080。

这是必需的设置。

有效值为 1026-65535。可以覆盖缺省值。

  目标
目录名称 hive Presto 连接器的目录名称。   目标
模式名称 缺省 用于 Presto 连接器的模式的名称。   目标

“安全”选项卡

名称 缺省 说明 可覆盖?

属性名称

连接器类型
身份验证机制 None 指示目标数据源上使用的身份验证机制。

有效值为 None、Kerberos 和 LDAP/Okta。

这是必需的设置。

  目标
用户名 用户的名称。

最大长度为 255 个字符。

该 NVP 保存在 Teradata QueryGrid 管理器配置中,当发起程序不支持提供用户凭据的机制时,该 NVP 是必需的。该用户名还用于连接诊断检查。
  目标
密码 None 用户密码。

最大长度为 255 个字符。

使用 Kerberos 时不得设置密码。

  目标
Kerberos Keytab None Kerberos keytab 文件的绝对路径。只有在用户未提供用户名和密码的情况下,QueryGrid 才会用它进行身份验证。   目标
Kerberos 领域 None Kerberos 领域。   目标
Kerberos 服务名称 Presto 如果使用 Kerberos,必须与在 Presto 协调器 config.properties 文件中设置的 http-server.authentication.krb5.service-name 相匹配。   目标
角色支持 False 对目标系统启用用户角色支持。此功能仅可用于 Presto 与 Sentry 配合使用的情况。

如果设置为 true,则发起程序或目标中的用户角色将根据角色映射(如果有)应用于目标系统。如果集群配置为支持角色,则会将错误返回给用户。如果集群未配置为支持角色,则不应用用户角色。

如果设置为 false,则不对目标系统应用角色。

roleSupport

目标
SSL 可信或密钥存储的路径 None 用于 Presto 上的 Kerberos 或 LDAP/Okta 身份验证的 SSL 信任库或密钥库路径。   目标
SSL 可信或密钥存储的密码 None 用于 Presto 上的 Kerberos 或 LDAP/Okta 身份验证的 SSL 信任库或密钥库密码。   目标

“查询引擎”选项卡

名称 缺省 说明 可覆盖?

属性名称

连接器类型
Explain 种类 LOGICAL 定义用于远程 Presto 查询 EXPLAIN SQL 语句的 Explain 种类。

有效值为 LOGICAL 或 DISTRIBUTED。

explainKind

目标
Presto 读取程序任务并发 8 Presto 中每个查询的每个工作线程上并行的并发读取程序数。

有效值为 1-32。

prestoReaderTaskConcurrency

目标
Presto 写入程序计数 8 Presto 中的并行写入程序数或每个查询每个工作线程的并发写入程序线程数。

有效值为 1-32。

prestoWriterCount

目标

“高级”选项卡

名称 缺省 说明 可覆盖?

属性名称

连接器类型
临时模式名称 None 用于创建临时表/视图的已指定数据库名称。

如果在此属性中不提供数据库名称,QueryGrid 将在分配给用户的缺省数据库中创建临时视图。

tempDbName

目标
启用日志记录 INFO 连接器或链接属性的日志记录级别。用户级别的日志设置可以在 QueryGrid 门户组件的添加或编辑链接页面中显式设置。

此设置适用于发起连接器和目标连接器。如果设置不同,将优先应用链接中发起程序连接器的日志记录级别。

有效值:NONE、WARN、INFO 和 DEBUG。

  发起程序、目标
禁用下推 False 设置为 true 时,将对目标系统禁用所有查询条件的下推。

某些系统级别、会话级别和列级别查询属性(如大小写特定)可能会影响字符串的比较结果。这些属性可能会由于目标系统上的不正确行筛选而返回不正确的结果。

为了避免在发起系统上的设置与目标系统上的设置不匹配的情况下条件下推导致结果不正确,您可以对目标系统禁用所有条件下推。

如果将此属性指定为“可覆盖”,则只能在会话级别将其从 false 更改为 true(表示要禁用下推),但不能将其从 true 更改为 false。

disablePushdown

发起程序
16.20+ LOB 支持 True 在 Teradata 系统版本 16.20 及更高版本中,Presto 上的 STRING 和 BINARY 列缺省映射至 CLOB 和 BLOB。取消选择此选项可将 STRING 和 BINARY 列分别映射至 VARCHAR 和 VARBYTE。

如果 Presto 表中有大量 STRING/BINARY 列,请禁用此选项。

lobSupport

目标
缺省字符串大小 32000 个字符 VARCHAR 截断大小。

从字符串列导入或导出至字符串列的数据将在该大小处截断。该值表示要导入的最大 Unicode 字符数,缺省值为 32000 个字符。如果在 defaultStringSize 中设置的缺省值小于实际列大小,Teradata QueryGrid 会在此缺省值处截断字符串列。

有效值为 1-1048544000 个字符。

该有效值适用于 Teradata 到 Presto 链接,由目标 Presto 连接器使用,当发起 Teradata 系统支持 QueryGrid 的 CLOB 数据类型时适用。在 CLOB 支持下,不使用缺省字符串大小。

defaultStringSize

目标
缺省二进制大小 64000 字节 VARBINARY 类型的缺省截断大小。

有效值为 1-2097088000 字节。

该有效值适用于 Teradata 到 Presto 链接,由目标 Presto 连接器使用,当发起 Teradata 系统支持 QueryGrid 的 BLOB 数据类型时适用。在 BLOB 支持下,不使用缺省二进制大小。

defaultBinarySize

目标
时间戳时区 None 使用指定的时区计算时间戳。时区属性值必须存在于 Java 返回的 TimeZone.getAvailableIDs() 列表中。

TimestampTimezone

目标
链接缓冲区计数 4 单通道上同时可用的最大写入缓冲区数量。
链接缓冲区计数将覆盖内部网络结构属性 shmDefaultNumMemoryBuffers 的缺省值。

有效值范围为 4-8。

linkBufferCount

发起程序、目标
链接缓冲区大小 1048576 为行处理和消息交换分配的写入缓冲区的最大大小。

有效值范围为 73728-10485760 个字节。

linkBufferSize

发起程序
响应超时 86400000 等待目标查询完成的毫秒数,随后目标查询超时并停止操作。网络结构停止并释放持续时间超过目标链接属性或目标连接器属性中设置的值相关联的所有资源。当网络结构的响应超过响应超时值时,连接器超时。

有效值为 300000-172800000。

responseTimeout

发起程序、目标
连接最大空闲时间 86400 秒 连接缓存对象的最大空闲时间,超过该时间之后,该对象将关闭并从缓存中移除。如果系统上运行着多个并发用户和查询,可能导致连接对象匮乏,请使用此属性。

有效值为 1-86400 秒。

  目标
连接池大小 100 连接池中可存储的最大连接对象数。在获取新连接时,连接器将检查池中的可用空间。如果连接池中可用空间不足,则连接将在 5 分钟后失败。仅允许为每个连接器配置提供一个连接池和用户名。

有效值为 1-10000。

  目标
连接逐出频率 30 分钟 逐出检查的频率。如果某个连接对象的空闲时间(当前时间-上次使用时间)超过连接最大空闲时间设置,则会检查、关闭并移除池中的连接对象。

如果存在多个运行查询的并发用户,请缩短此检查间隔时间,以便更频繁地清除连接。

有效值为 1-1440 分钟。

  目标