工作方式
可以完成什么
- 查询可用的 PawSQL 工作空间;
- 在不使用工作空间时,按数据库类型快速分析 SQL;
- 结合 DDL、索引和约束信息进行更准确的优化;
- 使用现有工作空间的数据库上下文进行优化;
- 获取 SQL 重写和索引优化建议;
- 在连接数据库且允许验证的工作空间中分析执行计划;
- 返回详细报告链接、分析环境和性能评估信息。
选择优化模式
前提条件
- 已有可访问的 PawSQL Cloud、PawSQL Server 或 PawSQL Community Edition;
- 使用支持远程 SSE MCP 服务的 AI 编程工具;
- 已从 PawSQL 管理员或服务提供方取得 MCP SSE 地址;
- 已准备当前部署要求的认证信息;
- 账号具有目标组织、项目和工作空间的访问权限;
- 企业网络允许客户端通过 HTTPS 访问 PawSQL MCP SSE 服务。
配置 PawSQL MCP
1. 获取 SSE 连接信息
PawSQL MCP 只通过 SSE 形式提供服务。配置前,从管理员或 PawSQL 服务提供方取得以下信息:不同 PawSQL Cloud、Server 和 Community Edition 部署的 SSE 地址可能不同。请使用实际环境提供的完整地址,不要根据示例推测端口或路径。
2. 在 MCP 客户端中添加远程服务
不同客户端的设置入口和字段名称不同。对于使用mcpServers 配置远程 SSE 服务的客户端,结构通常如下:
<pawsql-mcp-sse-url> 替换为实际 SSE 地址。如果部署要求认证,请按照 PawSQL 管理员和目标客户端的说明配置凭据或请求头。
3. 重新加载客户端
1
保存配置
检查 JSON 语法、SSE 地址和认证配置。
2
重启或重新加载 MCP
让客户端重新读取配置并连接 PawSQL MCP SSE 服务。
3
检查工具发现结果
在客户端的 MCP 状态或工具列表中确认 PawSQL 已连接且工具可用。
4
执行脱敏测试
先使用非生产 SQL 验证数据库类型、工作空间识别和报告返回是否正常。
第一次优化 SQL
方式一:仅提供 SQL 和数据库类型
适用于快速检查。提示中应明确数据库产品,必要时补充版本。方式二:同时提供 DDL
当无法使用工作空间时,提供相关表、索引和约束的完整定义。方式三:指定工作空间
先让客户端列出可用工作空间,再通过名称或 ID 指定目标环境。工作空间名称相似时,应使用工作空间 ID,并在调用前核对组织、项目、数据库类型和环境。不要根据名称猜测生产或测试环境。
阅读优化结果
建议按以下顺序审阅:- 分析环境:确认数据库类型、版本、工作空间和 Schema;
- 对象识别:确认表、列、索引和约束没有被错误解析;
- SQL 重写:比较过滤条件、连接关系、聚合、排序、空值和重复行语义;
- 索引建议:检查与已有索引的重叠、列顺序、写入成本和存储成本;
- 执行计划:比较访问路径、连接方式、估算行数和代价;
- 性能评估:确认结果来自真实验证还是估算,并检查测试参数是否具有代表性;
- 详细报告:保留报告链接或导出结果,作为评审和回溯依据。
安全采用建议
1
验证语义等价性
使用边界值、空值、重复值和代表性业务数据比较原 SQL 与重写 SQL 的结果。
2
评估索引影响
检查重复索引、DML 开销、磁盘空间、锁等待和数据库特定的在线创建方式。
3
在非生产环境验证
使用接近生产的数据规模、参数分布和统计信息执行多轮测试。
4
完成变更评审
将 SQL 和索引变更纳入代码评审、数据库变更审批及回退计划。
5
受控发布并观察
发布后关注延迟、吞吐量、资源使用和执行计划是否出现回退。