用自然语言管理数据，
用性能守住业务底线

Web 管理台 serve

一条命令拉起内置 Web 控制台，浏览器直接建库建表、跑 AI。

# 启动服务，默认监听 127.0.0.1:8080（仅本机）
dbsql --root <数据目录> serve --port 8080
# 纯数据库交付档：不要应用生成，只留数据库 + AI 生成 SQL
dbsql --root <数据目录> serve --apps off
# 浏览器打开 http://127.0.0.1:8080

命令行执行 SQL sql

方言可选 T-SQL / PL/SQL / MySQL，结果支持表格或 JSON 输出。

# 跑一整条 SQL
dbsql sql shop "SELECT name, age FROM users
  WHERE age > 25 LIMIT 10"
# 按表取数（库名 + 表名都必填）
dbsql select shop users --where "age > 25"
# 首次启动自动内置管理员 dbo/admin123，登录后立刻改密
# （或停机时用 CLI 改，数据根独占）
dbsql --root <数据目录> passwd dbo <新密码>

C# 数据提供程序 ADO.NET

DbSql.Data 兼容 ADO.NET，同步 / 异步 / 批量导入全支持。

// 连接串只认这四个关键字
Host=127.0.0.1;Port=8080;
Database=<库>;Dialect=standard
// DbSqlConnection/Command/Reader/Transaction/BulkCopy

数据迁移 import

CSV / JSON / MySQL / PostgreSQL / SQL Server / SQLite 六种源内置直连，Oracle 需启用 oracle feature 编译。

dbsql import --config <配置.json> [--dry-run]

备份与时间点恢复 backup

WAL 保证崩溃不丢数据；备份整个数据根（扩展名固定 .bak），还原与 PITR 前需停机。

dbsql backup [<目标文件.bak>]
dbsql restore <备份文件.bak>
# 快照 + 重放写操作，恢复到指定时刻（旧根不动）
dbsql restore-to <备份文件.bak> --ts "2026-10-13 09:00:00" --new <新根>
dbsql switch --root <旧根> --new <新根>

跨平台构建 cargo

引擎与解析器只用标准库加时间库 chrono，一条命令产出单个可执行文件（Windows / Linux / macOS）。

cargo build --release -p dbsql-cli
# 产物：target/release/dbsql
# 纯数据库交付包：sh scripts/package-lite.sh

T-SQL standard

标准 SQL 基础语法完备：查询、聚合、集合运算、DDL、事务。

• SELECT 全家桶：DISTINCT / JOIN（INNER·LEFT·RIGHT·FULL）/ GROUP BY / HAVING / 子查询 / 派生表 / 集合运算
• 聚合：COUNT / SUM / AVG / MIN / MAX，配合 GROUP BY + HAVING
• 分页：LIMIT / OFFSET / FETCH FIRST n ROWS ONLY 双风格
• DDL：建/删库表、ALTER ADD / DROP COLUMN、视图、存储过程与函数、触发器与定时任务
• 事务：BEGIN / COMMIT / ROLLBACK

SELECT e.name, d.name
FROM emp e JOIN dept d ON e.dept_id = d.dept_id
WHERE e.age > 25 ORDER BY e.name DESC LIMIT 10

PL/SQL procedural

Oracle 风格扩展：匿名块、PL/SQL、伪表、行号、连接符。

• PL/SQL 控制流：DECLARE / IF·ELSIF / LOOP·EXIT WHEN / := 赋值 / 绑定变量
• 例程：CREATE PROCEDURE / FUNCTION，CALL 调用、WHERE 内联求值
• Oracle 惯用法：DUAL 伪表、ROWNUM（转 LIMIT）、|| 连接、NVL、SYSDATE
• 集合运算：UNION [ALL] / INTERSECT / MINUS
• 类型映射：NUMBER(p,s) / VARCHAR2 / DATE / BOOLEAN 与引擎原生类型互认

DECLARE v_id NUMBER;
BEGIN
  SELECT id, name INTO :v_id, :v_nm FROM emp WHERE id = 1;
  IF v_id > 5 THEN INSERT INTO emp VALUES (:v_id, 'x');
  END IF;
END;

MySQL mysql

MySQL 系语法直接落地：反引号、自增、截断、IF EXISTS 全支持。

• 标识符：反引号 `` `name` `` 引号标识符，原样兼容现有脚本
• 分页：`LIMIT offset, count` 双参数风格
• 建表：`AUTO_INCREMENT` 自增列、`DROP TABLE IF EXISTS`、`TRUNCATE`
• 库切换：`USE` 语句、`CREATE OR REPLACE VIEW`
• 类型映射：INT / VARCHAR / TEXT / DECIMAL / DATETIME / BOOLEAN 与引擎原生类型互认

CREATE TABLE `orders` (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(50) NOT NULL);
SELECT * FROM `orders` LIMIT 10, 5;