MON_GET_QUEUE_STATS 表函数 - 返回阈值队列统计信息

对于所有活动成员， MON_GET_QUEUE_STATS 函数将返回 一个或所有阈值队列的基本统计信息。 此函数针对每个队列返回一行统计信息。

授权

至少需要下列其中一项权限:
  • 对例程的 EXECUTE 特权
  • DATAACCESS 权限
  • DBADM 权限
  • SQLADM 权限
  • WLMADM 权限

缺省 PUBLIC 特权

无。

语法

Read syntax diagramSkip visual syntax diagram MON_GET_QUEUE_STATS ( predicate , domain , threshold_name , threshold_id )

模式为 SYSPROC。

例程参数

谓词
类型为 VARCHAR (27) 的输入参数，用于指定要检索的队列或队列统计信息:
CONCDBC
检索 并发数据库协调程序活动 阈值队列的统计信息。
DBCONN
检索 数据库成员连接总数 阈值队列的统计信息。
SCCONN
检索 总服务类成员连接数 阈值队列的统计信息。
如果此参数为 NULL 或空字符串，那么将检索满足其他条件的所有队列的统计信息。

指定的值对应于 SYSCAT.THRESHOLDS 视图。

域
类型为 VARCHAR (18) 的输入参数，用于指定阈值域:
DB
数据库。
SB
服务子类。
SP
服务超类。
WA
工作操作集。
如果此参数为 NULL 或空字符串，那么将检索满足其他条件的所有队列的统计信息。

指定的值对应于 SYSCAT.THRESHOLDS 视图。

阈值名称
类型为 VARCHAR (128) 的输入参数，用于指定要检索其统计信息的特定阈值的名称。 指定的名称对应于 SYSCAT.THRESHOLDS 视图。 如果此自变量为 NULL 或空字符串，那么将检索满足其他条件的所有阈值的统计信息。
阈值标识
类型为 INTEGER 的输入参数，用于指定要检索其统计信息的特定阈值的标识。 指定的标识与 SYSCAT.THRESHOLDS 视图。 如果自变量为空或 -1，那么将检索满足其他条件的所有阈值的统计信息。

返回的信息

表 1. 由 MON_GET_QUEUE_STATS 例程返回的信息
列名 数据类型 描述
THRESHOLD_PREDICATE VARCHAR(27) threshold_predicate -“阈值谓词”监视元素
THRESHOLD_DOMAIN VARCHAR(18) threshold_domain -“阈值域”监视元素
THRESHOLD_NAME VARCHAR(128) threshold_name -“阈值名称”监视元素
THRESHOLD_ID INTEGER thresholdid -“阈值标识”监视元素
DBPARTITIONNUM SMALLINT dbpartitionnum -“数据库分区号”监视元素
SERVICE_SUPERCLASS_NAME VARCHAR(128) service_superclass_name -“服务超类名”监视元素
SERVICE_SUBCLASS_NAME VARCHAR(128) service_subclass_name -“服务子类名”监视元素
WORK_ACTION_SET_NAME VARCHAR(128) work_action_set_name -“工作操作集名称”监视元素
WORK_CLASS_NAME VARCHAR(128) work_class_name -“工作类名”监视元素
WORKLOAD_NAME VARCHAR(128) workload_name -“工作负载名称”监视元素
LAST_RESET TIMESTAMP last_reset -“最后重置时间戳记”监视元素
QUEUE_SIZE_TOP INTEGER queue_size_top -“最大队列大小”监视元素
QUEUE_TIME_TOTAL BIGINT queue_time_total -“总队列时间”监视元素
QUEUE_ASSIGNMENTS_TOTAL BIGINT queue_assignments_total -“队列分配总次数”监视元素
QUEUE_SIZE_CURRENT INTEGER 队列中的连接数或活动数。
QUEUE_TIME_LATEST BIGINT 要离开队列的最后一个连接或活动在队列上花费的时间。 单位为毫秒。
QUEUE_EXIT_TIME_LATEST TIMESTAMP 最后一个连接或活动离开队列的时间。
THRESHOLD_CURRENT_CONCURRENCY INTEGER 根据阈值当前正在运行的连接数或活动数。
THRESHOLD_MAX_CONCURRENCY INTEGER 阈值允许并行运行的最大连接数或最大活动数。
成员 SMALLINT member -“数据库成员”监视元素

使用说明

此函数不会跨成员聚集数据 (针对一个或多个队列)。 但是，可使用 SQL 查询来汇总数据，如示例中所示。

示例

  • 以下查询显示系统上所有队列（在所有成员上）的基本统计信息：
      SELECT substr(THRESHOLD_NAME, 1, 6) THRESHNAME,
       THRESHOLD_PREDICATE,
       THRESHOLD_DOMAIN,
       MEMBER MEMB,
       QUEUE_SIZE_TOP,
       QUEUE_TIME_TOTAL,
       QUEUE_ASSIGNMENTS_TOTAL QUEUE_ASSIGN 
  FROM table(MON_GET_QUEUE_STATS('', '', '', -1)) as QSTATS
    样本输出：
    THRESHNAME THRESHOLD_PREDICATE         THRESHOLD_DOMAIN   MEMB QUEUE_SIZE_TOP QUEUE_TIME_TOTAL QUEUE_ASSIGN
---------- --------------------------- ------------------ ---- -------------- ---------------- ------------
LIMIT1     CONCDBC                     DB                    0             12          1238540          734
LIMIT2     SCCONN                      SP                    0              4           741249           24
LIMIT3     DBCONN                      DB                    0              7           412785          128