数据库快照是一个只读的静态的数据库。DM 快照功能是基于数据库实现的，每个快照是基于数据库的只读镜像。通过检索快照，可以获取源数据库在快照创建时间点的相关数据信息。
为了方便管理自动工作集负载信息库 AWR（Automatic Workload Repository）的信息，系统为其所有重要统计信息和负载信息执行一次快照，并将这些快照存储在 AWR 中。
用户在使用 DBMS_WORKLOAD_REPOSITORY 包之前，需要提前调用系统过程 SP_INIT_AWR_SYS(1)创建包。DM 数据库在创建该包时，默认创建一个名为 SYSAUX 的表空间，对应的数据文件为 SYSAWR.DBF，该表空间用于存储该包生成快照的数据。如果该包被删除，那么 SYSAUX 表空间也对应地被删除。
AWR 功能默认是关闭的，如果需要开启，则调用 DBMS_WORKLOAD_REPOSITORY.AWR_SET_INTERVAL 过程设置快照的间隔时间。DBMS_WORKLOAD_REPOSITORY 包还负责 snapshot（快照）的管理。
若创建数据库时页大小选择为 4K，不支持 DBMS_WORKLOAD_REPOSITORY 包的相关方法；DM MPP 环境下不支持 DBMS_WORKLOAD_REPOSITORY 包。
22.1 相关方法
- AWR_CLEAR_HISTORY();
清理之前的所有 snapshot 记录。
语法如下：
PROCEDURE AWR_CLEAR_HISTORY();
- AWR_SET_INTERVAL();
设置生成 snapshot 的时间间隔。
语法如下：
PROCEDURE AWR_SET_INTERVAL(
AWR_INTERVAL IN INT DEFAULT 60
);
参数详解
-
AWR_INTERVAL
时间间隔。单位分钟，取值范围为 10~525600，缺省值为 60。参数为 0 时，关闭快照（关闭时参数值为 57816000 分钟(110 年)，是一个无效的值）。
- AWR_REPORT_HTML
定义 1：
生成 HTML 格式的报告。
FUNCTION AWR_REPORT_HTML(
START_SNAP_ID IN INT,
END_SNAP_ID IN INT
)RETURN AWRRPT_ROW_TYPE PIPELINED;
参数详解
-
START_SNAP_ID
起始 SNAPSHOT_ID。
-
END_SNAP_ID
终止 SNAPSHOT_ID。
返回值
返回包含报告的全部 html 脚本信息的嵌套表类型 AWRRPT_ROW_TYPE。
定义 2：
把 AWR 数据报表生成到指定路径的 HTML 文件。
PROCEDURE SYS.AWR_REPORT_HTML(
START_ID IN INT,
END_ID IN INT,
DEST_DIR IN VARCHAR(128),
DEST_FILE IN VARCHAR(128)
);
参数详解
-
START_ID
起始 SNAPSHOT_ID。
-
END_ID
终止 SNAPSHOT_ID。
-
DEST_DIR
指定生成报告的目标路径。
-
DEST_FILE
指定生成报告的目标文件名，文件名需要以.htm 和.html 结尾。
- AWR_REPORT_TEXT
定义 1：
生成 TEXT 格式的报告。
FUNCTION AWR_REPORT_TEXT(
START_SNAP_ID IN INT,
END_SNAP_ID IN INT
) RETURN AWRRPT_ROW_TYPE PIPELINED;
参数详解
-
START_SNAP_ID
起始 SNAPSHOT_ID。
-
END_SNAP_ID
终止 SNAPSHOT_ID。
返回值
返回包含报告的全部 TEXT 脚本信息的嵌套表类型 AWRRPT_ROW_TYPE。
定义 2：
把 AWR 数据报表生成到指定路径的 TEXT 文件。
PROCEDURE SYS.AWR_REPORT_TEXT(
START_ID IN INT,
END_ID IN INT,
DEST_DIR IN VARCHAR(128),
DEST_FILE IN VARCHAR(128)
);
参数详解
-
START_ID
起始 SNAPSHOT_ID。
-
END_ID
终止 SNAPSHOT_ID。
-
DEST_DIR
指定生成报告的目标路径。
-
DEST_FILE
指定生成报告的目标文件名，文件名需要以.txt 结尾。
- CREATE_SNAPSHOT
创建一次快照 snapshot
语法如下：
FUNCTION CREATE_SNAPSHOT(
FLUSH_LEVEL IN VARCHAR2 DEFAULT 'TYPICAL'
) RETURN INT;
参数详解
-
FLUSH_LEVEL
'TYPICAL' OR 'ALL'；如果为空，则缺省为'TYPICAL'，该值会影响快照生成数据的大小，如果是'ALL'，则将全部历史数据保存，如果是'TYPICAL'则会刷部分数据，具体在后续会涉及到。
返回值
返回创建的快照 ID 值。
- DROP_SNAPSHOT_RANGE
删除指定快照 ID 范围内的快照。
语法如下：
PROCEDURE DROP_SNAPSHOT_RANGE(
LOW_SNAP_ID IN INT,
HIGH_SNAP_ID IN INT,
DBID IN INT DEFAULT NULL,
FREE_TS_SIZE IN BOOLEAN DEFAULT FALSE
);
参数详解
-
LOW_SNAP_ID
范围的起始值。
-
HIGH_SNAP_ID
范围的结束值。
-
DBID
表示 snapshot 所在的 DB 唯一标识，默认为 NULL，表示当前 DB，目前该参数暂时忽略不支持。
-
FREE_TS_SIZE
是否不等待触发器执行，直接释放被删除快照对应分区表空间。TRUE：是；FALSE：否。缺省为 FALSE，表示等待系统触发器执行时统一释放空间。目前该参数暂时忽略不支持。
- DROP_SNAPSHOT_BY_TIME
删除快照创建时间小于等于指定时间戳的所有快照。
语法如下：
PROCEDURE DROP_SNAPSHOT_BY_TIME(
END_DT IN TIMESTAMP,
FREE_TS_SIZE IN BOOLEAN DEFAULT FALSE
);
参数详解：
-
END_DT
指定时间戳，若指定为 NULL，则指定时间戳为当前系统时间。
-
FREE_TS_SIZE
是否不等待触发器执行，直接释放被删除快照对应分区表空间。TRUE：是；FALSE：否。缺省为 FALSE，表示等待系统触发器执行时统一释放空间。目前该参数暂时忽略不支持。
- MODIFY_SNAPSHOT_SETTINGS
设置 snapshot 的属性值。
语法如下：
PROCEDURE MODIFY_SNAPSHOT_SETTINGS(
RETENTION IN INT DEFAULT NULL,
AWR_INTERVAL IN INT DEFAULT NULL,
TOPNSQL IN INT DEFAULT NULL,
DBID IN INT DEFAULT NULL
);
PROCEDURE MODIFY_SNAPSHOT_SETTINGS(
RETENTION IN INT DEFAULT NULL,
AWR_INTERVAL IN INT DEFAULT NULL,
TOPNSQL IN VARCHAR2,
DBID IN INT DEFAULT NULL
);
参数详解
-
RETENTION
表示 SNAPSHOT 在数据库中保留的时间，以分钟为单位，最小值为 1 天，最大值为 100 年；如果值为 0，则表示永久保留；如果值为 NULL，则表示本次设置的该值无效，保留以前的旧值。
-
AWR_INTERVAL
表示每次生成 SNAPSHOT 的间隔时间，以分钟为单位，最小值为 10 分钟，最大值为 1 年；如果值为 0，则 SNAPSHOT 会失效。如果值为 NULL，则表示本次设置的该值无效，保留以前的旧值。
-
TOPNSQL
如果为 NULL，则保留当前设置的值。
如果为 INT 类型，则表示按照 SQL 的衡量标准（执行时间，CPU 时间，消耗内存等）获取保存的 SQL 个数，最小值为 30，最大值为 50000。
如果为 VARCHAR2 类型，则可以设置如下 3 个值：DEFAULT、MAXIMUM 和 N。DEFAULT 对应值为 100；MAXIMUM 对应值为 50000；值 N 是数字串，但要求转化为 INT 类型之后，值必须在 30 至 50000 之间。
目前该参数暂时忽略不支持。
-
DBID
表示 SNAPSHOT 所在的 DB 唯一标识，缺省为 NULL，表示当前 DB。目前该参数暂时忽略不支持。
- AWR_CLEAR_TMP_TABLE
清理创建快照时产生的中间表。
创建快照时系统会创建中间表临时存储数据，预期在创建快照阶段末尾进行删除，若发生异常导致中间表未能如期删除，可以调用此接口对中间表进行手动清理。
语法如下
PROCEDURE AWR_CLEAR_TMP_TABLE();
22.2 系统表
DBMS_WORKLOAD_REPOSITORY 包相关的系统表包括快照信息管理表及快照信息表，这些系统表都只有创建了 DBMS_WORKLOAD_REPOSITORY 包后才能查看。
22.2.1 快照信息管理表
- SYS.WRM$_WR_CONTROL
记录快照的相关控制信息。
| 列名 | 类型 | 说明 |
|---|---|---|
| DBID | INTEGER | 数据库 id（NULL） |
| SNAP_INTERVAL | INTERVAL DAY(5) TO SECOND(1) | 快照间隔 |
| RETENTION | INTERVAL DAY(5) TO SECOND(1) | 快照保留时间（单位:INTERVAL DAY TO SECOND 类型） |
| TOPSQL | INTEGER | 每次快照搜集 sql 条数 |
| STATUS_FLA | INTEGER | AWR 状态（1：开启；0：关闭） |
- SYS.WRM$_SNAPSHOT
记录快照的相关信息。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | INTEGER | 快照 ID |
| DBID | INTEGER | 数据库 ID（NULL） |
| INSTANCE_NUMBER | INTEGER | 实例编号 |
| STARTUP_TIME | DATETIME(6) | 数据库启动时间 |
| BEGIN_INTERVAL_TIME | DATETIME(6) | 开始快照时间 |
| END_INTERVAL_TIME | DATETIME(6) | 结束快照时间 |
| FLUSH_ELAPSED | INTERVAL DAY(5) TO SECOND(1) | 生成快照的时间（NULL） |
| SNAP_LEVEL | INTEGER | 快照等级，恒为 1 |
| STATUS | INTEGER | 快照是否成功生成，0：成功；1：失败（NULL） |
| ERROR_COUNT | INTEGER | 快照生成失败时的错误数（NULL） |
| BL_MOVED | INTEGER | 保留字段（NULL） |
| SNAP_FLAG | INTEGER | 快照生成方式（NULL） |
| SNAP_TIMEZONE | INTERVAL DAY(1) TO SECOND(0) | 快照生成的时区和 UTC 时区的时间差 |
| BEGIN_INTERVAL_TIME_TZ | DATETIME(6) WITH TIME ZONE | 带时区的开始快照时间 |
| END_INTERVAL_TIME_TZ | DATETIME(6) WITH TIME ZONE | 带时区的结束快照时间 |
22.2.2 快照信息表
快照信息表记录快照中数据库的一些具体信息。
- SYS.WRH$_RESOURCE_LIMIT
显示所有快照中表、用户的空间限制信息。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | INTEGER | 快照 ID |
| NAME | VARCHAR(128) | 表/用户名 |
| ID | INTEGER | 表/用户 ID |
| TYPE | VARCHAR(64) | 表/用户类型 |
| SPACE_LIMIT | INTEGER | 空间限制大小，以页为单位 |
| SPACE_USED | INTEGER | 空间实际使用大小，以页为单位 |
- SYS.WRH$_SQL_HISTORY
当 INI 参数 ENABLE_MONITOR=1 时，显示所有快照中执行 sql 的历史记录信息，其中不同快照的 SQL_ID 和 START_TIME 肯定不相同。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | INTEGER | 快照 ID |
| SQL_ID | INTEGER | 当前语句的 SQL ID |
| START_TIME | DATETIME(6) | SQL 执行的起始时间 |
| TIME_USED | BIGINT | SQL 执行所使用时间（单位：usec） |
| BYTES_DYNAMIC_ALLOCED | BIGINT | 动态分配字节数 |
| N_LOGIC_READ | INTEGER | 语句逻辑读的次数 |
| N_PHY_READ | INTEGER | 语句物理读的次数 |
| AFFECTED_ROWS | INTEGER | 语句影响的行数 |
| HARD_PARSE_FLAG | INTEGER | 语句硬解析标记，0：软解析；1：语义解析；2：硬解析 |
| MPP_EXEC_ID | INTEGER | MPP 会话句柄上的执行序号，同一个会话上的每个节点上值相同 |
- SYS.WRH$_SQLTEXT
显示所有快照的缓冲区中的 SQL 语句信息。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | INTEGER | 快照 ID |
| SQL_ID | INTEGER | 语句的 SQL ID |
| N_EXEC | INTEGER | 语句执行次数 |
| SQL_TEXT | TEXT | SQL 语句内容，超过 7168 的串不分行显示，而是显示成一行 |
| SQL_NTH | INTEGER | SQL 语句段号（从 0 开始） |
- SYS.WRH$_SQLTEXT_TMP
SYS.WRH$_SQLTEXT 的辅助表，显示所有快照中缓冲区中的 SQL 语句信息。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | INTEGER | 快照 ID |
| SQL_ID | INTEGER | 语句的 SQL ID |
| SQL_TEXT | TEXT | SQL 语句内容，与 v$SQLTEXT 里的一致，超过 7168 的串分行显示 |
| SQL_NTH | INTEGER | SQL 语句段号（从 0 开始） |
- SYS.WRH$_SESSIONS
显示所有快照中会话的具体信息，如执行的 sql 语句、主库名、当前会话状态、用户名等。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | INTEGER | 快照 ID |
| N_SESSIONS | TEXT | 会话数 |
| N_STMT | INTEGER | 已使用的 STMT 数量之和 |
- SYS.WRH$_SESSION_WAIT_HISTORY
显示所有快照中会话等待事件的历史信息。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | INTEGER | 快照 ID |
| SQL_ID | INTEGER | 语句的 SQL ID |
| EVENT# | SMALLINT | 事件编号 |
| EVENT | VARCHAR(32) | 事件名称 |
| TIME_WAITED_MICRO | INTEGER | 等待时间（单位：微秒） |
| WAIT_CLASS# | SMALLINT | 等待事件类别编号 |
- SYS.WRH$_ACTIVE_SESSION_HISTORY
显示当前活动会话的等待信息。
此表与其他快照信息表的不同之处是，向此表内插入数据的时间周期与 ASH 刷盘的时间周期保持一致，不与创建快照的时间周期一致，即执行创建快照的操作后此表内可能没有数据写入，或者未执行创建快照的操作但此表内已写入数据两种情况均属正常现象。
| 列名 | 类型 | 说明 |
|---|---|---|
| SNAP_ID | BIGINT | 执行数据插入时的系统时间，格式为 YYYYMMDDHH24MISS，与其他信息表不同 |
| INSTANCE_NUMBER | INTEGER | 实例个数，单机下为 1 |
| SAMPLE_ID | BIGINT | 采样 ID |
| SAMPLE_TIME | DATETIME(3) | 采样时戳 |
| IS_AWR_SAMPLE | VARCHAR(1) | 是否已经刷盘或者即将刷盘(Y/N) |
| SESSION_ID | BIGINT | 会话 ID |
| SESSION_SERIAL# | INTEGER | 会话序列号，用来唯一标识会话 |
| USER_ID | INTEGER | 当前用户 ID |
| SQL_ID | INTEGER | 采样时正在执行的语句 ID |
| IS_SQLID_CURRENT | VARCHAR(1) | SQL_ID 列所标识的语句是否正在执行(Y/N) |
| SESSION_TYPE | VARCHAR(10) | FOREGROUND/BACKGROUND |
| SQL_OPCODE | INTEGER | SQL 语句类型 |
| SQL_OPNAME | VARCHAR(64) | SQL 语句类型名 |
| EVENT | VARCHAR(64) | 如果 SESSION_STATE=WAITING，则表示会话在采样时的等待事件。否则为 NULL |
| EVENT_ID | SMALLINT | 采样时等待事件的 ID |
| P1TEXT | VARCHAR(64) | 等待事件对应的参数 1 说明 |
| P1 | VARCHAR(256) | 等待事件对应的参数 1 值 |
| P2TEXT | VARCHAR(64) | 等待事件对应的参数 2 说明 |
| P2 | BIGINT | 等待事件对应的参数 2 值 |
| P3TEXT | VARCHAR(64) | 等待事件对应的参数 3 说明 |
| P3 | BIGINT | 等待事件对应的参数 3 值 |
| P4TEXT | VARCHAR(64) | 等待事件对应的参数 4 说明 |
| P4 | BIGINT | 等待事件对应的参数 4 值 |
| WAIT_CLASS | VARCHAR(64) | 等待会话在采样时等待的事件的类名 |
| WAIT_CLASS_ID | INTEGER | 等待会话在采样时等待的事件的类 ID |
| WAIT_TIME | BIGINT | 会话上次等待的事件的总等待时间，如果是在 SESSION_STAT=ON CPU 采样，否则为 0 |
| TIME_WAITED | BIGINT | 如果 SESSION_STATE=WAITING，则表示会话实际花费在等待该事件的时间，单位微秒 |
| PROGRAM | VARCHAR(128) | 程序名 |
| MODULE | VARCHAR(64) | 采样时执行模块的名称(DBMS_APPLICATION_INFO.SET_MODULE) |
| ACTION | VARCHAR(64) | 采样时执行模块的动作(DBMS_APPLICATION_INFO.SET_ACTION) |
| CLIENT_ID | VARCHAR(64) | 客户端标识 |
| SQL_EXEC_ID | BIGINT | SQL 执行 ID |
| TOP_LEVEL_SQL_ID | INTEGER | 顶层 SQL 语句 ID |
| TOP_LEVEL_SQL_OPCODE | INTEGER | 顶层 SQL 语句类型 |
| MACHINE | VARCHAR(128) | 客户端的机器名 |
| PORT | INTEGER | 客户端的端口号 |
快照信息表共有 40 张表，每张快照信息表都有其对应的动态性能视图，快照信息表名以“WRH$_”开头，相应的动态性能视图名以“V$”开头。例如快照信息表 SYS.WRH$_ARCH_QUEUE 对应的动态性能视图为 V$ARCH_QUEUE。除了上述 7 张快照信息表与其对应的动态性能视图在结构上有些许不同，其余的快照信息表仅比对应的动态性能视图多一列名为 SNAP_ID 的整型列，其余结构完全相同，如 SYS.WRH$_ARCH_QUEUE 仅比 V$ARCH_QUEUE 多一列 SNAP_ID，这里不再赘述，仅给出快照信息表的名称，具体字段介绍可以参考对应的动态性能视图，动态性能视图介绍可参考《DM8 系统管理员手册》附录 2。
剩余的快照信息表名称如下：
- SYS.WRH$_ARCH_QUEUE
- SYS.WRH$_BUFFERPOOL
- SYS.WRH$_CKPT_HISTORY
- SYS.WRH$_DATAFILE
- SYS.WRH$_DB_CACHE
- SYS.WRH$_DEADLOCK_HISTORY
- SYS.WRH$_DMSQL_EXEC_TIME
- SYS.WRH$_DM_INI
- SYS.WRH$_HASH_MERGE_USED_HISTORY
- SYS.WRH$_LARGE_MEM_SQLS
- SYS.WRH$_LOCK
- SYS.WRH$_MAL_INFO
- SYS.WRH$_MEM_POOL
- SYS.WRH$_MTAB_USED_HISTORY
- SYS.WRH$_PSEG_ITEMS
- SYS.WRH$_RLOG
- SYS.WRH$_SCP_CACHE
- SYS.WRH$_SESSION_HISTORY
- SYS.WRH$_SESSION_STAT
- SYS.WRH$_SORT_HISTORY
- SYS.WRH$_SQL_NODE_HISTORY
- SYS.WRH$_SQL_PLAN_NODE
- SYS.WRH$_SQL_STAT_HISTORY
- SYS.WRH$_SYSSTAT
- SYS.WRH$_SYSTEMINFO
- SYS.WRH$_SYSTEM_EVENT
- SYS.WRH$_TABLESPACE
- SYS.WRH$_TASK_QUEUE
- SYS.WRH$_TRACE_QUEUE
- SYS.WRH$_VIRTUAL_MACHINE
- SYS.WRH$_WAIT_HISTORY
- SYS.WRH$_TRX
- SYS.WRH$_LONG_EXEC_SQLS
22.3 创建、检测、删除语句
22.3.1 SP_INIT_AWR_SYS
创建或删除 DBMS_WORKLOAD_REPOSITORY 系统包。
语法如下：
void
SP_INIT_AWR_SYS(
CREATE_FLAG INT
)
参数详解
-
CREATE_FLAG
为 1 时表示创建 DBMS_WORKLOAD_REPOSITORY 包；为 0 表示删除该系统包。
返回值
无
举例说明
创建 DBMS_WORKLOAD_REPOSITORY 系统包。
SP_INIT_AWR_SYS(1);
22.3.2 SF_CHECK_AWR_SYS
系统的 DBMS_WORKLOAD_REPOSITORY 系统包启用状态检测。
语法如下：
int
SF_CHECK_AWR_SYS ()
返回值
0：未启用；1：已启用
举例说明
获得 DBMS_WORKLOAD_REPOSITORY 系统包的启用状态。
SELECT SF_CHECK_AWR_SYS;
22.4 AWR 报表解析说明
22.4.1 信息表介绍
自动工作集负载信息库 AWR（Automatic Workload Repository）提供了某一时间段内整个系统的报表数据，通过生成并解读该报告，用户能够对指定时间段内数据库系统的性能进行分析。后文中按照报表标题名细分出了若干小节，并依次给出了 AWR 报告中每个表格中的字段名、相应的说明和字段的计算方式。信息表的各个部分含义如下：
- HEAD INFO
AWR 报告的头部信息，包含数据库基本信息（DB INFO）、实例运行环境基本信息（HOST INFO）、快照统计基本信息（SNAP INFO）三个部分。
- Report Summary
AWR 报告的摘要，包含内存池信息报告（Memory Pool）、缓存池信息报告（Buffer Pool）、两次快照之间的数据库负载概况（Load Profile）、内存命中率及数据库实例操作的效率报告（Instance Efficiency Percentages）、系统中最严重的 5 个等待（Top 5 Timed Foreground Events）。
- Main Report
AWR 报告的主体部分，包含等待事件统计信息等待事件统计名称（Wait Events Statistics）、SQL 语句相关统计（SQL Statistics）、实例活动统计信息（Instance Activity Statistics）、IO 信息（IO Stats）、缓存区统计信息（Buffer Pool Statistics）、等待事件统计信息（Wait Statistics）、撤销的统计信息（Undo Statistics）、锁统计信息（Lock Statistics）、死锁统计信息（Dead Lock Statistics）、隔离区活动统计信息（Seg Activity Statistics ）、数据库缓存信息（Dictionary Cache Statistics）、库缓存统计信息（Library Cache Statistics）、内存池的统计信息（Memory Statistics）、分类统计信息（Sort Statistics）、空间限制信息（Resource Limit Statistics）、邮箱视图信息（Mail Statistics）、dm.ini 参数信息（dm.ini Parameters）、顶级等待事件中的高负载 SQL 语句（Top SQL with Top Events）。
22.4.1.1 HEAD INFO
22.4.1.1.1 DB INFO
显示数据库的基本信息，每个字段说明及值的计算参见表 22.1。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| DB Name | 数据库名 | 初始化时指定的数据库名 |
| DB Id | 数据库唯一标识 | \ |
| Instance | 实例名 | 生成报表时指定的起始快照 ID 对应的实例名 |
| Inst num | 实例数 | 单机环境为 1 |
| Startup Time | 起始快照服务器启动时间 | V$INSTANCE 中的 START_TIME |
| Release | 起始快照服务器的版本 | V$INSTANCE 中的 SVR_VERSION |
| DSC | 是否为 DSC 环境 | 单机环境为 NO, DSC 环境为 YES |
22.4.1.1.2 HOST INFO
显示实例运行环境，每个字段说明及值的计算参见表 22.2。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Host Name | 主机名 | V$INSTANCE 中 HOST_NAME |
| Platform | 实例运行平台 | \ |
| Cpus | cpu 数 | V$SYSTEMINFO 中 N_CPU |
| Cores | 核数 | CORE_NUM*SOCKET_NUMBER |
| Sockets | socket 数 | SOCKET_NUMBER |
| Memory(GB) | 内存 | 物理内存大小，单位 GB |
22.4.1.1.3 SNAP INFO
显示快照统计的基本信息，每个字段说明及值的计算参见表 22.3。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Snap Id | 快照 ID | 传入参数：快照的范围值[start,end] |
| Snap Time | 快照生成的时间 | 起始和结束快照生成的时间 |
| Sessions | 生成快照时的会话数 | V$SESSIONS count(*) |
| stmts/Session | 每个会话的语句数 | V$SESSIONS SUM(N_USED_STMT)/Sessions |
| Elapsed | 起始快照和结束快照持续的时间 | 起始快照和结束快照的时间差 |
| DB Time | 在起始和结束快照间的数据库时间 | V$SYSSTAT 中的 db_time (ms), 选择起始和结束快照的差值 |
22.4.1.2 Report Summary
22.4.1.2.1 Memory Pool
记录 dm memory pool 的使用情况，每个字段说明及值的计算参见表 22.4。每项显示 begin 和 end 的值。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Memory Pool Size(MB) | 内存池大小 | V$SYSSTAT 中’ memory pool size in bytes’ |
| Memory Used(MB) | 内存池使用大小 | V$SYSSTAT 中’memory used bytes’ |
| Bytes Allocated From OS(MB) | 从 OS 申请内存数 | V$SYSSTAT 中’bytes allocated from os’ |
| Memory used bytes from os(MB) | 内存池使用字节数 | V$SYSSTAT 中’memory used bytes from os’ |
| Memory Usage % | memory pool 使用率 | memory used / memory pool size |
| % SQL with executions>1 | 执行次数大于 1 的 sql 比率 | V$SYSSTAT 中的 sql cache hit count / sql executed count |
| % plan with executions>1 | 执行次数大于 1 的计划比率 | V$SYSSTAT 中的 plan cache hit count / sql executed count |
| %rowset cache hit count | rowset 比率 | V$SYSSTAT 中的 rowset cache hit count / rowset total count |
22.4.1.2.2 Buffer Pool
显示 buffer pool 的信息，每个字段说明及值的计算参见表 22.5。每项显示 begin 和 end 的值。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Name | 缓冲池名称 | V$BUFFERPOOL 中’NAME’ |
| Page Size(Bytes) | 基缓冲池页大小 | V$BUFFERPOOL 中’PAGE_SIZE’, 单位 Bytes |
| Total Pages | 页数 | V$BUFFERPOOL 中’ N_PAGES’ |
| Free | 空闲页数目 | V$BUFFERPOOL 中’FREE’ |
| Logic_Reads | READ 命中的次数 | V$BUFFERPOOL 中 ’N_LOGIC_READS’ |
| Discards | 淘汰的页数 | V$BUFFERPOOL 中’N_DISCARD’ |
| Rat Hit % | 命中率 | V$BUFFERPOOL 中’RAT_HIT’ |
22.4.1.2.3 Load Profile
主要记录两次快照之间的数据库负载概况，每个字段的含义和说明，参见表 22.6。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| DB Time(s) | 每秒/每事务的 DB TIME | 总的 db 时间、快照持续时间或总的事务数，根据 V$sysstat 计算，取两次快照的差值 |
| DB CPU(s) | 每秒/每事务的 cpu 时间 | 总的 cpu 时间、快照持续时间或总的事务数，根据 V$sysstat 计算，取两次快照的差值 |
| Redo size | 每秒/每事务 redo 日志的字节大小 | redo 日志的大小（根据 V$sysstat 的 redo log size in pages 计算）与总的 db 时间或者总的事务数的相除 |
| Logical reads | 每秒/每事务逻辑读的块数 | logic read count / db time 或者 total_trx |
| Block changes | 每秒/每事务修改的块数 | V$SYSSTAT 里添加 block changes 事件 |
| Physical reads | 每秒/每事务物理读的块数 | physical read count / db time |
| Physical writes | 每秒/每事务物理写的块数 | physical write count / db time |
| User calls | 每秒/每事务用户 call 次数 | V$SYSSTAT 中的 command received count 总数 |
| Parses | 每秒/每事 SQL 解析的次数 | 添加 parse 解析次数，prepare_low2 |
| Hard parses | 每秒/每事务 SQL 硬解析的次数 | V$SYSSTAT 添加硬解析次数，每走一次 phc 算一次 |
| Logons | 每秒/每事务登录的次数 | session alloc count |
| Logoff | 每秒/每事务登出的次数 | session free count |
| Executes | 每秒/每事务 SQL 执行次数 | V$SYSSTAT 中的 sql execution count / 快照持续时间 |
| Rollbacks | 每秒/每事务的回滚率 | transaction rollback count |
| Commit | 每秒/每事务的提交率 | transaction commit count |
| Deadlock | 每秒/每事务的死锁率 | transaction deadlock count |
| Transactions | 每秒事务数.每秒产生的事务数，反映数据库任务繁重与否 | transaction total count |
| %Changes changed per read | 每个逻辑读产生的数据页变更 | data page changes / logic read count |
| Rows per transaction | 每事务行数 | V$SYSSTAT 中的 optimized sort count+one-way sort count+one-way sort count |
| Rows per Sort | 每事务排序行数 | V$SORT_HISTORY 中 SORT_ROWS |
22.4.1.2.4 Instance Efficiency Percentages (Target 100%)
本节统计内存命中率及数据库实例操作的效率，每个字段的含义和说明参见表 22.7。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Buffer Nowait % | 在内存获得数据的未等待比例，在缓冲区中获取 Buffer 的未等待比率 | V$SYSTEM_EVENT 中的 buffer busy wait 事件 |
| Buffer Hit % | 数据块的命中率 | V$BUFFER_POOL 中的 N_LOGIC_READS / N_LOGIC_READS + N_PHY_READS |
| Redo NoWait % | LOG 缓冲区获得 BUFFER 的未等待比例 | V$SYSTEM_EVENT 中的(100-redo log system busy 的 TOTAL_WAITS)/ TOTAL_WAITS |
| Library Hit % | 从 Library Cache 中检索到一个解析过的 SQL 或 PL/SQL 语句的比率 | V$SYSSTAT 中的(plan cache hit count + rowset cache hit count + sql cache hit count) / (plan cache hit count + rowset cache hit count + sql cache hit count + plan total count) |
| Execute to Parse % | 语句执行与分析的比例，如果要 SQL 重用率高，则这个比例会很高. 该值越高表示一次解析后被重复执行的次数越多。该值 <0 通常说明 shared pool 设置或者语句效率存在问题，造成反复解析，reparse 可能较严重,或者是可能同 snapshot 有关，通常说明数据库性能存在问题。 | V$SYSSTAT 中的 100 * (1 - parse count/Executions) |
| In-memory Sort % | 在内存中排序的比率 | V$SYSSTAT 中的 optimized sort count / (optimized sort count + one-way sort count + multi-way sort count) |
| Soft Parse % | 软解析的百分比(softs/(softs+hards))，近似当作 sql 在共享区的命中率 | V$SYSSTAT 中的 parse time - hard parse time(ms) / parse time |
| % Non-Parse CPU | SQL 实际运行时间/(SQL 实际运行时间 +SQL 解析时间) 值越小表示解析消耗时间过多 | V$SYSSTAT 中的(1-PARSE_CPU)/db time(ms) |
22.4.1.2.5 Top 5 Timed Foreground Events
显示系统中最严重的 5 个等待，按所占等待时间的比例倒序显示，每个字段的说明参见表 22.8。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| event | 等待时间的名称 | V$SYSTEM_EVENT 中的 Event |
| Waits | 等待的次数 | V$SYSTEM_EVENT 中的 Total_waits |
| Times(s) | 等待的时间 | V$SYSTEM_EVENT 中的 Time_waited_micro(s) |
| Avg wait (ms) | 平均等待时间 | V$SYSTEM_EVENT 中的 Average_wait_micro(ms) |
| % DB time | 等待时间和 db time 的比例 | V$SYSTEM_EVENT 中的 Time_waited_micro / db time |
| Wait Class | 等待类别 | Wait_class |
22.4.1.3 Main Report
22.4.1.3.1 Wait Events Statistics
22.4.1.3.1.1 Time Model Statistics
记录各类型任务占用 CPU 时间，每个字段的含义和说明参见表 22.9。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Statistic Name | 统计名称 | 根据 V$SYSSTAT 细分的时间类型划分 |
| Time(s) | 各种类型任务所占用的 CPU 时间 | \ |
| % of DB Time | 该任务所占用的 CPU 时间占总的 DB TIME 的时间比 | Time/DB Time |
22.4.1.3.1.2 Operating System Statistics
记录起始快照与结束快照之间的系统信息，每个字段的含义和说明参见表 22.10。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Statistic | 统计名称 | V$SYSTEMINFO 系统信息 |
| Value | 起始快照对应统计值 | \ |
| End Value | 结束快照对应统计值 | 仅在与起始快照对应值不同时进行展示 |
22.4.1.3.1.3 Foreground Wait Class
记录等待事件类型的次数与所用时间，每个字段的含义和说明参见表 22.11。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Wait class | 等待事件类别 | V$SYSTEM_EVENT 中 WAIT_CLASS |
| Waits | 各种类型事件发生次数 | V$SYSTEM_EVENT 中 TOTAL_WAITS |
| %Time -outs | 各种类型事件所占用的 CPU 时间占总的 DB CPU 的时间比 | V$SYSTEM_EVENT 中的 MAX(TIME_WAITED_MICRO)/DB CPU |
| Total Wait Time (s) | 各种类型事件所占用的总的 CPU 时间 | V$SYSTEM_EVENT 中的 MAX(TIME_WAITED_MICRO) |
| Avg Wait(ms) | 各种类型事件的平均 CPU 时间 | Total Wait Time/ Waits |
| %DB time | 各种类型事件所占用的 CPU 时间占总的 DB TIME 的时间比 | Total Wait Time/DB TIME |
22.4.1.3.1.4 Foreground Wait Events
记录等待事件的次数与所用时间，每个字段的含义和说明参见表 22.12。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Event | 事件名称 | V$SYSTEM_EVENT 中 EVENT |
| Waits | 该事件等待次数 | V$SYSTEM_EVENT 中 TOTAL_WAITS |
| %Time -outs | 各种类型事件所占用的 CPU 时间占总的 DB CPU 的时间比 | Total Wait Time/DB CPU |
| Total Wait Time (s) | 事件所占用的总的 CPU 时间 | V$SYSTEM_EVENT 中 TIME_WAITED_MICROSS |
| Avg Wait (ms) | 事件的平均 CPU 时间 | Total Wait Time/ Waits |
| Waits /txn | 每个事务发生的等待次数总的事务个数 | Waits / transaction total count |
| %DB time | 事件所占用的 CPU 时间占总的 DB TIME 的时间比 | Total Wait Time/DB TIME |
22.4.1.3.1.5 Wait Event Histogram
事件的等待次数与具体等待时间占比，每个字段的含义和说明参见表 22.13。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Event | 事件名称 | V$SESSION_WAIT_HISTORY 中 EVENT |
| Total waits | 等待次数 | V$SESSION_WAIT_HISTORY 中 EVENT, COUNT(*) |
| % of Waits | 以 <1ms 为例，表示等待时间 <1ms 的百分比 | V$SESSION_WAIT_HISTORY 里每种事件的等待时间 <1ms 的等待次数/总的等待事件次数 |
22.4.1.3.2 Sql Statistics
22.4.1.3.2.1 SQL ordered by Elapsed Time
sql、pl/sql 按执行时间降序排序。每个字段的含义和说明参见表 22.14。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Elapsed Time (s) | 该条语句执行时间 | V$SQL_STAT_HISTORY 的 exec_time |
| Executions | 该条语句执行次数 | V$SQLTEXT 中 N_EXEC |
| Elapsed Time per Exec (s) | 每次执行的时间 | Elapsed Time / Executions |
| %Total | 执行时间占 DB TIME 总时间的百分比 | Elapsed Time / DB TIME |
| %CPU | 每条 sqlcpu 时间占执行时间的百分比 | V$SESSION_WAIT_HISTORY 中 TIME_WAITED_MICRO/Elapsed Time |
| %IO | 每条 sqlIO 时间占执行时间的百分比 | V$SQL_STAT_HISTORY 中 IO_WAIT_TIME/Elapsed Time |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.2 SQL ordered by CPU Time
sql、pl/sql 按每条语句的 cpu 时间降序排序。每个字段的含义和说明参见表 22.15。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| CPU Time (s) | 该条语句 cpu 时间 | V$SESSION_WAIT_HISTORY 中 TIME_WAITED_MICRO |
| Executions | 该条语句执行次数 | V$SQLTEXT 中 N_EXEC |
| CPU per Exec (s) | 每次执行的 cpu 时间 | CPU Time (s)/Executions |
| %Total | 该条语句 cpu 时间占总的 cpu 时间的百分比 | CPU Time (s)/V$SYSSTAT 中在指定快照范围内的总的 CPU 时间 |
| Elapsed Time (s) | 该条语句执行时间 | V$SQL_STAT_HISTORY 的 exec_time |
| %CPU | 每条语句 cpu 时间占执行时间的百分比 | CPU Time (s)/Elapsed Time (s) |
| %IO | 每条语句 IO 时间占执行时间的百分比 | V$SQL_STAT_HISTORY 中 IO_WAIT_TIME/Elapsed Time (s) |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.3 SQL ordered by User I/O Wait Time
sql、pl/sql 按 User I/O Wait 时间降序排序。每个字段的含义和说明参见表 22.16。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| User I/O Time (s) | 该条语句 User IO wait time | V$SQL_STAT_HISTORY 中 IO_WAIT_TIME |
| Executions | 该条语句执行次数 | V$SQLTEXT 中 N_EXEC |
| UIO per Exec (s) | 每次执行的 IO wait time | User I/O Time (s)/Executions |
| %Total | 该条语句 cpu 时间占总的 cpu 时间的百分比 | CPU Time (s)/V$SYSSTAT 中在指定快照范围内的总的 CPU 时间 |
| Elapsed Time (s) | 该条语句执行时间 | V$SQL_STAT_HISTORY 的 exec_time |
| %CPU | 每条语句 cpu 时间占执行时间的百分比 | V$SESSION_WAIT_HISTORY 中 TIME_WAITED_MICRO/Elapsed Time |
| %IO | 每条语句 IO 时间占执行时间的百分比 | V$SQL_STAT_HISTORY 中 IO_WAIT_TIME/Elapsed Time (s) |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.4 SQL ordered by Gets
sql、pl/sql 按 buffer gets 时间降序排序。每个字段的含义和说明参见表 22.17。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Buffer Gets | 该条语句 Buffer Gets | V$SQL_STAT_HISTORY LOGIC_READ_CNT |
| Executions | 该条语句执行次数 | V$SQLTEXT 中 N_EXEC |
| Gets per Exec | 每次执行的 Buffer Gets | Buffer Gets /Executions |
| %Total | 该条语句 Buffer Gets 占总的 Buffer Gets 的百分比 | Buffer Get/ V$SYSSTAT logic read count |
| Elapsed Time (s) | 该条语句执行时间 | V$SQL_STAT_HISTORY 的 exec_time |
| %CPU | 每条语句 cpu 时间占执行时间的百分比 | V$SESSION_WAIT_HISTORY 中 TIME_WAITED_MICRO/Elapsed Time |
| %IO | 每条语句 IO 时间占执行时间的百分比 | V$SQL_STAT_HISTORY 中 IO_WAIT_TIME/Elapsed Time (s) |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.5 SQL ordered by Reads
sql、pl/sql 按 physical reads 降序排序。每个字段的含义和说明参见表 22.18。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Physical Reads | 该条语句 Physical Reads | V$SQL_STAT_HISTORY 中 PHY_READ_CNT |
| Executions | 该条语句执行次数 | V$SQLTEXT 中 N_EXEC |
| Reads per Exec | 每次执行的 Buffer Gets | Physical Reads /Executions |
| %Total | 该条语句 Physical Reads 占总的 Disk Reads 的百分比 | Physical Reads/总的 Disk Reads 的次数 |
| Elapsed Time (s) | 该条语句执行时间 | V$SQL_STAT_HISTORY 的 exec_time |
| %CPU | 每条语句 cpu 时间占执行时间的百分比 | V$SESSION_WAIT_HISTORY 中 TIME_WAITED_MICRO/Elapsed Time |
| %IO | 每条语句 IO 时间占执行时间的百分比 | V$SQL_STAT_HISTORY 中 IO_WAIT_TIME/Elapsed Time (s) |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.6 SQL ordered by Executions
sql、pl/sql 按执行次数降序排序。每个字段的含义和说明参见表 22.19。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Executions | 该条 SQL 执行次数 | V$SQLTEXT 中 N_EXEC |
| Rows Processed | 该条 SQL 影响行数 | V$SQL_HISTORY 中 AFFECTED_ROWS |
| Rows per Exec | 每次执行影响行数 | Rows Processed/ Executions |
| Elapsed Time (s) | 该条语句执行时间 | V$SQL_STAT_HISTORY 的 exec_time |
| %CPU | 每条语句 cpu 时间占执行时间的百分比 | V$SESSION_WAIT_HISTORY 中 TIME_WAITED_MICRO/Elapsed Time |
| %IO | 每条语句 IO 时间占执行时间的百分比 | V$SQL_STAT_HISTORY 中 IO_WAIT_TIME/Elapsed Time (s) |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.7 SQL ordered by Parse Calls
sql、pl/sql 按解析次数降序排序。每个字段的含义和说明参见表 22.20。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Parse Calls | 该条语句解析次数 | V$SQL_STAT_HISTORY 中 HARD_PARSE_CNT |
| Executions | 该条语句执行次数 | V$SQLTEXT 中 N_EXEC |
| %Total Parses | 该条语句分析次数占总的解析次数的百分比 | Parse Calls/V$SYSSTAT 中 pl/sql parse count |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.8 SQL ordered by Sharable Memory
sql、pl/sql 按共享内存大小降序排序。每个字段的含义和说明参见表 22.21。只显示共享内存 >1048576 字节的字段。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Sharable Mem(b) | 该条语句共享内存 | V$LARGE_MEM_SQLS 中 MEM_USED_BY_K，单位 KB |
| Executions | 该条语句执行次数 | V$SQLTEXT 中 N_EXEC |
| %Total | 该条语句共享内存占总的共享内存的百分比 | Sharable Mem(b)/总的共享内存 |
| SQL Id | 语句编号 | V$SQL_STAT_HISTORY 中 SQL_ID |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.9 SQL Plan ordered by Cost
sql、pl/sql 按代价大小降序排序。每个字段的含义和说明参见表 22.22。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Pln_addr(b) | 计划地址 | V$SQL_PLAN_NODE 中 PLN_ADDR |
| Node_addr | 节点地址 | V$SQL_PLAN_NODE 中 NODE_ADDR |
| Operation | 操作符名称 | V$SQL_PLAN_NODE 中 OPERATION |
| Depth | 节点层次 | V$SQL_PLAN_NODE 中 DEPTH |
| SQL Id | 语句编号 | V$SQL_PLAN_NODE 中中 SQL_ID |
| card | 行数 | V$SQL_PLAN_NODE 中 CARD |
| cost | 代价 | V$SQL_PLAN_NODE 中 COST |
| cpu_cost | CPU 代价 | V$SQL_PLAN_NODE 中 CPU_COST |
| io_cost | IO 代价 | V$SQL_PLAN_NODE 中 IO_COST |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.10 SQL Node ordered by Time
sql、pl/sql 按节点执行耗时降序排序。每个字段的含义和说明参见表 22.23。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| seq_no | 操作符在计划中的序号 | V$SQL_NODE_HISTORY 中 SEQ_NO |
| exec_id | 执行 ID | V$SQL_NODE_HISTORY 中 EXEC_ID |
| node | 节点 ID | V$SQL_NODE_HISTORY 中 NODE |
| time_used(us) | 节点执行耗时 | V$SQL_NODE_HISTORY 中 TIME_USED,单位微秒 |
| SQL Id | 语句编号 | V$SQLTEXT 中 SQL_ID |
| n_enter | 节点进入次数 | V$SQL_NODE_HISTORY 中 N_ENTER |
| name | 代价 | V$SQL_NODE_NAME 中 NAME |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.2.11 DMSQL ordered by exec time
sql、pl/sql 按执行时间降序排序。每个字段的含义和说明参见表 22.24。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| exec_id | 语句执行号 | V$DMSQL_EXEC_TIME 中 EXEC_ID |
| type |语句类型 |VDMSQL_EXEC_TIME 中 TYPE$ | ||
| seq | 相对序号 | V$DMSQL_EXEC_TIME 中 SEQ |
| level | 执行层次 | V$DMSQL_EXEC_TIME 中 LEVEL |
| caller | 调用方法名 | V$DMSQL_EXEC_TIME 中 CALLER |
| method | 方法名 | V$DMSQL_EXEC_TIME 中 METHOD |
| exec_cnt | 执行次数 | V$DMSQL_EXEC_TIME 中 EXEC_CNT |
| last_exec_tick | 最后一次执行时戳 | V$DMSQL_EXEC_TIME 中 LAST_EXEC_TICK，单位微秒 |
| time_used(ms) | 执行时间 | V$DMSQL_EXEC_TIME 中 LAST_EXEC_TICK，单位毫秒 |
| SQL Text | SQL 语句内容 | V$SQLTEXT 中 SQL_TEXT |
22.4.1.3.3 Instance Activity Statistics
22.4.1.3.3.1 System Statistics
记录统计对象在两快照间的统计信息。每个字段的含义和说明参见表 22.25。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Statistic Name | 统计对象名 | V$SYSSTAT 中 NAME |
| Class Id | 统计对象所属类别 | V$SYSSTAT 中 CLASSID |
| ID | 统计对象 ID | V$SYSSTAT 中 ID |
| Max Stat Val | 最大统计值 | V$SYSSTAT 中 MAX(STAT_VAL) |
| Min Stat Val | 最小统计值 | V$SYSSTAT 中 MIN(STAT_VAL) |
| Avg Stat Val | 平均统计值 | V$SYSSTAT 中 AVG(STAT_VAL) |
| Total | 指定快照范围内统计值总计 | V$SYSSTAT 中 MAX(STAT_VAL)-MIN(STAT_VAL) |
| Per Second | 每秒统计值 | Total/Elapsed |
| Per Trans | 每事务统计值 | Total/Transaction |
22.4.1.3.3.2 VM Statistics
记录活动的虚拟机信息。每个字段的含义和说明参见表 22.26。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| id | 虚拟机 ID | V$VIRTUAL_MACHINE 中 ID |
| sessid | 会话 ID | V$VIRTUAL_MACHINE 中 SESSID |
| stmt_id | 语句 ID | V$VIRTUAL_MACHINE 中 STMT_ID |
| exp_flag | 表达式标识 | V$VIRTUAL_MACHINE 中 EXP_FLAG |
| vstack_size | 栈大小 | V$VIRTUAL_MACHINE 中 VSTACK_SIZE |
| vtop | 栈顶离基址距离 | V$VIRTUAL_MACHINE 中 VTOP |
| vused | 栈已用空间大小 | V$VIRTUAL_MACHINE 中 VUSED |
| stkfrm_depth | 栈深度 | V$VIRTUAL_MACHINE 中 STKFRM_DEPTH |
| vstack | 栈基址 | V$VIRTUAL_MACHINE 中 VSTACK |
| free_stkfrms | 已释放的栈 | V$VIRTUAL_MACHINE 中 FREE_STKFRM |
| curr_frm | 当前栈 | V$VIRTUAL_MACHINE 中 CURR_FRM |
| ip | IP 地址 | V$VIRTUAL_MACHINE 中 IP |
| sql_no | SQL 语句树的信号 | V$VIRTUAL_MACHINE 中 SQL_NO |
| reuse_cnt | 虚拟机重用次数 | V$VIRTUAL_MACHINE 中 REUSE_CNT |
22.4.1.3.3.3 Session state Statistics
记录指定快照范围内会话上的相关统计信息，属性列均源于动态视图 V$SESSION_STAT。
22.4.1.3.3.4 Session history Statistics
记录指定快照范围内会话历史的记录信息，属性列均源于动态视图 V$SESSION_HISTORY。
22.4.1.3.4 IO Stats
22.4.1.3.4.1 Tablespace IO Stats
统计各表空间 IO 信息，根据读写次数降序排序。每个字段的含义和说明参见表 22.27。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Tablespace | 表空间名称 | V$TABLESPACE 中 NAME |
| Reads | 读页 | V$DATAFILE 中 PAGES_READ，根据表空间 ID 进行 SUM |
| Av Reads/s | 每秒读页 | Reads/DB time |
| Writes | 写页 | V$DATAFILE 中 PAGES_WRITE，根据表空间 ID 进行 SUM |
| Av Writes/s | 每秒写页 | Writes/DB time |
22.4.1.3.4.2 File IO Stats
记录数据库文件信息，每个字段的含义和说明参见表 22.28。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Tablespace | 表空间名称 | V$TABLESPACE 中 NAME |
| Path | 数据库文件路径 | V$DATAFILE 中 PATH |
| Reads | 读页 | V$DATAFILE 中 PAGES_READ |
| Av Reads/s | 每秒读页 | Reads/DB time |
| Writes | 写页 | V$DATAFILE 中 PAGES_WRITE |
| Av Writes/s | 每秒写页 | Writes/DB time |
22.4.1.3.5 Buffer Pool Statistics
22.4.1.3.5.1 Buffer Pool Statistics
记录缓冲区动态性能信息，每个字段的含义和说明参见表 22.29。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Name | 缓冲区名称 | V$BUFFERPOOL 中 NAME |
| Id | 缓冲区 ID | V$BUFFERPOOL 中 ID |
| Page Size | 基缓冲区页大小 | V$BUFFERPOOL 中 PAGES_SIZE |
| Pages | 页数 | V$BUFFERPOOL 中 N_PAGES |
| Total Pages | 页大小 | V$BUFFERPOOL 中 N_TOTAL_PAGES |
| Max Pages | 最多的页数 | V$BUFFERPOOL 中 N_MAX_PAGES |
| Fixed | 数据页被引用的次数 | V$BUFFERPOOL 中 N_FIXED |
| Pool Hit % | READ 命中次数占比 | V$BUFFERPOOL 中 N_LOGIC_READS/N_LOGIC_READS+N_PHY_READS |
| Logical Reads | READ 命中次数 | V$BUFFERPOOL 中 N_LOGIC_READS |
| Physical Reads | READ 未命中次数 | V$BUFFERPOOL 中 N_PHY_READS |
| Exp Bufferpools | 扩展缓冲区个数 | V$BUFFERPOOL 中 N_EXP_BUFFERPOOL |
22.4.1.3.5.2 Checkpoint Activity
显示检查点历史信息，每个字段的含义和说明参见表 22.30。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Thread Id | 线程 ID | V$CKPT_HISTORY 中 THREAD_ID |
| Ckpt Cmd | 检查点 | V$CKPT_HISTORY 中 CKPT_CMD |
| Start Time | 基缓冲区页大小 | V$CKPT_HISTORY 中 START_TIME |
| Total Used Time(s) | 页数 | V$CKPT_HISTORY 中 TIME_USED |
| Total Flused Pages | 页大小 | V$CKPT_HISTORY 中 PAGE_FLUSHED |
| Min Ckpt Lsn | 最多的页数 | V$CKPT_HISTORY 中 MIN(CKPT_LSN) |
| Max Ckpt Lsn | 数据页被引用的次数 | V$CKPT_HISTORY 中 MAX(CKPT_LSN) |
22.4.1.3.5.3 Rlog Statistics
显示日志的总体信息，每个字段的含义和说明参见表 22.31。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| ckpt_lsn | 最近一次检查点 LSN | V$RLOG 中 CKPT_LSN |
| file_lsn | 已经到盘上的 LSN | V$RLOG 中 FILE_LSN |
| flush_lsn | 当前准备刷盘的 LSN | V$RLOG 中 FLUSH_LSN |
| cur_lsn | 当前的 LSN | V$RLOG 中 CUR_LSN |
| next_seq | 下一页页号 | V$RLOG 中 NEXT_SEQ |
| flush_pages | Flush 链表中的总页数 | V$RLOG 中 FLUSH_PAGES |
| flushing_pages | 正在刷盘的总页数 | V$RLOG 中 FLUSHING_PAGES |
| free_space | 可用的日志空间 | V$RLOG 中 FREE_SPACE，单位为字节 |
| total_space | 日志总空间 | V$RLOG 中 TOTAL_SPACE，单位为字节 |
| suspend_time | 挂起时间戳 | V$RLOG 中 SUSPEND_TIME |
| upd_ctl_lsn | 系统修改控制文件的 RLOG_RESERVE_THRESHOLD ->lsn | V$RLOG 中 UPD_CTL_LSN |
| n_reserve_wait | 日志空间预申请等待个数 | V$RLOG 中 N_RESERVE_WAIT |
22.4.1.3.6 Wait Statistics
22.4.1.3.6.1 Wait History
记录指定快照范围内等待事件的具体信息，属性列均源于动态视图 V$WAIT_HISTORY。
22.4.1.3.6.2 Enqueue Activity
记录当前归档任务队列信息，每个字段的含义和说明参见表 22.32。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| queue_name | 归档类型 | V$ARCH_QUEUE 中 ARCH_TYPE |
| readys | 已处理任务数 | V$ARCH_QUEUE 中 READY |
| total_wait | 已处理任务的总等待时间 | V$ARCH_QUEUE 中 TOTAL_WAIT_TIME |
| avg_wait | 已处理任务的平均等待时间 | total_wait/readys |
22.4.1.3.7 Undo Statistics
22.4.1.3.7.1 Pseg Items
记录回滚系统中回滚项信息，每个字段的含义和说明参见表 22.33。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Snap Id | 快照 ID | \ |
| Total Pages | 总回滚页数 | V$PSEG_ITEMS 中 SUM(N_PAGES) |
| Total Extends | 总扩展回滚段次数 | V$PSEG_ITEMS 中 SUM(N_EXTEND) |
| Total Purge Pages | 总 purge 页数 | V$PSEG_ITEMS 中 SUM(N_PURGED_PAGES) |
| Total Used Pages | 总正在使用的页数 | V$PSEG_ITEMS 中 SUM(N_USED_PAGES) |
| Total Urec Used(MB) | 总生成回滚记录的总字节数 | V$PSEG_ITEMS 中 SUM(N_UREC_BYTES) |
| Total Commit Trx | 总已经提交未 PURGE 的事务数 | V$PSEG_ITEMS 中 SUM(N_COMMIT_TRX) |
| Max Reserve Time | 最大最长的保留时间，单位秒 | V$PSEG_ITEMS 中 MAX(RESERVE_TIME) |
| Free Stack Total Pages | 最小空闲回滚页堆栈中总页数 | V$PSEG_ITEMS 中 MIN(STACK_SIZE) |
| Free Stack Free Pages | 最小空闲回滚页堆栈中空闲页数 | V$PSEG_ITEMS 中 MIN(STACK_SP) |
22.4.1.3.7.2 Undo Segment Summary
记录系统中回滚项相关信息，每个字段的含义和说明参见表 22.34。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Num Undo Blocks | 当前回滚项的回滚块数 | V$PSEG_ITEMS 中 N_PAGES |
| Number of Transactions | 当前回滚表空间上执行过的事务总数 | V$PSEG_ITEMS 中 N_TRXS |
| Max Exec Len | 持续最久的查询时间 | V$LONG_EXEC_SQLS 中 MAX(EXEC_TIME) |
| Max Tx Concy | 最大事务并发量 | V$TRX 中 MAX(COUNT(ID)) |
| Min/Max TR (mins) | 最小和最大的 undo retention | V$PSEG_ITEMS 中 MAX(TUNED_UNDO_RETENTION) /MIN(TUNED_UNDO_RETENTION) |
22.4.1.3.8 Lock Statistics
记录活动的事务锁信息，每个字段的含义和说明参见表 22.35。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| addr | 锁地址 | V$LOCK 中 ADDR |
| trx_id | 所属事务 ID | V$LOCK 中 TRX_ID |
| ltype | 锁类型 | V$LOCK 中 LTYPE |
| lmode | 锁模式 | V$LOCK 中 LMODE |
| blocked | 是否阻塞 | V$LOCK 中 BLOCKED |
| table_id | 对于对象锁，表示表对象或字典对象的 ID；对于 TID 锁，表示封锁记录对应的表 ID | V$LOCK 中 TABLE_ID |
| row_idx | TID 锁封锁记录行信息 | V$LOCK 中 ROW_IDX |
22.4.1.3.9 Dead Lock Statistics
22.4.1.3.9.1 Dead Lock Stats
记录死锁的历史信息，每个字段的含义和说明参见表 22.36。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| SeqNo | 编号 | V$DEADLOCK_HISTORY 中 SEQNO |
| trx_id | 事务 ID | V$DEADLOCK_HISTORY 中 TRX_ID |
| Sess Id | 会话 ID | V$DEADLOCK_HISTORY 中 SESS_ID |
| Sess Seq | 会话序列号 | V$DEADLOCK_HISTORY 中 SESS_SEQ |
| Happen Time | 死锁发生时间 | V$DEADLOCK_HISTORY 中 HAPPEN_TIME |
| Sql Text | 产生死锁的 SQL 语句 | V$DEADLOCK_HISTORY 中 SQL_TEXT |
22.4.1.3.10 Seg Activity Statistics
记录指定快照范围内统计对象 ID 在 98 至 106 区间内的具体信息，属性列均源于动态视图 V$SYSSTAT。
22.4.1.3.11 Dictionary Cache Statistics
记录两快照间数据字典的实时信息，每个字段的含义和说明参见表 22.37。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Snap Id | 快照编号 | \ |
| Total Size(MB) | 总缓存池空间，单位字节 | V$DB_CACHE 中 SUM(TOTAL_SIZE) |
| Used % | 总实际使用空间，单位字节 | V$DB_CACHE 中 SUM(USED_SIZE)/SUM(TOTAL_SIZE) |
| Dict Num | 总缓存池中字典对象 | V$DB_CACHE 中 SUM(DICT_NUM) |
| Total LRU Discards Used(MB) | 总被淘汰字典对象空间的总和，单位字节 | V$DB_CACHE 中 SUM(SIZE_LRU_DISCARD) |
| Total LRU Discards | 总字典对象被淘汰次数 | V$DB_CACHE 中 SUM(LRU_DISCARD) |
| DDL Discards | 总 DDL 操作导致字典对象被淘汰的次数 | V$DB_CACHE 中 SUM(DDL_DISCARD) |
22.4.1.3.12 Library Cache Statistics
记录两快照间缓存池信息，每个字段的含义和说明参见表 22.38。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Pln_addr | 缓存池地址 | V$SCP_CACHE 中 SCP_ADDR |
| Pln_num | 计划缓存总数 | V$SCP_CACHE 中 PLN_CNT |
| Sql_num | SQL 缓存总数 | V$SCP_CACHE 中 SQL_CNT |
| RS_num | 结果集缓存总数 | V$SCP_CACHE 中 RS_CNT |
| Discard_Mem | 缓存对象淘汰大小 | V$SCP_CACHE 中 DISCARD_MEM |
| Discard_cnt | 缓存对象淘汰次数 | V$SCP_CACHE 中 DISCARD |
22.4.1.3.13 Memory Statistics
记录指定快照范围内所有内存池的具体信息，属性列均源于动态视图 V$MEM_POOL。
22.4.1.3.14 Sort Statistics
22.4.1.3.14.1 Hash Merge Used History
记录指定快照范围内 HASH MERGE 连接操作符使用的缓存信息，属性列均源于动态视图 V$HASH_MERGE_USED_HISTORY。
22.4.1.3.14.2 Memory Table Used History
显示快照范围内使用 MTAB 空间最多的操作符信息，每个字段的含义和说明参见表 22.39。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Exec Id | 语句执行 ID | V$MTAB_USED_HISTORY 中 EXEC_ID |
| Op Seq No | 操作符在执行计划中序号 | V$MTAB_USED_HISTORY 中 OP_SEQ_NO |
| Op Type | 节点名字 | V$SQL_NODE_NAME 中 NAME |
| Mtab Used(MB) | 操作符使用的 MTAB 空间，单位 MB | V$MTAB_USED_HISTORY 中 MTAB_USED_BY_M |
| Sql Text | SQL 文本 | V$MTAB_USED_HISTORY 中 SQL_TEXT |
22.4.1.3.14.3 Sort History
记录指定快照范围内当 INI 参数 ENABLE_MONITOR=1 都打开时，显示系统自启动以来使用排序页数最多的 50 个操作符信息，属性列均源于动态视图 V$SORT_HISTORY。
22.4.1.3.15 Resource Limit Statistics
记录指定起始快照与结束快照对应的表的空间限制信息，属性列均源于动态视图 V$RESOURCE_LIMIT。
22.4.1.3.16 Mail Statistics
记录指定快照范围内 mail 邮箱视图信息，属性列均源于动态视图 V$MAL_INFO。
22.4.1.3.17 dm.ini Parameters
显示快照范围内 ini 参数和 dminit 建库参数信息，每个字段的含义和说明参见表 22.40。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| Parameter Name | 参数名称 | V$DM_INI 中 PARA_NAME |
| Begin value | 起始快照系统参数值 | V$DM_INI 中 PARA_VALUE |
| End value (if different) | 结束快照系统参数值 | V$DM_INI 中 PARA_VALUE，仅与 Begin value 不同时显示 |
22.4.1.3.18 Top SQL with Top Events
显示采样的 SQL 语句及其对应的等待事件相关信息，来源 V$ACTIVE_SESSION_HISTORY。由于动态视图的采样周期与快照生成周期不一致，故此表仅分析在指定快照范围对应的采样时间的采样数据。每个字段的含义和说明参见表 22.41。
| 字段名 | 说明 | 计算值 |
|---|---|---|
| SQL ID | SQL 语句 ID | V$ACTIVE_SESSION_HISTORY 中 SQL_ID |
| Samples | SQL 语句的采样次数 | V$ACTIVE_SESSION_HISTORY 中 COUNT(SQL_ID) |
| %Activity | SQL 执行时间对 DB Time 的占比 | V$SQL_STAT_HISTORY 中 SUM(EXEC_TIME) / DB TIME |
| Event | SQL 语句对应等待事件 | V$ACTIVE_SESSION_HISTORY 中 EVENT |
| Waits | 事件等待次数 | V$SYSTEM_EVENT 中 TOTAL_WAITS，取结束快照与起始快照的差值 |
| %Event | 平均等待时间对 DB Time 的占比 | V$SYSTEM_EVENT 中 AVERAGE_WAIT_MICRO / DB Time |
| Sql Text | 采样的 SQL 语句 | V$SQL_STAT_HISTORY 中 SQL_TXT |
22.4.2 快照存储说明
快照信息管理表 WRM$_SNAPSHOT 中 SNAP_ID 为自增列，默认值为 1，每当新建一个快照该参数就自增“1”。快照信息表为水平分区表，且为范围（Range）分区类型，初始分区为 Part0 不存储信息，分区表均存储于 SYSAUX 表空间上。
分区表均以快照 ID 进行分区，新建快照时会在每个分区表末尾新增新的分区 Parti（i 为变量，Part 为常量），其中 i 为当前快照 ID，同时向 Parti 中插入此快照对应的数据。
暂未提供接口查询指定快照的大小。可以使用系统函数 TABLE_USED_SPACE 获取每个水平分区表中指定快照所占用的页大小，如获取 SYS.WRH$_SESSIONS 表中快照 8 所占用的页大小可执行以下 SQL 语句：
SELECT TABLE_USED_SPACE('SYS', 'WRH$_SESSIONS_PART8');
执行结果如下：
行号 TABLE_USED_SPACE('SYS','WRH$_SESSIONS_PART8')
---------- ---------------------------------------------
1 16
22.4.3 快照存储说明
目前 AWR 支持四种对快照进行删除的方式：
- 过期快照定期删除
快照保留时间由快照信息管理表 WRM$_WR_CONTROL 中 RETENTION 列决定，RETENTION 列默认为 8 天，可以使用 MODIFY_SNAPSHOT_SETTINGS 接口进行修改。每次创建新的快照创建新的分区子表前对当前所有快照进行扫描，找到已过期的快照。
- 指定快照范围删除
调用接口 DROP_SNAPSHOT_RANGE 指定待删除的 LOW_SNAP_ID 与 HIGH_SNAP_ID 对[LOW_SNAP_ID, HIGH_SNAP_ID]范围内的快照进行删除。
- 指定快照创建时间删除
调用接口 DROP_SNAPSHOT_BY_TIME 指定待删除的快照创建时间 END_DT，对快照开始创建时间小于等于 END_DT 范围内的快照进行删除。
上述删除快照的方式均会将待删除快照存入中间表 SYS.WRM\_SNAPSHOT\_D，并立即对SYS.WRM_SNAPSHOT 表中待删除快照的数据进行 DELETE。
每间隔 11min 会对中间表 SYS.WRM\_SNAPSHOT\_D中存储的快照ID对应的快照信息表中的分区子表进行DROP，且经过系统purge时间后对应空间会真正释放。DROP操作结束后将已删除的快照从中间表SYS.WRM_SNAPSHOT_D 中进行 DELETE。
- 对全部快照进行删除
调用接口 AWR_CLEAR_HISTORY，对全部快照信息表先进行 TRUNCATE 操作释放空间，再对表进行 DROP 操作。删除后再执行对全部信息表的重建操作，同时对中间表 SYS.WRM\_SNAPSHOT\_D与SYS.WRM_SNAPSHOT 表进行数据清理。
22.5 举例说明
用户在使用 DBMS_WORKLOAD_REPOSITORY 包之前，需要提前调用系统过程并设置间隔时间：
SP_INIT_AWR_SYS(1);
下面语句设置间隔为 10 分钟，也可以是其他值：
CALL DBMS_WORKLOAD_REPOSITORY.AWR_SET_INTERVAL(10);
设置成功后，可以使用 CREATE_SNAPSHOT 手动创建快照，也可以等待设置的间隔时间后系统自动创建快照，快照 id 从 1 开始递增：
手动创建快照：
DBMS_WORKLOAD_REPOSITORY.CREATE_SNAPSHOT();
查看创建的快照信息，包括快照 id：
SELECT * FROM SYS.WRM$_SNAPSHOT;
查看 snapshot 的 id 在 1~2 范围内的 AWR 分析报告的带 html 格式的内容。然后复制到文本文件中，保存成 html 格式即可查看。
SELECT * FROM TABLE (DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_HTML(1,2));
把 snapshot 的 id 在 1~2 范围内的 AWR 分析报告生成到 c 盘 awr1.html 文件。
SYS.AWR_REPORT_HTML(1,2,'C:\','AWR1.HTML');
通过 DBMS_WORKLOAD_REPOSITORY 包还可以对快照本身做增删改操作。
例 1 删除 id 在 22~32 之间的 snapshot，并立即释放相应分区表空间。
CALL DBMS_WORKLOAD_REPOSITORY.DROP_SNAPSHOT_RANGE(22,32,NULL,TRUE);
例 2 删除“2023-11-17 17:01:29.488000”时间点之前创建的所有 snapshot，并立即释放相应分区表空间。
CALL DBMS_WORKLOAD_REPOSITORY.DROP_SNAPSHOT_BY_TIME('2023-11-17 17:01:29.488000', TRUE);
例 3 修改 snapshot 的间隔时间为 30 分钟、保留时间为 1 天。
CALL DBMS_WORKLOAD_REPOSITORY.MODIFY_SNAPSHOT_SETTINGS(1440,30);
查询设置后快照参数。
SELECT * FROM SYS.WRM$_WR_CONTROL;
例 4 创建一次 snapshot。
CALL DBMS_WORKLOAD_REPOSITORY.CREATE_SNAPSHOT();
例 5 清理全部 snapshot。
CALL DBMS_WORKLOAD_REPOSITORY.AWR_CLEAR_HISTORY();
例 6 设置 snapshot 的间隔为 10 分钟。
CALL DBMS_WORKLOAD_REPOSITORY.AWR_SET_INTERVAL(10);
例 7 手动清理创建快照时产生的中间表。
CALL DBMS_WORKLOAD_REPOSITORY.AWR_CLEAR_TMP_TABLE();
