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

远方16092025-06-22 22:16

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

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

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

一、hcheck的主要功能和特点

主要功能​：
  • 数据字典检查 ：通过内置规则（如DBMS_HCHECK或DBMS_DICTIONARY_CHECK包）
    扫描数据字典的完整性，检测如对象缺失、索引孤立、表分区异常等问题
  1. 检查模式：支持FULL（全面检查）和CRITICAL（仅关键检查），后者速度更快
  2. 修复能力：通过Repair=TRUE参数自动修复部分问题（如修复元数据不一致）
  • 多维度监控：
  1. 性能：采集动态视图（如V$SYSSTAT）分析CPU、I/O、内存资源瓶颈
  2. 空间：监控表空间、数据文件、索引的存储状态，预防空间不足风险
  3. 安全：识别弱密码、未授权访问等漏洞
  • 自动化报告：生成分级报告（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 单独下载
    • 无修复功能，仅能检测问题
    • 执行过程需手工解析日志
  • 典型输出：
bash 复制代码 
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发版会有改变）：
bash 复制代码 
-- 关键检查（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​
bash 复制代码 
-- 下载脚本后执行（需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();
bash 复制代码 
-- 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：仅诊断（默认）

四、典型应用场景

  • 升级验证
bash 复制代码 
-- 升级后立即执行
EXEC DBMS_HCHECK.FULL(container=>'CDB$ROOT');
EXEC DBMS_HCHECK.FULL(container=>'FREEPDB1');
  • 空间异常诊断
    当出现 ORA-01578 数据块损坏时，通过 CRITICAL 模式快速定位元数据问题。
  • 自动化运维
    结合调度任务每月执行修复：
bash 复制代码 
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.
  • 生产上使用规范
  1. 修复前必须备份：RMAN> BACKUP CURRENT CONTROLFILE;
  2. 避免高峰时段执行 FULL 检查
相关推荐
@十八子德月生21 分钟前
第十章——8天Python从入门到精通【itheima】-99~101-Python基础综合案例-数据可视化（案例介绍=JSON格式+pyecharts简介）
大数据·python·信息可视化·pycharm·echarts·数据可视化
网硕互联的小客服2 小时前
高并发下分布式数据库性能下降的解决方法
数据库·分布式
qq_463944863 小时前
【Spark征服之路-3.2-Spark-SQL核心编程（一）】
sql·ajax·spark
远方16093 小时前
59-Oracle 10046事件-知识准备
大数据·数据库·sql·oracle·database
静听山水4 小时前
PostgreSQL/Hologres 外部数据包装器系统表 pg_foreign_data_wrapper 详解
数据库·postgresql
神洛华4 小时前
SQL Server基础语句1：基础查询、数据筛选 / 排序 、分组聚合
数据库·sql
DoWeixin64 小时前
【请关注】mysql一些经常用到的高级SQL
数据库·mysql
时序数据说4 小时前
时序数据库双存储引擎技术解析
大数据·数据库·物联网·开源·时序数据库·iotdb
Java初学者小白4 小时前
秋招Day14 - MySQL - 数据库架构
java·数据库·数据库架构
热门推荐
01KGG转MP3工具|非KGM文件|解密音频02扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解03Coze扣子平台完整体验和实践（附国内和国际版对比）0438、基于卷积神经网络(CNN)的车牌自动识别系统(matlab)05DeepSeek各版本说明与优缺点分析06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07C# 项目：导线计算 / 坐标转换 / 曲线放样 / 水准网 / 导线网平差08AI Agent | Coze 插件使用指南：从功能解析到实操步骤09YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】10jdk21下载、安装（Windows、Linux、macOS）