IDAX.LIST_MODELS - 列出所选模型或所有模型

使用此存储过程可列出所有模型或所选模型。

权限

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

对模型的 CONTROL 特权
针对模型的 SELECT 特权
DATAACCESS 权限

语法

IDAX.LIST_MODELS(in parameter_string varchar(32672))

参数描述

parameter_string

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

数据类型：VARCHAR(32672)

以下列表显示参数值：

format=short: 可选。; 打印部分列。所有的列均为具有最小大小（即，最短条目大小）的 varchar 类型。; 在命令行上使用此格式可进行交互式工作。; 缺省值。
format=long: 可选。; 打印所有的列。; 如果打印部分列并不足够，请指定这个 format 参数以访问并处理完整数据集。
schema: 可选。; 仅显示此模式中的模型。; 缺省值：当前模式; 注：不可同时指定 schema 和 all=true。
all: 可选。; 如果指定 all=true，那么将显示所有模式中的模型。; 注：不可同时指定 all=true 和 schema。
where: 可选。; 过滤结果。
outtable: 可选。; 如果指定了常规表或已声明的全局临时表，那么不会显示结果集，而是将其写入指定的表。; 该表不能已存在。如果此过程尝试创建的表已存在，那么将发生异常。; 如果未指定模式名称，那么会在当前模式中创建一个常规表。; 如果模式名为 SESSION，那么会创建已声明的全局临时表，例如 SESSION."Foo"。
directory: 可选。; 指定先前导出的 .mdl 文件所在的目录。; 如果对 LIST_MODELS 过程指定 directory 参数，那么还必须包括 name 参数。不可将任何其他参数与 directory 和 name 参数配合使用。
name: 指定 EXPORT_MODEL 过程所生成的文件的名称。不需要在文件名中包括 .mdl 扩展名。; LIST_MODELS 过程列示 .mdl 文件中的模型的名称和部分属性。

format=short: 可选。; 打印部分列。所有的列均为具有最小大小（即，最短条目大小）的 varchar 类型。; 在命令行上使用此格式可进行交互式工作。; 缺省值。
format=long: 可选。; 打印所有的列。; 如果打印部分列并不足够，请指定这个 format 参数以访问并处理完整数据集。
schema: 可选。; 仅显示此模式中的模型。; 缺省值：当前模式; 注：不可同时指定 schema 和 all=true。
all: 可选。; 如果指定 all=true，那么将显示所有模式中的模型。; 注：不可同时指定 all=true 和 schema。
where: 可选。; 过滤结果。
outtable: 可选。; 如果指定了常规表或已声明的全局临时表，那么不会显示结果集，而是将其写入指定的表。; 该表不能已存在。如果此过程尝试创建的表已存在，那么将发生异常。; 如果未指定模式名称，那么会在当前模式中创建一个常规表。; 如果模式名为 SESSION，那么会创建已声明的全局临时表，例如 SESSION."Foo"。
directory: 可选。; 指定先前导出的 .mdl 文件所在的目录。; 如果对 LIST_MODELS 过程指定 directory 参数，那么还必须包括 name 参数。不可将任何其他参数与 directory 和 name 参数配合使用。
name: 指定 EXPORT_MODEL 过程所生成的文件的名称。不需要在文件名中包括 .mdl 扩展名。; LIST_MODELS 过程列示 .mdl 文件中的模型的名称和部分属性。

返回的信息

如果指定了 format=short，那么结果集列为 MODELSCHEMA、MODELNAME、OWNER、CREATED、STATE、MININGFUNCTION、ALGORITHM 和 USERCATEGORY。

如果指定了 format=long，那么结果集列如下所示：

表 1. IDAX.LIST_MODELS 过程的结果集列
列名	列类型	描述
MODELSCHEMA	VARCHAR(128)	存储模型组件的分析模型的模式
MODELNAME	VARCHAR(64)	分析模型的名称
OWNER	VARCHAR(128)	分析模型的所有者名称，即，数据库的普通用户最初，所有者的用户名与创建者的用户名完全相同。
CREATOR	VARCHAR(128)	分析模型的创建者名称，即，数据库的普通用户最初，创建者的用户名与所有者的用户名完全相同。
CREATED	TIMESTAMP	创建分析模型的日期和时间此值不可更改。
MODIFIED	TIMESTAMP	最近一次更改分析模型的日期和时间当模型的元数据或内容更改时，将会更新此条目。
STATE	VARCHAR(128)	模型状态，例如，`Creating`、`Updating` 或 `Complete` Creating 表示正在计算模型。Updating 表示正在更新模型。Complete 表示没有运行中的创建过程或更新过程。计算或更新模型时，对模型元数据或内容的访问受限。
DESCRIPTION	VARCHAR(4096)	分析模型的用户定义描述对于新模型，此列为 NULL。您可以在生成模型完成后更新此列。
COPYRIGHT	VARCHAR(128)	分析模型的用户定义版权声明对于新模型，此列为 NULL。您可以在生成模型完成后更新此列。
MININGFUNCTION	VARCHAR(64)	模型的挖掘函数，例如，`clustering`、`classification`、`regression`、`associations` 和 `time series`
ALGORITHM	VARCHAR(64)	用于创建分析模型的算法的名称
COMPONENTFORMAT	VARCHAR(16)	版本标识，用于指示模型组件的格式
SOURCE	VARCHAR(128)	模型的来源，例如，`Local`。
APPLICATIONNAME	VARCHAR(128)	创建分析模型的应用程序的名称此值派生自 DB2® 版本。
APPLICATIONVERSION	VARCHAR(64)	创建分析模型的应用程序的版本
USERCATEGORY	VARCHAR(64)	用户定义的类别名称，例如，项目名称

示例

CALL IDAX.LIST_MODELS('format=short, where=owner=''JDOE'' and algorithm=''Naive Bayes''')

此调用将返回以下结果集：

Result set 1
--------------
MODELSCHEMA MODELNAME OWNER    CREATED                 STATE    MININGFUNCTION ALGORITHM   USERCATEGORY
----------- --------- -------- ----------------------- -------- -------------- ----------- ------------
JDOE        NBX       JDOE     2015-02-24-15.27.22.547 Complete classification Naive Bayes - 

1 record(s) selected.

Return Status = 0