54-Oracle 23 ai DBMS_HCHECK新改变-从前的hcheck.sql

关注

原创最新推荐文章于 2026-11-10 17:16:45 发布 1.2k 阅读 AI 写同款· GEO 优化 ›

编程范式的本质：阴阳二分，相融相异本文源于一次真实的设计讨论，上片博客沿着四种语言实现的路子走下去，本篇博客则沿着设计模式的路线归结到计算机哲学的根。需求本身小得不能再小：给一个存放数据库读取结果的 `Dict` 列表按字段名排序。但当我们把约束加码到"字段演进时排序器永不改动"时，这个需求就不再是工程问题，而成了三种编程范式的正面交锋。沿着这条线走下去，我们最终抵达了一个更根本的结论——**编程范式不是一张并列的表格，而是一棵树，而树的根只有两个。** 阅读详情

Oracle Hcheck（Health Check）是Oracle数据库内置的健康监测工具，自动化检查数据库的核心问题，包括数据字典一致性、性能瓶颈、空间使用及安全隐患。本质是数据字典的CT扫描仪，其核心价值在于将“字典逻辑错误”这类灰色地带的故障扼杀在初始阶段。

Hcheck专注修复元数据逻辑层的隐蔽错误（非物理文件损坏），这类问题虽然不会立即导致崩溃，但会逐步侵蚀稳定性。通过定期执行CRITICAL模式（轻量级检查），可提前拦截大部分都字典级隐患，尤其适用于频繁DDL变更的开发测试环境，预防从而避免问题蔓延至生产。

但HCHECK无法进行物理损坏（如磁盘坏道）这样的底层，同业也无法检测漏洞和补丁。

一、hcheck的主要功能和特点

主要功能：

数据字典检查：通过内置规则（如DBMS_HCHECK或DBMS_DICTIONARY_CHECK包）
扫描数据字典的完整性，检测如对象缺失、索引孤立、表分区异常等问题

检查模式：支持FULL（全面检查）和CRITICAL（仅关键检查），后者速度更快
修复能力：通过Repair=TRUE参数自动修复部分问题（如修复元数据不一致）

多维度监控：

性能：采集动态视图（如V$SYSSTAT）分析CPU、I/O、内存资源瓶颈
空间：监控表空间、数据文件、索引的存储状态，预防空间不足风险
安全：识别弱密码、未授权访问等漏洞

自动化报告：生成分级报告（CRITICAL/FAIL/WARN/PASS），明确优先级并提供解决方案建议

核心特点：

轻量化与集成化：作为数据库原生组件（取代早期脚本hcheck.sql），无需外部依赖，可直接通过PL/SQL调用
修复一体化：支持“检测-修复”闭环操作，简化DBA维护流程
多环境适配：适用于CDB/PDB容器化架构，兼容Oracle 23ai及以上版本（23ai中更名为DBMS_DICTIONARY_CHECK）

二、演进历程

1. 上古时期：hcheck.sql (文档 ID 136697.1)

起源：早期 Oracle 版本（如 10g/11g）缺乏内置检查工具，用户需手动下载脚本 hcheck.sql。
动作：
- 需从 My Oracle Support 单独下载
- 无修复功能，仅能检测问题
- 执行过程需手工解析日志
典型输出：

SQL> @hcheck
HCheck Version 04AUG23 
Procedure Name          Result
----------------------- ------
LobNotInObj             PASS
OrphanedIndex           FAIL  -- 需人工干预

2. 23ai：DBMS_DICTIONARY_CHECK

革新：首次将检查能力封装为内置包，支持 CDB/PDB 架构。
核心特性：
- 提供 FULL（全量检查）和 CRITICAL（关键项检查）两种模式
- 支持 REPAIR=TRUE 参数自动修复问题
- 结果分级：CRITICAL > FAIL > WARN > PASS
示例代码（23ai发版会有改变）：

-- 关键检查（PDB 环境）
EXEC DBMS_DICTIONARY_CHECK.CRITICAL;

-- 全量检查并修复
EXEC DBMS_DICTIONARY_CHECK.FULL(repair=>TRUE);

3. 新的演进：DBMS_HCHECK (Oracle 23ai正式发版之后)

命名统一：包名标准化为 DBMS_HCHECK，功能继承并增强。
核心优化：
- 完全替代 hcheck.sql，无需外部脚本
- 深度集成到数据库内核，检查效率提升 50%+
- 输出标准化，日志自动写入 trace 文件

