Database 手册 · Chapter 4

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

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

xscript

Solution Explorer
├── Data Editor Pages
└── Database                       ← 与 Data Editor Pages 同级的最上层
    ├── Database Connections       (第 2 章)
    ├── Database Studio            ← 本章
    │   ├── Structure 选项卡        (第 3 章看到的表 / 列树)
    │   ├── Data 选项卡             (按行查看 — 只读)
    │   └── SQL 选项卡              (自由执行 SQL)
    └── Database Events            (第 8 章)

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

SQL 选项卡 — 自由执行

在顶部输入框写 SQL,然后按 [Run] 按钮或 F5 执行。

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

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 结果行 — 显示列名、值、排序
状态消息	SELECT 显示 `N row(s) returned. (ms ms)`;INSERT / UPDATE / DELETE 显示 `N row(s) affected. (ms ms)`
执行时间	用上面消息中的 `(ms ms)` 检查响应性

Data 选项卡 — 按行查看(只读)

在左侧树中选择某个表后,可将该表的行以表格形式查看。本版本中 Data 选项卡为只读,用以下控件筛选要显示的行:

WHERE 输入框 — 过滤条件(如 is_error = 1)。留空则显示全部行。
Page Size — 一次最多拉取的行数(默认 100)。
[Load] 按钮 — 按以上条件重新读取行并显示在网格中。

底部提示 "Data editing is read-only in this version. Use SQL tab for INSERT/UPDATE/DELETE." — 因此 INSERT / UPDATE / DELETE 全部在 SQL 选项卡 完成。

推荐用途:

用 WHERE 过滤快速查看符合条件的行
用肉眼确认脚本结果(如 DB_UpdateSelected 之后)是否落地到 DB
确认表是空的还是已有数据

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

SQL 选项卡 — 自由执行

结果区域

Data 选项卡 — 按行查看(只读)

推荐的验证顺序