SNAP_GET_DB_V97 表函数-从 dbase 逻辑组检索快照信息

SNAP_GET_DB_V97 表函数返回数据库 (dbase) 逻辑组中的快照信息。

重要信息: 不推荐使用 SNAP_GET_DB_V97 表函数，已将其替换为 MON_GET_DATABASE 表函数-获取数据库指标和 MON_GET_TRANSACTION_LOG 表函数-获取日志信息。

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

语法

模式为 SYSPROC。

表函数参数

dbname: 类型为 VARCHAR (128) 的输入参数，用于指定与当前连接的数据库在同一实例中的有效数据库名称。指定目录条目类型为 "Indirect" 或 "Home" 的数据库名称，如 LIST DATABASE DIRECTORY 命令所返回。指定空字符串以从当前连接的数据库获取快照。指定 NULL 值以从与当前连接的数据库相同的实例中的所有数据库获取快照。
成员: 类型为 INTEGER 的可选输入参数，用于指定有效数据库成员编号。对当前数据库成员指定 -1 ，或对所有活动数据库成员的聚集指定 -2 。如果 dbname 未设置为 NULL ，并且 member 设置为 NULL，那么将为 member隐式设置 -1 。如果未使用此输入选项，即仅提供 dbname ，那么将从所有活动数据库成员返回数据。活动数据库成员是数据库可供应用程序连接和使用的成员。

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

权限

需要下列其中一个权限：

对 SNAP_GET_DB_V97 表函数的 EXECUTE 特权
DATAACCESS 权限

此外，要访问快照监视器数据，还需要下列其中一个权限:

SYSMON
SYSCTRL
SYSMAINT
SYSADM

缺省 PUBLIC 特权

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

示例

示例 1: 检索当前连接的数据库的所有数据库成员中的状态，平台，位置和连接时间作为聚集视图。

SELECT SUBSTR(DB_NAME, 1, 20) AS DB_NAME, DB_STATUS, SERVER_PLATFORM, 
   DB_LOCATION, DB_CONN_TIME FROM TABLE(SNAP_GET_DB_V97('', -2)) AS T

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

DB_NAME     DB_STATUS    SERVER_PLATFORM ... 
-------...- ---------... --------------- ... 
SAMPLE      ACTIVE       AIX64           ... 
                                             
  1 record(s) selected.

此查询的输出（继续）。

... DB_LOCATION  DB_CONN_TIME               
... ------------ -------------------------- 
... LOCAL        2005-07-24-22.09.22.013196

示例 2: 检索包含当前连接的数据库的同一实例中所有活动数据库的所有数据库成员之间的状态，平台，位置和连接时间作为聚集视图。

SELECT SUBSTR(DB_NAME, 1, 20) AS DB_NAME, DB_STATUS, SERVER_PLATFORM, 
   DB_LOCATION, DB_CONN_TIME 
   FROM TABLE(SNAP_GET_DB_V97(CAST (NULL AS VARCHAR(128)), -2)) AS T

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

DB_NAME      DB_STATUS    SERVER_PLATFORM ...
--------...- ---------... --------------- ...
TOOLSDB      ACTIVE       AIX64           ...
SAMPLE       ACTIVE       AIX64           ...

此查询的输出（继续）。

... DB_LOCATION  DB_CONN_TIME              
... ------------ --------------------------
... LOCAL        2005-07-24-22.26.54.396335
... LOCAL        2005-07-24-22.09.22.013196

示例 3: 可以通过在命令行上调用以下命令来使用此例程:

连接到数据库时:

SELECT TOTAL_OLAP_FUNCS, OLAP_FUNC_OVERFLOWS, ACTIVE_OLAP_FUNCS 
   FROM TABLE (SNAP_GET_DB_V97('', 0)) AS T

The output will look like:

TOTAL_OLAP_FUNCS  OLAP_FUNC_OVERFLOWS  ACTIVE_OLAP_FUNCS   
----------------  -------------------- --------------------
               7                     2                    1
 
1 record(s) selected.

示例 4: 运行工作负载后，用户可以将以下查询与表函数配合使用。

 SELECT STATS_CACHE_SIZE, STATS_FABRICATIONS, SYNC_RUNSTATS, 
   ASYNC_RUNSTATS, STATS_FABRICATE_TIME, SYNC_RUNSTATS_TIME 
   FROM TABLE (SNAP_GET_DB_V97('mytestdb', -1)) AS SNAPDB

STATS_CACHE_SIZE STATS_FABRICATIONS SYNC_RUNSTATS ASYNC_RUNSTATS ...
---------------- ------------------ ------------- -------------- ...
             200                  1             2              0 ...

