MON_GET_ACTIVITY_DETAILS 表函数 - 返回有关活动的信息（采用 XML 文档格式）

权限

缺省 PUBLIC 特权

无

语法

模式为 SYSPROC。

例程参数

application_handle

类型为 BIGINT 的输入参数，该参数指定有效的应用程序句柄。 如果自变量为空，那么不会从此函数返回任何行，并且会返回 SQL0171N 错误。

uow_id

类型为 INTEGER 的输入参数，该参数指定应用程序内唯一的有效工作单元标识。 如果自变量为空，那么不会从此函数返回任何行，并且会返回 SQL0171N 错误。

activity_id

类型为 INTEGER 的输入参数，该参数指定工作单元内唯一的有效活动标识。 如果自变量为空，那么不会从此函数返回任何行，并且会返回 SQL0171N 错误。

成员

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

返回的信息

<db2_activity_details xmlns="http://www.ibm.com/xmlns/prod/db2/mon" release="90700000">
  <member>0</member>
  <application_handle>70</application_handle>
  <activity_id>1</activity_id>
  <activity_state>IDLE</activity_state>
  <activity_type>READ_DML</activity_type>
  <uow_id>1</uow_id>
  ...
  <activity_metrics release="90700000">
    <lock_wait_time>2000</lock_wait_time>
    ...
  </activity_metrics>
</db2_activity_details>

<xs:simpleType name = "executable_id_type" >
  <xs:annotation>
     <xs:documentation>
       The binary Executable ID
     </xs:documentation>
  </xs:annotation>
   <xs:restriction base = "xs:hexBinary" >
      <xs:maxLength value = "32" />
   </xs:restriction>
</xs:simpleType>

返回的详细度量值

使用说明

MON_GET_ACTIVITY_DETAILS 函数为格式化输出提供了最大的灵活性，因为它将单个活动的详细信息作为 XML 文档返回。 XML 输出包含描述性信息 (例如，语句文本) 和度量。 可以通过 XML 解析器直接解析输出，也可以通过 XMLTABLE 函数将输出转换为关系格式，如示例中所示。

通过此函数报告的度量 (例如， CPU 使用率) 将在活动生存期内定期汇总到活动中。 因此，此表函数报告的值反映最新汇总时系统的当前状态。

活动度量通过工作负载上的 COLLECT ACTIVITY METRICS 子句或数据库级别的 mon_act_metrics 数据库配置参数进行控制。 如果提交活动的连接与启用了活动度量值的工作负载或数据库相关联，那么将收集度量值。 如果未针对某个活动收集活动度量值，那么会将所有度量值报告为 0。

MON_GET_ACTIVITY_DETAILS 表函数针对存在该活动的每个成员返回一行数据。 不会对度量值执行跨成员的聚集。 但是，可以通过 SQL 查询来实现聚集。

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

示例

调查长时间运行的查询，以确定它是否正在花费时间执行或等待 (例如，锁定或 I/O 被阻塞)。

注: 可以将以下查询组合到一个语句中，并在 2 步骤中显示，以了解清楚的原因。 此外，如果要检索完整文本，可以使用可执行标识从 MON_GET_PKG_CACHE_STMT 表函数获取语句文本。

1. 首先使用 WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES 表函数来列出活动及其开始时间。

   SELECT application_handle, 
          activity_id, 
          uow_id, 
          local_start_time 
   FROM TABLE(
      WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES(
         cast(NULL as bigint), -1)
   ) AS T

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

   APPLICATION_HANDLE   ACTIVITY_ID UOW_ID      LOCAL_START_TIME          
   -------------------- ----------- ----------- --------------------------
                      7           1           2 2008-06-10-10.06.55.675668
                     16           1           7 2008-06-10-10.08.38.613610
   
     2 record(s) selected.
   

