添加属性

属性（Property）是 Object Type 的核心组成部分，描述业务实体的各项数据字段。每个属性代表 Object Type 在物理数据源中对应表的某一列，或通过物理表达式派生的计算列。

属性字段说明

在为 Object Type 添加属性时，需要填写以下字段：

基本字段

字段	说明	必填
名称（name）	属性的唯一标识名，必须符合数据库列名规范（字母、数字、下划线），同一 Object Type 内不允许重名	✅
描述（description）	属性的业务含义说明，建议用简洁的中文描述该字段的业务用途	✅
数据类型（typeRef）	属性的数据类型，从系统支持的本体类型中选择（如 STRING、INTEGER、DOUBLE、TIMESTAMP 等）	✅
主键（pk）	是否为该 Object Type 的主键列。每个 Object Type 建议设置一个主键，主键值唯一标识该实体的每条记录	✅
可空（nullable）	该字段是否允许为空值。当 pk=true 时，nullable 不能设为 true	✅
语义角色（roleType）	属性的业务语义角色，用于 ChatBI 等分析场景。详见 角色类型说明	✅

高级字段

字段	说明	必填
物理表达式（physicalExpression）	可选。当物理存储中的列值需要转换后才能使用时，填写转换表达式。详见 物理表达式	❌

操作步骤

1. 进入目标 Object Type 的详情页
2. 点击「添加属性」按钮

3. 在弹出的属性编辑表单中填写各字段
4. 点击「保存」完成添加

约束与校验

• 名称唯一性：同一 Object Type 内，不允许添加同名属性（大小写不敏感）
• 主键与可空互斥：若勾选了「主键」，则「可空」选项自动禁用且必须设为否
• 名称格式：只允许字母、数字和下划线，且不能以数字开头

示例

以下是一个「订单」Object Type 中常见属性的配置示例：

名称	数据类型	主键	可空	语义角色	说明
order_id	STRING	✅	❌	Identifier	订单唯一编号
customer_id	STRING	❌	❌	Dimension	关联客户编号
order_amount	DOUBLE	❌	✅	Measure	订单金额
order_time	TIMESTAMP	❌	❌	TimeDimension	下单时间
status	STRING	❌	✅	Dimension	订单状态

相关功能

• 物理表达式 — 了解如何通过 SQL 表达式对列值做转换
• 角色类型 — 了解 5 种语义角色的适用场景
• 关联共享属性 — 将属性与已有的 Shared Property 关联
• 关联值类型 — 将属性与已有的 Value Type 关联