DBAKIT 使用手册 - 中文
发布日期
- 此用户手册适用于软件版本:ver 1.0.0
- 此手册以管理Oracle数据库为例子进行演示,介绍DBAKIT的使用方法,其他数据库的使用方法类似。
- 不同数据库类型展示的内容页面可能不同,用户需要根据实际情况进行操作。
一、软件简介
- DBAKIT 数据库运维管理软件系统(以下简称“DBAKIT”)是一套面向数据库日常运维、性能管理与故障诊断场景的数据库智能运维平台。软件作者长期深耕数据库领域,拥有十余年数据库架构设计、运维、优化及故障处理经验,并在大量实际项目和生产环境实践的基础上,对数据库运维中的共性问题、标准流程和高频操作进行系统化整理、抽象与沉淀,最终形成了本软件系统。
- DBAKIT 以提升数据库运维效率、降低人工操作风险、规范运维流程、增强故障发现与处理能力为核心目标,面向多数主流关系型数据库提供统一的管理与运维能力。
- 系统覆盖数据库连接管理、运行状态监控、实例管理、性能分析与优化、故障诊断、对象浏览、存储空间管理、例行巡检、安装部署、备份恢复、维护与容灾、常用运维工具等多个关键模块,可帮助数据库管理员更加高效、规范、直观地完成日常数据库管理工作。
- 通过 DBAKIT,用户可以对不同类型、不同版本的数据库进行集中化管理,快速掌握数据库运行状态,及时发现潜在风险,辅助定位性能瓶颈和异常问题,并为数据库的持续稳定运行提供有效支撑。系统不仅适用于日常运维管理场景,也可用于数据库巡检、环境交付、故障排查、性能优化、应急恢复等专业运维工作,是面向数据库管理员、运维工程师等及相关技术团队的一体化数据库运维管理工具。
适用人群:
- 数据库管理员
- 信息系统运维人员
- 软件开发人员
- 其他IT从业人员(需具备基础数据库知识)
本用户手册用于说明软件的用途、功能特点、运行要求和页面操作流程。各功能章节按用户能够看到的页面、入口、按钮、输入项、提示信息和处理结果进行说明。
二、模块功能特点
-
数据库连接管理
- 提供数据库连接配置的新增、编辑、删除、连通性检测和实例状态检查能力,并结合授权信息控制可使用的数据库类型。
-
数据库概览监控与趋势查看
- 首页集中展示实例状态、CPU、内存、存储、会话等核心指标,并提供趋势历史和告警信息,帮助用户快速判断数据库整体运行情况。
-
实例管理 (实例信息、内存分配、初始化参数等)
- 支持查看实例详细信息、内存分配详细信息、初始化参数等内容,便于用户核对运行配置和资源使用情况同时提供2个工具用于进程查询分别是:根据进程号查找操作系统进程号、按照内存大小筛选进程。
-
监控诊断 (会话管理、SQL分析、性能诊断)
- 支持查看会话、锁、性能相关信息,并提供 SQL 分析、SQL 终端和快捷 SQL 库,便于用户执行查询、分析性能和复用常用语句。
-
对象浏览器 (查看 PDB 与 Schema、对象管理、用户与角色等)
- 支持查看 PDB 与 Schema、数据库对象、用户与角色等内容,帮助用户完成对象浏览、用户权限核查和基础管理操作。
-
存储管理 (逻辑空间、物理文件管理等)
- 支持查看逻辑表空间和物理文件信息,并提供与数据库存储结构相关的检查与处理入口。
-
维护与容灾 (备份恢复、任务管理、高可用管理等)
- 提供备份概览、备份任务、备份片、恢复预案、传统任务与调度任务等能力,帮助用户执行或跟踪维护工作。
-
工具与其他 (SQL终端、快捷SQL库、数据库巡检等)
- 支持 SQL 终端、快捷 SQL 库和数据库巡检等工具能力,便于用户执行查询、复用常用语句并形成巡检结论。
-
设置(主题设置、通用设置、安全设置、阈值设置、软件注册、版本信息等)
- 提供主题设置、通用设置、安全设置、阈值设置、软件注册和版本信息查看等能力,便于用户维护本地运行环境和授权状态。
三、软件使用说明
3.1、操作系统要求
请确保实际运行环境满足以上要求,以保证 DBAKIT能够正常使用。
| 系统要求 | 最低配置 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 x64、macOS Apple Silicon 15.0 | Windows 11 x64 或 macOS 15.7 |
| 运行环境 | 具备桌面图形界面和可访问目标数据库的网络环境 | 稳定网络环境、软件基础运行环境 |
| 数据库权限(示例:Oracle数据库) | 可连接目标数据库并具有基础查询权限 | 由管理员授予字典视图、AWR、备份恢复和任务管理所需权限 |
3.2、支持的数据库
| 数据库类型 | 数据库产品 | 支持主版本 | 支持的软件版本 |
|---|---|---|---|
| 商业关系型数据库 | Oracle Database | 9i(部分支持) / 10g / 11g / 12c / 18c / 19c / 21c / 23ai / 26ai | DBAKIT v1.0.0 |
| 商业关系型数据库 | Microsoft SQL Server | 2012 / 2014 / 2016 / 2017 / 2019 / 2022 / 2025 | 后续版本支持 |
| 商业关系型数据库 | IBM Db2 LUW | 10.5 / 11.1 / 11.5 / 12.1 | 后续版本支持 |
| 开源关系型数据库 | MySQL | 5.7 / 8.0 / 8.4 LTS / 9.x Innovation | 后续版本支持 |
| 开源关系型数据库 | MariaDB | 10.3 / 10.4 / 10.5 / 10.6 / 10.11 / 11.4 | 后续版本支持 |
| 开源关系型数据库 | PostgreSQL | 12 / 13 / 14 / 15 / 16 / 17 / 18 | 后续版本支持 |
| 国产关系型数据库 | OceanBase | V3 / V4 | 后续版本支持 |
| 国产关系型数据库 | 达梦数据库 DM | DM7 / DM8 | 后续版本支持 |
| 国产关系型数据库 | 金仓数据库 KingbaseES | V8 / V9 | 后续版本支持 |
| 国产关系型数据库 | PolarDB | MySQL版 / PostgreSQL版 / Oracle兼容版 / PolarDB-X | 后续版本支持 |
| 国产关系型数据库 | GoldenDB | V6 / V7 / V9 | 后续版本支持 |
| 国产关系型数据库 | TiDB | V6 / V7 / V8 | 后续版本支持 |
| 国产关系型数据库 | GBASE | GBase 8a / 8s / 8c | 后续版本支持 |
| 国产关系型数据库 | GaussDB | GaussDB 企业版 / 云服务版 | 后续版本支持 |
| 国产关系型数据库 | TDSQL | TDSQL MySQL / TDSQL PostgreSQL / TDSQL-C | 后续版本支持 |
| 国产关系型数据库 | YashanDB | V22 / V23 | 后续版本支持 |
| 国产关系型数据库 | TiDB | 6.x / 7.x / 8.x | 后续版本支持 |
3.2、软件连接用户权限
3.2.1、操作系统用户
暂不支持windows平台的操作系统用户
- 可以是root用户,也可以是数据库运行所在的用户。
- 操作系统用户不是必须(部分功能模块不可用)。
3.2.2、数据库用户
- 必须,且需要赋予足够权限。
- 建议的权限设置(数据库类型为:Oracle数据库)参考如下表:
-- 创建用于DBAKIT连接的数据库用户(比如:DBAKIT)
-- 注意:创建CDB数据库用户通用用户前缀必须为:C##DBAKIT
CREATE USER DBAKIT IDENTIFIED BY 密码;
CREATE USER C##DBAKIT IDENTIFIED BY 密码;
-- 最简单的数据库权限配置
GRANT DBA TO 用户名;
-- 最小数据库权限配置
GRANT CONNECT, RESOURCE TO DBAKIT;
GRANT SELECT_CATALOG_ROLE TO DBAKIT;
GRANT SELECT ANY DICTIONARY to DBAKIT;
GRANT MANAGE TABLESPACE TO DBAKIT;
GRANT MANAGE SCHEDULER TO DBAKIT;
GRANT GATHER_SYSTEM_STATISTICS TO DBAKIT;
GRANT ANALYZE ANY TO DBAKIT;
GRANT ANALYZE ANY DICTIONARY TO DBAKIT;
GRANT CREATE TABLESPACE TO DBAKIT;
GRANT ALTER SYSTEM TO DBAKIT;
GRANT ALTER TABLESPACE TO DBAKIT;
GRANT ALTER DATABASE TO DBAKIT;
GRANT ALTER PROFILE TO DBAKIT;
GRANT CREATE USER TO DBAKIT;
GRANT DROP USER TO DBAKIT;
GRANT DROP TABLESPACE TO DBAKIT;
GRANT ADMINISTER ANY SQL TUNING SET TO DBAKIT;
GRANT EXECUTE ON DBMS_STATS TO DBAKIT;
GRANT EXECUTE ON DBMS_SCHEDULER TO DBAKIT;
GRANT EXECUTE ON DBMS_WORKLOAD_REPOSITORY to DBAKIT;
GRANT EXECUTE ON DBMS_SPM TO DBAKIT;
GRANT EXECUTE ON DBMS_SQLTUNE TO DBAKIT;
GRANT EXECUTE ON DBMS_SQLDIAG TO DBAKIT;
GRANT ADVISOR, ADMINISTER SQL TUNING SET, ADMINISTER SQL MANAGEMENT OBJECT TO DBAKIT;
3.3、其他事宜告知
对于部分商业数据库来说,软件会调用连接数据库内部分高级特性,我们默认您连接的数据库已经获得相关正式授权,同时我们会在涉及使用相关功能模块时,进行必要提示。如果您想了解软件内具体哪些功能模块会使用到其高级特性,请与作者联系:aaronqlm@icloud.com
3.4、风险告知
- 部分功能不正确使用可能会导致数据库出现宕机/数据丢失风险,当您使用此功能时我们默认您已经知悉且承担藉此带来的结果。对于某些功能如果不确定其风险,请查看软件帮助文档或者联系作者寻求帮助。
- 切勿将非正规授权的软件用于生产环境,藉此带来的一切风险请自行承担。
- 本软件为商业软件,未经授权,严禁复制、分发、修改或用于非授权的商业用途,违者作者将追究其法律责任,当您使用本软件时,我们默认您已知悉。
四、软件安装 & 注册
4.1、Windows平台
- 获取软件介质安装包
- 解压软件包并安装到所需目录后进行安装。