2. 然后使用 MON_GET_ACTIVITY_DETAILS 表函数来查看活动等待的时间百分比。

   SELECT actmetrics.application_handle,
     actmetrics.activity_id,
     actmetrics.uow_id,
     varchar(actmetrics.stmt_text, 50) as stmt_text,
     actmetrics.total_act_time,
     actmetrics.total_act_wait_time,
     CASE WHEN actmetrics.total_act_time > 0
       THEN DEC((
         FLOAT(actmetrics.total_act_wait_time) / 
         FLOAT(actmetrics.total_act_time)) * 100, 5, 2)
       ELSE NULL
     END AS PERCENTAGE_WAIT_TIME 
   FROM TABLE(MON_GET_ACTIVITY_DETAILS(7, 2, 1, -2)) AS ACTDETAILS,
   XMLTABLE (XMLNAMESPACES( DEFAULT 'http://www.ibm.com/xmlns/prod/db2/mon'),
     '$actmetrics/db2_activity_details' 
     PASSING XMLPARSE(DOCUMENT ACTDETAILS.DETAILS) as "actmetrics"
     COLUMNS "APPLICATION_HANDLE" INTEGER PATH 'application_handle', 
       "ACTIVITY_ID" INTEGER PATH 'activity_id',
       "UOW_ID" INTEGER PATH 'uow_id',
       "STMT_TEXT" VARCHAR(1024) PATH 'stmt_text',
       "TOTAL_ACT_TIME" INTEGER PATH 'activity_metrics/total_act_time',
       "TOTAL_ACT_WAIT_TIME" INTEGER PATH 'activity_metrics/total_act_wait_time'
     ) AS ACTMETRICS;
   

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

   APPLICATION_HANDLE ACTIVITY_ID UOW_ID      ... 
   ------------------ ----------- ----------- ... 
                    7           1           2 ... 
   
     1 record(s) selected.
   

   查询的输出（继续）。

   ... STMT_TEXT                                          ... 
   ... -------------------------------------------------- ... 
   ... select * from syscat.tables optimize for 1 row     ... 

   查询的输出（继续）。

   ... TOTAL_ACT_TIME TOTAL_ACT_WAIT_TIME PERCENTAGE_WAIT_TIME
   ... -------------- ------------------- --------------------
   ...            459                   0                 0.00

使用 MON_GET_ACTIVITY_DETAILS 表函数可创建用于捕获有关系统上当前正在运行的所有活动的信息的查询。

• 示例 1: 使用命令行处理器 (CLP) 运行以下命令

  WITH A1 AS 
     (SELECT * FROM TABLE(wlm_get_workload_occurrence_activities(null, -1)) 
      WHERE activity_id > 0 ) 
  SELECT A1.application_handle, 
    A1.activity_id, 
    A1.uow_id, 
    total_act_time, 
    total_act_wait_time, 
    varchar(actmetrics.stmt_text, 50) AS stmt_text FROM A1, 
  TABLE(MON_GET_ACTIVITY_DETAILS(A1.application_handle, A1.uow_id,A1.activity_id, -1)) 
      AS ACTDETAILS, 
  XMLTABLE (XMLNAMESPACES( DEFAULT 'http://www.ibm.com/xmlns/prod/db2/mon'), 
   '$actmetrics/db2_activity_details' 
   PASSING XMLPARSE(DOCUMENT ACTDETAILS.DETAILS) AS "actmetrics" 
   COLUMNS "STMT_TEXT" VARCHAR(1024) PATH 'stmt_text', 
   "TOTAL_ACT_TIME" INTEGER PATH 'activity_metrics/total_act_time', 
   "TOTAL_ACT_WAIT_TIME" INTEGER PATH 'activity_metrics/total_act_wait_time' ) 
   AS ACTMETRICS

  以下是此查询的输出的示例：

  APP...HANDLE  A..._ID  UOW_ID  T...ACT_TIME  T...WAIT_TIME  
  ------------  -------  ------  ------------  -------------  
  15            1        5       16            5              
  15            1        3       17            5              
  7             1        49      0             0              
  SQL0445W Value "with A1 as (select * from table(wlm_get_workload
  3 record(s) selected with 1 warning messages printed.

  以下样本继续此查询的输出:

  ... STMT_TEXT
  ... -------------------------------------------------
  ... select name from sysibm.systables
  ... select * from sysibm.systables
  ... with A1 as (select * from table(wlm_get_workload_o
  _occurrence_" has been truncated. SQLSTATE=01004
  
  3 record(s) selected with 1 warning messages printed.