IDAX.PRINT_MODEL - 打印模型

权限

此语句的授权标识所拥有的特权必须至少包括下列其中一项权限：

• 对源模型的 SELECT 特权
• DATAACCESS 权限

语法

IDAX.PRINT_MODEL(in parameter_string varchar(32672))

参数描述

parameter_string

必需的单字符串参数，其中包含以逗号分隔的 <parameter>=<value> 条目对。

数据类型：VARCHAR(32672)

以下列表显示参数值：

model

必需。

要打印的模型的名称。

可以使用模式名称来限定模型参数的值，如下所示：

<schema name>.<model name>

返回的信息

结果集形式的打印输出。

结果集的结构取决于模型类型，即，算法以及模型表的格式和内容。

示例

CALL IDAX.PRINT_MODEL('model=cc_nb_ewd');

关联规则模型的其他参数

outtable

可选。

模型表的名称，模式和规则将会写入其中。

缺省值：无

数据类型：VARCHAR(128)

如果未指定值，那么将仅打印模式或规则。

type

可选。

要显示的信息类型。

缺省值：rules

可能的值为“rules”和“patterns”。

数据类型：VARCHAR(8)

limit

可选。

要显示的规则或模式的最大数量。

缺省值：无

范围：>=1

数据类型：INTEGER

如果未指定值，那么将显示所有规则或模式。

itemsin

可选。

一列项目名称，它们必须包含在所显示的规则或模式中。各个项目之间以分号分隔。必须至少包含一个所列项目。

缺省值：无

数据类型：VARCHAR(32000)

当指定 type=rules 参数时，以下条件适用：

• 要指示该项目必须包含在规则头中，项目名称必须以 :h 或 :head 开头。
• 要指示该项目必须包含在规则体中，项目名称必须以 :b 或 :body 开头。

如果未指定此参数，那么不会应用任何约束。

itemsout

可选。

一列项目名称，它们不得包含在所显示的规则或模式中。各个项目之间以分号分隔。

缺省值：无

数据类型：VARCHAR(32000)

如果未指定此参数，那么不会应用任何约束。

minlen

可选。

要显示在规则或模式中的最小项目数。

缺省值：1

范围：>= 1 且 <= maxlen

数据类型：INTEGER

maxlen

可选。

要显示在规则或模式中的最大项目数。

缺省值：模型的最长模式

范围：>= minlen

数据类型：INTEGER

minsupport

可选。

要显示在规则或模式中的项目的最小支持度。

缺省值：0.0

范围：>=0.0 且 <=maxsupport

数据类型：DOUBLE

maxsupport

可选。

要显示在规则或模式中的项目的最大支持度。

缺省值：1.0

范围：>=minsupport 且 <=1.0

数据类型：DOUBLE

minlift

可选。

要显示的规则或模式的最小增益。

缺省值：0.0

范围：>=0.0 且 <=maxlift

数据类型：DOUBLE

maxlift

可选。

要显示的规则或模式的最大增益。

缺省值：模型的模式的最大增益

范围：>=minlift

数据类型：DOUBLE

minconf

可选。

要显示的规则的最小置信度。

缺省值：0.0

数据类型：DOUBLE

范围：>=0.0 且 <=maxconf

仅当指定了 type=rules 参数时，才可以指定此参数。

maxconf

可选。

要显示的规则的最大置信度。

缺省值：1.0

数据类型：DOUBLE

范围：>=minconf 且 <=1.0

仅当指定了 type=rules 参数时，才可以指定此参数。

sort

可选。

一列关键字，用于指示显示规则或模式的顺序。列表的顺序为降序。各个项目之间以分号分隔。

可能的值为“support”、“confidence”、“lift”和“length”。

如果指定了 type=rules 参数，那么缺省值为：support;confidence;length

如果指定了 type=patterns 参数，那么缺省值为：support;lift;length

数据类型：VARCHAR(32000)

关联规则的返回信息

结果集包含符合所定义约束的所有规则或模式，它们以 sort 参数中指定的顺序排列。

如果指定了 outtable 参数，那么将会创建内容与结果集相同的输出表。

K 均值模型的其他参数

clusters

可选。

要打印的模型的聚类标识。

各个聚类标识之间以分号 (;) 分隔。

如果未指定 clusters，那么将会打印所有聚类的聚类标识。

columns

可选。

要打印的模型的输入列名。

各个输入列名之间以分号 (;) 分隔。

如果未指定 columns，那么将会打印所有输入列的输入列名。

mode

可选。

方式，用于确定要打印模型的哪些信息。

允许的值为 preview、clusters、centers 和 statistics。

• 如果指定了 mode=preview，那么打印输出将会显示一个表，对于每个输入列，该表均包含相应的一行。对于每个聚类以及总体数据，该表均包含 mean 列（对于数字输入列）和 mode 列（对于名义输入列），并且对于每个聚类大小，该表均包含相应的一行。
• 如果指定了 mode=clusters，那么打印输出将会显示一个表，对于每个聚类，该表均包含相应的一行，列如下所示：clusterid、name、size、withinss 和 description。
• 如果指定了 mode=centers，那么打印输出将会显示一个表，对于每个聚类的每个输入列，该表均包含相应的一行。该表的列如下：clusterid、columnname、cardinality、mode、minimum、maximum、mean、variance、count 和 importance。如果使用 statistics=none 来构建模型，那么该表的列如下：clusterid、columnname、mode（对于名义输入列）和 mean（对于数字输入列）。
• 如果指定了 mode=statistics，那么打印输出将会显示一个表，对于输入列的每个值以及每个聚类，该表均包含相应的一行，列如下所示：clusterid、columnname、value、count、relfrequency、deviation、mean 和 variance。如果使用 statistics=none 或 statistics=columns 来构建模型，那么该表为空。

