MON_GET_CONTAINER 表函数 - 获取表空间容器指标

语法

模式为 SYSPROC。

表函数参数

tbsp_name

类型为 VARCHAR (128) 的输入参数，用于指定与调用此函数时当前连接到的数据库相同的数据库中的有效表空间名称。 如果自变量为 NULL 或空字符串，那么将针对数据库中所有表空间中的所有容器返回度量值。

成员

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

权限

缺省 PUBLIC 特权

无

示例

示例 1: 列出读取时间最长的所有数据库成员上的容器。

SELECT varchar(container_name,70) as container_name, 
       varchar(tbsp_name,20) as tbsp_name, 
       pool_read_time 
FROM TABLE(MON_GET_CONTAINER('',-2)) AS t 
ORDER BY pool_read_time DESC

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

CONTAINER_NAME                                                         ... 
---------------------------------------------------------------------- ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000000/C0000000.CAT      ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000002/C0000000.LRG      ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000001/C0000000.TMP      ... 

  3 record(s) selected.

查询的输出（继续）。

... TBSP_NAME            POOL_READ_TIME      
... -------------------- --------------------
... SYSCATSPACE                           597
... USERSPACE1                             42
... TEMPSPACE1                              0

示例 2: 列出不可访问的任何容器。

SELECT varchar(container_name, 70) as container_name 
FROM TABLE(MON_GET_CONTAINER('',-1)) AS t 
WHERE accessible = 0

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

CONTAINER_NAME                                                        
----------------------------------------------------------------------

  0 record(s) selected.

示例 3: 列出容器文件系统的利用率，按最高利用率排序。

SELECT varchar(container_name, 65) as container_name, 
       fs_id, 
       fs_used_size, 
       fs_total_size, 
       CASE WHEN fs_total_size > 0 
            THEN DEC(100*(FLOAT(fs_used_size)/FLOAT(fs_total_size)),5,2) 
            ELSE DEC(-1,5,2) 
       END as utilization 
FROM TABLE(MON_GET_CONTAINER('',-1)) AS t 
ORDER BY utilization DESC

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

CONTAINER_NAME                                                    ... 
----------------------------------------------------------------- ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000000/C0000000.CAT ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000001/C0000000.TMP ... 
/home/hotel55/swalkty/swalkty/NODE0000/TEST/T0000002/C0000000.LRG ... 

  3 record(s) selected.

查询的输出（继续）。

FS_ID                FS_USED_SIZE         FS_TOTAL_SIZE        UTILIZATION 
-------------------- -------------------- -------------------- ----------- 
               64768         106879311872         317068410880       33.70
               64768         106879311872         317068410880       33.70
               64768         106879311872         317068410880       33.70

使用说明

MON_GET_CONTAINER 表函数针对每个容器和每个数据库成员返回一行数据。 可以针对给定表空间中的所有容器返回数据，也可以针对数据库中的所有容器返回数据。 不执行跨数据库分区的聚集。 但是，可以通过 SQL 查询来实现聚集。

此函数收集的度量在数据库级别使用 mon_obj_metrics 配置参数进行控制。 缺省情况下，已启用指标收集。

返回的信息