双击运行安装包,按照提示进行安装。





- 软件会在桌面生成快捷方式。
- 安装运行库
本软件在 Windows 上运行时,需确保系统已具备以下运行环境:
- Microsoft Edge WebView2 Runtime 用于承载软件界面。若系统未安装,软件可能无法正常打开或界面显示异常。
- Microsoft Visual C++ Redistributable 用于加载部分原生运行库。若缺失,数据库底层驱动相关功能可能无法正常初始化。
4.2、MacOS平台
- 获取软件介质安装包
- 解压软件包并安装到所需目录后进行安装。

打开dmg文件,把程序拖动到应用程序中:


- 点击打开程序,如果提示程序已损坏,则打开终端窗口输入如下命令后重新打开软件:
sudo spctl --master-disable
# 确保系统安全设置已经改为任何来源后,重新打开软件。如果仍提示损坏,在终端窗口输入如下命令重新打开软件:
sudo xattr -r -d com.apple.quarantine /Applications/DBAKIT.app
4.3、软件注册

输入授权文件即可激活。
五、软件操作步骤
5.1、设置软件启动密码
- 软件初次使用必须设置访问密码,目的是防止未授权的用户通过软件对数据库进行非法操作。

如果您忘记了 访问密码/密码错误10次,需要重置,请参考:“常见问题解答” 章节。
5.2、使用流程
DBAKIT软件使用很简单,操作逻辑遵循:
- 选择数据库 - > 左侧导航栏选择需要使用的模块进入详细页面即可。
- 在软件顶部会显示当前数据库的连接情况,如下所示:

5.2.1、调整应用窗口

5.2.2、主界面说明

六、功能模块介绍
6.1、数据库连接管理(示例数据库类型:Oracle数据库)
- 用户可在数据库连接管理页面维护数据库连接资料,并在进入业务页面前确认数据库可以正常访问。用户可以通过从主界面顶部打开数据库连接管理窗口进入。


6.1.1、添加数据库连接

6.1.2、数据库连接管理 & 测试连接




