MON_GET_CONNECTION_DETAILS 表函数 - 获取连接度量值（采用 XML 文档格式）

权限

缺省 PUBLIC 特权

无

语法

模式为 SYSPROC。

例程参数

application_handle

类型为 BIGINT 的输入参数，用于指定特定应用程序句柄，用于标识要为其返回度量值的连接。 如果自变量为 NULL ，那么将返回所有连接的度量值。

成员

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

系统应用程序

数据类型为 SMALLINT 的输入参数，用于指定是否返回系统应用程序的信息。 以下值有效：

• 0 或 NULL：不返回系统应用程序信息。 如果未提供 system_appls 的值，那么 NULL 是缺省值。
• 1：返回用户和系统应用程序信息。

返回的信息

<db2_connection xmlns="http://www.ibm.com/xmlns/prod/db2/mon" release="90700000">
   <application_handle>21</application_handle>
   <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_connection>

<xs:simpleType name="db2DbObjectString">
   <xs:restriction base="xs:string">
      <xs:maxLength value="128"/>
   </xs:restriction>
</xs:simpleType>

<xs:simpleType name="db2PartitionNum">
   <xs:restriction base="xs:nonNegativeInteger">
      <xs:maxInclusive value="999"/>
   </xs:restriction>
</xs:simpleType>

使用说明

度量值在工作单元边界上汇总，并在执行请求期间定期汇总。 因此，此表函数报告的值反映最新汇总时系统的当前状态。 指标值严格递增。 要确定时间间隔内给定度量的值，请使用 MON_GET_CONNECTION_DETAILS 表函数在时间间隔开始和结束时查询度量，并计算差异。

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

MON_GET_CONNECTION_DETAILS 表函数针对每个连接和每个成员返回一行数据。 不会跨成员 (针对服务类或更多服务类) 执行聚集。 但是，可以通过 SQL 查询来实现聚集。

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

示例

显示将最大数据量返回给客户机的连接，按返回的行排序。

SELECT detmetrics.application_handle, 
       detmetrics.rows_returned, 
       detmetrics.tcpip_send_volume
FROM TABLE(MON_GET_CONNECTION_DETAILS(CAST(NULL as bigint), -2)) 
AS CONNMETRICS,
XMLTABLE (XMLNAMESPACES( DEFAULT 'http://www.ibm.com/xmlns/prod/db2/mon'),
       '$detmetric/db2_connection' PASSING XMLPARSE(DOCUMENT CONNMETRICS.DETAILS) 
       as "detmetric"
COLUMNS "APPLICATION_HANDLE" INTEGER PATH 'application_handle',
       "ROWS_RETURNED" BIGINT PATH 'system_metrics/rows_returned', 
       "TCPIP_SEND_VOLUME" BIGINT PATH 'system_metrics/tcpip_send_volume'
       ) AS DETMETRICS
ORDER BY rows_returned DESC

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

APPLICATION_HANDLE ROWS_RETURNED        TCPIP_SEND_VOLUME   
------------------ -------------------- --------------------
                21                    4                    0

  1 record(s) selected.