K 最近邻 (KNN) 的返回信息

结果集包含列属性表，用于描述模型表的标识列、目标列和输入列。将会收集所有输入列的统计。

线性回归的返回信息

结果集取决于创建模型时指定的选项。

• 如果在 calculatediagnostics 参数设置为 false 的情况下创建模型，那么将会返回一个结果集。
• 如果在 calculatediagnostics 参数设置为 true 的情况下创建模型，那么将会返回两个结果集。第二个结果集包含额外的诊断信息。

PCA 模型的其他参数

mode

可选。

方式，用于确定要打印模型的哪些信息。

允许的值为 standard 和 summary。

• 如果指定了 mode=standard，那么打印输出将会显示两个结果集。

  采用此方式时，很容易就可以与 R 中使用“prcomp()”和“print()”函数创建的 PCA 模型进行比较。

• 如果指定了 mode=summary，那么打印输出将会显示一个结果集。

  此方式类似于 R 中的“summary()”函数。

缺省值：standard

PCA 的返回信息

结果集取决于创建模型时指定的选项。

指定了 mode=standard 时，输出如下所示：

指定了 mode=summary 时，输出如下所示：

顺序模式的其他参数

outtable

可选。

模型表的名称，模式和规则将会写入其中。

缺省值：无

数据类型：VARCHAR(128)

如果未指定值，那么将仅打印模式或规则。

type

可选。

要显示的信息类型。

缺省值：rules

可能的值为“patterns”和“rules”。

数据类型：VARCHAR(8)

limit

可选。

要显示的模式或规则的最大数量。

缺省值：无

范围：>=1

数据类型：INTEGER

如果未指定值，那么将显示所有规则或模式。

itemsin

可选。

一列项目名称，它们必须包含在所显示的模式或规则中。各个项目之间以分号分隔。必须至少包含一个所列项目。

缺省值：无

数据类型：VARCHAR(32000)

当指定 type=rules 参数时，以下条件适用：

• 要指示该项目必须包含在规则头中，项目名称必须以 :h 或 :head 开头。
• 要指示该项目必须包含在规则体中，项目名称必须以 :b 或 :body 开头

如果未指定此参数，那么不会应用任何约束。

itemsout

可选。

一列项目名称，它们不得包含在所显示的模式或规则中。各个项目之间以分号分隔。

缺省值：无

数据类型：VARCHAR(32000)

如果未指定此参数，那么不会应用任何约束。

minlen

可选。

每个模式或规则要显示的最小项目数。

缺省值：1

范围：>= 1 且 <= maxlen

数据类型：INTEGER

maxlen

可选。

每个模式或规则要显示的最大项目数。

缺省值：模型的最长顺序模式

范围：>= minlen

数据类型：INTEGER

minsupport

可选。

要显示的模式或规则的最小支持度。

缺省值：0.0

范围：>=0.0 且 <=maxsupport

数据类型：DOUBLE

maxsupport

可选。

要显示的模式或规则的最大支持度。

缺省值：1.0

范围：>=minsupport 且 <=1.0

数据类型：DOUBLE

minlift

可选。

要显示的模式或规则的最小增益。

缺省值：0.0

范围：>=0.0 且 <=maxlift

数据类型：DOUBLE

maxlift

可选。

要显示的模式或规则的最大增益。

缺省值：模型的顺序模式的最大增益

范围：>=minlift

数据类型：DOUBLE

minconf

可选。

要显示的规则的最小置信度。

缺省值：0.0

数据类型：DOUBLE

范围：>=0.0 且 <=maxconf

仅当指定了 type=rules 参数时，才可以指定此参数。

maxconf

可选。

要显示的规则的最大置信度。

缺省值：1.0

数据类型：DOUBLE

范围：>=minconf 且 <=1.0

仅当指定了 type=rules 参数时，才可以指定此参数。

mintime

可选。

要显示的规则的规则体与规则头之间的最短时间。

如果构建模型所基于的数据序列的事务标识属日期、时间或时间戳记类型，那么此参数的值为秒数。

缺省值：0.0

数据类型：DOUBLE

范围：>0.0 且 <=maxtime

仅当指定了 type=rules 参数时，才可以指定此参数。

maxtime

可选。

要显示的规则的规则体与规则头之间的最长时间。

如果构建模型所基于的数据序列的事务标识属日期、时间或时间戳记类型，那么此参数的值为秒数。

缺省值：模型规则的最长相对时间

数据类型：DOUBLE

范围：>= mintime

仅当指定了 type=rules 参数时，才可以指定此参数。

sort

可选。

一列关键字，用于指示显示规则或模式的顺序。列表的顺序为降序。各个项目之间以分号分隔。

可能的值为“support”、“confidence”、“lift”、“length”和“time”。

如果指定了 type=rules 参数，那么缺省值为：support;confidence;length

如果指定了 type=patterns 参数，那么缺省值为：support;lift;length

数据类型：VARCHAR(32000)

顺序模式的返回信息

如果指定了 outtable 参数，那么将会创建内容与文本表示相同的输出表。