-
当用户首次使用软件/需要切换到另一套数据库/需要修正主机、端口、服务名和账号信息时,点击软件顶部选择数据库会进入该窗口处理连接配置。
-
用户在数据库连接管理页面会看到连接列表、新增与编辑表单、数据库类型选择、主机与数据库地址输入框、账号密码输入框、连通性测试按钮、实例状态检查按钮和删除确认提示等信息,并可依据页面显示继续处理。
-
使用该功能时,用户先打开连接管理窗口后,先查看已有连接列表,确认当前需要使用的数据库记录是否已经存在,随后如需新增连接,填写连接名称、数据库类型、主机地址、SSH 信息、数据库地址、端口、服务名、用户名和密码等内容,接着填写完成后先执行连通性检测,确认数据库能够成功连接,再根据需要执行实例状态检查,最后检测成功后选择目标连接并返回主界面,软件会把该连接作为当前数据库上下文供各页面继续使用。
-
页面会按照数据库类型受授权范围限制,未授权的类型不可选、Oracle 的 SYSDBA 快捷权限仅允许 Oracle 的 sys 用户使用、连通性测试有超时控制,测试期间禁止重复点击和删除连接前会弹出确认提示等规则限制或提示用户。处理结束后,用户可以看到测试成功后会显示成功状态与提示信息、测试失败或超时会显示失败原因或超时提示和连接选中后主界面头部会同步展示数据库地址、端口、用户名和备注等信息。
下为数据库正常连接的主页面示意图:

6.2、仪表盘
6.2.1、概览
- 用户可在此页面查看数据库的整体健康评分,软件会根据阈值来判定数据库整体运行情况。对于此5个指标阈值需要自行设定参数值可以在设置页面来配置,如下图:





页面说明:
- 用户在连接数据库后,通常先查看概览页判断当前数据库是否运行正常,以及是否存在资源压力和异常告警。
- 该部分提供实例状态卡片、CPU 与内存指标、存储使用率、告警列表、数据库信息和顶部的刷新按钮等内容,用户可据此查看状态、选择下一步操作。
- 在该页面中,用户先进入概览页后先查看实例运行状态和主要指标,判断数据库是否处于正常服务状态,随后继续查看基础信息和告警区域,确认当前数据库名称、平台、归档模式以及是否存在需要优先处理的异常,最后当需要比较一段时间内的变化时,再切换到趋势页面查看历史趋势曲线和相关明细。
如果数据库没有配置/错误配置主机的IP/SSH/用户名/密码则涉及主机的CPU、内存、磁盘I/O不会被收集因为其依赖SSH访问数据库。

6.2.1.1、手动刷新

- 导航栏模块中,当我们点击进入具体页面后,如果我们需要获取最新数据,则点击手动刷新即可。(部分模块支持定期刷新)。
6.2.1.2、定期刷新

- 定期刷新为全局设定,定期刷新会根据设定值定期采集概览页面的数据(概览统计、趋势指标、基本信息、告警信息)、并写入本地数据库文件中。
请不要在生产库环境中把定期刷新设置为:实时,否则将会给生产库带来一定性能压力。推荐60秒设置为宜。
6.2.2、趋势

- 趋势页面是一个统计页面,基于指定的时间来展现定期刷新的历史数据。
- 点击趋势页面顶部的暂停按钮,即可暂停当前页面刷新的数据收集。
6.3、实例管理
6.3.1、实例信息

数据库实例信息卡片: 包含了数据库实例的主要信息。

SGA信息卡片: 包括SGA详细信息、SGA动态组件信息、SGA当前调整操作信息、历史SGA调整操作信息、SGA Buffer Cache Top 对象。通过这些数据能够帮用户从各个角度明细SGA当前/历史的使用情况。




PGA信息卡片: 包含:会话/进程 PGA 使用排名、以及2个工具可以帮助用户来进一步对PGA相关进程排查问题。
6.3.2、内存分配



- 内存总揽卡片: 在内存分配角度展示当前数据库内存分配情况。
- SGA 分配分析卡片、SGA动态趋势卡片: 相比实例信息进步展示SGA子区域的内存分配情况。
- PGA使用趋势卡片: 从AWR仓库分析历史PGA的内存分配情况。
- 内存顾问建议卡片: 通过分析最近一次AWR报告给SGA、PGA大小提供优化建议。
6.3.3、配置参数

- 默认显示数据库非默认初始化参数。
- 可以通过筛选条件来过滤参数便于查询。
6.4、监控诊断
6.4.1、会话管理

-
刷新间隔卡片: 默认刷新间隔联动全局定期刷新的值,可以“暂停当前页面的刷新”,也可以自定义此页面的刷新值。
-
所有会话卡片:
- 默认只显示活动会话
- 选中会话记录后可以点击会话详情按钮查看会话详细情况。
如果会话详情为:暂无数据。 则说明此会话为短暂会话,已经退出数据库所以无法查看。
- 工具:
-
根据操作系统进程号查找会话信息: 当我们需要对数据库某些进程进行排故/分析时,可以通过登陆数据库服务器找到对应的操作系统进程号或者在所有会话卡片中找到对应的OS PID号来匹配。
-
DUMP数据库会话详细信息: 可以通过DUMP数据库会话及选择DUMP级别来进一步分析会话。
此功能需要配置完整的主机连接信息。


6.4.2、SQL分析


SQL筛选卡片: 通过选择合适的数据源来查看/分析SQL语句。
- 实时性能视图: 来自当前数据库SGA内存区域,数据库重启/特殊操作后SQL语句可能会消失。
- AWR仓库: 历史执行过的SQL语句会存放在此处。
SQL语句分类列表排序: 根据实际需求分类展示SQL语句,方便用户快速定位。

导出数据: 可以把当前sql明细表格的所有数据导出用于后续分析。

SQL执行计划稳固卡片:
- 不是所有的数据库版本都支持,有些执行计划功能已经废弃。
工具说明:
- 查询硬解析高的SQL语句: 用于分析SQL语句执行计划是否存在问题。
- 共享池4031错误分析: 当数据库alert日志出现ora-04031错误时可用于分析详细信息。
6.4.3、性能诊断

AWR卡片:
-
生成一个AWR快照: 当数据库出现性能问题时,生成一个性能快照用于后续性能分析。
-
生成AWR报告: 对于某个时间段/基线生成一个性能分析报告。


