Oracle巡检工具（Windows免客户端版）使用说明

一、工具简介

本工具基于Python开发，采用oracledb纯Thin模式（无需安装Oracle客户端），已打包为exe可执行文件，无需安装Python环境即可运行。支持Oracle数据库单库巡检、批量巡检，可自动采集数据库信息、主机资源（CPU、内存、磁盘）使用情况，并生成Excel/Word格式巡检报告，适用于Windows环境下的Oracle数据库日常巡检工作。

核心功能：

单库巡检：手动输入数据库连接信息，完成单库全方位巡检
批量巡检：通过Excel导入多个数据库配置，批量完成巡检并生成汇总报告
报告生成：自动生成单库Word巡检报告、批量Excel汇总报告
主机监控：采集Windows主机CPU、内存、磁盘使用率信息

二、环境准备

2.1 基础环境

无需安装Python环境，仅需满足以下条件即可正常运行exe工具：

操作系统：Windows 7及以上（32位/64位均可）
网络权限：运行工具的主机可访问目标Oracle数据库的IP和端口（默认1521）
文件路径：将exe可执行文件保存到无中文、无空格的路径（避免运行报错）

2.2 依赖说明

exe可执行文件已集成所有必要依赖（cryptography、oracledb、openpyxl、python-docx等），无需手动安装任何额外组件，下载后即可直接运行。

三、工具使用步骤

3.1 前期准备

下载exe可执行文件（命名为oracle_check.exe），保存到无中文、无空格的路径（例如：D:\OracleInspection\oracle_check.exe）。
无需安装任何依赖，exe文件已集成所有所需组件。
确认目标Oracle数据库状态正常，且运行工具的主机可ping通数据库IP。

3.2 启动工具

找到exe文件所在路径（例如：D:\OracleInspection），双击oracle_check.exe，即可启动工具（无需打开CMD命令行）。
启动成功后，将自动弹出工具主菜单（如下），按提示选择功能即可： ============================================================ Oracle 巡检工具（Windows 免客户端版） ============================================================ 1 → 单库巡检 2 → 批量巡检 3 → 生成Excel批量模板 4 → 退出 请选择:

3.3 功能使用详解

3.3.1 生成Excel批量模板（选项3）

用于批量巡检时，提前生成配置模板，填写多个数据库连接信息，步骤如下：

在主菜单输入 3，按回车。
工具会自动在exe文件所在目录生成 Oracle批量巡检模板.xlsx 文件。
打开模板文件，按表格提示填写数据库信息（示例已给出，可直接修改）：
数据库名称：自定义（如"生产库1""测试库"）
IP地址：Oracle数据库所在主机IP
端口：默认1521（若数据库端口修改，填写实际端口）
服务名：默认ORCL（填写实际数据库服务名）
用户名：默认system（需拥有数据库查询权限）
密码：对应用户名的密码（明文填写，模板仅用于本地配置，建议妥善保管）
连接模式：默认normal（无需修改，特殊需求可填sysdba）
填写完成后，保存模板文件，用于后续批量巡检。

3.3.2 单库巡检（选项1）

针对单个Oracle数据库进行巡检，步骤如下：

在主菜单输入 1，按回车，进入单库巡检流程。
按提示输入Oracle数据库连接信息（括号内为默认值，直接按回车可使用默认值）： ℹ️ 请输入Oracle连接信息 主机 [localhost]: 192.168.1.100 # 输入数据库IP 端口 [1521]: 1521 # 输入端口，默认1521 服务名 [ORCL]: ORCL # 输入服务名 用户名 [system]: system # 输入用户名 密码: ******** # 输入密码（输入时不显示，按回车确认） 模式(normal/sysdba) [normal]: normal # 直接回车 数据库名称 [Oracle]: 生产库1 # 自定义数据库名称
输入完成后，工具会自动进行连接测试，提示 ✓ 连接测试成功！即表示连接正常，开始自动巡检。
巡检过程中会显示进度条，完成后提示巡检结果（健康状态、告警数）。
巡检完成后，工具会在exe文件所在目录的 reports 文件夹下，生成该数据库的Word巡检报告（文件名格式：Oracle巡检_数据库名称_时间戳.docx）。
按回车返回主菜单，可进行其他操作。

3.3.3 批量巡检（选项2）

通过Excel模板导入多个数据库，批量完成巡检，步骤如下：

提前按照"3.3.1 生成Excel批量模板"步骤，填写好包含多个数据库信息的Excel模板。
在主菜单输入 2，按回车，进入批量巡检流程。
按提示输入Excel模板文件的完整路径（可复制文件路径，粘贴到命令行，按回车）： 请输入Excel配置文件路径：C:\OracleInspection\Oracle批量巡检模板.xlsx
工具会自动导入模板中的数据库配置，提示 ✓ 成功导入 X 个数据库配置（X为模板中填写的有效数据库数量）。
工具将逐个对导入的数据库进行巡检，每个数据库巡检时会显示进度条，巡检完成后自动生成该数据库的Word巡检报告。
所有数据库巡检完成后，工具会在exe文件所在目录的 reports 文件夹下，生成批量巡检Excel汇总报告（文件名格式：Oracle批量巡检_时间戳.xlsx），包含所有数据库的健康状态、告警数等核心信息。
按回车返回主菜单，可进行其他操作或退出工具。

四、常见问题

4.1 启动exe文件报错"无法打开此文件"

解决方案：检查exe文件路径是否包含中文、空格或特殊字符，将文件移动到纯英文、无空格路径（如D:\OracleInspection）后重新双击启动。

4.2 巡检时提示"连接失败"

排查要点：1. 确认数据库IP、端口、服务名填写正确；2. 确认运行工具的主机可ping通数据库IP，且数据库端口（默认1521）未被防火墙拦截；3. 确认数据库用户名、密码正确，且拥有查询权限。

4.3 无法生成巡检报告

解决方案：无需额外操作，exe已集成报告生成依赖，若仍无法生成，检查exe文件所在目录是否有写入权限（右键exe文件，选择"以管理员身份运行"重试）。

五、注意事项

Excel模板中密码为明文填写，仅用于本地巡检，建议巡检完成后删除模板中的密码，或妥善保管模板文件。
巡检过程中请勿关闭工具窗口，否则会中断巡检流程，无法生成完整报告。
若需巡检多个数据库，优先使用批量巡检功能，提高巡检效率。
reports文件夹会自动生成（无需手动创建），所有巡检报告均保存在该文件夹下，可按时间戳和数据库名称查找对应报告。

Oracle 巡检工具支持双系统，Windows 可直接双击，附完整使用说明