---
title: 准备数据
navTitle: 准备数据
---
# 准备数据

“准备数据”通常指创建或修改数据模型、查询、字段、过滤条件、数据源配置或取数逻辑。AI 可以辅助理解表结构、生成查询草稿和检查字段引用，但涉及数据写入和数据源变更时必须人工确认。

## 阅读顺序{#reading-order}

1. 先读 [SuccApp 官方文档 Skill](../../../../SKILL.md) 中的 AI 低代码开发说明和[工作区中的 AI 协作文件](../basics/workspace.md#ai-files)，确认数据范围、环境、权限和是否只允许只读操作。
2. 再读[数据模型](../../meta/file-types/data/tbl.md)、[查询](../../meta/file-types/data/query.md)、[数据源连接](../../meta/file-types/config/jdbc.md)和[查询数据](./query-data.md)。
3. 使用 SuccApp CLI 只读命令前，先确认服务器、数据源和模型范围；物理库排查用 `db`，语义模型排查用 `model`。
4. 修改后按[引用检查](../quality/reference-check.md)、[元数据静态检查](../quality/metadata-check.md)和[产品验证](../quality/product-verification.md)验证影响范围。

## 常见文件和工具{#files}

| 对象 | 用途 |
| --- | --- |
| `.tbl` | 数据模型、字段、物理表和取数配置。 |
| `.query` | 查询 DSL 或数据准备逻辑。 |
| `.jdbc` | 数据源连接配置。 |
| SuccApp CLI `db` 命令 | 查看数据源、schema、表结构和执行只读查询。 |
| SuccApp CLI `model` 命令 | 查看 `.tbl` 模型摘要、字段、索引，并通过模型表达式或 Query DSL 查询模型数据。 |

## AI 修改前{#before}

明确告诉 AI：

1. 目标业务问题和数据口径。
2. 数据源、schema、表名和字段范围。
3. 是否只允许只读查询。
4. 是否允许修改 `.tbl`、`.query` 或 `.jdbc`。
5. 是否涉及生产数据、敏感数据或数据写入。

## 推荐流程{#workflow}

1. 使用 `succapp db source list`、`schema list`、`table describe` 读取物理结构；使用 `succapp model list`、`model show`、`model fields` 读取语义模型结构。
2. 让 AI 先解释字段和表关系，不要直接执行写 SQL。
3. 需要 SQL 或模型查询时先生成只读查询并限制行数；单模型查询优先用 `succapp model select <model> --where "STATUS='ACTIVE'" --max-rows 20`。
4. 修改模型或查询文件前，搜索页面、报表和脚本引用。
5. 修改后验证依赖该模型的页面、看板和报表。

## 安全边界{#safety}

以下操作必须人工确认：

1. `succapp db exec`。
2. 导入、删除或更新业务数据。
3. 修改数据源配置。
4. 修改模型主键、物理表名、字段编码和权限相关字段。
5. 在生产数据源上执行大范围查询。

更多说明见[查询数据](./query-data.md)和[安全边界](../basics/safety.md)。