运行数据库自动诊断: 选择一段范围内的AWR快照ID,进行自动性能诊断及分析。


SQL优化卡片: 用户根据实际情况选择合适的优化指导,如果只是调优单个SQL语句则使用:SPA即可。SAA需要提前创建STS优化集。
6.5、对象浏览器
6.5.1、PDB & SCHEMAS

- 此页面展示PDB/SCHEMAS的总揽信息以及SCHEMA对象分布的情况,对于Oracle 12C以下的数据库,没有PDB的概念。
6.5.2、对象管理





6.5.3、用户与权限




- 创建用户、删除用户: 仅限SYS用户操作。
- 用户赋权: 需要提前赋权给连接数据库用户。
- 角色与系统权限: 展示整体数据库角色、权限分布情况。
- 风险与审计关注: 展示当前整体数据库用户权限分配情况以及建议整改。
- 风险提醒: 用户根据建议对其存在的问题进行改进即可。
6.6、存储管理
6.6.1、逻辑空间

- 一般来说用户需要关注表空间容量分配、使用情况,对于达到告警以上的表空间需要及时进行扩容(在物理文件页面可以进行)。
- 表空间分配详情卡片: 我们已经考虑到了数据文件的自动扩展,用户只需要重点关注:剩余空间、使用率、状态列即可。
- 全库日增长趋势卡片: 能够让用户知道数据库的日数据量增长情况。
6.6.2、物理文件


可缩容建议卡片: 如果当前磁盘空间告急,可以对数据文件进行调整。
操作前请先做数据库备份,切勿在业务高峰期操作。
功能介绍:新增数据库文件
高危操作!
- 在配置好正确的参数后,准备添加前请务必点击:执行预检查(此功能必须配置好主机连接相关参数)。
- 注意:开始添加后此操作不能撤销!


功能介绍:日志文件管理


- 添加日志组/日志文件时,注意跟其他日志组/日志文件大小保持一致,建议在业务不繁忙时进行添加。


- 日志组切换时,建议在业务不繁忙时进行切换,如无需求,建议不进行切换。


- 如无必要,不建议删除。
- 要删除日志组只有在日志组状态为:inactive时才能进行。
6.7、维护与容灾
6.7.1、备份恢复



- 可在此页面查看备份任务、备份片、恢复预案和调度任务,并支持发起部分备份操作。
- 此页面包含检查备份是否按期执行、查看最近失败原因、发起备份操作等信息。
- 此页面提供备份概览指标、备份任务列表、备份片列表、FRA 信息、恢复预案说明、备份操作表单、任务列表和任务启停或创建入口等页面内容,用户可据此查看状态、填写信息或选择下一步操作。
- 如果不满足备份操作依赖主机地址、SSH 用户、SSH 密码和端口等配置完整、某些备份场景受数据库归档模式和实例状态限制和任务操作需要具备相应数据库权限等要求,用户需要根据页面提示调整后再继续。
- 页面反馈通常包括备份执行时页面会显示进度、日志、耗时和结果路径、备份失败时会反馈错误码与错误明细和任务操作完成后,列表会更新任务状态。
6.7.2、任务管理

- 概括来说Oracle任务管理分为3个类型:传统任务(job)、调度任务(scheduler)、自动维护任务(数据库自带,基于scheduler)。
- Oracle 10g及其以后版本推荐使用调度任务来添加JOB。
6.7.3、高可用管理

- 高可用管理页面用于查看 Oracle Data Guard / Active Data Guard 的高可用运行状态,帮助运维人员快速掌握当前数据库角色、保护模式、同步延迟、归档应用情况以及日志结构信息,便于开展日常巡检和主备同步诊断。
适用范围
- 仅支持 Oracle 数据源。
- 使用前需要先在系统中选择并连接目标数据库。
- 页面展示的部分能力可能涉及 Oracle Data Guard 或 Active Data Guard,使用前应确认当前环境具备相应授权。
页面功能说明
- 页面顶部提供 8 个总览卡片,用于快速展示当前高可用关键状态。
- 中部提供 5 个工作区标签,分别展示总览、配置参数、同步状态、日志应用、日志结构。
- 底部提供 3 个辅助区域,分别展示已应用的最新归档、未应用的归档日志、归档日志间隙。
顶部总览卡片说明
- 数据库角色:显示当前数据库是主库还是备库,例如 PRIMARY。
- 打开模式:显示数据库当前的打开状态,例如 READ WRITE。
- 保护模式:显示 Data Guard 当前保护模式,例如 MAXIMUM PERFORMANCE。
- 保护级别:显示数据库当前实际达到的保护级别。
- 切换状态:显示当前是否允许执行主备切换,常见值如 NOT ALLOWED、TO PRIMARY、TO STANDBY。
- 应用延迟:显示备库应用归档日志的延迟情况。
- 归档间隙:显示是否存在归档缺口,数值越大表示需要重点关注。
- 恢复模式:显示备库日志恢复或应用模式,例如 IDLE、MANAGED 等。
工作区标签说明
- 总览:以表格方式展示核心高可用指标、指标值、来源视图和状态。
- 配置参数:展示与 Data Guard 相关的重要参数,例如归档目标、FAL 参数、standby_file_management 等。
- 同步状态:展示 transport lag、apply lag、apply finish time 等同步诊断指标。
- 日志应用:展示归档日志是否已归档、是否已应用、完成时间等信息。
- 日志结构:展示在线日志和 Standby 日志的组号、线程号、序列号、状态及大小。
底部辅助区域说明
- 已应用的最新归档:显示最近一次已应用归档的线程号、序列号、归档文件名和应用完成时间。
- 未应用的归档日志:显示当前尚未应用的归档日志列表,便于判断积压情况。
- 归档日志间隙:显示归档缺口所在的线程及序列范围,用于定位日志传输或应用异常。
状态-说明
- 正常:当前指标处于预期状态。
- 关注:当前指标存在轻微异常或需要持续观察。
- 风险:当前指标异常较明显,建议尽快排查。
- N/A:当前指标不适用、未返回或当前角色下无意义。
常用使用方法
- 日常巡检时,先查看顶部总览卡片,确认数据库角色、保护模式和切换状态是否正常。
- 如果发现 应用延迟 或 归档间隙 异常,再进入 同步状态 和 日志应用 标签页进一步排查。
- 需要核对高可用配置时,可进入 配置参数 标签页检查关键参数是否正确。
- 需要确认日志组配置是否完整时,可进入 日志结构 标签页查看在线日志和 Standby 日志结构。
注意事项
- 本页面当前以监控和诊断为主,不直接执行主备切换操作。
- 归档日志间隙区域可能比页面主体稍晚加载,属于正常现象。
- 表格列支持点击表头排序,排序顺序为:降序 -> 升序 -> 默认顺序。
- 当页面提示“当前未连接数据库”时,需要先返回连接管理处选择并连接数据库。
6.8、工具与其他
6.8.1、SQL终端

