一、查什么：select 与结果形状

基本写法

select 对象类型 {
    属性1,
    属性2,
    ...
}

• 对象类型：如 Order（订单头）、OrderLine（订单行）。

• 大括号内：列出要返回的属性或链接的编码，用逗号分隔。返回结果中每条记录都包含这些字段。

示例场景说明

后文示例统一使用「订单单据」场景：订单头（Order） 与 订单行（OrderLine） 头行结构，行表通过链接指向头表，并配置级联删除（删除订单头时自动删除其下所有订单行）。订单头另有关联的主数据：客户、仓库。

关系：一个订单头对应多条订单行，行通过链接 order 指向头，头删则行删；订单头通过链接 customer、warehouse 指向客户与仓库。

第一条查询

不加任何条件，只查订单头的三个属性：订单号、订单日期、状态。

select Order {
    order_no,
    order_date,
    status
}

结果示意（JSON）：每条记录是一个订单头对象，仅包含上述三个字段。

[
  { "order_no": "ORD001", "order_date": "2023-10-01", "status": "draft" },
  { "order_no": "ORD002", "order_date": "2023-10-02", "status": "confirmed" }
]

快捷查看全部属性：Splat（ * / ** ）

不想逐个列出属性时，可用星号快速返回所有字段：

示例：快速查看订单头的全部属性。

select Order { * }
limit 1

结果示意：返回 id、order_no、order_date、status 等所有属性。

[
  { "id": "...", "order_no": "ORD001", "order_date": "2023-10-01", "status": "draft" }
]

** 双星号会在此基础上多展开一层链接（如 customer、warehouse 的属性），适合快速查看完整数据，但字段较多。

查询标量值与自由对象

select 不仅能查对象，也能直接查标量值或组合成自由对象（Free Object）：

# 直接查标量
select 'hello world'

# 集合
select {1, 2, 3}

# 自由对象：把多个表达式打包到一行结果中
select {
    today := cal::local_datetime_of_statement(),
    order_count := count(Order),
    draft_count := count(Order filter .status = 'draft')
}

结果示意：

{
  "today": "2023-10-10T14:00:00",
  "order_count": 5,
  "draft_count": 2
}

自由对象适合在查询器里一次性查多个统计，不需要与某个具体对象类型绑定。

小结

下一步可以为查询加上条件、排序和条数限制，见「二、缩小范围：条件、排序、条数」。