SNAPFCM 管理视图和 SNAP_GET_FCM 表函数-检索 fcm 逻辑数据组快照信息

SNAPFCM 管理视图和 SNAP_GET_FCM 表函数从数据库管理器快照 (尤其是 fcm 逻辑数据组) 返回有关快速通信管理器的信息。

要点: 不推荐使用 SNAPFCM 管理视图和 SNAP_GET_FCM 表函数,已将其替换为 MON_GET_FCM-Get FCM metrics
根据您使用的是管理视图还是表函数,请参阅下列其中一个部分:

SNAPFCM 管理视图

通过将 MON_GET_FCM , MON_GET_INSTANCE , MON_GET_MEMORY_SET 和 MON_GET_MEMORY_POOL 表函数与 SNAPSWITCH 管理视图配合使用, SNAPFCM 管理视图提供等同于 GET SNAPSHOT FOR DBM 命令的数据。

模式为 SYSIBMADM。

请参阅 表 1 ,以获取可返回的完整信息列表。

权限

需要下列其中一个权限才能使用该视图:
  • 对 SNAPFCM 管理视图的 SELECT 特权
  • 对 SNAPFCM 管理视图的 CONTROL 特权
  • DATAACCESS 权限
  • DBADM 权限
  • SQLADM 权限
需要下列其中一项才能使用表函数:
  • 对 SNAP_GET_FCM 表函数的 EXECUTE 特权
  • DATAACCESS 权限
  • DBADM 权限
  • SQLADM 权限
此外,要访问快照监视器数据,还需要下列其中一个权限:
  • SYSMON
  • SYSCTRL
  • SYSMAINT
  • SYSADM

缺省 PUBLIC 特权

在非限制性数据库中,当自动创建视图时,将向 PUBLIC 授予 SELECT 特权。

示例

在所有成员上检索有关快速通信管理器的消息缓冲区的信息。
SELECT BUFF_FREE, BUFF_FREE_BOTTOM, MEMBER
    FROM SYSIBMADM.SNAPFCM ORDER BY MEMBER
下列是从此查询输出的示例。
BUFF_FREE        BUFF_FREE_BOTTOM     MEMBER
---------...---- -------------------- --------------
            5120                 5100              0
            5120                 5100              1
            5120                 5100              2

SNAP_GET_FCM 表函数

SNAP_GET_FCM 表函数返回与 SNAPFCM 管理视图相同的信息,但允许您检索特定数据库成员,聚集所有数据库成员或所有数据库成员的信息。

与 SNAP_GET_DBM , SNAP_GET_DBM_MEMORY_POOL , SNAP_GET_FCM_PART 和 SNAP_GET_SWITCH 表函数配合使用, SNAP_GET_FCM 表函数提供与 GET SNAPSHOT FOR DBM 命令等效的数据。

请参阅 表 1 ,以获取可返回的完整信息列表。

语法

Read syntax diagramSkip visual syntax diagramSNAP_GET_FCM(member)

模式为 SYSPROC。

表函数参数

成员
类型为 INTEGER 的可选输入参数,用于指定有效数据库成员编号。 对当前成员指定 -1 ,或对所有活动成员的聚集指定 -2 。 如果 dbname 未设置为 NULL ,并且 member 设置为 NULL,那么将为 member隐式设置-1 。 如果未使用此输入选项,那么将从所有活动数据库成员返回数据。 活动数据库成员是数据库可供应用程序连接和使用的成员。

如果 member 设置为 NULL,那么将尝试从 SNAP_WRITE_FILE 过程创建的文件中读取数据。 请注意,此文件可能是在任何时候创建的,这意味着数据可能不是最新的。 如果不存在具有相应快照 API 请求类型的文件,那么 SNAP_GET_FCM 表函数将为当前连接的数据库和数据库成员生成快照。

权限

需要下列其中一个权限:
  • 对 SNAP_GET_FCM 表函数的 EXECUTE 特权
  • DATAACCESS 权限
此外,要访问快照监视器数据,还需要下列其中一个权限:
  • SYSMON
  • SYSCTRL
  • SYSMAINT
  • SYSADM

缺省 PUBLIC 特权

在非限制性数据库中,当自动创建该功能时,将向 PUBLIC 授予 EXECUTE 特权。

示例

检索有关数据库成员 1 上快速通信管理器的消息缓冲区的信息。
SELECT BUFF_FREE, BUFF_FREE_BOTTOM, MEMBER 
   FROM TABLE(SYSPROC.SNAP_GET_FCM( 1 )) AS T
下列是从此查询输出的示例。
BUFF_FREE            BUFF_FREE_BOTTOM     MEMBER
-------------------- -------------------- ------
                5120                 5100      1

返回的信息

表 1. SNAPFCM 管理视图和 SNAP_GET_FCM 表函数返回的信息
列名 数据类型 描述或相应的监视元素
snapshot_timestamp TIMESTAMP 获取快照的日期和时间。
buff_free BIGINT buff_free - 当前可用的 FCM 缓冲区数
buff_free_bottom BIGINT buff_free_bottom - 最小可用 FCM 缓冲区数
ch_free BIGINT ch_free - 当前可用的通道数
ch_free_bottom BIGINT ch_free_bottom - 最低可用通道数
DBPARTITIONNUM SMALLINT dbpartitionnum -“数据库分区号”监视元素
MEMBER SMALLINT member -“数据库成员”监视元素