SuperAPI AI 工具集

mz-ontology-design

数据与分析

查看项目

更新于 10-16 00:06

技能介绍

用途:在 Materialize SQL 代码库中设计并审查语义层,把源数据与消费端输出之间的共享含义集中到规范本体,把展示与工作流策略留在边缘。

架构:使用共享 raw 数据库、共享 core 数据库,以及每个用例一个数据库,依赖方向为 raw.<source_system> -> core.<source_system> -> core.internal -> core.public -> <use_case>.<schema>。raw 保存源形状的摄取对象并保留源表身份;core.<source_system> 保存源本地类型、清理、去重与命名;core.internal 保存跨源集成与身份解析;core.public 是文档化本体,也是消费端唯一可读的 core schema。每个用例拥有自己的数据库,存放投影、聚合、评分、过滤与索引,用例之间不共享数据库。只有 core 读取 raw,用例数据库只读 core.public,边界通过授权与依赖校验强制。

语义对象:语义对象是规范关系,具有单一文档化粒度、持久身份规则、明确时间语义,且含义独立于消费端,可为实体、事件、测量或关系对象。聚合、评分、展示分类、报表行、源副本或一对一投影不因消费端需要而成为语义对象。新增公共对象需满足粒度与身份明确、含义不依赖特定仪表盘或模型、对多个消费端有用或为其他公共对象的基础、属性同粒度且来源清晰可安全暴露。

身份与时间:优先使用全局有意义的不可变上游标识符;身份受父级限定时使用显式复合键;跨源身份在 core.internal 解析一次并保留源标识符用于血缘;无持久键时才用确定性合成标识符并记录输入与稳定边界。每个公共对象声明其表示当前状态、不可变事件、时点测量还是生效日期历史,并区分事件时间、生效时间与摄取时间。

公共与用例对象:每个 core.public 语义对象只定义一次,用领域名词命名,并作为物化视图发布在转换计算上。共享含义规范化,一个事实只有一个规范所有者。用例数据库可重塑为本体星型、宽表、群组、排名、评分或告警状态,但不得重定义身份或维护共享概念的独立版本。转换计算与服务计算分离。

关系:引用边由公共对象上的列表示另一公共对象中的一行,基数为多对一或一对一;关系对象在关联具有属性、时间、证据、置信度或多对多含义时成为公共语义对象。启发式匹配不得暴露为外键式边,应建模为带方法、状态、证据、置信度与生效时间的关系对象。core.public.relationships 是所有引用边的机器可读注册表,创建或审查时读取 references/relationships.sql。

文档与测试:使用 comment on 记录消费端契约,说明粒度、身份、时间行为、含义与重要排除项。测试公共键唯一性与非空、可接受状态、关系完整性、粒度保持与非显然语义规则。CI 应拒绝反向层依赖、用例数据库访问私有 schema、未文档化的公共对象,以及转换计算上的消费端索引。

限制:资料未提供具体安装命令、收费、价格或平台支持信息。