Spotfire® 用户指南

Teradata 连接器 - 功能和设置

可以使用 Teradata 连接器连接到 Teradata 数据库并访问其中的数据。在此页面上,可以了解相关功能、可用设置以及处理与 Teradata 的数据连接时的注意事项。

页面内容

连接器功能

当您使用 Teradata 连接器访问数据时,可以使用以下功能。

功能 支持?
加载方法
  • 导入(内存中)
  • 外部(数据库内)
  • 按需
自定义查询
预存程序
自定义连接属性
使用身份提供程序进行单点登录
在 Web 客户端中编写
包含在 Linux 上的 Spotfire 发行版中

数据源属性

以下是在使用 Teradata 连接器创建数据连接时可以配置的受支持的数据源属性。

选项 说明
服务器

您的数据所在的服务器名称。要包含端口号,请将其直接添加在服务器名称的后面,前面带有冒号。

端口号的示例:MyTeradataDatabaseServer:1234

身份验证方法 当登录到数据库时要使用的身份验证方法。从 Teradata 身份验证 (TD2)、LDAP 身份验证和 Windows 身份验证中选择。

Teradata 身份验证 (TD2)

使用数据库用户进行身份验证。

系统会提示打开连接或打开使用该连接的分析的用户输入数据库凭据以连接到数据源。

提示: 您可以使用“数据源设置”对话框中的设置将数据库凭据以未加密形式另存为分析文件的一部分。如果凭据嵌入在分析中,则意味着系统不会在用户连接到数据源时提示其输入凭据。请注意,将数据库凭据嵌入在分析文件中会带来安全风险。

LDAP 身份验证

使用 LDAP 身份验证时,系统会提示用户输入其 LDAP 凭据。在 LDAP 目录中拥有有效帐户的用户能够连接和读取数据。

Windows 身份验证

使用 Windows 身份验证(例如 Kerberos)时,系统将使用已登录用户的访问令牌。已提供对 Teradata 的适当访问权限的用户能够连接和读取数据。

域凭据未存储在分析文件中。

连接 将您连接到指定服务器并填充可用数据库的下拉列表。
数据库 成功连接后将列出可用的数据库。
使用数据加密 选中此复选框可在连接到 Teradata 时使用数据加密。
使用 X 视图 选中此复选框可使用 X 视图。X 视图可以将用户的视图限制为仅显示用户有权访问的数据库和表。这可以缩短加载元数据所用的时间。
会话字符集 选择在连接到 Teradata 时使用哪个会话字符集。
会话模式 选择在连接到 Teradata 时使用哪个会话模式。选择的模式将会影响如何处理事务过程中的错误以及性能。
连接超时(秒)

指定与数据库尝试建立连接允许的最大秒数。

注: 如果将连接超时设为零,则被视为永不超时。即,尝试连接时不设上限。通常不建议采取这种做法。
命令超时 (秒)

指定执行命令允许的最大秒数。

注: 如果将命令超时设为零,则被视为永不超时。即,尝试执行命令时不设上限。通常不建议采取这种做法。
使用代理设置 勾选此复选框,使用代理用户连接到数据源。
代理用户:使用当前 Spotfire 用户 选择此选项,使用打开连接的用户的 Spotfire 用户名作为代理用户。
代理用户:其他 选择此选项,为连接手动指定一个代理用户。
代理角色 您也可以为连接指定一个代理角色。

来自 Spotfire 的查询分级信息

为了更方便数据库管理员开展故障排除以及了解查询的来源,Spotfire 包含了向 Teradata 发出查询的查询分级。该表介绍了查询分级及其包含的信息。

查询分级名称 说明
ApplicationName 应用程序的名称。该值始终是“SpotfireDXP”。
Version Spotfire 应用程序的版本号。
ClientUser 已登录用户的 Spotfire 用户名。
Spotfire.Domain

Windows 域,如果用户使用 Windows 身份验证登录到 Spotfire 服务器的话。

使用其他身份验证方法时,该值为“spotfire”。

Spotfire.Analysis Spotfire 分析的文件名(对于本地文件)或 Spotfire 库路径。
Spotfire.Visualization 发起查询的图表的名称。
ProxyUser

[仅当选择了“使用代理设置”时会包含此查询分级。]

指定的代理用户。

ProxyRole

[仅当选择了“使用代理设置”时,才会包含此查询分级。]

指定的代理角色。

