SNAPDBM 管理视图和 SNAP_GET_DBM 表函数-检索 dbm 逻辑分组快照信息
SNAPDBM 管理视图和 SNAP_GET_DBM 表函数返回快照监视器数据库管理器 (dbm) 逻辑分组信息。
重要信息: 不推荐使用 SNAPDBM 管理视图和 SNAP_GET_DBM 表函数，已将其替换为 MON_GET_INSTANCE 表函数-获取实例级别信息。
根据您使用的是管理视图还是表函数，请参阅下列其中一个部分:
SNAPDBM 管理视图
与 SNAPSWITCH 管理视图和 MON_GET_FCM ， MON_GET_MEMORY_SET ， MON_GET_MEMORY_POOL 表函数配合使用时， SNAPDBM 管理视图提供与 GET SNAPSHOT FOR DBM 命令等效的数据。
模式为 SYSIBMADM。
请参阅 表 1 ，以获取可返回的完整信息列表。
权限
需要下列其中一个权限才能使用该视图:
- 对 SNAPDBM 管理视图的 SELECT 特权
- 对 SNAPDBM 管理视图的 CONTROL 特权
- DATAACCESS 权限
- DBADM 权限
- SQLADM 权限
- ACCESSCTRL 权限
- SECADM 权限
需要下列其中一项才能使用表函数:
- 对 SNAP_GET_DBM 表函数的 EXECUTE 特权
- DATAACCESS 权限
- DBADM 权限
- SQLADM 权限
此外，要访问快照监视器数据，还需要下列其中一个权限:
- SYSMON
- SYSCTRL
- SYSMAINT
- SYSADM
缺省 PUBLIC 特权
在非限制性数据库中，当自动创建视图时，将向 PUBLIC 授予 SELECT 特权。
示例
检索所有数据库成员的数据库管理器状态和连接信息。
SELECT DB2_STATUS, DB2START_TIME, LAST_RESET, LOCAL_CONS, REM_CONS_IN,
(AGENTS_CREATED_EMPTY_POOL/AGENTS_FROM_POOL) AS AGENT_USAGE,
DBPARTITIONNUM FROM SYSIBMADM.SNAPDBM ORDER BY DBPARTITIONNUM下列是从此查询输出的示例。
DB2_STATUS DB2START_TIME LAST_RESET ...
------------ -------------------------- ----------...- ...
ACTIVE 2006-01-06-14.59.59.059879 - ...
ACTIVE 2006-01-06-14.59.59.097605 - ...
ACTIVE 2006-01-06-14.59.59.062798 - ...
3 record(s) selected. ...
此查询的输出（继续）。
... LOCAL_CONS REM_CONS_IN AGENT_USAGE DBPARTITIONNUM
... ----------...- -----------...- -----------...- --------------
... 1 1 0 0
... 0 0 0 1
... 0 0 0 2
SNAP_GET_DBM 表函数
SNAP_GET_DBM 表函数返回与 SNAPDBM 管理视图相同的信息，但允许您检索特定数据库成员的信息，聚集所有数据库成员或所有数据库成员。
与 SNAP_GET_DBM_MEMORY_POOL ， SNAP_GET_FCM ， SNAP_GET_FCM_PART 和 SNAP_GET_SWITCH 表函数配合使用， SNAP_GET_DBM 表函数提供与 GET SNAPSHOT FOR DBM 命令等效的数据。
请参阅 表 1 ，以获取可返回的完整信息列表。
语法
模式为 SYSPROC。
表函数参数
- 成员
- 类型为 INTEGER 的可选输入参数，用于指定有效数据库成员编号。 对当前数据库成员指定 -1 ，或对所有活动数据库成员的聚集指定 -2 。 如果未使用此输入选项，那么将从所有活动数据库成员返回数据。 活动数据库成员是数据库可供应用程序连接和使用的成员。
如果 member 设置为 NULL，那么将尝试从 SNAP_WRITE_FILE 过程创建的文件中读取数据。 请注意，此文件可能是在任何时候创建的，这意味着数据可能不是最新的。 如果不存在具有相应快照 API 请求类型的文件，那么 SNAP_GET_DBM 表函数将从内存调用快照。
权限
需要下列其中一个权限：
- 对 SNAP_GET_DBM 表函数的 EXECUTE 特权
- DATAACCESS 权限
此外，要访问快照监视器数据，还需要下列其中一个权限:
- SYSMON
- SYSCTRL
- SYSMAINT
- SYSADM
缺省 PUBLIC 特权
在非限制性数据库中，当自动创建该功能时，将向 PUBLIC 授予 EXECUTE 特权。
示例
检索数据库成员号 2 的开始时间和当前状态。
SELECT DB2START_TIME, DB2_STATUS FROM TABLE(SNAP_GET_DBM(2)) AS T下列是从此查询输出的示例。
DB2START_TIME DB2_STATUS
-------------------------- ------------
2006-01-06-14.59.59.062798 ACTIVE
返回的信息
| 列名 | 数据类型 | 描述或相应的监视元素 |
|---|---|---|
| snapshot_timestamp | TIMESTAMP | 获取快照的日期和时间。 |
| SORT_HEAP_ALLOCATED | BIGINT | sort_heap_allocated - 分配的总排序堆 |
| POST_THRESHOLD_SORTS | BIGINT | post_threshold_sorts - 后阈值排序数 |
| piped_sorts_requested | BIGINT | piped_sorts_requested - 请求的管道排序数 |
| piped_sorts_accepted | BIGINT | piped_sorts_accepted - 接受的管道排序数 |
| rem_cons_in | BIGINT | rem_cons_in - 与数据库管理器的远程连接数 |
| rem_cons_in_exec | BIGINT | rem_cons_in_exec － 在数据库管理器中执行的远程连接数监视元素 |
| local_cons | BIGINT | local_cons - 本地连接数 |
| local_cons_in_exec | BIGINT | local_cons_in_exec － 在数据库管理器中执行的本地连接数监视元素 |
| con_local_dbases | BIGINT | con_local_dbases - 带有当前连接的本地数据库 |
| agents_registered | BIGINT | agents_registered - 已注册的代理程序数 |
| agents_waiting_on_token | BIGINT | agents_waiting_on_token - 正在等待令牌的代理程序数 |
| DB2_STATUS | VARCHAR(12) | db2_status -数据库实例的状态 此接口根据 sqlmon.h中的定义返回文本标识，并且是下列其中一项:
|
| agents_registered_top | BIGINT | agents_registered_top - 已注册的最大代理程序数 |
| agents_waiting_top | BIGINT | agents_waiting_top - 正在等待的最大代理程序数 |
| comm_private_mem | BIGINT | comm_private_mem - 已落实的专用内存 |
| idle_agents | BIGINT | idle_agents - 空闲代理程序数 |
| agents_from_pool | BIGINT | agents_from_pool - 从池中分配的代理程序数 |
| agents_created_empty_pool | BIGINT | agents_created_empty_pool - 由于空的代理程序池而创建的代理程序数 |
| coord_agents_top | BIGINT | coord_agents_top - 最大协调代理程序数 |
| max_agent_overflows | BIGINT | max_agent_overflows - 最大代理程序溢出次数 |
| agents_stolen | BIGINT | agents_stolen - 失窃代理程序数 |
| gw_total_cons | BIGINT | gw_total_cons- Db2® Connect 的尝试连接总数 |
| gw_cur_cons | BIGINT | gw_cur_cons- Db2 Connect 的当前连接数 |
| gw_cons_wait_host | BIGINT | gw_cons_wait_host - 等待主机应答的连接数 |
| gw_cons_wait_client | BIGINT | gw_cons_wait_client - 等待客户机发送请求的连接数 |
| POST_THRESHOLD_ HASH_JOIN | BIGINT | post_threshold_hash_joins - 散列连接阈值 |
| num_gw_conn_switches | BIGINT | num_gw_conn_switches - 连接交换次数 |
| DB2START_TIME | TIMESTAMP | db2start_time - 启动数据库管理器时间戳记 |
| LAST_RESET | TIMESTAMP | last_reset - 最后重置时间戳记 |
| NUM_NODES_IN_ DB2_INSTANCE | INTEGER | num_nodes_in_db2_instance - 数据库分区中的节点数 |
| PRODUCT_NAME | VARCHAR(32) | product_name - 产品名称 |
| service_level | VARCHAR(18) | service_level - 服务级别 |
| SORT_HEAP_TOP | BIGINT | sort_heap_top-排序专用堆高水位标记 |
| DBPARTITIONNUM | SMALLINT | dbpartitionnum -“数据库分区号”监视元素 |
| POST_THRESHOLD_OLAP_FUNCS | BIGINT | post_threshold_olap_funcs - OLAP 函数阈值 |
| MEMBER | SMALLINT | member -“数据库成员”监视元素 |