---
tags: [WPS Comate, 语义模型, 教程, 数据建模]
---
前置条件
在创建语义模型之前，你需要确保：
- 已有可用的数据空间，且空间内至少有一个数据集（物理表或数据集视图）
- 数据集已完成字段定义和数据导入
如果还没有数据集，请先在「数据资产」模块中创建数据空间、接入数据源并通过数据管道清洗数据。
第一步：创建语义模型
- 登录 Comate Studio，左侧导航栏点击「数据」→「语义模型」
- 点击页面右上角的「+ 新建语义模型」按钮
- 在弹窗中填写以下信息：
- 模型名称（必填）：如"销售分析语义模型"
- 模型描述（必填，不超过500字）：描述该模型覆盖的业务范围和目标
- 成员配置：从通讯录添加成员，分配管理员或成员角色
- 点击「保存配置」
保存后你会看到一个模型卡片，显示名称、更新时间和三组统计数字（本体对象/对象关系/数据指标），初始均为0。
第二步：定义业务对象
点击模型卡片进入详情页，选择「对象建模」模块。
- 点击「+ 新建对象」
- 填写配置：
- 对象名称：小写英文 snake_case，如
sales_order - 展示名称：中文，如"销售订单"
- 描述：说明该对象的业务含义
- 保存后双击对象卡片进入详情页
- 在 PROPERTY 区域配置基础属性：
- 每个属性映射到数据集中的具体字段
- 类型分为维度（如地区、分类）和度量（如金额、数量）
建议：从核心业务实体开始，先建最重要的2-3个对象，再逐步扩展。
第三步：建立对象关系
切换到「关系建模」模块，定义对象之间的关联。
- 点击「+ 新建关系」
- 配置关系名称、来源对象、目标对象和基数（1:N 或 N:1）
- 在编辑界面中，通过可视化连线建立 JOIN 条件：
- 左列显示来源对象的所有属性
- 右列显示目标对象的所有属性
- 点击左列字段拖线到右列对应字段
- 底部实时显示 SQL JOIN 表达式
示例：将"销售订单"和"客户"对象关联，以 customer_id 为关联字段，基数为 N:1（多个订单属于一个客户）。
第四步：添加规则属性
切换到「规则属性」模块，为对象添加衍生字段。
- 点击「+ 新建规则」
- 选择所属对象，填写规则名称和展示名称
- 选择规则类型（SQL），在代码编辑器中编写 SQL 表达式
- 编辑器支持「字段」「函数」「模板」三个快捷插入按钮
- 点击「预览」验证计算结果
典型用例：计算"月度成本"= 当月所有费用明细的 SUM。
第五步：构建业务指标
切换到「指标构建」模块，通过五步向导创建指标。
关键在第4步「定义度量」：
- 选择聚合类型：SUM、COUNT、AVG、MAX 或 MIN
- 编写 SQL 表达式，使用
{CUBE}.field语法引用字段 - 设置单位（元、人、%等）
可以为同一指标添加多个度量。例如"部门业绩"指标同时包含"总金额（SUM）"和"平均金额（AVG）"两个度量。
第六步：发布模型
回到模型详情页顶部，点击「发布新版本」。发布后：
- 模型状态从草稿变为已发布
- Comate 专家和大模型应用可以调用该模型
- 业务人员可通过自然语言进行数据问答
常见问题
Q：语义模型和数据空间有什么关系？
两者独立存在。数据空间管理原始数据资产（连接、管道、数据集），语义模型基于这些数据资产构建业务语义层。成员权限也可以独立配置。
Q：发布后还能修改吗？
可以。发布后继续编辑会进入新草稿状态，修改完成需再次发布新版本。历史版本始终可查看和回溯。
Q：规则属性和指标有什么区别？
规则属性是对象级别的衍生字段（如"月度成本"），指标是跨对象的聚合度量（如"各部门平均预算执行率"）。
注：部分内容由 AI 匹配目标关键词"WPS Comate 语义模型"自动生成，仅供参考。
