选择数据能力
本页只帮助你做选择。选定能力后，进入数据与集成参考查看配置入口、边界和验收方法。
先回答四个问题
- 谁拥有数据：当前运行实例、某台 Runtime target、外部系统，还是 App 项目？
- 要保留多久：仅本次运行、跨重启保留，还是长期归档？
- 数据是什么形状：单个值、一整套参数、多行记录，还是只读文件？
- 是否需要共享：只在一个 QG 内、一个 App 内、一台目标机，还是多台设备之间？
答案不明确时先记录为待确认，不要让默认值替你做业务决定。
快速选择
| 需求 | 优先选择 |
|---|---|
| 当前运行期间共享一个小值 | App Variable |
| 目标机重启后保留一个小值 | Saved Variable |
| 只在一个 QG 实例中使用状态 | QG state |
| 按名称整体切换一组固定参数 | Recipe |
| 在一台目标机保存有限的多行数据 | TableStore |
| 读取或写入 MES、ERP 等外部系统 | Query |
| 管理 Page 和 Component 的多语言文案 | i18n |
| 随 App 交付图片、视频或 3D 模型等只读文件 | Asset |
大量历史、复杂检索或多台设备共享的数据应由外部系统负责，再通过 Query 访问。
容易混淆的边界
- Saved Variable 与 Recipe：独立的小值用 Saved Variable；需要命名、整套切换和审批的参数组用 Recipe。
- TableStore 与 Query：单机、有限、轻量的行数据用 TableStore；外部、大量、复杂或多机共享的数据用 Query。
- App Variable 与 Object 状态：设备或业务对象拥有的状态应由 Object 提供，不要复制一份 Variable 作为第二个真相。
- Asset 与运行数据：Asset 是随版本交付的只读内容；报告、上传文件和现场产生的数据必须由明确的数据能力负责。
- QG state 与共享状态：只影响当前流程的中间状态留在 QG；需要被多个页面或流程使用时选择明确的共享能力。
做出选择后
- 在设计记录中写明能力、所有者、生命周期、备份和迁移责任。
- 按数据与集成参考从正确入口配置。
- 使用测试账号和可撤销数据完成第一次外部写入。
- Build 后在正确 Runtime target 上检查重启、失败和恢复。
- 对凭据、个人信息、设备动作参数和长期数据保留单独完成人工审查。
如果数据范围或共享需求持续增长，应重新做选择；不要因为已经上线就让 Variable 或 TableStore 长期承担不适合的职责。