跳到正文
Caravel使用手册

数据与分析

数据库:查询和修改数据

在体验版中试试

连接 MySQL、PostgreSQL、SQLite、MongoDB 和 Redis,写 SQL 查询、浏览表数据,修改数据前会预览并确认,也可以让 AI 帮你写 SQL。

数据库页面

编号 区域 作用
① 新建连接 添加一个数据库连接。
② 对象树 当前连接下的库、表和视图。双击表可以直接查看数据。
③ SQL 编辑器 写 SQL,支持表名和字段名自动补全。上方可以开多个查询标签。
④ 执行 运行 SQL。选中一段 SQL 时只运行选中的部分。
⑤ 结果区 查询结果。可以筛选、排序、查看单行详情和导出。

连接数据库

  1. 点击 新建连接,选择数据库类型(MySQL、PostgreSQL、SQLite、MongoDB、Redis)。
  2. 填写主机、端口、账号、密码等信息。SQLite 只需要选择本地数据库文件。
  3. 点击 测试连接 确认能连上,再保存。

查询数据

  1. 在编辑器中写 SQL,例如 SELECT * FROM orders LIMIT 100;。
  2. 点击 执行,或按 ⌘ + Enter(Windows 为 Ctrl + Enter)。
  3. 在结果区查看数据。点击 导出 可以保存为 CSV、JSON、Excel 等格式。

工具栏

编号 按钮 作用
① 格式化 整理 SQL 的缩进和换行。
② 执行计划 查看数据库打算怎么执行这条 SQL,用于排查慢查询。不会真正执行。
③ Copilot 用自然语言描述需求,让 AI 生成、改写、解释 SQL 或诊断报错。生成的 SQL 不会自动执行,查询结果也不会发送给 AI。
④ 收藏 保存常用查询,以后一键打开。
⑤ 历史 查看执行过的 SQL。
⑥ 只读标记 显示当前连接是否为只读。

修改数据

单表、带主键的查询结果可以直接在表格里修改。

  1. 运行查询后,点击结果区右上角的 编辑数据。

  2. 双击单元格修改,按回车确认。也可以批量粘贴,或点击单元格里的 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。