ADMIN_GET_DBP_MEM_USAGE 表函数 - 获取实例的内存总耗用量

ADMIN_GET_DBP_MEM_USAGE 表函数获取给定实例的总内存消耗。

注: 不推荐使用此表函数，将其替换为 ADMIN_GET_MEM_USAGE 表函数-获取实例的总内存消耗。

ADMIN_GET_DBP_MEM_USAGE 表函数采用可选输入参数 member (INTEGER 类型) ，用于指定有效的数据库成员编号，并仅返回该单个数据库成员的统计信息。如果省略该参数，那么将返回所有活动数据库成员的统计信息。在多成员环境中，如果为 member指定 -1 或 NULL 值，那么将从当前连接的成员返回数据。

语法

模式为 SYSPROC。

表函数参数

成员: 类型为整数的可选输入参数，用于指定将从中检索内存使用情况统计信息的数据库成员。如果指定 -1 或 NULL 值，那么将从当前连接的成员返回数据。

权限

需要下列其中一项权限才能执行此例程：

对例程的 EXECUTE 特权
DATAACCESS 权限
DBADM 权限
SQLADM 权限

缺省 PUBLIC 特权

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

返回的信息

表 1. ADMIN_GET_DBP_MEM_USAGE 的结果集
列名	数据类型	描述
DBPARTITIONNUM	SMALLINT	dbpartitionnum -“数据库分区号”监视元素
MAX_PARTITION_MEM	BIGINT	在强制实施实例内存限制的情况下，允许在数据库分区中使用的最大实例内存量 (以字节计)。
CURRENT_PARTITION_MEM	BIGINT	数据库分区中当前使用的实例内存量 (以字节计)。
PEAK_PARTITION_MEM	BIGINT	数据库分区中实例内存的峰值或高水位标记消耗 (以字节计)。

示例

示例 1: 从数据库分区检索内存使用情况统计信息 3

SELECT * FROM TABLE (SYSPROC.ADMIN_GET_DBP_MEM_USAGE(3)) AS T

DBPARTITIONNUM   MAX_PARTITION_MEM   CURRENT_PARTITION_MEM   PEAK_PARTITION_MEM
--------------   -----------------   ---------------------   ------------------
             3           500000000               381000000            481000000

  1 record(s) selected.

示例 2: 从当前连接的成员检索内存使用情况统计信息 (假定用户已连接到成员 2 处的数据库。)

SELECT * FROM TABLE (SYSPROC.ADMIN_GET_DBP_MEM_USAGE(-1)) AS T

DBPARTITIONNUM   MAX_PARTITION_MEM   CURRENT_PARTITION_MEM   PEAK_PARTITION_MEM
--------------   -----------------   ---------------------   ------------------
             2           500000000               381000000            481000000

  1 record(s) selected.

示例 3: 从所有成员检索内存使用情况统计信息

SELECT * FROM TABLE (SYSPROC.ADMIN_GET_DBP_MEM_USAGE()) AS T

DBPARTITIONNUM   MAX_PARTITION_MEM   CURRENT_PARTITION_MEM   PEAK_PARTITION_MEM
--------------   -----------------   ---------------------   ------------------
             0           500000000               381000000            481000000
             1           500000000               381000000            481000000
             2           500000000               381000000            481000000
             3           500000000               381000000            481000000

  4 record(s) selected.

示例 4: 检索内存使用情况统计信息 (以兆字节 (MB) 值为单位)

SELECT DBPARTITIONNUM, MAX_PARTITION_MEM/1048576 AS MAX_MEM_MB,
   CURRENT_PARTITION_MEM/1048576 AS CURRENT_MEM_MB, PEAK_PARTITION_MEM/1048576
   AS PEAK_MEM_MB FROM TABLE (SYSPROC.ADMIN_GET_DBP_MEM_USAGE()) AS T

DBPARTITIONNUM  MAX_MEM_MB  CURRENT_MEM_MB  PEAK_MEM_MB
--------------  ----------  --------------  -----------
             0        4590            1107         1107
             1        4590            1108         1108
             2        4590            1106         1106

  3 record(s) selected.