SQL 终端提供以下能力
- 提供 SQL 编辑区,支持多行输入、行号显示和光标位置显示。
- 支持 格式化 SQL,可对当前编辑区中的语句进行排版整理。
- 支持执行整段 SQL,也支持先选中一段 SQL 后执行选中内容。
- 查询结果会根据真实返回列动态生成表格。
- 结果表支持横向滚动、纵向滚动和表头三态排序。
- 大结果集采用分批渲染方式,滚动到底部时会自动继续加载后续行。
- 页面会显示返回行数、列数、后端耗时和执行时间。
- 编辑区内容会按连接自动保留,切换页面或刷新后通常仍可恢复草稿。
界面说明
SQL 终端页面主要分为两个区域:
- SQL 编辑区
- 用于输入或粘贴待执行的 SQL 语句。右上角会显示当前光标所在的行号与列号,并提供 格式化 SQL 和 执行 按钮。
- 查询结果区 用于展示 SQL 返回的数据结果,并显示以下信息:
- 返回行数与列数
- 后端执行耗时
- 执行时间
- 当前已显示的行数
操作步骤
- 先在应用顶部确认已选择并连接目标数据库。
- 打开左侧导航中的 SQL终端。
- 在 SQL 编辑区输入查询语句。
- 如需整理语句格式,可点击 格式化 SQL。
- 点击 执行 开始查询。
- 如果编辑区中有多段语句,请先选中需要执行的那一段,再点击 执行选中。
- 在下方 查询结果 区查看返回数据。
支持的 SQL 范围
当前 SQL 终端只支持只读查询,使用时应注意以下规则:
- 不支持一次执行多条语句。
- 单条语句末尾可以保留一个分号,但语句中不能包含多条以分号分隔的 SQL。
结果查看说明 查询执行成功后,结果区会展示真实数据表格,并具备以下交互能力:
- 点击表头可排序,排序顺序为:降序 -> 升序 -> 默认顺序
- 支持横向滚动查看较多字段
- 支持纵向滚动查看较多记录
- 为保证性能,大结果集会先显示首批数据,继续下拉时自动追加显示 如果查询成功但没有返回数据,系统会提示当前结果集没有返回数据行。
常见提示信息
使用 SQL 终端时,可能会看到以下提示:
- 请先输入 SQL 语句后再执行或格式化。
- 请先选择已连接的数据库后再执行 SQL。
- 存在多条语句,请先选择要执行的语句。
- SQL 执行完成,返回 X 行 / Y 列,后端耗时 Z 秒。
- SQL 执行失败:原因说明
使用建议
- 建议优先用于查询系统视图、对象状态、会话信息和性能数据。
- 如果需要从脚本中只执行一段 SQL,先框选目标语句再执行。
- 格式化功能只会调整 SQL 排版,不会执行语句。
- 页面刷新或切换连接后,历史结果会清空,但编辑区草稿通常会保留,便于继续编写。
6.8.2、快捷SQL库

- 快捷SQL库用于集中保存、分类管理和复用常用 SQL 语句,适合存放日常巡检、备份恢复、性能诊断、业务核对等场景中的常用查询。用户可在此页面快速检索历史 SQL、维护分类,并对符合条件的 SQL 直接执行与导出结果。
界面说明
快捷SQL库页面主要由以下区域组成:
- 顶部操作区
- 可执行以下操作:
- 新增一个快捷SQL:创建新的快捷 SQL
- 新增分类:创建新的分类
- 删除分类:删除当前选中的分类
- 筛选与搜索区
- 支持以下筛选方式:
- 数据库类型:按数据库类型筛选 SQL
- 搜索框:可按标题、SQL 内容或分类名称进行模糊搜索
- 分类导航区
- 左侧显示所有分类,点击分类后,右侧仅展示该分类下的快捷 SQL。
- 默认包含“全部”分类,用于汇总显示所有已保存的快捷 SQL。
- SQL 列表区 右侧显示当前分类下的快捷 SQL,常见字段包括:
- 标题
- 说明
- 数据库类型
- 最近使用
- 操作
- 操作按钮包括:
- 运行
- 编辑
- 删除
新增快捷SQL
- 进入“快捷SQL库”页面。
- 点击“新增一个快捷SQL”。
- 在弹窗中填写以下内容:
-
快捷SQL标题:用于标识该 SQL 的名称
-
所属分类:选择该 SQL 所属分类
-
适用数据库类型:选择 SQL 对应的数据库类型
-
说明:填写用途、注意事项或参数说明
-
SQL 编辑区:输入需要保存的 SQL 语句
- 如需优化排版,可点击“格式化 SQL”。
- 点击“保存”完成新增。
- 说明:
- 标题和 SQL 内容不能为空。
- 保存后,该 SQL 会写入本地 SQLite 库中,供后续重复使用。
新增分类
- 点击“新增分类”。
- 输入以下信息:
- 分类名称
- 分类说明
- 点击“确认新增”完成保存。 建议根据使用场景建立分类,例如:
- 日常管理
- 备份恢复
- 性能优化
- 业务管理
- 巡检脚本
编辑快捷SQL
- 在 SQL 列表中找到目标 SQL。
- 点击对应行的“编辑”按钮。
- 修改标题、分类、数据库类型、说明或 SQL 内容。
- 点击“保存”完成更新。
删除快捷SQL
- 在 SQL 列表中找到目标 SQL。
- 点击“删除”。
- 在确认提示后完成删除。
- 删除说明:
- 删除快捷SQL后,该快捷 SQL 将从本地库中移除,无法继续在快捷SQL库中使用。
删除分类
- 在左侧分类导航中选中需要删除的分类。
- 点击“删除分类”。
- 确认后删除该分类。
- 注意事项:
- 如果该分类下仍存在已保存的快捷 SQL,则不能直接删除。
- 需要先删除或转移该分类下的 SQL,再执行分类删除。
执行快捷SQL
- 先确保当前已选择数据库连接。
- 在 SQL 列表中点击“运行”按钮,即可执行对应 SQL。
- 执行完成后,系统会弹出执行结果窗口,展示:
- 返回行数
- 返回列数
- 执行耗时
- 执行时间
- 查询结果明细
- 补充说明:
- 双击 SQL 标题,也可快速执行该 SQL。
- SQL 成功执行后,“最近使用”时间会自动更新。
执行限制
- 当前版本中:
- 快捷SQL库支持保存多种数据库类型的 SQL
- 但“直接执行”功能当前仅支持 Oracle 连接
- 如果所选 SQL 的数据库类型不是 Oracle,系统会提示当前不支持执行。
结果导出 执行结果窗口支持导出: • 导出 Excel • 导出 TXT
- 适用场景:
- 导出巡检结果留档
- 导出查询结果发送给同事
- 导出数据用于后续分析
排序与检索
在 SQL 列表中,可对以下字段进行排序:
- 标题
- 数据库类型
- 最近使用
排序方式为三态切换:
- 降序
- 升序
- 恢复默认顺序
支持通过搜索框快速定位目标 SQL。
使用建议
- 建议为每条 SQL 填写清晰标题和说明,方便团队共享与复用。
- 建议按业务场景建立分类,避免 SQL 数量增多后难以管理。
- 对常用巡检 SQL,可统一放入“巡检脚本”分类,便于定期执行。
- 对生产环境 SQL,建议在说明中补充适用范围和风险提示。
注意事项
- 快捷 SQL 保存在本地应用数据中,不会自动同步到其他设备。
- 删除快捷 SQL 或分类前,请确认内容是否仍需保留。
6.8.3、数据库巡检




