帮你快速理解、总结文档立即下载

使用 WorkBuddy 进行自然语言查询与日常巡检

最近更新时间:2026-07-22 10:44:01

我的收藏
WorkBuddy 是一款腾讯开发的 AI 智能体工作台,可以通过 MCP(Model Context Protocol,模型上下文协议)连接外部工具和数据源。通过配置适用于 PostgreSQL 的 MCP Server,用户可以使用自然语言辅助完成云数据库 PostgreSQL 的数据查询、SQL 分析和日常巡检等工作。
本文介绍 WorkBuddy 连接云数据库 PostgreSQL 后,用自然语言完成数据查询、SQL 分析和日常巡检的典型场景和注意事项。
说明:
WorkBuddy 生成的 SQL 和分析结论仅作为辅助参考。生产环境中的 SQL 应由用户确认后执行,涉及数据变更的操作应遵循业务发布和数据库变更规范。

前提条件

开始前,请完成以下准备工作:
创建云数据库 PostgreSQL 实例,并获取实例的连接地址、端口和数据库名称。
PostgreSQL MCP Server 的运行环境与数据库网络互通。位于同一私有网络时,建议通过内网地址连接。
已为 WorkBuddy 创建独立的普通数据库账号,并根据实际任务授予所需权限。数据分析和巡检场景建议默认使用只读权限。
WorkBuddy 所在设备已安装 Node.js,并可以执行 npx 命令,也可以让 WorkBuddy 自己去安装。
云数据库 PostgreSQL 支持在控制台的数据库管理 > 账号管理页面创建账号和配置对象权限。网络连接还需要确保实例安全组已放通 MCP Server 运行环境的访问地址和数据库端口。

配置 PostgreSQL MCP Server

本文以腾讯云开发者 MCP 广场收录的 PostgreSQL MCP Server 为例。该服务支持检查数据库表结构和执行只读查询,所有查询均在只读事务中执行。

步骤1:准备连接信息

登录 云数据库 PostgreSQL 控制台,进入目标实例的实例详情页面,获取以下信息:
内网或外网连接地址。
数据库端口,默认为5432。
需要访问的数据库名称。
专用普通账号及密码。
建议优先使用内网连接。使用外网连接时,应限制安全组来源地址,避免直接向所有公网地址开放数据库端口。

步骤2:打开 MCP 配置

在 WorkBuddy 侧边栏选择专家·技能·连接器,选择连接器,单击自定义连接器,进入 MCP 服务管理页面,选择配置 MCP。
在此页面,可以将腾讯云数据库的 MCP 配置填写进去。

数据库连接信息中包含凭证,建议使用用户级配置,并妥善保护配置文件。不要将包含真实密码的配置提交到代码仓库。

步骤3:填写 MCP 配置

macOS 或 Linux 环境可以使用以下配置:
{
"mcpServers": {
"tencentdb-postgresql": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://<账号>:<密码>@<连接地址>:<端口>/<数据库名>"
]
}
}
}
Windows 环境需要通过 cmd 调用 npx:
{
"mcpServers": {
"tencentdb-postgresql": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://<账号>:<密码>@<连接地址>:<端口>/<数据库名>"
]
}
}
}
将尖括号中的内容替换为实际连接信息。如果密码包含 @、:、/、# 或 ? 等 URL 特殊字符,需要先进行 URL 编码。实例启用 SSL 后,还需要按照云数据库 PostgreSQL 的 SSL 连接要求配置连接参数。
注意:
示例使用的是开源 MCP Server。正式用于生产环境前,请评估其来源、版本、权限范围和安全风险,并使用独立的只读数据库账号控制访问范围。

步骤4:验证连接

保存配置后,在 WorkBuddy MCP Server 列表中查看状态。绿色表示连接成功;红色表示配置异常,应依次检查 node 和 npx 命令、JSON 格式、网络和安全组、连接地址以及账号密码。
连接状态正常后,输入以下指令进行验证:
请连接 PostgreSQL 数据库,仅执行只读操作,并返回当前数据库名称和数据库版本。

WorkBuddy 返回当前数据库名称和版本后,表示 MCP Server 已能够访问实例。建议先使用测试实例或非核心数据库验证连接、权限和 SQL 执行范围,再用于生产环境。

典型使用场景

场景
适合解决的问题
主要产出
梳理数据库结构
新接手数据库,不清楚 Schema、表和字段的用途
数据库结构概览、数据字典
自然语言查询数据
有明确的业务问题,但不熟悉 SQL 或表结构
查询 SQL、结果表格、分析摘要
SQL 开发和性能分析
需要编写 SQL 或理解执行计划
SQL 草稿、执行计划说明、优化建议
日常巡检
需要快速了解连接、事务、锁和容量情况
巡检摘要、异常项和处理建议

梳理数据库结构和生成数据字典