三、核心功能解析

健康检查等级

检查类型	执行命令	耗时	适用场景
CRITICAL	DBMS_HCHECK.CRITICAL;	秒级	紧急运维、升级后快速验证
FULL	DBMS_HCHECK.FULL;	分钟级	周期性深度健康检查
FULL (修复模式)	DBMS_HCHECK.FULL(repair=>TRUE);	分钟级	发现严重问题后自动修复

四、全版本操作指南

1. Oracle 11g/12c/19c：使用 hcheck.sql

-- 下载脚本后执行（需SYSDBA）
[root@rac11 ~]# find / -name hcheck.sql
/opt/oracle.ahf/orachk/.cgrep/hcheck.sql
/opt/oracle.ahf/tfa/resources/sql/hcheck.sql

SPOOL hcheck.log
@/opt/oracle.ahf/tfa/resources/sql/hcheck.sql
SPOOL OFF
--
SQL> SPOOL hcheck.log
SQL> @/opt/oracle.ahf/tfa/resources/sql/hcheck.sql

Session altered.

HCheck Version 04AUG23 on 20-JUN-2025 18:51:56
----------------------------------------------
Catalog Version 19.0.0.0.0 (1900000000)
db_name: PRODCDB
Is CDB?: YES CON_ID: 1 Container: CDB$ROOT

                                   Catalog       Fixed
Procedure Name                     Version    Vs Release    Timestamp
Result
------------------------------ ... ---------- -- ---------- --------------
------
.- LobNotInObj                 ... 1900000000 <=  *All Rel* 06/20 18:51:56 PASS
…………
.- BadSegFreelist              ... 1900000000 <=  *All Rel* 06/20 18:51:57 PASS
.- BadDepends                  ... 1900000000 <=  *All Rel* 06/20 18:51:57 WARN

HCKW-0016: Dependency$ p_timestamp mismatch for VALID objects (Doc ID
1361045.1)
[W] - P_OBJ#=66997 D_OBJ#=67053
……………………
[W] - P_OBJ#=67044 D_OBJ#=67100
[W] - P_OBJ#=67045 D_OBJ#=67101
[W] - P_OBJ#=67048 D_OBJ#=67104
[W] - P_OBJ#=67049 D_OBJ#=67105
[W] - P_OBJ#=67050 D_OBJ#=67106
[W] - P_OBJ#=67051 D_OBJ#=67107

.- CheckDual                   ... 1900000000 <=  *All Rel* 06/20 18:51:57 PASS
.- ObjectNames                 ... 1900000000 <=  *All Rel* 06/20 18:51:57 PASS
…………
.- SystemNotRfile1             ... 1900000000 >   902000000 06/20 18:51:58 PASS
.- DictOwnNonDefaultSYSTEM     ... 1900000000 <=  *All Rel* 06/20 18:51:58 PASS
.- OrphanTrigger               ... 1900000000 <=  *All Rel* 06/20 18:51:58 PASS
.- ObjNotTrigger               ... 1900000000 <=  *All Rel* 06/20 18:51:58 PASS
---------------------------------------
20-JUN-2025 18:51:58  Elapsed: 2 secs
---------------------------------------
Found 0 potential problem(s) and 40 warning(s)
Contact Oracle Support with the output and trace file
to check if the above needs attention or not

PL/SQL procedure successfully completed.

Statement processed.

Complete output is in trace file:
/u01/app/oracle/diag/rdbms/prodcdb/prodcdb1/trace/prodcdb1_ora_276568_HCHECK.trc

Session altered.
SQL> SPOOL OFF

-- 结果分析 grep "FAIL" hcheck.log 提取问题项
tail -f -n 300 /u01/app/oracle/diag/rdbms/prodcdb/prodcdb1/trace/prodcdb1_ora_276568_HCHECK.trc
……………………
.- OrphanTrigger               ... 1900000000 <=  *All Rel* 06/20 18:51:58
PASS
.- ObjNotTrigger               ... 1900000000 <=  *All Rel* 06/20 18:51:58
PASS
---------------------------------------
20-JUN-2025 18:51:58  Elapsed: 2 secs
---------------------------------------
Found 0 potential problem(s) and 40 warning(s)

Contact Oracle Support with the output and trace file
to check if the above needs attention or not

*** 2025-06-20T18:51:58.059112+08:00 (CDB$ROOT(1))
Processing Oradebug command 'setmypid'

