DBX

配置 AI 供应商后，在 DBX 中生成 SQL、解释查询、优化语句并辅助修复错误。

AI 助手用于辅助 SQL 工作。它会结合当前连接的数据库元数据理解表结构和字段，再根据你的描述生成 SQL、解释查询、给出优化建议或帮助修复错误。

AI 生成的 SQL 不会自动执行。请在执行前检查表名、字段名、筛选条件和影响范围，尤其是在生产环境连接上。

配置

打开设置

进入 DBX 设置页，找到 AI 相关配置。

选择供应商

选择 Anthropic、OpenAI 或兼容 OpenAI API 的自定义端点。

填写凭据

输入 API Key。使用自定义端点时，还需要填写接口地址和模型名称。

保存并测试

保存配置后回到编辑器，尝试用自然语言生成一条简单查询。

如果没有配置 API Key，AI 功能应向用户提示需要先完成设置，而不是静默失败。

Ask 模式与 Agent 模式

模式	行为	执行
Ask	生成 SQL、解释、修复、优化、方言转换或样例数据	不暗示已经执行
Agent	当用户明确要求查询数据时，优先生成一条可执行 SQL	DBX 会先评估生成 SQL，再决定是否尝试执行

Schema 上下文

AI 提示可以包含当前数据库类型、连接名称、数据库、当前 SQL、最近错误、结果预览和 Schema 上下文。Schema 上下文包含表、字段、索引和外键。

当 Schema 很大时，DBX 会截断上下文。可以在提示中使用 @table 或 @schema.table 明确提到表名，让 AI 优先围绕这些表推理。

SQL 安全策略

SQL 类型	DBX 行为
`SELECT`、`WITH`、`SHOW`、`DESCRIBE`、`DESC`、`EXPLAIN` 等只读语句	用户明确表达查询意图时，Agent 模式可自动执行
`INSERT` 或按键限定的 `UPDATE` 等低风险写入	只在明确非生产环境自动执行；其他情况需要确认
多语句、`DELETE`、`MERGE`、`REPLACE`、`CREATE` 或未知 SQL	执行前需要确认
`DROP`、`TRUNCATE`、`ALTER`、`RENAME` 或大范围 `UPDATE` 等危险语句	会被 AI 执行策略阻止

连接名、主机或数据库名看起来像生产环境时，DBX 会更保守。AI 生成的 SQL 仍然是模型输出，请像审查代码一样审查它。

常见用法

生成 SQL

用自然语言描述目标，AI 会结合当前连接的元数据生成查询：

查看最近 30 天订单金额最高的 10 个客户

可能生成：

SELECT c.name, SUM(o.amount) AS total_amount
FROM customers c
JOIN orders o ON c.id = o.customer_id
WHERE o.created_at >= NOW() - INTERVAL 30 DAY
GROUP BY c.id, c.name
ORDER BY total_amount DESC
LIMIT 10;