接手新的云数据库 PostgreSQL 实例时,用户通常需要先了解实例中有哪些 Schema 和数据表,以及主要字段之间的关系。WorkBuddy 可以通过 MCP Server 读取数据库元数据,并在账号权限范围内查询 PostgreSQL 系统目录,整理表、字段、数据类型、主键、外键和索引等信息。
例如:
请以只读方式分析当前数据库:
1. 列出所有业务 Schema 和数据表。
2. 重点分析 public Schema 中的 orders、order_items 和 customers 表。
3. 整理字段、数据类型、主键、外键和索引信息。
4. 生成 Markdown 格式的数据字典,并说明表之间的关系。
不要查询或展示表中的业务数据。

WorkBuddy 可以输出数据库结构概览和数据字典,帮助开发人员快速熟悉数据库。生成结果来自数据库元数据,字段的实际业务含义仍需结合系统设计文档或研发人员确认。

自然语言查询和分析数据

当用户有明确的数据分析目标,但不熟悉表结构或 SQL 时,可以直接用自然语言描述需求。WorkBuddy 会先读取相关表结构,再生成只读 SQL;用户确认后执行查询,最后将结果整理为表格和分析摘要。
例如:
请先查看订单相关表的结构,再完成以下分析:
1. 统计最近 7 天每天的订单数量和成交金额。
2. 计算订单数量和成交金额的日环比变化。
3. 只生成 SELECT 语句,执行前先展示 SQL
4. 执行后以表格展示结果,并用三句话总结变化趋势。
一次完整的输出应包含实际执行的 SQL、查询结果以及基于结果生成的摘要,便于用户检查分析口径。该场景适合临时查数、数据核对和趋势分析。对于数据量较大的表,建议在指令中明确时间范围、过滤条件和返回行数,避免生成开销过大的查询。


辅助 SQL 开发和性能分析

WorkBuddy 可以结合云数据库 PostgreSQL 中的字段类型、表关联和索引信息,辅助编写查询 SQL。对于已有 SQL,可以让 WorkBuddy 执行 EXPLAIN 并解释扫描方式、连接顺序、估算行数和代价较高的节点。
例如:
请结合 orders 和 order_items 的表结构分析下面的 SQL
1. 检查连接条件和过滤条件是否正确。
2. 执行 EXPLAIN,不要执行 EXPLAIN ANALYZE
3. 说明扫描方式、连接顺序、估算行数和索引使用情况。
4. 给出优化建议和建议的验证方法,不要直接创建或删除索引。
输出内容可以包括 SQL 问题说明、执行计划解读、改写后的 SQL 以及索引建议。WorkBuddy 可以帮助识别全表扫描、大量数据读取、排序或连接开销等问题,但建议仍需结合实际数据分布、业务访问模式和实例负载进行验证。普通 EXPLAIN 展示的是估算开销;EXPLAIN ANALYZE 会实际执行目标 SQL,不建议直接对生产环境中的高开销语句使用。


生成日常巡检摘要

通过查询 pg_stat_activity、pg_locks 等 PostgreSQL 运行状态视图,WorkBuddy 可以辅助检查连接、长事务和锁等待。还可以使用 PostgreSQL 容量函数统计当前数据库和主要数据表的空间占用,并将结果整理为巡检摘要。
例如:
请以只读方式完成一次数据库巡检:
1. 按连接状态统计当前连接数。
2. 找出持续时间超过 10 分钟的事务。
3. 检查锁等待,并说明等待会话和阻塞会话。
4. 统计当前数据库容量和占用空间最大的 10 张表。
5. 输出检查结果、异常项、可能影响和建议处理方式。
不要终止会话,也不要修改数据库参数。
巡检结果可以按“检查项、当前状态、是否异常、处理建议”组织成表格,便于日常留档。普通数据库账号能够查看的会话和统计信息可能受到权限限制,应根据巡检范围配置必要的只读监控权限。

PostgreSQL MCP Server 主要获取数据库内的信息,不能直接替代云数据库 PostgreSQL 控制台的 CPU、内存、存储 I/O、告警和慢查询分析能力。发现异常后,建议结合控制台监控和诊断数据进一步确认。

安全使用建议

遵循最小权限原则。为 WorkBuddy 创建独立账号,仅授予目标数据库、Schema 和数据表的必要权限。
默认限制为只读操作。查询类任务应明确只允许执行 SELECT。INSERT、UPDATE、DELETE、DDL 和会话终止等操作应经过人工确认。
妥善保管连接凭证。不要在对话指令、截图或共享文档中填写明文密码,建议使用 MCP Server 支持的环境变量或安全凭证管理方式。
控制查询影响。对查询设置合理的时间范围、返回行数和执行超时,避免复杂 SQL 对生产实例造成额外负载。
检查生成内容。执行 WorkBuddy 生成的 SQL 前,应检查访问对象、查询条件和预估影响,重要操作应先在测试环境验证。

总结

通过 PostgreSQL MCP Server,WorkBuddy 可以使用自然语言辅助访问云数据库 PostgreSQL,降低临时查数、SQL 分析和日常巡检的操作门槛。实际使用时,建议从只读场景开始,通过专用账号、最小权限和人工确认机制控制风险,并继续使用云数据库 PostgreSQL 控制台完成实例监控、告警和管理操作。

相关文档