ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
62 lines
2.8 KiB
Markdown
62 lines
2.8 KiB
Markdown
# Base data-query guide
|
|
|
|
This guide is the entry point for `+data-query`. Use it for common aggregation fewshots and command selection. For the complete DSL fields, operators, limits, and response details, use [lark-base-data-query.md](lark-base-data-query.md) as the DSL SSOT.
|
|
|
|
Before using `+data-query`, also follow [lark-base-data-analysis-sop.md](lark-base-data-analysis-sop.md) to confirm that the task really needs aggregation instead of record listing or a temporary view.
|
|
|
|
## When to use
|
|
|
|
Use `+data-query` when the user asks for server-side:
|
|
|
|
- group by / aggregation
|
|
- sum, average, min, max, count, distinct count
|
|
- filtered aggregation
|
|
- sorted Top N or Bottom N
|
|
- global statistical conclusions
|
|
|
|
`+data-query` can return dimension field rows, but those rows are grouped by dimension values and do not include `record_id`. Use `+record-list`, `+record-search`, or `+record-get` for row-level output, record identity, or full raw record details.
|
|
|
|
## Common Fewshots
|
|
|
|
Count records by a category field:
|
|
|
|
```bash
|
|
lark-cli base +data-query \
|
|
--base-token <base_token> \
|
|
--dsl '{"datasource":{"type":"table","table":{"tableId":"<table_id>"}},"dimensions":[{"field_name":"Status","alias":"status"}],"measures":[{"field_name":"Status","aggregation":"count","alias":"count"}],"shaper":{"format":"flat"}}'
|
|
```
|
|
|
|
Sum a number field by category and return Top 10:
|
|
|
|
```bash
|
|
lark-cli base +data-query \
|
|
--base-token <base_token> \
|
|
--dsl '{"datasource":{"type":"table","table":{"tableId":"<table_id>"}},"dimensions":[{"field_name":"Region","alias":"region"}],"measures":[{"field_name":"Amount","aggregation":"sum","alias":"total_amount"}],"sort":[{"field_name":"total_amount","order":"desc"}],"pagination":{"limit":10},"shaper":{"format":"flat"}}'
|
|
```
|
|
|
|
Aggregate only records matching a filter:
|
|
|
|
```bash
|
|
lark-cli base +data-query \
|
|
--base-token <base_token> \
|
|
--dsl '{"datasource":{"type":"table","table":{"tableId":"<table_id>"}},"dimensions":[{"field_name":"Owner","alias":"owner"}],"measures":[{"field_name":"Amount","aggregation":"sum","alias":"total_amount"}],"filters":{"type":1,"conjunction":"and","conditions":[{"field_name":"Status","operator":"is","value":["Done"]}]},"shaper":{"format":"flat"}}'
|
|
```
|
|
|
|
Use `tableName` when the table ID is unavailable but the table name is known:
|
|
|
|
```bash
|
|
lark-cli base +data-query \
|
|
--base-token <base_token> \
|
|
--dsl '{"datasource":{"type":"table","table":{"tableName":"Orders"}},"measures":[{"field_name":"Amount","aggregation":"sum","alias":"total_amount"}],"shaper":{"format":"flat"}}'
|
|
```
|
|
|
|
## Routing to the DSL SSOT
|
|
|
|
Read [lark-base-data-query.md](lark-base-data-query.md) when you need:
|
|
|
|
- the full DSL field reference
|
|
- supported aggregations and field types
|
|
- filter operator details
|
|
- pagination and result limits
|
|
- response shape and error recovery
|