Continued

...STATS_FABRICATE_TIME  SYNC_RUNSTATS_TIME
...--------------------  ------------------
...                   2                  32

  1 record(s) selected.

示例 5: 以下示例显示如何使用 SNAP_GET_DB_V97 表函数来确定数据库的状态:

SELECT SUBSTR
   (DB_NAME, 1, 20) AS DB_NAME, DB_STATUS 
    FROM  table(SNAP_GET_DB_V97('hadrdb', 0))

DB_NAME              DB_STATUS
-------------------- ----------------
HADRDB               ACTIVE_STANDBY

返回的信息

表 1. SNAP_GET_DB_V97 表函数返回的信息
列名	数据类型	描述或相应的监视元素
snapshot_timestamp	TIMESTAMP	获取快照的日期和时间。
DB_NAME	VARCHAR(128)	db_name - 数据库名称
DB_PATH	VARCHAR(1024)	db_path - 数据库路径
input_db_alias	VARCHAR(128)	input_db_alias - 输入数据库别名
db_status	VARCHAR(16)	db_status-数据库状态。此接口根据 sqlmon.h中的定义返回文本标识，并且是下列其中一项: 活动 QUIESCE_PEND QUIESCED ROLLFWD ACTIVE_STANDBY-HADR 数据库处于已启用 "在备用数据库上读取" 的备用方式。 STANDBY-HADR 数据库处于备用数据库方式 (未启用对备用数据库的读取)。
CATALOG_PARTITION	SMALLINT	catalog_node - 目录节点号
CATALOG_PARTITION_NAME	VARCHAR(128)	catalog_node_name - 目录节点网络名
SERVER_PLATFORM	VARCHAR(12)	server_platform-服务器操作系统。此接口根据 sqlmon.h中的定义返回文本标识，并且是下列其中一项: AIX AIX64 AS400_DRDA DOS DYNIX HP HP64 HPIA HPIA64 LINUX LINUX390 LINUXIA64 LINUXPPC LINUXPPC64 LINUXX8664 LINUXZ64 MAC MVS_DRDA NT NT64 OS2 OS390 SCO SGI SNI SUN SUN64 未知 UNKNOWN_DRDA 虚拟机 DRDA VSE_DRDA WINDOWS
db_location	VARCHAR(12)	db_location-数据库位置。此接口返回基于 sqlmon.h, 中的定义的文本标识，并且是下列其中一项: LOCAL 远程
db_conn_time	TIMESTAMP	db_conn_time - 数据库激活时间戳记
LAST_RESET	TIMESTAMP	last_reset - 最后重置时间戳记
last_backup	TIMESTAMP	last_backup - 上次备份时间戳记
CONNECTIONS_TOP	BIGINT	connections_top - 最大并行连接数
TOTAL_CONS	BIGINT	total_cons - 数据库激活以后的连接数
total_sec_cons	BIGINT	total_sec_cons - 辅助连接数
appls_cur_cons	BIGINT	appls_cur_cons - 当前连接的应用程序数
APPLS_IN_DB2	BIGINT	appls_in_db2 - 数据库中当前执行的应用程序数
NUM_ASSOC_AGENTS	BIGINT	num_assoc_agents - 关联代理程序数
AGENTS_TOP	BIGINT	agents_top - 创建的代理程序数
coord_agents_top	BIGINT	coord_agents_top - 最大协调代理程序数
LOCKS_HELD	BIGINT	locks_held - 挂起的锁定数
LOCK_WAITS	BIGINT	lock_waits - 等待锁定次数
LOCK_WAIT_TIME	BIGINT	lock_wait_time - 等待锁定时间
lock_list_in_use	BIGINT	lock_list_in_use - 正在使用的锁定列表内存总量
DEADLOCKS	BIGINT	deadlocks - 检测到的死锁数
LOCK_ESCALS	BIGINT	lock_escals - 锁定升级次数
X_LOCK_ESCALS	BIGINT	x_lock_escals - 互斥锁定升级数
LOCKS_WAITING	BIGINT	locks_waiting - 当前正在等待锁定的代理程序数
LOCK_TIMEOUTS	BIGINT	lock_timeouts - 锁定超时次数
NUM_INDOUBT_TRANS	BIGINT	num_indoubt_trans - 不确定事务数
SORT_HEAP_ALLOCATED	BIGINT	sort_heap_allocated - 分配的总排序堆
SORT_SHRHEAP_ALLOCATED	BIGINT	sort_shrheap_allocated - 当前分配的共享排序堆
SORT_SHRHEAP_TOP	BIGINT	sort_shrheap_top-排序共享堆高水位标记
POST_SHRTHRESHOLD_SORTS	BIGINT	post_shrthreshold_sorts - 后共享阈值排序数
TOTAL_SORTS	BIGINT	total_sorts - 排序总数
TOTAL_SORT_TIME	BIGINT	total_sort_time - 排序总时间
SORT_OVERFLOWS	BIGINT	sort_overflows - 排序溢出数
ACTIVE_SORTS	BIGINT	active_sorts - 活动排序数
POOL_DATA_L_READS	BIGINT	pool_data_l_reads - 缓冲池数据逻辑读取数
POOL_DATA_P_READS	BIGINT	pool_data_p_reads - 缓冲池数据物理读取数
POOL_TEMP_DATA_L_READS	BIGINT	pool_temp_data_l_reads - 缓冲池临时数据逻辑读取数
POOL_TEMP_DATA_P_READS	BIGINT	pool_temp_data_p_reads - 缓冲池临时数据物理读取数
POOL_ASYNC_DATA_READS	BIGINT	pool_async_data_reads - 缓冲池异步数据读次数
POOL_DATA_WRITES	BIGINT	pool_data_writes - 缓冲池数据写次数
POOL_ASYNC_DATA_WRITES	BIGINT	pool_async_data_writes - 缓冲池异步数据写次数
POOL_INDEX_L_READS	BIGINT	pool_index_l_reads - 缓冲池索引逻辑读取数
POOL_INDEX_P_READS	BIGINT	pool_index_p_reads - 缓冲池索引物理读取数
POOL_TEMP_INDEX_L_READS	BIGINT	pool_temp_index_l_reads - 缓冲池临时索引逻辑读取数
POOL_TEMP_INDEX_P_READS	BIGINT	pool_temp_index_p_reads - 缓冲池临时索引物理读取数
POOL_ASYNC_INDEX_READS	BIGINT	pool_async_index_reads - 缓冲池异步索引读取数
POOL_INDEX_WRITES	BIGINT	pool_index_writes - 缓冲池索引写次数
POOL_ASYNC_INDEX_WRITES	BIGINT	pool_async_index_writes - 缓冲池异步索引写次数
POOL_XDA_P_READS	BIGINT	pool_xda_p_reads - 缓冲池 XDA 数据物理读取数
POOL_XDA_L_READS	BIGINT	pool_xda_l_reads - 缓冲池 XDA 数据逻辑读取数
POOL_XDA_WRITES	BIGINT	pool_xda_writes - 缓冲池 XDA 数据写次数
POOL_ASYNC_XDA_READS	BIGINT	pool_async_xda_reads - 缓冲池异步 XDA 数据读取数
POOL_ASYNC_XDA_WRITES	BIGINT	pool_async_xda_writes - 缓冲池异步 XDA 数据写次数
POOL_TEMP_XDA_P_READS	BIGINT	pool_temp_xda_p_reads -“缓冲池临时 XDA 数据物理读取数”监视元素
POOL_TEMP_XDA_L_READS	BIGINT	pool_temp_xda_l_reads - 缓冲池临时 XDA 数据逻辑读取数
POOL_READ_TIME	BIGINT	pool_read_time - 缓冲池物理读总时间
POOL_WRITE_TIME	BIGINT	pool_write_time - 缓冲池物理写总时间
POOL_ASYNC_READ_TIME	BIGINT	pool_async_read_time - 缓冲池异步读取时间
POOL_ASYNC_WRITE_TIME	BIGINT	pool_async_write_time - 缓冲池异步写入时间
POOL_ASYNC_DATA_READ_REQS	BIGINT	pool_async_data_read_reqs - 缓冲池异步读请求数
POOL_ASYNC_INDEX_READ_REQS	BIGINT	pool_async_index_read_reqs - 缓冲池异步索引读请求数
POOL_ASYNC_XDA_READ_REQS	BIGINT	pool_async_xda_read_reqs - 缓冲池异步 XDA 读请求数
POOL_NO_VICTIM_BUFFER	BIGINT	pool_no_victim_buffer - 缓冲池无牺牲缓冲区的次数
POOL_LSN_GAP_CLNS	BIGINT	pool_lsn_gap_clns - 触发缓冲池日志空间清清除程序的次数
POOL_DRTY_PG_STEAL_CLNS	BIGINT	pool_drty_pg_steal_clns - 触发缓冲池牺牲页清除程序的次数
POOL_DRTY_PG_THRSH_CLNS	BIGINT	pool_drty_pg_thrsh_clns - 触发缓冲池阈值清除程序的次数
PREFETCH_WAIT_TIME	BIGINT	prefetch_wait_time - 等待预取的时间
UNREAD_PREFETCH_PAGES	BIGINT	unread_prefetch_pages - 未读取的预取页数
DIRECT_READS	BIGINT	direct_reads - 直接读取数据库的次数
DIRECT_WRITES	BIGINT	direct_writes - 直接写至数据库的次数
DIRECT_READ_REQS	BIGINT	direct_read_reqs - 直接读请求数
DIRECT_WRITE_REQS	BIGINT	direct_write_reqs - 直接写请求数
DIRECT_READ_TIME	BIGINT	direct_read_time - 直接读时间
DIRECT_WRITE_TIME	BIGINT	direct_write_time - 直接写时间
FILES_CLOSED	BIGINT	files_closed - 关闭的数据库文件数
ELAPSED_EXEC_TIME_S	BIGINT	elapsed_exec_time - 语句执行耗用时间
ELAPSED_EXEC_TIME_MS	BIGINT	elapsed_exec_time - 语句执行耗用时间
COMMIT_SQL_STMTS	BIGINT	commit_sql_stmts - 尝试的落实语句数
ROLLBACK_SQL_STMTS	BIGINT	rollback_sql_stmts - 尝试的回滚语句数
DYNAMIC_SQL_STMTS	BIGINT	dynamic_sql_stmts - 尝试的动态 SQL 语句数
STATIC_SQL_STMTS	BIGINT	static_sql_stmts - 尝试的静态 SQL 语句数
FAILED_SQL_STMTS	BIGINT	failed_sql_stmts - 失败的语句操作
SELECT_SQL_STMTS	BIGINT	select_sql_stmts - 执行的 Select SQL 语句数
UID_SQL_STMTS	BIGINT	uid_sql_stmts - 执行的 UPDATE/INSERT/DELETE SQL 语句数
DDL_SQL_STMTS	BIGINT	ddl_sql_stmts - 数据定义语言 (DDL) SQL 语句数
INT_AUTO_REBINDS	BIGINT	int_auto_rebinds - 内部自动重新绑定次数
INT_ROWS_DELETED	BIGINT	int_rows_deleted - 删除的内部行数
INT_ROWS_INSERTED	BIGINT	int_rows_inserted - 插入的内部行数
INT_ROWS_UPDATED	BIGINT	int_rows_updated - 更新的内部行数
INT_COMMITS	BIGINT	int_commits - 内部落实数
INT_ROLLBACKS	BIGINT	int_rollbacks - 内部回滚
INT_DEADLOCK_ROLLBACKS	BIGINT	int_deadlock_rollbacks - 死锁导致的内部回滚数
ROWS_DELETED	BIGINT	rows_deleted - 删除行数
ROWS_INSERTED	BIGINT	rows_inserted - 插入行数
ROWS_UPDATED	BIGINT	rows_updated - 更新行数
ROWS_SELECTED	BIGINT	rows_selected - 选择的行数
ROWS_READ	BIGINT	rows_read - 读取行数
BINDS_PRECOMPILES	BIGINT	binds_precompiles - 尝试的绑定次数/预编译次数
TOTAL_LOG_AVAILABLE	BIGINT	total_log_available - 可用的总日志量
TOTAL_LOG_USED	BIGINT	total_log_used - 使用的日志空间总量
SEC_LOG_USED_TOP	BIGINT	sec_log_used_top - 使用的最大辅助日志空间
TOT_LOG_USED_TOP	BIGINT	tot_log_used_top - 使用的日志空间最大总量
SEC_LOGS_ALLOCATED	BIGINT	sec_logs_allocated - 当前分配的辅助日志数
LOG_READS	BIGINT	log_reads - 读取的日志页数
LOG_READ_TIME_S	BIGINT	log_read_time - 日志读取时间
LOG_READ_TIME_NS	BIGINT	log_read_time - 日志读取时间
LOG_WRITES	BIGINT	log_writes - 写入的日志页数
LOG_WRITE_TIME_S	BIGINT	log_write_time - 日志写入时间
LOG_WRITE_TIME_NS	BIGINT	log_write_time - 日志写入时间
NUM_LOG_WRITE_IO	BIGINT	num_log_write_io - 日志写入次数
NUM_LOG_READ_IO	BIGINT	num_log_read_io - 日志读取数
NUM_LOG_PART_PAGE_IO	BIGINT	num_log_part_page_io - 部分日志页写入数
NUM_LOG_BUFFER_FULL	BIGINT	num_log_buffer_full - 完整日志缓冲区的数量
num_log_data_found_in_buffer	BIGINT	num_log_data_found_in_buffer - 在缓冲区中找到日志数据的次数
appl_id_oldest_xact	BIGINT	appl_id_oldest_xact - 带有最旧事务的应用程序
LOG_TO_REDO_FOR_RECOVERY	BIGINT	log_to_redo_for_recovery - 要为恢复重做的日志量
LOG_HELD_BY_DIRTY_PAGES	BIGINT	log_held_by_dirty_pages - 脏页占用的日志空间量
PKG_CACHE_LOOKUPS	BIGINT	pkg_cache_lookups - 程序包高速缓存查询数
PKG_CACHE_INSERTS	BIGINT	pkg_cache_inserts - 程序包高速缓存插入数
PKG_CACHE_NUM_OVERFLOWS	BIGINT	pkg_cache_num_overflows - 程序包高速缓存溢出数
PKG_CACHE_SIZE_TOP	BIGINT	pkg_cache_size_top-程序包高速缓存高水位标记
APPL_SECTION_LOOKUPS	BIGINT	appl_section_lookups - 节查询数
APPL_SECTION_INSERTS	BIGINT	appl_section_inserts - 节插入数
CAT_CACHE_LOOKUPS	BIGINT	cat_cache_lookups - 目录高速缓存查询数
CAT_CACHE_INSERTS	BIGINT	cat_cache_inserts - 目录高速缓存插入数
CAT_CACHE_OVERFLOWS	BIGINT	cat_cache_overflows - 目录高速缓存溢出数
CAT_CACHE_SIZE_TOP	BIGINT	cat_cache_size_top-目录高速缓存高水位标记
priv_workspace_size_top	BIGINT	priv_workspace_size_top - 最大专用工作空间大小
priv_workspace_num_overflows	BIGINT	priv_workspace_num_overflows - 专用工作空间溢出数
priv_workspace_section_inserts	BIGINT	priv_workspace_section_inserts - 专用工作空间节插入数
priv_workspace_section_lookups	BIGINT	priv_workspace_section_lookups - 专用工作空间节查询数
shr_workspace_size_top	BIGINT	shr_workspace_size_top - 最大共享工作空间大小
shr_workspace_num_overflows	BIGINT	shr_workspace_num_overflows - 共享工作空间溢出数
shr_workspace_section_inserts	BIGINT	shr_workspace_section_inserts - 共享工作空间节插入数
shr_workspace_section_lookups	BIGINT	shr_workspace_section_lookups - 共享工作空间节查询数
TOTAL_HASH_JOINS	BIGINT	total_hash_joins - 散列连接总数
TOTAL_HASH_LOOPS	BIGINT	total_hash_loops - 总散列循环数
HASH_JOIN_OVERFLOWS	BIGINT	hash_join_overflows - 散列连接溢出数
HASH_JOIN_SMALL_OVERFLOWS	BIGINT	hash_join_small_overflows - 散列连接小溢出数
POST_SHRTHRESHOLD_HASH_JOINS	BIGINT	post_shrthreshold_hash_joins - 后阈值散列连接数
ACTIVE_HASH_JOINS	BIGINT	active_hash_joins - 活动散列连接数
num_db_storage_paths	BIGINT	num_db_storage_paths - 自动存储路径数
DBPARTITIONNUM	SMALLINT	dbpartitionnum -“数据库分区号”监视元素
smallest_log_avail_node	INTEGER	smallest_log_avail_node - 带有最少可用日志空间的节点
TOTAL_OLAP_FUNCS	BIGINT	total_olap_funcs - OLAP 函数总数
OLAP_FUNC_OVERFLOWS	BIGINT	olap_func_overflows - OLAP 函数溢出次数
ACTIVE_OLAP_FUNCS	BIGINT	active_olap_funcs - 活动 OLAP 函数
STATS_CACHE_SIZE	BIGINT	stats_cache_size 统计信息高速缓存大小
STATS_FABRICATIONS	BIGINT	stats_处生成统计信息的总数
SYNC_RUNSTATS	BIGINT	sync_runstats 同步 RUNSTATS 活动总数
ASYNC_RUNSTATS	BIGINT	async_runstats 异步 RUNSTATS 请求总数
STATS_FABRICATE_TIME	BIGINT	stats_fabricate_time 用于统计信息生成活动的总时间
SYNC_RUNSTATS_TIME	BIGINT	sync_runstats_time 用于同步 RUNSTATS 活动的总时间
NUM_THRESHOLD_VIOLATIONS	BIGINT	num_threshold_violations - 阈值违例次数