MON_GET_SERVICE_SUBCLASS_DETAILS 表函数 - 获取服务子类度量值（采用 XML 文档格式）

权限

缺省 PUBLIC 特权

无

语法

模式为 SYSPROC。

例程参数

service_superclass_name

VARCHAR(128) 类型的输入参数，在调用此函数时指定当前连接的数据库中的有效服务超类名称。 如果参数为 null 或空字符串，则检索数据库中所有超类的度量。

service_subclass_name

VARCHAR(128) 类型的输入参数，在调用此函数时指定当前连接的数据库中的有效服务子类名称。 如果参数为 null 或空字符串，则检索数据库中所有子类的指标。

成员

类型为 INTEGER 的输入自变量，调用此函数时，此自变量指定与当前连接的数据库位于同一实例中的有效成员。 指定 -1（表示当前数据库成员）或 -2（表示所有活动数据库成员）。 如果指定空值，那么会隐式设置 -1。

返回的信息

<db2_service_subclass xmlns="http://www.ibm.com/xmlns/prod/db2/mon" release="90700000">
   <service_superclass_name>SYSDEFAULTSYSTEMCLASS</service_superclass_name>
   <service_subclass_name>SYSDEFAULTSUBCLASS</service_subclass_name>
   <service_subclass_id>11</service_subclass_id>
   <member>0</member>
   <system_metrics release="90700000">
   <act_aborted_total>5</act_aborted_total>
    ...
   <wlm_queue_assignments_total>3</wlm_queue_assignments_total>
   </system_metrics>
</db2_service_subclass>

使用说明

度量将汇总到服务类（按工作单元），并在请求执行期间定期汇总。 因此，此表函数报告的值反映最新汇总时系统的当前状态。 指标值严格递增。 要确定某个时间间隔内给定度量的值，请使用 MON_GET_SERVICE_SUBCLASS_DETAILS 表函数在该时间间隔的开始和结束时查询该度量，并计算差异。

请求度量是通过服务超类上的 COLLECT REQUEST METRICS 子句和数据库级别的 mon_req_metrics 数据库配置参数来控制的。 仅当请求由服务子类（其父服务超类已启用请求指标值）中的代理程序处理，或者对整个数据库启用请求指标收集时，才会为请求收集指标。 缺省情况下，在数据库级别启用请求指标。 如果在数据库级别和对服务超类禁用请求度量，则为映射到该服务超类的每个连接报告的度量停止增加（如果在数据库激活时禁用请求指标，则保持为 0）。

MON_GET_SERVICE_SUBCLASS_DETAILS 表函数针对每个服务子类和每个成员返回一行数据。 不执行跨服务类（在成员上）或跨成员（对于服务类或更多）的聚集。 但是，可以通过 SQL 查询实现聚集（请参阅示例）。 输入参数具有与 ANDed 在一起的效果。 因此，如果您指定冲突的输入参数（例如，超类名称 SUPA 和不是 SUPA 子类的子类名称 SUBB），则不会返回任何行。

在此函数返回的描述超类 SYSDEFAULTSYSTEMCLASS 下的缺省子类 SYSDEFAULTSUBCLASS 的数据中，所有度量都具有值 0。

请注意，来自后台 EDU 的度量（例如，预取器和页面清理器）不会汇总到服务类。

在 DETAILS 列中返回的 XML 文档的模式在文件 sqllib/misc/DB2MonRoutines.xsd 中可用。 可以在 sqllib/misc/DB2MonCommon.xsd 文件中找到更多详细信息。

示例

显示每个服务超类使用的总 CPU 时间和处理的请求总数，按关系格式的 CPU 使用率排序（使用 XMLTABLE）。

SELECT varchar(scmetrics.service_superclass_name,30) as service_superclass,
       sum(detmetrics.total_cpu_time) as total_cpu, 
       sum(detmetrics.app_rqsts_completed_total) as total_rqsts 
FROM TABLE(MON_GET_SERVICE_SUBCLASS_DETAILS('','',-2)) AS SCMETRICS,
XMLTABLE (XMLNAMESPACES( DEFAULT 'http://www.ibm.com/xmlns/prod/db2/mon'), 
        '$detmetric/db2_service_subclass' 
        PASSING XMLPARSE(DOCUMENT SCMETRICS.DETAILS) 
        as "detmetric" 
COLUMNS "TOTAL_CPU_TIME" INTEGER PATH 'system_metrics/total_cpu_time', 
        "APP_RQSTS_COMPLETED_TOTAL" INTEGER PATH 
        'system_metrics/app_rqsts_completed_total') 
        AS DETMETRICS
GROUP BY service_superclass_name
ORDER BY total_cpu desc

下列是从此查询输出的示例。

SERVICE_SUPERCLASS             TOTAL_CPU            TOTAL_RQSTS         
------------------------------ -------------------- --------------------
SYSDEFAULTUSERCLASS                         2428188                   26
SYSDEFAULTMAINTENANCECLASS                        0                    0
SYSDEFAULTSYSTEMCLASS                             0                    0

  3 record(s) selected.