Database 手册 · Chapter 4

DB Studio — 用 SQL · Data 选项卡验证

在用脚本写代码之前,推荐先用 DB Studio 的两个选项卡直接确认连接与数据。先把同一段 SQL 跑两次、确认得到一致结果,再迁入脚本。

Solution Explorer
└── Data Editor Pages
    └── Database
        ├── Database Connections   (第 2 章)
        ├── Database Studio        ← 本章
        │   ├── Structure 选项卡    (第 3 章看到的表 / 列树)
        │   ├── SQL 选项卡          (自由执行 SQL)
        │   └── Data 选项卡         (按行查看 / 编辑)
        └── Database Events        (第 8 章)

在左侧树中选择 local 连接后切换选项卡。

SQL 选项卡 — 自由执行

在顶部输入框写 SQL,然后按 [Run] 或 Ctrl + Enter 执行。

针对示例项目常用的几个 SQL:

-- 总行数
SELECT COUNT(*) FROM order_history;
 
-- 最近 5 件作业
SELECT id, order_no, menu_name, result, end_time
FROM   order_history
ORDER  BY id DESC
LIMIT  5;
 
-- 按结果分组统计
SELECT result, COUNT(*) AS cnt
FROM   order_history
GROUP  BY result;
 
-- 仅看错误
SELECT id, order_no, menu_name, weight_g
FROM   order_history
WHERE  is_error = 1;

脚本中的 RunSqlSelect / RunSqlScalarInt 可直接接收在该选项卡能正常运行的 SQL。养成"只把这里跑通的 SQL 搬到脚本"的习惯,调试时间会显著缩短。

结果区域

区域	内容
结果网格	SELECT 结果行 — 显示列名、值、排序
消息 / 行数	INSERT / UPDATE / DELETE 时的 `Affected Rows: N`
执行时间	用以检查简单 SQL 的响应性

Data 选项卡 — 按行查看 / 编辑

在左侧树中选择某个表后,该表的全部行以表格形式显示。需要时可直接编辑单元格,立即 UPDATE。

推荐用途:

快速修改一两行测试数据
用肉眼确认脚本结果(如 DB_UpdateSelected 之后)是否落地到 DB
在空表中预填数据,检查 ViewRun 的显示

警告 — 在量产 DB 上通过 Data 选项卡直接编辑不会留下变更记录。量产环境请尽量通过脚本(事务 + 日志)进行修改。

推荐的验证顺序

Connections — 确认 local 已正常注册(第 2 章)
Structure 选项卡 — 确认能看到 order_history 表(第 3 章)
SQL 选项卡 — 执行上述 4 条查询确认结果
Data 选项卡 — 修改一两行 → 在 SQL 选项卡用 SELECT 验证落地
若为空,在 SQL 选项卡执行以下语句先填一行:

INSERT INTO order_history(order_no, menu_name, start_time, end_time, weight_g, result, is_error)
VALUES('O0001', 'Americano', '2026-01-01 09:00:00', '2026-01-01 09:00:30', 250, 'Done', 0);

走完这 5 步,接下来就是脚本部分。