小麦苗数据库巡检生成word工具之AI分析版本说明

前言

近10年间，麦老师使用纯SQL脚本陆续编写了各种数据库的巡检脚本，可以直接生成html格式的报告，参考：https://dbhealthcheck.dbaup.com/

2025年花费将近半年时间，使用Python脚本编写了一个工具，可以一键直接生成word格式的报告，参考：https://www.dbaup.com/xiaomaimiaoshujukuxunjianshengchengwordgongjushuoming.html

随着AI的爆火，巡检脚本也接入了AI功能，2025年年底和2026年年初做了AI升级，接入了AI分析功能，能够对巡检结果进行智能解读，这里非常感谢一个网友的引路。

AI版主要修改地方：

1、界面修改

• 历史库有保留功能，避免每次都输入
• 数据库连接支持导出导入
• 数据库连接支持搜索、排序等功能
• 支持连接测试功能
• 接入AI功能，界面手动配置AI
• 其它…

2、生成word后，可以选择对生成的word做AI分析，生成巡检报告和对巡检报告做AI分析的功能是解耦的，做AI分析需要联网

工具简介

该工具为绿色版，解压可直接使用，目前支持Oracle、MySQL、SQL Server、PostgreSQL、GreenPlum、达梦、人大金仓、操作系统（Linux+Windows）、openGauss、MongoDB的巡检，后续还会增加其它数据库种类，主界面截图如下：

新建和编辑界面：

AI分析配置界面：

Oracle说明

需要注意的是：

1、若用户名是sys，则后台会自动以sysdba角色运行，其它用户以普通用户运行脚本。

2、服务名：这里尤其注意，不是实例名，而是服务名。目前仅支持服务名这种连接方式。

最终的word报告示例：

MySQL说明

最终的word报告示例：

SQL Server说明

最终的word报告示例：

PostgreSQL说明

最终巡检word结果示例：

GreenPlum说明

最终的word报告示例：

opengauss说明

MongoDB说明

最终的word报告示例：

人大金仓说明

最终的word报告示例：

达梦说明

最终的word报告示例：

操作系统说明

Linux系统

最终的word报告示例：

Windows系统

启动巡检步骤

Windows 11系统

在Windows 11上，有GUI图形界面，解压包后，直接双击 start.bat 即可，支持所有功能。

Windows  7系统

解压包后，进入windows7文件夹，直接双击 start.bat 即可，不支持AI功能。

Linux系统

在Linux上，无GUI图形界面，只有命令行模式，依然使用最初的版本，AI版本不支持Linux系统，解压包后，进入Linux目录，根据当前OS的版本类型选择使用start_linux7.sh或start_linux6.sh脚本运行即可：

1root@dbaup:/mnt/f/dbchecktowordai/linux# ll2total 1003-rwxrwxrwx 1 root root  1635 Mar 20 10:57 start_linux6.sh4-rwxrwxrwx 1 root root  1036 May 21 11:55 start_linux7.sh5-rwxrwxrwx 1 root root  4830 May 21 10:05 db_check_linux.py6-rwxrwxrwx 1 root root 52611 May 21 12:00 db_check_doc.py7-rwxrwxrwx 1 root root   133 May 21 12:55 db.conf8drwxrwxrwx 1 root root  4096 May 21 12:56 reports9drwxrwxrwx 1 root root  4096 May 21 15:00 ..