- 数据库巡检功能用于对已接入的数据库连接执行健康检查,自动采集实例状态、连接信息、会话与对象健康指标,并生成 HTML 巡检报告,便于日常值班、例行检查和问题留档。当前版本已支持 Oracle 数据库巡检。
功能概述
数据库巡检页面提供以下能力:
- 手动发起单次巡检。
- 配置定期巡检计划,由系统自动执行。
- 实时查看巡检执行进度和后台日志。
- 保存巡检历史记录。
- 生成并定位 HTML 巡检报告文件。
巡检结果
当前巡检结果会重点检查以下内容:
- 实例状态。
- 数据库打开模式。
- 活跃会话数。
- 无效对象数。
- 30 天内即将到期的用户数量。
- 调度任务异常情况。
- Top 表空间使用率。
- 健康分、摘要和告警信息。
巡检页面布局
页面主要分为以下区域:
- 巡检统计卡片:显示待巡检、运行中、成功、失败数量。
- 操作区:包括 “开始巡检” 和 “定期巡检”、数据库类型筛选和关键字搜索。
- 巡检对象列表:展示可巡检的数据库连接。
- 巡检历史区:展示最近巡检记录及报告文件。
使用前提
- 使用数据库巡检前,需要先完成数据库连接维护,确保待巡检数据库已在系统中配置完成。
巡检对象列表
复用系统中的数据库连接信息,通常包含以下字段:
- 连接名称。
- 数据库类型。
- 主机 IP。
- 主机 SSH 端口。
- OS 用户。
- DB IP 地址。
- DB 端口。
- DB 服务名。
- DB 用户。
- 权限。
- 备注。
使用说明
- 当前数据库巡检实际已落地的是 Oracle 巡检。
- 密码类字段在页面中默认以掩码方式显示。
- 若页面没有可选对象,请先到数据库连接管理相关页面维护连接信息。
手动巡检操作
- 进入“数据库巡检”页面。
- 在巡检对象列表中勾选一个或多个数据库。
- 可按“数据库类型”筛选,或通过关键字搜索目标连接。
- 点击“开始巡检”按钮。
- 系统弹出“巡检执行进度”窗口,显示本次巡检启动时间、已选数据库数量、运行线程、完成数量及实时日志。
- 巡检完成后,可在历史记录中查看执行结果,并打开输出报告。
使用说明
- 未勾选巡检对象时,系统不会启动巡检。
- 巡检过程中可关闭进度窗口并切换使用其他功能,任务仍会在后台继续执行。
- 巡检完成后,系统会记录成功或失败状态。
定期巡检操作
- 点击“定期巡检”按钮后,可进入定期巡检配置窗口。
定期巡检使用说明
- 上班巡检:适合工作日上班时自动执行。
- 下班巡检:适合工作日下班前例行巡检归档。
- 每周巡检:按固定星期和时间执行。
- 每月巡检:按固定日期和时间执行。
配置步骤如下:
- 选择巡检类型。
- 设置首次执行日期。
- 设置执行时刻。
- 若为每周巡检,选择每周执行日。
- 若为每月巡检,选择每月执行日。
- 勾选需要纳入计划的数据库。
- 点击“保存”。
- 保存成功后:
- 计划会写入本地计划列表。
- 应用启动后会自动恢复已保存计划。
- 到达计划执行时间后,系统会自动触发巡检。
- 每次自动巡检都会写入巡检历史。
巡检历史说明
巡检历史区用于记录巡检执行结果,通常包括以下内容:
- 任务号。
- 触发方式。
- 巡检窗口。
- 状态。
- 输出文件。
- 开始时间。
触发方式说明:
- 手动巡检:由用户主动点击“开始巡检”触发。
- 定期巡检:由已配置计划自动触发。
历史展示规则:
- 默认显示最近 24 小时内的巡检记录。
- 如需查看更多历史,可点击“显示更多历史记录”继续加载。
- 历史记录会保留对应巡检窗口信息,便于区分上班巡检、下班巡检、周检或月检。
巡检报告说明
-
每次巡检完成后,系统会生成 HTML 格式巡检报告。
-
报告特点: 报告特点:
- 可用于归档和留痕。
- 可用于日常巡检结果汇报。
- 可用于问题定位时回溯数据库健康状态。
-
报告通常包含:
- 巡检目标信息。
- 巡检执行时间。
- 数据库实例基础信息。
- 健康指标结果。
- 告警项。
- 健康评分。
- 巡检摘要。
-
报告输出位置:
- 报告会保存到程序所在目录下的 files 目录。
- 在巡检历史中点击输出文件,可快速打开文件所在目录并定位报告。
页面辅助功能
- 为了便于快速定位巡检对象,页面还提供以下辅助能力:
- 数据库类型筛选。
- 关键字搜索。
- 表格列排序。
- 关键字搜索通常支持按以下信息检索:
- ID。
- 连接名称。
- 主机信息。
- DB IP。
- 服务名。
- 用户名。
- 备注。
- 表格表头支持三态排序:
- 降序。
- 升序。
- 恢复默认顺序。
常见使用场景
- 值班人员在早班前执行“上班巡检”,快速掌握数据库总体健康状态。
- 运维人员在下班前执行“下班巡检”,完成例行归档。
- 管理员配置“每周巡检”或“每月巡检”,形成周期性巡检记录。
- 故障处理前后分别执行巡检,对比数据库健康变化情况。
使用注意事项
-
- 当前版本数据库巡检已实际支持 Oracle 数据库。
-
- 巡检依赖已配置的数据库连接信息,请确保连接参数正确。
-
- 若巡检失败,可优先检查数据库连接、监听端口、服务名、账号权限等配置。
-
- 若历史记录中没有可打开的输出路径,说明该条历史未成功记录报告文件位置。
-
- 建议定期结合“定期巡检”功能,形成固定巡检机制。
6.9、数据库部署