受支持的数据类型

设置到外部数据源的连接时,Spotfire 需要将数据源中的数据类型映射到 Spotfire 中的数据类型。以下是 Teradata 连接器支持的数据类型。

数据库数据类型 Spotfire 数据类型
BLOB Binary
BYTE Binary
VARBYTE Binary
DATE Date
PERIOD DATE Date [作为两列,开始/结束]
PERIOD TIMESTAMP DateTime [作为两列,开始/结束]
PERIOD TIMESTAMP WITH TIME ZONE DateTime [作为两列,开始/结束]
TIMESTAMP DateTime
TIMESTAMP WITH TIMEZONE DateTime
BYTEINT Integer
INTEGER Integer
SMALLINT Integer
BIGINT LongInteger
FLOAT Real
NUMBER Real
CHARACTER String
GRAPHIC String
JSON String
注: 由于 Teradata 转换函数的种种限制,您可以将最多包含 32000 个字符的 JSON 列加载到 Spotfire 中。整个 JSON 代码(包括标签)都包含在字符统计中。

当您从 Teradata 为 JSON 列定义提示时,只有“手动输入”提示类型可用。

LONG VARCHAR String
LONG VARGRAPHIC String
VARCHAR String
VARGRAPHIC String
XML String
注: 由于 Teradata 转换函数的种种限制,您可以将最多包含 32000 个字符的 XML 列加载到 Spotfire 中。整个 XML 代码(包括标签)都包含在字符统计中。
PERIOD TIME Time [作为两列,开始/结束]
PERIOD TIME WITH TIME ZONE Time [作为两列,开始/结束]
TIME Time
TIME WITH TIME ZONE Time
INTERVAL DAY TimeSpan
INTERVAL DAY TO HOUR TimeSpan
INTERVAL DAY TO MINUTE TimeSpan
INTERVAL DAY TO SECOND TimeSpan
INTERVAL HOUR TimeSpan
INTERVAL HOUR TO MINUTE TimeSpan
INTERVAL HOUR TO SECOND TimeSpan
INTERVAL MINUTE TimeSpan
INTERVAL MINUTE TO SECOND TimeSpan
INTERVAL SECOND TimeSpan
DECIMAL(p,s)

当 p <= 9 并且 s = 0 时:Integer

当 9 < p <= 18 并且 s = 0 时:LongInteger

其他:Real

注: 不支持任何用户定义数据类型,包括几何类型。

Amazon S3 和 Microsoft Azure Blob 中的数据

如果您的 Teradata 实例支持本地对象存储 (NOS),则可以在 Spotfire 中查询和分析 Amazon S3 和 Microsoft Azure Blob 中的文件数据。通过 NOS 功能,您可以为 S3 和 Azure Blob 中的文件定义外部表。然后在 Spotfire 中,您可以通过选择连接中的那些数据库表来访问数据。

支持的函数

支持的函数是指您在处理数据库中的数据表时可以使用的函数,例如在计算的列和自定义表达式中使用。

注: 您的数据库可能无法使用某些受支持的函数。这取决于数据库中可用的函数,不同数据库版本和类型之间通常会有差异。

以下是 Teradata 连接器支持的函数。

函数类型 支持的函数
日期和时间 Year, Month, Day, DayOfMonth, Hour, Minute, Second, Quarter
转换 SN
数学 Abs, Log, Ln, Exp, Sqrt, Sin, Cos, Tan, ASin, ACos, ATan, ATan2, Sinh, Cosh, Tanh, ASinh, ACosh, ATanh, NullIfZero, ZeroIfNull, Power
运算符 +, -, *, /, %, Mod
统计 Sum, Avg, Min, Max, Count, UniqueCount, StdDev_Samp, StdDev_Pop, Var_Samp, Var_Pop, Skew, Kurtosis, CoVar_Pop, CoVar_Samp, Corr, Regr_AvgX, Regr_AvgY, Regr_Count, Regr_Intercept, Regr_R2, Regr_Slope, Regr_SXX, Regr_SYX, Regr_SYY
文本 Character_Length, Lower, Upper, Soundex, Trim

Teradata 连接器还支持合并功能和宏。

注: 在 Spotfire 中,宏的处理方式与预存程序相同。连接到 Teradata 时,数据库中的任何宏在“选择数据”浮出控件(或“连接中的视图”对话框)中的数据库表列表中可用。