示例：

  1[root@dbaup linux]# sh start_linux7.sh  2请输入连接信息：  3types [默认: Oracle, 支持: Oracle、MySQL、SQL Server、PostgreSQL、GreenPlum、达梦、人大金仓、操作系统]: pg  4host [默认: 127.0.0.1]: 192.168.8.8  5port [默认: 5432]: 54331  6user [默认: postgres]:   7password :   8database [默认: postgres]:   9project XXX项目（可选）: pg18 10 11已生成 db.conf 文件，内容如下： 12[database] 13host = 192.168.8.8 14port = 54331 15database = postgres 16user = postgres 17password = *** 18dbtypes = PostgreSQL 19project = pg18 20 21 22[2025-09-29 12:09:12] 开始执行 db_check_doc.py ... 23项目名: pg18 24类型: PostgreSQL 25读取配置文件... 26本次巡检使用的Markdown文件为: ./pg_sql.md 27连接 postgresql 数据库中... 28数据库连接成功！！！ 29创建Word文档... 30 31[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > PostgreSQL基本信息 32 33[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 数据库基本信息（数据库大小） 34 35[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 数据库基本信息（数据库大小） > 所有表空间 36 37[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 库的前10张大表 38 39[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 库的schema大小 40 41[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 数据库对象统计 42 43[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 所有语言 44 45[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 所有可用插件 > 所有插件（已编译） 46 47[2025-09-29 12:09:12] 执行检查: 数据库总体概况 > 所有可用插件 > 已安装的插件 48 49[2025-09-29 12:09:12] 执行检查: 会话和锁情况 > 所有会话和进程 > 总计 50 51[2025-09-29 12:09:12] 执行检查: 会话和锁情况 > 所有会话和进程 > 当前用户统计 52 53[2025-09-29 12:09:12] 执行检查: 会话和锁情况 > 所有会话和进程 > 状态统计 54 55[2025-09-29 12:09:12] 执行检查: 会话和锁情况 > 所有会话和进程 > 当前活动会话详情（只取前20） 56 57[2025-09-29 12:09:12] 执行检查: 会话和锁情况 > 空闲会话时长 > 统计 58 59[2025-09-29 12:09:12] 执行检查: 会话和锁情况 > 空闲会话时长 > 详情列表 60 61[2025-09-29 12:09:12] 执行检查: 会话和锁情况 > 锁详情 62 63[2025-09-29 12:09:12] 执行检查: SQL情况 > 总执行时间最长的SQL 64 65[2025-09-29 12:09:12] 执行检查: SQL情况 > 最耗IO的SQL 66 67[2025-09-29 12:09:12] 执行检查: SQL情况 > 最耗共享内存 SQL 68 69[2025-09-29 12:09:12] 执行检查: 索引 > 从未使用过的索引统计 70 71[2025-09-29 12:09:12] 执行检查: 索引 > 占用空间最大的几个索引 72 73[2025-09-29 12:09:12] 执行检查: 索引 > 缺失主键索引的表 74 75[2025-09-29 12:09:12] 执行检查: 数据库性能 > 基本参数 > 基本参数 76 77[2025-09-29 12:09:12] 执行检查: 数据库性能 > 基本参数 > 哪些参数被修改过 78 79[2025-09-29 12:09:12] 执行检查: 数据库性能 > 基本参数 > pg_hba.conf配置文件信息（PG10） 80 81[2025-09-29 12:09:12] 执行检查: 数据库性能 > 基本参数 > 参数文件记录的参数 82 83[2025-09-29 12:09:12] 执行检查: 数据库性能 > 基本参数 > 获取已安装的PostgreSQL的信息 84 85[2025-09-29 12:09:12] 执行检查: 数据库性能 > 基本参数 > 用户认证方式（PG16） 86 87[2025-09-29 12:09:12] 执行检查: 数据库性能 > 所有库表膨胀信息 88 89[2025-09-29 12:09:12] 执行检查: 数据库性能 > 所有库表膨胀信息 > 按数据库汇总统计膨胀的表 90 91[2025-09-29 12:09:12] 执行检查: 数据库性能 > 所有库缺失统计信息的表（只列举100条） 92 93[2025-09-29 12:09:12] 执行检查: 数据库性能 > 所有库缺失统计信息的表（只列举100条） > 按数据库汇总统计缺失统计信息的表 94 95[2025-09-29 12:09:12] 执行检查: 数据库性能 > 缓存命中率和事务提交率 96 97[2025-09-29 12:09:12] 执行检查: 数据库性能 > WAL日志切换频率（可能需要手工指定归档日志的位置） 98 99[2025-09-29 12:09:12] 执行检查: 数据库性能 > 用户100101[2025-09-29 12:09:12] 执行检查: 高可用情况 > 主从流复制情况 > 主库查看wal日志发送状态102103[2025-09-29 12:09:12] 执行检查: 高可用情况 > 主从流复制情况 > 从库查看wal日志接收状态104105[2025-09-29 12:09:12] 执行检查: 高可用情况 > 主从流复制情况 > 主从库延迟数据（单位MB）106107[2025-09-29 12:09:12] 执行检查: 高可用情况 > 主从流复制情况 > 主从流复制冲突统计108109[2025-09-29 12:09:12] 执行检查: 高可用情况 > 逻辑复制 > 查看发布110111[2025-09-29 12:09:12] 执行检查: 高可用情况 > 逻辑复制 > 查看发布的表112113[2025-09-29 12:09:12] 执行检查: 高可用情况 > 逻辑复制 > 查看所有的订阅者114115[2025-09-29 12:09:12] 执行检查: 高可用情况 > 逻辑复制 > 复制进度116117[2025-09-29 12:09:12] 执行检查: 高可用情况 > 逻辑复制 > 查看订阅118119[2025-09-29 12:09:12] 执行检查: 高可用情况 > 逻辑复制 > 查看订阅的表120121[2025-09-29 12:09:12] 执行检查: 高可用情况 > 逻辑复制 > 查看复制槽122123[2025-09-29 12:09:12] 执行检查: 数据库统计 > 后台写进程统计信息124125[2025-09-29 12:09:12] 执行检查: 数据库统计 > wal日志统计（PG14）126127[2025-09-29 12:09:12] 执行检查: 数据库统计 > 统计软硬解析次数128129[2025-09-29 12:09:12] 执行检查: 数据库统计 > 数据库统计详情(含坏块等)130131[2025-09-29 12:09:12] 执行检查: 数据库统计 > 数据库IO详情（PG16新增）132133[2025-09-29 12:09:12] 执行检查: 数据库统计 > 复制槽活动信息（pg14）134135[2025-09-29 12:09:12] 执行检查: 数据库统计 > copy进度（pg14）136137[2025-09-29 12:09:12] 执行检查: 数据库统计 > 显示访问cached pages的统计信息（PG 13）138139[2025-09-29 12:09:12] 执行检查: 数据库统计 > 查看share buffer的使用情况（PG13）140141[2025-09-29 12:09:12] 执行检查: 数据库统计 > 查询备份进度（PG13）142143[2025-09-29 12:09:12] 执行检查: 数据库统计 > 查询analyze的进度（PG13）144145[2025-09-2912:09:12] 执行检查: 数据库统计 > 新建或重建索引的过程跟踪、进度显示（PG12）146147[2025-09-2912:09:12] 执行检查: 数据库统计 > cluster的各个阶段（PG12）148149[2025-09-2912:09:12] 执行检查: 数据库统计 > vacuum的各个阶段150151[2025-09-2912:09:12] 执行检查: 数据库统计 > 查看当前会话的内存上下文使用情况（PG14）152153[2025-09-2912:09:13] 执行检查: 数据库统计 > 查看扩展统计信息定义（PG12）154155[2025-09-2912:09:13] 执行检查: 数据库统计 > 查看扩展统计信息详情（PG12）156157[2025-09-2912:09:13] 执行检查: 数据库统计 > 查看扩展统计信息对象中包含的表达式信息（PG14）158159[2025-09-2912:09:13] 执行检查: 巡检报告结果160161巡检报告已生成: /soft/dbchecktoword/reports/PostgreSQL巡检_pg18_20250929_120913.docx162163注意：请在打开 Word 后在目录处按 F9 更新目录！！！164连接已关闭165[2025-09-2912:09:14] 执行完成166总耗时：0小时 0分钟 2秒！

word报告文件的位置

主目录生成的word文件位置：.\dbchecktowordai\reports\

Linux目录或windows7目录生成的Word文件均在当前目录的reports文件下。

关于费用问题

该工具目前和之前的巡检脚本绑定，99元可以购买全套，即包含html和word格式，之前已经购买过html格式的朋友可以免费获取该工具。