数据与分析
连接 MySQL、PostgreSQL、SQLite、MongoDB 和 Redis,写 SQL 查询、浏览表数据,修改数据前会预览并确认,也可以让 AI 帮你写 SQL。
数据库页面
| 编号 | 区域 | 作用 |
|---|---|---|
| ① | 新建连接 | 添加一个数据库连接。 |
| ② | 对象树 | 当前连接下的库、表和视图。双击表可以直接查看数据。 |
| ③ | SQL 编辑器 | 写 SQL,支持表名和字段名自动补全。上方可以开多个查询标签。 |
| ④ | 执行 | 运行 SQL。选中一段 SQL 时只运行选中的部分。 |
| ⑤ | 结果区 | 查询结果。可以筛选、排序、查看单行详情和导出。 |
连接数据库
- 点击 新建连接,选择数据库类型(MySQL、PostgreSQL、SQLite、MongoDB、Redis)。
- 填写主机、端口、账号、密码等信息。SQLite 只需要选择本地数据库文件。
- 点击 测试连接 确认能连上,再保存。
从其他工具导入连接
已经在 Navicat、DBeaver 或 DataGrip 中配好连接时,可以点击连接列表顶部的导入按钮(空列表时为 导入连接)批量迁移。
- 选择来源工具和配置文件:Navicat 导出的
.ncx;DBeaver 工作区中的data-sources.json;DataGrip 的dataSources.xml,可同时选择同目录的dataSources.local.xml补充账号。 - 在预览中勾选要导入的连接,展开可修改名称、地址、端口等字段,补填密码,或为这一批统一分组。
- 保存后显示成功、重复跳过和失败的数量,失败项可以重试。
导入只保存配置,不会自动连接,也不会覆盖已有连接;新连接默认只读、不开放给 Agent。源文件中的密码不会导入,Caravel 也不读取系统钥匙串。SSH 隧道、特殊认证等无法迁移的设置会明确标出,需要手动配置。每次最多 200 个连接,配置文件合计不超过 2 MiB。
查询数据
- 在编辑器中写 SQL,例如
SELECT * FROM orders LIMIT 100;。 - 点击 执行,或按
⌘ + Enter(Windows 为Ctrl + Enter)。 - 在结果区查看数据。点击 导出 可以保存为 CSV、JSON、Excel 等格式。
工具栏
| 编号 | 按钮 | 作用 |
|---|---|---|
| ① | 格式化 | 整理 SQL 的缩进和换行。 |
| ② | 执行计划 | 查看数据库打算怎么执行这条 SQL,用于排查慢查询。不会真正执行。 |
| ③ | Copilot | 用自然语言描述需求,让 AI 生成、改写、解释 SQL 或诊断报错。生成的 SQL 不会自动执行,查询结果也不会发送给 AI。 |
| ④ | 收藏 | 保存常用查询,以后一键打开。 |
| ⑤ | 历史 | 查看执行过的 SQL。 |
| ⑥ | 只读标记 | 显示当前连接是否为只读。 |
修改数据
单表、带主键的查询结果可以直接在表格里修改。
运行查询后,点击结果区右上角的 编辑数据。
双击单元格修改,按回车确认。也可以批量粘贴,或点击单元格里的 NULL 设为空值(空字符串和 NULL 是不同的)。主键和二进制字段不能修改。
- ① 编辑模式下按钮变为 退出编辑,点击后放弃全部未提交的修改。
- ② 修改过的行会高亮显示。
- ③ 底部显示待提交的修改数。点击 提交,会按主键生成 UPDATE 语句,整批在一个事务里执行,任何一条出错都会全部回滚;点击 放弃改动 撤销。
复制、导出与复用
右键单元格 可以复制所选内容、查看单行详情、复制整行,或者把当前行复制成 INSERT / UPDATE 语句;可编辑的结果还能按主键删除这一行。
点击结果区右上角的 导出:
- 勾选 含表头 后,复制和导出都会带上列名。
- CSV、JSON、Markdown、SQL、Excel 导出的是当前已取回并经过筛选的行。
- 全量 CSV 和 全量 JSON 会重新执行原始 SQL,分段写入文件并显示进度,适合结果超过显示上限的情况。
常用的 SQL 可以点击工具栏的 收藏 保存,设置名称、标签、是否置顶,以及只在当前连接还是全局可用。历史 按连接、SQL、是否成功和时间筛选执行过的语句,可以在新标签打开、追加到编辑器、复制或转为收藏;清空历史不会删除收藏。
让 Agent 只读访问数据库(MCP)
开启后,Claude Code 等 Agent 可以通过 MCP 只读查询你授权的数据库,例如查表结构、跑 SELECT 帮你排查问题。
点击数据库页面右上角的 MCP:
| 编号 | 区域 | 作用 |
|---|---|---|
| ① | 开放数据库给其它 Agent | 总开关。服务只监听本机 127.0.0.1。 |
| ② | 服务地址 | 手动配置其他 MCP 客户端时复制这个地址。右侧按钮重新生成访问令牌,已接入的 Agent 配置会同步更新。 |
| ③ | 连接授权 | 逐个开放连接,也可以按环境筛选后 全开 / 全关。没开放的连接对 Agent 完全不可见。 |
| ④ | Agent 接入 | 为已安装的 Agent 写入或移除 MCP 配置,新会话开始后生效。 |
MongoDB 和 Redis 的使用方法见 MongoDB 与 Redis。
双击表或视图、从右键菜单选择查看数据时,会向 SQL 编辑器插入带 WHERE 1=1 的 SELECT,便于继续追加筛选条件;此时不会自动执行,检查 SQL 后再点击执行。