IDAX.LIST_MODELS - 列出所選取模型或所有模型

使用此儲存程序來，可以列出所有模型或所選取的模型。

授權

陳述式的授權 ID 所持有的專用權必須至少包含下列其中一項權限：

模型的 CONTROL 專用權
模型的 SELECT 專用權
DATAACCESS 權限

語法

IDAX.LIST_MODELS(in parameter_string varchar(32672))

參數說明

parameter_string

必要的單一字串參數，其中包含以逗點區隔的 <parameter>=<value> 項目配對。

資料類型：VARCHAR(32672)

下列清單顯示參數值：

format=short: 選用。; 列印直欄子集。所有直欄都是 varchar 類型，且具有最小大小，亦即最短項目的大小。; 在指令行上使用此格式進行互動式工作。; 預設值。
format=long: 選用。; 列印所有直欄。; 如果直欄子集的列印還不夠，請指定此格式參數來存取及使用完整資料集。
schema: 選用。; 只會顯示此綱目中的模型。; 預設值：現行綱目; 註：您不能同時指定 schema 及 all=true。
all: 選用。; 如果您指定 all=true，則會顯示所有綱目中的模型。; 註：您不能同時指定 all=true 及 schema。
其中: 選用。; 過濾結果。
outtable: 選用。; 如果您指定一般表格或宣告的廣域暫存表格，則不會顯示結果集，但結果集會寫入至指定的表格。; 該表格不可以已經存在。如果此程序嘗試建立的表格已經存在，會引發異常狀況。; 如果未指定綱目名稱，則會在現行綱目中建立一般表格。; 如果綱目名稱是 SESSION，則會建立宣告的廣域暫存表格，例如 SESSION."Foo"。
directory: 選用。; 指定包含先前匯出的 .mdl 檔案的目錄。; 如果您使用 LIST_MODELS 程序指定 directory 參數，則還必須包括 name 參數。directory 和 name 參數不得與任何其他參數搭配使用。
name: 指定 EXPORT_MODEL 程序產生的檔案名稱。您不需要在檔名中包含 .mdl 副檔名。; LIST_MODELS 程序會列出 .mdl 檔案中模型的名稱和部分內容。

format=short: 選用。; 列印直欄子集。所有直欄都是 varchar 類型，且具有最小大小，亦即最短項目的大小。; 在指令行上使用此格式進行互動式工作。; 預設值。
format=long: 選用。; 列印所有直欄。; 如果直欄子集的列印還不夠，請指定此格式參數來存取及使用完整資料集。
schema: 選用。; 只會顯示此綱目中的模型。; 預設值：現行綱目; 註：您不能同時指定 schema 及 all=true。
all: 選用。; 如果您指定 all=true，則會顯示所有綱目中的模型。; 註：您不能同時指定 all=true 及 schema。
其中: 選用。; 過濾結果。
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	分析模型最近一次變更的日期和時間當模型的 meta 資料或內容變更時，會更新此項目。
STATE	VARCHAR(128)	模型的狀態，例如 `Creating`、`Updating` 或 `Complete`。 Creating 表示正在計算模型。Updating 表示正在更新模型。Complete 表示沒有在執行任何建立程序或更新程序。計算或更新模型時，會限制對模型的 meta 資料或內容的存取權。
DESCRIPTION	VARCHAR(4096)	使用者定義的分析模型說明若為新模型，此直欄為 NULL。您可以在模型產生完成之後更新此直欄。
COPYRIGHT	VARCHAR(128)	使用者定義的分析模型版權聲明若為新模型，此直欄為 NULL。您可以在模型產生完成之後更新此直欄。
MININGFUNCTION	VARCHAR(64)	模型的採礦功能，例如 `clustering`、`classification`、`regression`、`associations`、`time series`。
ALGORITHM	VARCHAR(64)	用來建立分析模型的演算法名稱
COMPONENTFORMAT	VARCHAR(16)	指出模型元件格式的版本 ID
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