三、带出关联数据：链接

正向链接：带出关联对象

用 .链接编码 到达关联对象，在 select 的大括号里用嵌套形状写出要带出的属性。

• 订单行 → 订单头：订单行有链接 order 指向订单头，在查订单行时可带出头的字段，例如 order: { order_no, order_date, status }。

• 订单头 → 主数据：订单头有链接 customer、warehouse 指向客户、仓库，可带出客户名（多语言字段，取中文名用 <str>.customer.name['zh-cn']）、仓库名等。

语法示例（查订单行，并带出所属订单头的订单号、日期）：

select OrderLine {
    line_no,
    product_name,
    qty,
    price,
    order: { order_no, order_date, status }
}

多级时继续用 . 或嵌套；例如订单行的订单号也可写成 .order.order_no（见下文「多级与计算字段」）。

反向链接：谁指向当前对象

每条正向链接都有一条虚拟的反向链接：从「被指向的对象」看「谁指向我」。

• 写法：.<链接名[is 对象类型]，其中 < 表示反向，[is 对象类型] 指定链接另一端的对象类型。

• 例如：订单行有正向链接 order 指向订单头，则在订单头上就有反向链接 .<order[is OrderLine]，表示「指向当前订单头的所有订单行」。

典型用法是在头表上统计行表数量：count(.<order[is OrderLine]) 表示该订单下的订单行数量。

多级与计算字段

• 正向：.order.order_no、.order.order_date 以及主数据 .customer.name（多语言 JSON）、.warehouse.name 可直接作为输出字段的表达式。客户名为多语言字段，取中文用 <str>.customer.name['zh-cn']。

• 在 select 里用 := 可给输出起别名，例如在订单头上把「客户中文名」「仓库名」「订单行数量」「订单行金额之和」作为单独字段：

select Order {
    order_no,
    order_date,
    status,
    customer_name := <str>.customer.name['zh-cn'],
    warehouse_name := .warehouse.name,
    line_count := count(.<order[is OrderLine]),
    total_amount := sum(.<order[is OrderLine].qty * .<order[is OrderLine].price)
}

综合示例

查询最近 10 条已确认订单，并带出：订单号、日期、状态、客户名、仓库名、订单行数量、订单行金额合计。

select Order {
    order_no,
    order_date,
    status,
    customer_name := <str>.customer.name['zh-cn'],
    warehouse_name := .warehouse.name,
    line_count := count(.<order[is OrderLine]),
    total_amount := sum(.<order[is OrderLine].qty * .<order[is OrderLine].price)
}
filter .status = 'confirmed'
order by .order_date desc
limit 10

结果示意：

[
  {
    "order_no": "ORD003",
    "order_date": "2023-10-03",
    "status": "confirmed",
    "customer_name": "客户甲",
    "warehouse_name": "华北仓",
    "line_count": 2,
    "total_amount": 350.00
  },
  {
    "order_no": "ORD002",
    "order_date": "2023-10-02",
    "status": "confirmed",
    "customer_name": "客户乙",
    "warehouse_name": "华东仓",
    "line_count": 1,
    "total_amount": 99.00
  }
]

拉平 vs 嵌套：两种输出结构对比

查链接数据时，有两种输出方式：拉平到第一层和嵌套结构。

select OrderLine {
    line_no,
    product_name,
    qty,
    price,
    order_no := .order.order_no,
    order_date := .order.order_date,
    customer_name := <str>.order.customer.name['zh-cn']
}

[
  { "line_no": 1, "product_name": "商品A", "qty": 2, "price": 50.00, "order_no": "ORD001", "order_date": "2023-10-01", "customer_name": "客户甲" },
  { "line_no": 2, "product_name": "商品B", "qty": 1, "price": 99.00, "order_no": "ORD001", "order_date": "2023-10-01", "customer_name": "客户甲" }
]

select OrderLine {
    line_no,
    product_name,
    qty,
    price,
    order: {
        order_no,
        order_date,
        customer: { name }
    }
}

[
  {
    "line_no": 1, "product_name": "商品A", "qty": 2, "price": 50.00,
    "order": {
      "order_no": "ORD001", "order_date": "2023-10-01",
      "customer": { "name": { "zh-cn": "客户甲", "en": "Customer A" } }
    }
  }
]

select Order {
    order_no,
    lines := .<order[is OrderLine] {
        line_no,
        product_name,
        qty,
        price
    }
}

[
  {
    "order_no": "ORD001",
    "lines": [
      { "line_no": 1, "product_name": "商品A", "qty": 2, "price": 50.00 },
      { "line_no": 2, "product_name": "商品B", "qty": 1, "price": 99.00 }
    ]
  }
]

import pandas as pd

# 假设 result 是 DeepQL 查询返回的嵌套结果（list of dict）
df = pd.DataFrame(result)

# lines 列是嵌套的数组，explode 展开为多行
df_flat = df.explode('lines')

# 再将 lines 中的字段拉平到列
lines_df = pd.json_normalize(df_flat['lines'])
df_flat = df_flat.drop(columns=['lines']).reset_index(drop=True)
df_flat = pd.concat([df_flat, lines_df], axis=1)

嵌套形状中的 filter / order by / limit

在展开链接时，可以直接对链接的嵌套形状加 filter、order by、limit，只筛选/排序/截取需要的关联对象。

示例：查订单头，并只带出单价 > 50 的订单行（按单价降序，最多 5 行）：

select Order {
    order_no,
    lines := .<order[is OrderLine] {
        line_no,
        product_name,
        price
    } filter .price > 50
      order by .price desc
      limit 5
}

注意：嵌套 filter 里的 .price 表示订单行的 price（作用域变为嵌套的对象类型），而非外层 Order 的属性。

类型交叉（[is 类型]）

当一条链接指向抽象类型或联合类型时，链接的结果可能是多种子类型的混合。可用 [is 子类型] 进行类型交叉，只保留特定子类型的对象。

语法：链接[is 子类型] 或 [is 子类型].属性。

此语法也可用于反向链接中，前文已见：.<order[is OrderLine] 就是一种类型交叉，指定反向链接另一端的对象类型。

小结

下一步可以让查询支持传入参数、用 with 复用中间结果，见「四、可复用与可传参：变量与 with」。