数据库部署说明
- 数据库部署功能用于对目标主机执行数据库安装与初始化配置,支持按步骤生成部署计划、执行部署前校验,并记录部署任务、日志文件和历史结果,便于数据库环境交付、标准化安装和后续追溯。
功能描述
数据库部署页面提供以下能力:
- 新建数据库部署任务。
- 按部署向导配置基础参数、主机连接、安装介质和数据库参数。
- 在正式部署前执行自动校验,提前发现环境问题。
- 启动部署流程并记录执行日志。
- 按数据库类型、任务关键字或目标信息筛选历史任务。
- 展示部署目标信息和部署计划摘要。
- 保留部署历史记录,便于追踪和审计。
部署结果说明
当前数据库部署任务通常围绕以下内容展开:
- 部署目标主机信息。
- SSH 接入信息。
- 数据库类型。
- 数据库版本。
- 部署模式。
- 主机操作系统类型。
- 数据库软件用户。
- 监听端口。
- 安装目录与数据目录。
- 部署前校验状态。
- 部署执行日志与历史记录。
部署页面布局
页面主要分为以下区域:
- 部署统计卡片:显示部署目标、部署模式、校验状态和历史记录数量。
- 操作区:包括“新建任务”、“执行部署前校验”、“启动部署流程”、数据库类型筛选和关键字搜索。
- 提示区:显示当前 License 允许的数据库部署类型。
- 部署配置区:按步骤配置部署参数。
- 部署目标区:展示当前任务的目标主机、版本、端口等信息。
- 部署计划摘要区:展示本次部署生成的核心计划内容。
使用前提
使用数据库部署功能前,需要先确认以下条件:
- 已完成目标主机准备,并具备可用的 SSH 连接信息。
- 已明确数据库类型、版本和部署模式。
- 已准备好数据库安装介质或安装目录。
- 已确认数据库软件用户、监听端口、安装目录和数据目录等基础信息。
- 当前 License 已授权对应数据库类型的部署能力。
部署对象信息
部署任务通常会使用或展示以下字段:
- 任务名称或备注。
- 目标主机 IP 或主机名。
- SSH 端口。
- SSH 用户。
- 数据库类型。
- 数据库版本。
- 主机操作系统。
- 数据库名称。
- 数据库软件用户。
- 监听端口。
- 安装目录。
- 数据目录。
- 安装介质目录。
使用说明
- 进入“数据库部署”页面。
- 点击“新建任务”开始配置部署任务。
- 按向导依次填写“基础参数”、“主机连接”、“安装介质”、“数据库参数”。
- 完成配置后,先执行“部署前校验”。
- 校验通过后,再点击“启动部署流程”。
- 部署执行过程中,系统应记录执行状态和相关日志。
- 部署完成后,可在历史记录中查看任务结果。
手动部署操作说明
- 在基础参数中选择部署模式、数据库类型、数据库版本和主机操作系统。
- 填写备注信息,说明当前任务用途。
- 在主机连接步骤中配置目标主机连接参数。
- 在安装介质步骤中填写数据库安装介质所在目录。
- 在数据库参数步骤中填写数据库名、软件用户、监听端口、安装目录和数据目录等内容。
- 先执行部署前校验,确认环境满足要求。
- 启动部署流程,等待系统完成安装与配置。
部署前校验说明
部署前校验用于在正式执行前确认目标环境是否满足部署条件,通常包括以下检查项:
- 目标主机连接是否可达。
- SSH 登录信息是否有效。
- 操作系统版本是否符合要求。
- 安装目录或介质目录是否存在。
- 端口、用户或目录配置是否合理。
- 当前部署参数是否完整。
校验未通过时,不建议直接启动部署流程,应先修正配置后重新校验。
部署历史说明
部署历史区域用于记录数据库部署任务结果,通常包括以下内容:
- 任务名称。
- 数据库类型。
- 部署目标。
- 部署模式。
- 校验状态。
- 执行状态。
- 日志文件。
- 创建时间或开始时间。
历史展示规则
- 页面默认展示当前筛选条件下的部署历史记录。
- 可按数据库类型过滤历史任务。
- 可通过任务名、目标主机、版本或日志文件关键字进行搜索。
- 历史记录可用于后续排查、复核和交付留档。
页面辅助功能
为了便于快速完成部署任务,页面还提供以下辅助能力:
- 部署目标信息实时汇总展示。
- 部署计划摘要自动生成。
- 部署前校验状态独立展示。
- 历史记录数量快速统计。
- 关键字搜索与数据库类型筛选。
6.10、设置
设置页面说明
- “设置”页面用于管理应用外观、通用行为、访问安全、监控阈值、授权注册和版本信息。页面左侧为标签导航,右侧为对应设置内容。用户点击左侧标签后,可切换到相应功能页。
当前设置页面包含以下标签页,下面会详细介绍每个标签页的功能:
- 主题设置
- 通用设置
- 安全设置
- 阈值设置
- 注册
- 关于
6.10.1、主题设置

