DEFINE TABLE DB 命令

通过使用 AX 连接器连接到数据库表来定义 Analytics 服务器表。您可以连接到 Microsoft SQL Server、Oracle 或 DB2 数据库。

语法

DEFINE TABLE DB {SOURCE 数据库配置文件 <PASSWORD 数字> <PASSWORD 数字> | SERVER 服务器配置文件 <PASSWORD 数字>} <FORMAT 格式名> SCHEMA 架构 <TITLED acl_表名> <PRIMARY|SECONDARY> DBTABLE 数据库表名 FIELDS {域名|ALL} <...n> <WHERE 条件> <ORDER 域名>

参数

SOURCE 数据库摘要

要用来访问数据库引擎的 Analytics 数据库配置文件。

数据库配置文件包括为连接到数据库引擎所需的信息,包括:

  • 对关联服务器配置文件的引用
  • 数据库类型
  • 数据库名称
  • 用户账户信息

说明

DEFINE TABLE DB 仅支持连接到下列数据库:Microsoft SQL Server、Oracle 或 DB2。

PASSWORD 数字

可选

要使用的密码定义。

您不使用 PASSWORD 数字提示用户提供或者指定实际密码。密码定义是指先前使用 PASSWORD 命令、SET PASSWORD 命令或 PASSWORD 分析标记提供或设置的密码。

数字是密码定义的编号。例如,如果之前已在脚本中或在调度分析脚本时提供或设置了两个密码,则 PASSWORD 2 指定使用密码 #2。

有关提供或设置密码的详细信息,请参阅:

仅当数据库配置文件不包含已保存的密码时,才需要密码。请在 SOURCE 关键字后使用 PASSWORD 两次。第一个密码可让您登录到服务器,第二个密码可让您登录到数据库。

说明

在指定或输入服务器配置文件密码、数据库配置文件密码或邮件服务器密码时,Analytics 支持的最大密码长度为 30 个字符。如果指定的密码值超过长度限制,会导致密码被截断和连接失败。

SERVER 服务器配置文件

不再使用。

在 Analytics 版本 10.0 之前,在连接至 ACL Server Edition for z/OS 时使用。从 Analytics 版本 10.0 开始,不再包括 ACL Server Edition for z/OS。

FORMAT 格式名

可选

具有您想要使用的表布局的 Analytics 表或表布局文件 (.layout) 的名称。

SCHEMA 架构

要连接到的架构。必须用引号把图表名称引起来。

TITLED acl_表名

可选

要创建的 Analytics 表的名称。

acl 表名称必须是带引号的字符串。如果您省略 TITLED,则 Analytics 将使用数据库表名称。同时访问多个表时,Analytics 会使用第一个表的名称。

PRIMARY | SECONDARY

可选

在多文件命令中使用该表作为主表或辅表。如果没有指定任一选项,则使用默认值 PRIMARY。

DBTABLE 数据库表

您想要访问的数据库表。数据库表必须是带引号的字符串。

FIELDS 域名 | ALL

要包括在输出中的域:

  • FIELDS 域名称使用指定的域

    域名称必须是带引号的字符串。

  • ALL 使用该表中的所有域

要使用一个以上的表中的域:

  1. 输入第一个表名称,后面跟该表中的域。
  2. 输入下一个表名称,后面跟该表中的域。
  3. 对于其他每个表,重复执行步骤 b。
DBTABLE "DSN1310" FIELDS "Field_A Field_B Field_C" DBTABLE "DSN2516" FIELDS "Field_L Field_M Field_N"

说明

使用 AX 连接器,可以访问数量不限的相关表,但建议访问的表不要超过 5 个。当访问多个表时,处理时间会增加。

WHERE 条件

可选

一个 SQL WHERE 子句,它将数据限定到那些满足指定条件的记录。

您必须使用以带引号的字符串形式输入的有效 SQL 语法。

联接表时,Analytics 在 WHERE 子句中显示联接条件:

"Table_1.First_name = Table_2.First_name"
ORDER 域名

可选

数据库引擎用来对记录进行排序的域。域名称必须是带引号的字符串。

在对记录进行排序时,该命令需要较长的时间来运行。当排序很重要时,请只使用 ORDER。

示例

示例

您想要通过 AX 连接器从 Microsoft SQL Server 数据库访问数据。为此,您使用 DEFINE TABLE DB 命令。您包括 SOURCE 参数以便通过数据库配置文件连接到 AX 连接器:

DEFINE TABLE DB SOURCE "SQLServer_Audit" SCHEMA "HR" TITLED "工资表" DBTABLE "HR.Employee" FIELDS "EmployeeID" DBTABLE "HR.EmployeePayHistory" FIELDS "Rate PayFrequency" WHERE "HR.Employee.EmployeeID=HR.EmployeePayHistory.EmployeeID"

备注

工作原理

Analytics 服务器表被定义为使用数据库配置文件连接到数据库表的查询。

隐藏日期时间值的时间部分

在 DEFINE TABLE DB 命令前面使用 SET SUPPRESSTIME 命令来隐藏日期时间值的时间部分。

SET SUPPRESSTIME ON 可供在低于版本 10.0 的假设日期时间值的时间部分将被截断的 Analytics 脚本中使用。如果未将 SET SUPPRESSTIME ON 添加至这些脚本,则这些脚本无法在支持日期时间的 Analytics 版本中运行。

有关详细信息,请参见 SET 命令 中的“SET SUPPRESSTIME”部分。