*** 2025-06-20T18:51:58.059145+08:00 (CDB$ROOT(1))
Oradebug command 'setmypid' console output: <none>

*** 2025-06-20T18:51:58.059203+08:00 (CDB$ROOT(1))
Processing Oradebug command 'tracefile_name'

*** 2025-06-20T18:51:58.059214+08:00 (CDB$ROOT(1))
Oradebug command 'tracefile_name' console output:
/u01/app/oracle/diag/rdbms/prodcdb/prodcdb1/trace/prodcdb1_ora_276568_HCHECK.trc

2. Oracle 23.3ai：Oracle 23ai free-版本23.8.0.25.04-DBMS_DICTIONARY_CHECK.FULL();

-- 23ai内置DBMS_HCHECK（现在依然是DBMS_DICTIONARY_CHECK），数据字典健康检查（替代传统hcheck.sql）
-- 验证数据库版本
SELECT BANNER_FULL FROM V$VERSION;
--
BANNER_FULL
__________________________________________________________________________________
Oracle Database 23ai Free Release 23.0.0.0.0 - Develop, Learn, and Run for Free
Version 23.8.0.25.04

-- 检查 DBMS_HCHECK 可用性 ,查询可用的数据字典检查包
SELECT OBJECT_NAME 
FROM ALL_OBJECTS 
WHERE OWNER = 'SYS'
AND OBJECT_NAME LIKE 'DBMS_%CHECK%';
--
OBJECT_NAME
_______________________________
DBMS_DICTIONARY_CHECK
DBMS_DICTIONARY_CHECK
DBMS_DICTIONARY_CHECK_LIB
DBMS_EXTENDED_TTS_CHECKS
DBMS_PDB_CHECK_LOCKDOWN
DBMS_EXTENDED_TTS_CHECKS
DBMS_EXTENDED_TTS_CHECKS_LIB
--
7 rows selected.
Elapsed: 00:00:00.192
-- 全面检查
SET SERVEROUTPUT ON SIZE UNLIMITED
BEGIN
  SYS.DBMS_DICTIONARY_CHECK.FULL();
END;
/
--
SYS@CDB$ROOT> BEGIN
  2    SYS.DBMS_DICTIONARY_CHECK.FULL();
  3  END;
  4* /
dbms_dictionary_check on 20-JUN-2025 17:48:37
----------------------------------------------
Catalog Version 23.0.0.0.0 (2300000000)
db_name: FREE
Is CDB?: YES CON_ID: 1 Container: CDB$ROOT
Trace File: /opt/oracle/diag/rdbms/free/FREE/trace/FREE_ora_128711_DICTCHECK.trc

                                   Catalog       Fixed
Procedure Name                     Version    Vs Release    Timestamp      Result
------------------------------ ... ---------- -- ---------- -------------- ------
.- OIDOnObjCol                 ... 2300000000 <=  *All Rel* 06/20 17:48:37 PASS
.- LobNotInObj                 ... 2300000000 <=  *All Rel* 06/20 17:48:37 PASS
…………………………
- ValidateTrigger             ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
.- ObjNotTrigger               ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
.- InvalidTSMaxSCN             ... 2300000000 >  1202000000 06/20 17:48:39 PASS
.- OBJRecycleBin               ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
.- LobSeg                      ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
.- ObjLogicalConstraints       ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
.- SysSequences                ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
.- ValidateFile                ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
.- ValidateObjStub             ... 2300000000 <=  *All Rel* 06/20 17:48:39 PASS
---------------------------------------
20-JUN-2025 17:48:39  Elapsed: 2 secs
---------------------------------------
Found 0 potential problem(s) and 0 warning(s)
Trace File: /opt/oracle/diag/rdbms/free/FREE/trace/FREE_ora_128711_DICTCHECK.trc
PL/SQL procedure successfully completed.
Elapsed: 00:00:02.215
-- 关键检查
SET SERVEROUTPUT ON SIZE UNLIMITED
BEGIN
  SYS.DBMS_DICTIONARY_CHECK.CRITICAL();
END;
/
--
SYS@CDB$ROOT> SET SERVEROUTPUT ON SIZE UNLIMITED
SYS@CDB$ROOT> BEGIN
  2    SYS.DBMS_DICTIONARY_CHECK.CRITICAL();
  3  END;
  4* /
