语义模型文件夹结构

文件夹布局

My_Sales_Model/
    ├── model.json
    ├── dataObjects.json
    ├── relationships.json
    ├── calculatedDimensions.json
    ├── calculatedMeasurements.json
    ├── logicalViews.json
    ├── dimensionHierarchies.json
    ├── metrics.json
    ├── parameters.json
    ├── modelInfo.json
    ├── fieldsOverrides.json
    ├── modelFilters.json
    ├── groupings.json
    └── metadata/
       ├── orgInfo.json
       ├── positions.json
       └── groups.json

核心模型文件

• model.json — 模型元数据，包括 API 名称、标签和数据空间（必填项）
• dataObjects.json — 带有维度和测量的数据模型对象 (DMO) 和数据湖对象 (DLO)
• relationships.json — 具有基数和联接条件的数据对象之间的联接
• modelInfo.json — 模型权限和设置

计算字段和业务逻辑

• calculatedDimensions.json — 从表达式计算的维度字段
• calculatedMeasurements.json — 带有聚合逻辑的测量字段
• metrics.json — 业务度量定义
• logicalViews.json — 从 HardJoin 或 Union 操作创建的虚拟表

导航和筛选器

• dimensionHierarchies.json — 维度的向下层次结构
• parameters.json — 计算字段的用户输入变量
• modelFilters.json — 模型级筛选器定义
• fieldsOverrides.json — 字段级属性覆盖

可视化和元数据

• groupings.json — 可视组织的 ERD 分组定义
• metadata/orgInfo.json — 源组织跟踪信息
• metadata/positions.json — 保存的 ERD 节点位置
• metadata/groups.json — ERD 组配置

备注 仅需要model.json。缺少的文件被视为空。大多数文件使用{ "items": [...] }格式，但使用{ "groupings": [...] }的groupings.json和裸对象的modelInfo.json除外。