连接到数据库。支持 MySQL、MariaDB、PostgreSQL、SQLite、MSSQL、Oracle。传入连接参数后会建立新连接,之前的连接会被自动关闭。SQLite 只需要传 filepath 参数;PostgreSQL/MSSQL/Oracle 可通过 schema 指定命名空间,不传则列出所有非系统 schema;Oracle 的 database 参数表示 service name 或 TNS connect string;MSSQL 在 SQL Server 2019+ 默认要求加密,自签证书环境需将 trustServerCertificate 设为 true。连接成功后返回当前数据库的表信息列表与当前权限模式(权限模式仅由 server 启动配置决定,无法通过此工具修改)。

主动断开当前数据库连接并释放连接池。断开后再次执行 query / execute 等操作前需调用 connect 工具重新连接。未连接时调用也安全(幂等)。

查看当前数据库连接的状态，返回是否已连接、数据库类型、ping 健康度（实测耗时）、表信息列表以及权限模式。LLM 在长时间未操作后或捕获到执行失败时可调用此工具确认连接可用性。

执行只读 SQL 查询(SELECT / SHOW / DESCRIBE)。响应最多返回前 1000 行,并通过 limit 字段告知本次返回上限;超过 QUERY_TIMEOUT_MS 会失败。执行计划请使用 explain 工具。

执行单条写操作。在 readwrite 模式下仅支持 DML(INSERT / UPDATE / DELETE);在 full 模式下额外支持 DDL(DROP / TRUNCATE / ALTER / CREATE / GRANT / REVOKE);readonly 模式禁用此工具。

在数据库事务中按顺序执行一组 SQL。任一语句失败则整体回滚;全部成功才提交。权限规则与 execute 一致:readonly 禁用;readwrite 仅 DML;full 支持 DML + DDL。常用于多步写操作的原子性保证(如转账、订单创建)。

列出当前连接数据库的所有表名与表注释。tables 字段为包含 schema/name/comment 的结构化列表。PostgreSQL/MSSQL/Oracle 未配置 schema 时返回所有非系统 schema 的表,已配置 schema 时只返回该 schema 的表。

查看指定表的详细信息,一次返回:列定义/索引/外键/估算行数/数据采样。PostgreSQL/MSSQL/Oracle 跨 schema 同名表时应传 schema 精确定位。LLM 在写 SQL 前调用此工具可同时拿到字段结构、关联关系、表大小量级、字段真实取值示例,大幅减少猜测。

按关键词搜索当前数据库 schema,匹配表名、列名和字段类型。适合在大库中快速定位相关表或字段,响应最多返回前 50 个命中项。

获取 SQL 的执行计划，辅助分析查询性能与优化。所有权限模式下均可调用（EXPLAIN 不实际执行原 SQL）。仅支持 SELECT / INSERT / UPDATE / DELETE / WITH 开头的语句；无需自带 EXPLAIN 前缀，适配器内部统一拼接。