dbms_dictionary_check on 20-JUN-2025 17:56:25
----------------------------------------------
Catalog Version 23.0.0.0.0 (2300000000)
db_name: FREE
Is CDB?: YES CON_ID: 3 Container: FREEPDB1
Trace File: /opt/oracle/diag/rdbms/free/FREE/trace/FREE_ora_128711_DICTCHECK.trc

                                   Catalog       Fixed
Procedure Name                     Version    Vs Release    Timestamp      Result
------------------------------ ... ---------- -- ---------- -------------- ------
.- UndoSeg                     ... 2300000000 <=  *All Rel* 06/20 17:56:25 PASS
.- MaxControlfSeq              ... 2300000000 <=  *All Rel* 06/20 17:56:25 PASS
.- InvalidTSMaxSCN             ... 2300000000 >  1202000000 06/20 17:56:25 PASS
.- SysSequences                ... 2300000000 <=  *All Rel* 06/20 17:56:25 PASS
---------------------------------------
20-JUN-2025 17:56:25  Elapsed: 0 secs
---------------------------------------
Found 0 potential problem(s) and 0 warning(s)

Trace File: /opt/oracle/diag/rdbms/free/FREE/trace/FREE_ora_128711_DICTCHECK.trc
PL/SQL procedure successfully completed.
Elapsed: 00:00:00.056
--检查后修复
SET SERVEROUTPUT ON SIZE UNLIMITED
BEGIN
  SYS.DBMS_DICTIONARY_CHECK.FULL(repair => TRUE);
END;
/
SYS@CDB$ROOT> SET SERVEROUTPUT ON SIZE UNLIMITED
SYS@CDB$ROOT> BEGIN
  2    SYS.DBMS_DICTIONARY_CHECK.FULL(repair => TRUE);
  3  END;
  4* /
dbms_dictionary_check on 20-JUN-2025 17:57:36
----------------------------------------------
Catalog Version 23.0.0.0.0 (2300000000)
db_name: FREE
Is CDB?: YES CON_ID: 3 Container: FREEPDB1
Trace File: /opt/oracle/diag/rdbms/free/FREE/trace/FREE_ora_128711_DICTCHECK.trc

                                   Catalog       Fixed
Procedure Name                     Version    Vs Release    Timestamp      Result
------------------------------ ... ---------- -- ---------- -------------- ------
.- OIDOnObjCol                 ... 2300000000 <=  *All Rel* 06/20 17:57:36 PASS
.- LobNotInObj                 ... 2300000000 <=  *All Rel* 06/20 17:57:36 PASS
.- SourceNotInObj              ... 2300000000 <=  *All Rel* 06/20 17:57:36 PASS
^^^
--.- ValidateFile                ... 2300000000 <=  *All Rel* 06/20 17:57:38 PASS
.- ValidateObjStub             ... 2300000000 <=  *All Rel* 06/20 17:57:38 PASS
---------------------------------------
20-JUN-2025 17:57:38  Elapsed: 2 secs
---------------------------------------
Found 0 potential problem(s) and 0 warning(s)
Trace File: /opt/oracle/diag/rdbms/free/FREE/trace/FREE_ora_128711_DICTCHECK.trc
PL/SQL procedure successfully completed.
Elapsed: 00:00:02.294
SYS@CDB$ROOT>
--仅诊断
BEGIN
  SYS.DBMS_DICTIONARY_CHECK.FULL(repair => FALSE);
END;
/

3、核心功能说明

检查级别：

- CRITICAL：关键检查
- FULL：全面检查

修复模式：

- repair => TRUE：自动修复问题
- repair => FALSE：仅诊断（默认）

四、典型应用场景

升级验证

-- 升级后立即执行
EXEC DBMS_HCHECK.FULL(container=>'CDB$ROOT');
EXEC DBMS_HCHECK.FULL(container=>'FREEPDB1');

空间异常诊断

当出现 ORA-01578 数据块损坏时，通过 CRITICAL 模式快速定位元数据问题。

自动化运维

结合调度任务每月执行修复：

Oracle Database 23ai Free Release 23.0.0.0.0 - Develop, Learn, and Run for Free
Version 23.8.0.25.04

BEGIN
      DBMS_SCHEDULER.CREATE_JOB(
        job_name   => 'HCHECK_REPAIR_JOB',
        job_type   => 'PLSQL_BLOCK',
        job_action => 'BEGIN SYS.DBMS_DICTIONARY_CHECK.FULL(repair=>TRUE); END;',
        repeat_interval => 'FREQ=MONTHLY'
      );
    END;
    /

PL/SQL procedure successfully completed.