← 都来码 / Dolaima← 例程索引sql/README.md 原文

sql/README.md · 2081 字节 · 下载原文

# SQL 示例

这里放 `.sql` 脚本,由工作区的 **`tools/sql_run`**(`third_party/vml/FileTools/sql_run.c`)执行。

- **手机**:文件页点某个 `.sql` → 菜单里选「运行」→ 结果表打印在命令行页。
- **桌面**:`vmlcli third_party/vml/FileTools/sql_run.c --arg <这个文件的绝对路径>`

> ⚠ 桌面上**必须把工具源放到与本文件同一个目录**再跑 —— vmlcli 的文件沙箱根就是
> **源文件所在目录**(`Program.cs` 给 VM 的 `FileSystemRoot`),跨目录一律 `FILE_ACCESS_DENIED`。
> 手机上没这个问题:沙箱根是工作区,`tools/` 够得着 `examples/`。

## ⚠ 两个必须知道的约定

1. **每个 `.sql` 要有一个同名的 `.dbf` 放在旁边**(`demo.sql` → `demo.dbf`)。
   工具按**脚本名**找表:`argv[3]` 没给时就用同名的 `.dbf`;而文件页只传文件路径,不会传第三个参数。
2. **`.sql` 里只写一条语句、不要写注释**。这一版的 SQL 引擎把 `;` 当**语句分隔符**,
   不认识 `--` / `;` 注释 —— 写了注释会直接报 `SQL_ERROR`(表都读不到)。

## 支持的子集

```
SELECT <* | 列[,列...]> FROM <表名> [WHERE <条件>] [ORDER BY <列> [ASC|DESC]] [LIMIT <n>]
```

- `WHERE` 里可用 `AND` / `OR` / `NOT` / `IS [NOT] NULL` / `LIKE`,比较按**字节**(两边都是数字时按数值)。
- ⚠ **只读**:没有 `INSERT` / `UPDATE` / `DELETE` / `CREATE TABLE`(写库走 `dbf_*` 接口,见 `tools/dbf_open`)。
- ⚠ `FROM <表名>` 那个名字**解析但不参与定位** —— 表就是传进去的那个 `.dbf`。留着 `FROM` 是为了让
  老程序里的语句能直接贴过来,所以这里三个例子的 `FROM` 都写着 `demo`,而文件却叫 `older.sql`。

## 这三个例子(数据都是那两行:Alice 30 / Bob 7)

| 文件 | 查什么 |
|---|---|
| `demo.sql` | 整表 + `WHERE AGE > 5`(与 `tools/demo.sql` 同一条) |
| `older.sql` | 选两列 + `WHERE AGE > 10` + `ORDER BY AGE DESC` |
| `starts_with.sql` | `LIKE 'A%'` + `LIMIT 5` |