Skip to main content
Version: 5.1.0

属性(Properties)

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

属性的作用

  • 数据语义化:将物理字段名转换为具有业务含义的语义标签
  • 类型约束:为每个字段指定数据类型(整数、字符串、时间等)
  • 主键标识:标记哪个属性作为 ObjectType 的唯一标识符
  • 查询优化:通过物理表达式支持列的预处理转换
  • ChatBI 支持:通过语义角色(SemanticRole)为 AI 查询提供分析维度信息

属性包含的配置项

配置项说明
名称(name)属性标识名,需符合数据库列命名规则
描述(description)业务含义描述,供查询引擎和 ChatBI 使用
数据类型(typeRef)属性的数据类型,或关联到 SharedProperty / ValueType
是否主键(pk)标记是否为 ObjectType 的主键列
是否可空(nullable)属性值是否允许为 NULL
语义角色(roleType)指定 ChatBI 场景下属性的角色(标识符、维度、度量等)
物理表达式(physicalExpression)可选,描述从物理列到查询格式的转换逻辑

子章节导航