- 主题设置用于切换应用界面的整体视觉风格。用户点击任意主题卡片后,主题会立即生效。
当前提供的主题
当前提供的主题包括:
- 默认
- 经典紫
- 深色蓝
- 森林绿
- 日落橙
- 海洋青
- 篯净白
使用说明
主题卡片会显示预览图,便于用户直观选择。
- 当前已启用的主题会显示选中标记。
- 主题切换后立即应用,无需重启软件。 适用场景:
- 希望根据个人偏好调整界面风格。
- 需要在浅色、深色或彩色风格之间切换,以适配不同使用环境。
6.10.2、通用设置

- 通用设置用于控制应用的基础行为,包括语言、自动刷新、通知、滚动条同步和监控快照保留策略。
语言
- 语言设置用于切换应用显示语言。
可选项
- 中文
- English
说明
- 语言切换后会立即生效。
- 适合中英文用户根据使用习惯自行调整。
刷新间隔
- 刷新间隔设置用于设置数据自动刷新的时间间隔。
可选项
- 关闭
- 实时
- 5秒
- 15秒
- 30秒
- 60秒
- 输入值(秒)
说明
- 选择“关闭”后,应用不再自动刷新数据。
- 选择固定秒数后,应用会按该周期自动刷新。
- 选择“输入值(秒)”后,可手工输入自定义刷新间隔。
- 自定义输入必须为大于 0 的数字。
注意事项
- 当用户选择“实时”时,系统会弹出风险提示,提醒实时刷新可能影响数据库性能。
- 只有在用户确认后,实时刷新才会真正启用。
- 如果取消,则会恢复到之前的刷新设置。
说明
- 启用后,重要事件发生时会显示通知。
- 关闭后,应用将不再主动弹出通知提示。
启动时同步系统滚动条设置
- 仅在 macOS 系统中显示。
说明
- 启用后,应用启动时会同步 macOS 的全局滚动条显示策略。
- 适合希望应用滚动条行为与系统外观保持一致的用户。
系统滚动条显示方式
- 仅在 macOS 系统中显示,且需要先开启“启动时同步系统滚动条设置”。
可选项
- 自动
- 滚动时
- 总是
说明
- 该设置对应 macOS 系统“外观”中的滚动条显示方式。
- 修改后系统会提示“请重启软件后使滚动条显示方式完全生效”。
自动清理历史快照
- 用于控制是否自动删除过期监控快照。
说明
- 启用后,系统会根据保留天数自动清理旧的监控快照。
- 关闭后,系统不会自动清理历史快照。
历史快照保留天数
- 用于设置监控快照的保留时间。
说明
- 只有在启用“自动清理历史快照”后,该项才可编辑。
- 可设置范围为 1-3650 天。
- 系统会只保留最近 N 天的快照,超期数据会被自动清理。
6.10.3、安全设置

- 安全设置用于管理“启动访问密码”,用于增强应用启动时的访问控制。
说明
- 应用完成初始化后,会根据此处配置决定是否在启动时要求输入访问密码。
- 该功能依赖授权状态,未完成授权注册时,启动访问密码流程不会启用。
启动访问密码状态
状态显示:
- 已设置
- 未设置
说明:
- 用于显示当前设备是否已经配置启动访问密码。
最近修改时间
说明:
- 显示最近一次更新启动访问密码的本地时间。
- 仅在已经设置过密码时显示。
创建或修改启动访问密码
- 如果尚未配置密码,页面显示“创建启动访问密码”;如果已配置,则显示“修改启动访问密码”。
输入项包括:
- 当前访问密码
- 新访问密码
- 确认新访问密码
规则说明:
- 首次创建密码时,无需输入当前密码。
- 修改密码时,必须先输入当前密码。
- 两次输入的新密码必须一致,否则无法保存。
超级密码说明
说明:
- 如果忘记当前访问密码,可在应用下次启动时使用超级密码解锁。
- 解锁成功后,系统会强制要求重新设置新的访问密码。
超级密码获取:
- 请联系作者:aaronqlm@icloud.com
注意事项:
- 未完成授权注册时,安全设置页会提示当前不可启用此流程。
- 未授权状态下,密码配置区域会处于不可用状态。
6.10.4、阈值设置

- 阈值设置用于定义监控卡片的状态判定标准。系统会根据“警告阈值”和“严重阈值”判断监控指标的风险等级。
CPU 使用率阈值
- 单位:%
- 用途:用于 CPU 监控卡片的状态判定
- 建议:严重阈值应高于警告阈值
内存使用率阈值
- 单位:%
- 用途:用于内存监控卡片的状态判定
- 建议:严重阈值应高于警告阈值
磁盘 I/O 阈值
- 单位:IOPS(读写)
- 用途:用于磁盘 I/O 卡片状态判定
存储/表空间阈值
- 单位:%
- 用途:用于表空间使用率状态判定
网络延迟阈值
- 单位:ms
- 用途:用于网络延迟卡片状态判定
使用说明:
- 每个指标均可设置两档阈值:
- 警告阈值
- 严重阈值
- 当实际指标达到或超过阈值时,系统会在仪表盘中以不同状态进行提示。
- 建议始终将严重阈值设置为高于警告阈值,以便形成清晰的风险分级。
6.10.5、注册

- 注册页用于查看当前授权信息,并导入授权文件完成软件注册。
授权信息展示
页面会显示以下内容:
- 本机机器码
- 授权文件路径
- 当前授权状态
- 授权用户
- 用户邮箱
- 数据库授权范围
- 授权 ID
- 有效期
当前授权状态可能包括:
- 已授权
- 未找到授权文件
- 授权已过期
- 授权文件无效
- 授权与当前机器不匹配
- 未知状态
导入授权文件
- 用户点击“选择授权文件”后,可选择本地授权文件进行导入。
支持文件类型
- .dat
说明:
- 选择文件后,系统会自动开始校验并导入。
- 导入成功后,授权状态会立即更新。
- 若授权文件无效、过期或与当前机器不匹配,页面会显示对应错误信息。
退出
- 页面会提供“退出”按钮。
- 说明:
- 当用户尚未完成授权,或当前不准备继续操作时,可直接退出应用。
6.10.6、关于

- 关于页用于查看软件基础信息和本地配置路径。
dbakit.db 为应用本地数据库文件,用于保存软件配置、数据库连接配置、监控数据、快照等信息,如果软件升级,请不要手动删除该文件,否则会导致数据丢失。