Aller au contenu principal

Spark Data CLI

Traduction en coursCe guide est actuellement disponible en chinois simplifié. Une version traduite sera ajoutée ultérieurement.

spark-designer data 面向 Business Object Designer。它读取业务对象语义，而不是把 Data 字段和 Task 字段混在同一个命令空间中。

当前版本支持只读配置审计：Business Object、字段、DQL、Data Source 环境 Profile 和物理 Mapping。创建或修改这些资产仍由对象设计器完成。

1. 选择设计上下文​

spark-designer data app list
spark-designer data app use spark-sample
spark-designer data current
spark-designer data version list
spark-designer data version entry

选择结果与 Page、Task、SLA CLI 共用。切换 App 后，其他设计器命令也会进入同一 App 和版本。

2. 查看数据设计摘要​

spark-designer data summary

摘要统计当前版本中的：

  • Business Object 数量和字段数量。
  • DQL Query 数量。
  • Data Source 数量。
  • Mapping 总数和 READY Mapping 数量。
spark-designer data summary --json

3. Business Object 和字段​

spark-designer data object list
spark-designer data object show pet_type
spark-designer data field list pet_type

object show 会一次展示：

  • 对象类型、字段数、查询数和 Mapping 状态。
  • 字段的 Value Type、Identifier、Title、Required、Searchable 和 Filterable。
  • 对象关联的 DQL、物理 Mapping、Relation 和 Action。

对象引用支持 ID、Object Key 和名称。

4. DQL Query​

列出全部 DQL：

spark-designer data query list

只查看某个对象：

spark-designer data query list --object pet_type

查看一条 DQL 和参数声明：

spark-designer data query show "pet type filter"
spark-designer data query show LeF-1Y-cqU --json

例如：

code LIKE :code

CLI 会显示 code 参数的 Value Type 和 Required 状态。参数在 DataList 中如何绑定到工具栏控件，请参阅 DataList 控件介绍。

5. 多环境 Data Source​

spark-designer data source list
spark-designer data source profiles "65.109.119.73 / spark-test"

source profiles 显示 DEV、TEST、PROD 是否已配置、是否继承其他环境、验证状态和最近验证时间。命令不会输出用户名、密码或其他敏感凭据。

当 TEST 或 PROD 未独立配置并继承 DEV 时，输出中的 inherited 会显示为 yes。

6. 物理 Mapping​

spark-designer data mapping list pet_type

Mapping 输出包括 Mapping Key、数据源、类型、状态、租户隔离模式和字段映射数量。READY 表示该 Mapping 当前验证通过；对象级状态仍可能因为其他映射或配置不完整显示为 PARTIAL。

7. 结合页面配置排查​

spark-designer page show DataList --json
spark-designer data object show pet_type
spark-designer data query show LeF-1Y-cqU
spark-designer data source profiles "65.109.119.73 / spark-test"
spark-designer data mapping list pet_type

这组命令可以回答：页面引用了哪个对象、DQL 参数是什么、环境数据源是否继承、字段映射是否 READY。

8. 当前边界​

当前 Data CLI 不提供原始对象 JSON、DQL JSON 或 Source Profile JSON 的整包导入。后续写命令应分别校验对象字段、DQL 语义、凭据安全和环境继承规则，并对高影响操作要求显式确认。

Dernière mise à jour le