数据库工作台
数据库工作台
文档指南
请输入
- 文档首页
数据库工作台最佳实践如何借助 Database-skill 实现 Agent 的智能查询、数据分析与故障排查
复制全文
下载 pdf如何借助 Database-skill 实现 Agent 的智能查询、数据分析与故障排查
文档反馈
问问助手Database-skill 能够将数据库能力从仅供数据库管理员（DBA）使用转变为可供所有人使用。每位开发者、产品人员以及运营人员均能够直接进行数据库查询、生成报告以及排查故障，无需寻求他人帮助、无需等待工单处理，也无需记忆 SQL 语句。本文介绍如何借助 Database-skill 实现智能查询、数据分析以及故障排查等功能。
背景信息
Database-skill 面向支持 Agent Skills 协议的智能助手，提供数据库查询、数据分析与故障排查能力，可将复杂的数据库运维操作整合进对话式工作流。接入后，您可通过自然语言描述意图，由 Agent 自动编排并执行数据探查、查询分析、故障诊断和优化建议等任务。
当前已支持 OpenClaw、Trae-CN、ArkClaw。其他兼容 Agent Skills 协议的 Coding Agent 也具备接入基础，具体可用性以实际适配与验证结果为准。
流程概述
支持 Agent Skills 协议的智能助手，例如 OpenClaw、Trae-CN、ArkClaw 实现了从“按钮驱动”向“意图驱动”的交互范式升级。在控制台中，您无需再寻找具体的操作入口，只需直接表达业务诉求即可。其底层采用三层协作架构：
- 指令解析层：由支持 Agent Skills 协议的智能助手例如 OpenClaw、Trae-CN、ArkClaw 负责承接您的自然语言输入，精准理解并提取核心意图。
- 能力路由层：Database-skill 作为中间枢纽，负责将解析后的意图精准分发至对应的数据库处理能力。
- 执行引擎层：由数据库工作台或数据源连接模块接管，最终落地执行具体的查询、分析及诊断动作。
支持的功能
- 元数据探查：支持实例与数据库列表浏览，深度解析表结构与字段级信息。
- 数据分析：提供自然语言查数、多维统计分析、可视化报告生成及多源联合查询能力。
- 运维诊断：覆盖慢查询分析、死锁/锁等待排查、表空间监控、错误日志检索及自动化健康巡检。
- 开发变更：支持 DML/DDL 工单创建、审批流程跟踪以及 SQL 规范自动校验。
- 数据治理：实现全局资产盘点、数据画像构建、数据质量检查及敏感数据安全扫描。
使用场景
场景 | Agent 可以帮您做的事 |
智能查询 | 查看实例、列数据库、查表结构、读取样例数据、按自然语言生成查询。 |
数据分析 | 围绕趋势、聚合、分布、关联关系做数据分析，并生成可视化报告。 |
故障排查 | 针对查询变慢、慢 SQL、连接数打满、资源水位异常等问题执行标准排查路径，并给出优化建议。 |
优势
- 告别多端切换：无需在控制台、Grafana、工单系统间反复跳转，一个对话框完成所有数据库操作。
- 降低专业门槛：无需死记硬背表结构和复杂 SQL 语法，自然语言直接转化为精准查询与图表。
- 智能辅助决策：不仅能查出慢查询，还能自动关联上下文给出专业的优化建议。
- 流程极简闭环：从数据洞察到变更申请，通过对话即可完成闭环，大幅缩短排障与运维链路。
前提条件
在开始安装和配置之前，请确保您已完成以下准备工作：
- 服务开通：您需要拥有一个火山引擎账户，并已开通数据库工作台 DBW 服务。如未开通，请访问火山引擎数据库工作台 DBW 服务开通页面。
- 实例接入：您的实例已被接入到 DBW 控制台。详细操作，请参见接入实例。
- 权限申请：申请成为 DBW 的管理员。同时，还需申请对应实例的访问权限。详细操作，请参见角色权限申请及后续操作。
- 获取访问密钥：为了让已接入 Database-skill 的智能助手能够通过 API 与火山引擎服务进行交互，您需要生成并获取访问密钥。
- 登录火山引擎访问控制控制台。
- 在 API访问密钥管理页面。
- 创建或获取一对有效的 Access Key ID 和 Secret Access Key。这两个值将分别对应后续配置中的 VOLCENGINE_ACCESS_KEY 和 VOLCENGINE_SECRET_KEY。
- 同时，请记下您资源所在的地域（Region），例如 cn-beijing。
安装 Database-skill
本文主要以 OpenClaw 和 ArkClaw 为例介绍如何安装 Database-skill。除上述助手外，Trae-CN 等支持 Agent Skills 协议的通用助手同样可以加载 Database-skill，若安装入口或命令格式不同，请以对应助手的接入方式为准。
- 安装 Node.js 22+。详细信息，请参见 Node.js。
- 安装 OpenClaw
- 根据操作系统选择合适的命令安装 OpenClaw
- macOS 和 Linux 操作系统：
- curl -fsSL https://openclaw.ai/install.sh | bash
- Windows 操作系统（使用 PowerShell）：
- iwr -useb https://openclaw.ai/install.ps1 | iex
- 执行以下命令初始化 OpenClaw，并根据提示进行依次配置。
- openclaw onboard --install-daemon
- 安装成功后您可以执行 openclaw --version 命令验证是否成功安装。
- 安装 Database-skill。
- 执行以下命令安装 Database-Skill。
- npx skills add https://skills.volces.com/skills/volcengine/agentkit-samples -s database-skill
- 对于需要显式配置凭证的环境，可以通过环境变量或同级 .env 文件提供以下配置：
-
说明
如果您经常查看某个固定实例，可以提前配置默认地域、实例和数据库，后续很多问题就可以直接省略上下文，提问会更顺手。
- 登录 ArkClaw 控制台。
- 发起 ArkClaw 任务。详细操作，请参见发起任务。
- 安装 Database-skill。
- 在左侧导航栏，选择技能中心。
- 在技能广场页面，找到 Database-skill，单击添加。
- 在 ArkClaw 的对话框中，输入以下信息：
- VOLCENGINE_ACCESS_KEY — 火山引擎 Access Key
- VOLCENGINE_SECRET_KEY — 火山引擎 Secret Key
- VOLCENGINE_REGION（可选，默认 cn-beijing）— 实例所在地域。
使用示例
您可以复制以下表格内的 Prompt 后替换对象名进行智能查询、数据分析和故障排查。
场景 | 可直接使用的 Prompt |
元数据探查 | 帮我看看 [instance_id] 里 [database] 有哪些表，再展示 [table] 的结构。 |
明细查询 | 在 [instance_id] 的 [database] 上查 [table] 最近 100 条记录。 |
趋势分析 | 分析 [instance_id] 的 [database] 的 [table]，按天统计最近 7 天的订单量，输出 HTML 报告。 |
多源联合 | 把 MySQL 实例的订单数据、PostgreSQL 实例的用户画像、本地 marketing_data.xlsx 的投放数据联合起来，分析各渠道 ROI。 |
慢查询排查 | [instance_id] 最近 8 小时有哪些慢查询？给优化建议。 |
健康巡检 | 对 [instance_id] 做一次完整巡检，给出 P0/P1/P2 处置建议。 |
智能查询不是单纯的帮您写 SQL，而是让 Agent 先理解您的目标，再自动补齐中间的步骤，例如：先列示例、再查询表、再查询结构，最后跑查询。
推荐提问方式如下所示：
- 查看示例：帮我列一下 cn-beijing 的数据库实例。
- 查看表结构：帮我看看 [instance_id] 里 [database] 有哪些表，再展示 [table] 的结构。
- 查样例数据：在 [instance_id] 的 [database] 上查 [table] 最近 100 条记录。
- 带业务条件查询：帮我查 [table] 最近 7 天新增订单里，状态为已支付的数据。
说明
- 建议您在问题中带上实例 ID、数据库名、表名，这样命中会更快。
- 如果您要查趋势，最好明确时间范围，例如“最近 7 天”“最近 1 个月”。
- 如果您要看明细，最好说明行数，例如“最近 100 条”。
- 如果您要做统计，最好补充指标，例如“按天统计订单量”“统计支付成功率”。
数据分析这里包含业务数据分析和数据库侧性能观察两类能力，具体如下所示：
- 业务数据分析：比如销售趋势、订单变化、渠道 ROI、用户分层。
- 数据库侧性能观察：比如慢查询分布、热点表、资源使用风险。
推荐提问方式如下所示：
- 分析 [instance_id] 的 [database] 的 [table]，按天统计最近 7 天的订单量，输出 HTML 报告。
- 分析 mysql-abc123 的 mydb 的 orders 表近一个月的销售趋势，给我个具有丰富可视化的 HTML 报告。
- 把 MySQL 实例的订单数据、PostgreSQL 实例的用户画像、本地 marketing_data.xlsx 的投放数据联合起来，分析各渠道 ROI。
说明
建议把一个分析请求拆成四要素：
- 对象：哪个实例、哪个库、哪张表。
- 时间范围：最近 7 天、最近 30 天、本月。
- 指标：订单量、GMV、成功率、延迟、错误数。
- 输出形式：是否要图表、是否要 HTML 报告、是否要结论摘要。
故障排查场景适合于问题已发生、但您还没来得及逐个平台排查时使用。您可以先用一句自然语言描述现象，让 Agent 自动跑标准排查路径。具体问法如下所示：
- 查询变慢：[instance_id] 最近 8 小时有哪些慢查询？给优化建议。
- 泛化排查：[instance_id] 的查询有些慢啊，帮我排查下。
- 巡检式排障：对 [instance_id] 做一次完整巡检，给出 P0/P1/P2 处置建议。
FAQ
Q：支持哪些 Agent？
- 目前支持 OpenClaw、Trae-CN、ArkClaw。其他支持 Agent Skills 协议的 Coding Agent 理论上都可以使用。
Q：会不会误操作写入数据？
- 不会。Skill 严格限制为只读操作，所有写操作（DDL / DML）都通过工单平台执行。Agent 会帮您生成写操作 SQL 并引导您走工单流程。
Q：如何配置 AK/SK？
- 首次使用时助手会自动检测凭证状态并引导配置。AK/SK 可在火山引擎控制台 > 密钥管理中创建。配置后安全存储在本地 .env 文件中，不会在对话中暴露。
Q：支持哪些公网自建数据库？
- 所有兼容 MySQL 或 PostgreSQL 线协议的数据库均可通过标准驱动直接连接，包括 TiDB、OceanBase、CockroachDB、StarRocks、ClickHouse 等 40+ 种。
Q：PostgreSQL 查询要注意什么？
- 表名需使用 schema.table 写法（如 public.users），查询表结构时需指定 schema。
Q：返回空结果，是没有数据还是能力不支持？
- Skill 会明确区分：能力不支持时主动说明并给替代方案；能力可用但数据为空，会提示您"接口正常，请确认查询条件"。不会让您误以为"没数据"。
最近更新时间：2026.06.11 10:29:48
这个页面对您有帮助吗？
有用
有用
无用
无用