属性(Properties)
属性(Property)是 ObjectType(对象类型)的核心组成部分,描述了业务实体具备的各个数据字段。每个属性对应物理表中的一列或由物理列派生计算出的值。

属性的作用
- 数据语义化:将物理字段名转换为具有业务含义的语义标签
- 类型约束:为每个字段指定数据类型(整数、字符串、时间等)
- 主键标识:标记哪个属性作为 ObjectType 的唯一标识符
- 查询优化:通过物理表达式支持列的预处理转换
- ChatBI 支持:通过语义角色(SemanticRole)为 AI 查询提供分析维度信息
属性包含的配置项
| 配置项 | 说明 |
|---|---|
| 名称(name) | 属性标识名,需符合数据库列命名规则 |
| 描述(description) | 业务含义描述,供查询引擎和 ChatBI 使用 |
| 数据类型(typeRef) | 属性的数据类型,或关联到 SharedProperty / ValueType |
| 是否主键(pk) | 标记是否为 ObjectType 的主键列 |
| 是否可空(nullable) | 属性值是否允许为 NULL |
| 语义角色(roleType) | 指定 ChatBI 场景下属性的角色(标识符、维度、度量等) |
| 物理表达式(physicalExpression) | 可选,描述从物理列到查询格式的转换逻辑 |
子章节导航
- 添加属性 — 为 ObjectType 创建新属性
- 派生属性 — 通过聚合运算定义跨关联的计算度量
- 物理表达式 — 配置列的物理层转换
- 语义角色类型 — 了解 5 种语义角色及其用途
- 关联 Shared Property — 将属性引用到已有的共享属性
- 关联 Value Type — 为属性指定自定义值类型