AI 资讯 知识库 本体论Palantir Foundry 深度研究(六):本体的分支与发布机制

Palantir Foundry 深度研究(六):本体的分支与发布机制

前作《本体的版本演化与更新》讲过通用方法论:变更要评审、迁移要有计划、兼容性要有策略。方法论落到产品里长什么样?Foundry 的答案是把 staged changes、分支、proposal 与合并检查引进本体治理。不过要先校准一个时效事实:旧式 Ontology Branches 已标为 Legacy;启用 Global Branching 的环境不能再创建旧分支。现役的 Global Branching 把数据、本体与代码纳入统一分支体系,但它与旧流程并非完全等价。本篇先区分两代机制,再看 schema 迁移与跨环境发布。

flowchart TD
  Main[main 主干] --> Branch[Global Branch]
  Branch --> Schema[本体 schema 修改]
  Branch --> Data[数据与管道验证]
  Schema --> Preview[分支预览与索引]
  Data --> Preview
  Preview --> Proposal[Proposal 审查]
  Proposal --> Checks[Merge checks]
  Checks -->|通过| Merge[合并并构建]
  Checks -->|失败| Fix[修复 / Rebase]
  Fix --> Proposal
  Merge --> Consumer[应用 / OSDK / Agent]

两代分支体系:Legacy 本体分支与 Global Branching

旧式 Ontology Branches 文档已被官方标记为 Legacy;在启用了 Global Branching 的 enrollment 上,不能再创建旧式本体分支。旧文档对 proposal 工作流仍有参考价值:提案每个被修改的本体实体各成一个 Task;进入 In review 后才通知评审人;评审者需要 owner 或 edit 权限;proposal 合并后不能自动整体回滚,只能逐项撤销变更。需要强调:这些是旧体系文档说明,不能当作所有现役环境的统一操作手册。

Global Branching 是现役统一分支体系:一个分支可以同时容纳本体、数据与代码变更,让端到端工作流在隔离环境中演练。现役工作流的权限门槛比旧 proposal 更高:创建 proposal 需要分支 Owner 或 Space Administrator。对数据与本体资源的隔离语义也不完全相同——本体资源的创建、修改、删除可以留在分支里;有些其他 Foundry 资源(例如新建数据集)在分支上创建或删除仍会影响 main,必须先确认具体资源的分支行为,不能假设所有东西都被 fork 隔离。

分支生命周期也有运行成本:Active 分支在一段时间不活跃后会进入 Inactive,默认保留策略下本体会取消索引、数据随后清理;分支可手动归档并恢复,已合并分支则为终态。保持分支持续活跃会消耗额外计算。对测试分支的管理因此不仅是「代码卫生」,也是资源治理。

小结:Global Branching 把语义、本体和代码纳入统一工作流,但旧 Ontology Branches 已是 Legacy,资源隔离、权限与生命周期规则不能混为一谈。

Proposal:变更审查与合并检查

在现役 Global Branching 流程里,proposal 是分支变更进入主干的审查入口。分支上的本体修改先在隔离环境验证;需要回到主干时,发起 proposal、请求审查,并执行合并检查。若 main 在分支创建后继续演进,需先 rebase,把主干变化合入分支,再逐资源解决冲突。通过评审后可触发合并,并选择构建所有受影响资源、只构建修改资源或不构建等选项;合并时排除某资源只会将其排除在合并构建之外,变更本身仍会合并。

这套工作流把「谁提议、谁审查、哪些检查通过、合并时触发什么构建」变成结构化记录。它解决的是前作《版本演化》里的核心命题——「谁批准了这次语义变更」要有可追溯答案。但平台不承诺所有合并都可撤销:部分失败的 Global Branching 合并当前不能回滚,Legacy proposal 也没有自动整体 revert。上线前的合并检查因此比事后回滚更重要。

旧体系与新体系都使用 proposal 概念,但权限条件、资源覆盖范围、生命周期与回滚语义有差异;实际操作应以 enrollment 当前启用的 Global Branching 文档为准。

小结:proposal 提供变更审查入口,但不能把它想成「所有资源都隔离、所有合并都可回滚」的通用 Git。

发布语义:Save、合并与下游生效

Foundry 里「发布」不是一个单独的按钮,而是依所处工作流有不同含义。在 Ontology Manager 的直接编辑模式中,修改先保存在本地的 work-in-progress 状态,点击 Save 并确认 Review edits 后,变更就对其他用户和下游应用生效;若其他人先保存了同一资源,则需要更新并处理并发变化。开启分支治理后,敏感类型的修改可能要求「创建并保存到分支」,之后经过 proposal 审查与合并才能进 main。

这一区分纠正了一个常见误解:Foundry 并非每个环境都有独立的发布审批流水线。基础 Save 是直接生效;评审与审批由分支/proposal 治理承担。团队要根据项目权限模式与 Global Branching 启用状态,明确哪些对象类型可直接保存、哪些必须经过 proposal。不要只看「Save 成功」就推断「生产发布完成」。

小结:基础编辑的 Save 可直接让修改生效;强治理工作流则把 Save 导向分支,合并才进入主干。

Schema 变更与数据:演化时的三联动

改本体不是改一张图,是改「schema + 数据 + 消费方」的三体运动。Foundry 的机制把三者联动管理起来。

Schema 变更:属性增删、类型修改、主键调整等变更可能破坏现有对象编辑与应用。OSv2 会自动识别部分破坏性 schema 变更,并要求选择迁移方案后才能保存,例如移动已有编辑、转换属性类型、丢弃编辑或为由编辑创建的对象回填值。此处的「backfill」不是重跑所有历史源数据:它只为编辑创建对象上未设置的属性补一个指定值,不覆盖已有值(包括显式 null)。大规模历史数据重算仍需通过数据管道完成。

数据刷新:对象索引由 Object Data Funnel 管理。批管道默认增量索引,changelog 自动计算;流式输入则需显式配置为 stream,否则会退回批处理索引。官方文档给出的流式默认 checkpoint 频率约为每秒一次,这是端到端索引延迟的重要组成部分;实际延迟还受源系统、转换、排队与索引负载影响。流式输入支持 CDC 创建、更新与删除,但不支持部分行更新,需上游管道解析完整对象。文档给出的单对象类型流式索引吞吐限制为 2 MB/s,超过需与支持团队确认。

消费方适配:schema 合并后,应用、OSDK 代码与 MCP 工具要与新契约保持一致。OSDK 的类型代码需要重新生成;SuperRepo 模式下更容易纳入代码流程,普通生成模式仍需要显式安排再生成与测试。变更影响面应在合并前盘点:对象视图、动作、函数、Agent 工具分别引用哪些属性与链接?

小结:schema 迁移要选择编辑数据策略,流式数据有明确吞吐与更新限制,消费方也要同步适配;不能把「本体保存成功」等同于全链路升级完成。

跨环境分发:Marketplace 与 SuperRepo

单个环境内的演化机制有了,多环境(开发、测试、生产)之间怎么搬?Foundry 给了两条通道。

Marketplace 是官方推荐的跨环境分发方式:把本体资产(连同相关数据管道)打包成产品,在环境间安装与升级。它的价值在于「可重复安装」——同一个包进测试环境验证、进生产环境部署,版本与依赖关系随包携带,避免「开发环境手工改过、生产环境根本装不出来」的漂移。

SuperRepo 是面向开发者团队的本体即代码:对象类型、链接、动作与函数声明在同一个代码仓库,本地生成 OSDK 代码、变更自动再生成。它把本体的「源代码」收进 git,环境部署变成代码发布——对工程团队这是熟悉的地盘。两条通道的选择逻辑与基础设施即代码的历史一致:低代码团队走 Marketplace 产品化分发,工程团队走 SuperRepo 代码化分发,两者底座是同一套本体资产。

多环境实践中还剩一块官方机制没覆盖的空地:环境间的数据重放(开发环境灌生产脱敏数据)要自己搭管道。语义契约可以打包,但「契约 + 合适的数据」才是可测试的本体——自建平台设计分发机制时别忘了这一块。

小结:跨环境分发的成熟解法是「产品化打包(Marketplace)+ 代码化声明(SuperRepo)」双轨;数据重放是普遍的自行补齐项。

复盘 OSv1→OSv2:一次大版本演化的完整案例

第一篇提过 OSv1→OSv2 的破坏性变更清单,本篇换个视角:把它当作「本体仓库大版本演化」的方法论样本复盘。

这次迁移演示了四件事如何协同。变更声明:官方维护逐条破坏性变更清单(只支持动作编辑、物化可选、强制数据约束、changelog 语义更换),每条都写明旧行为、新行为与迁移动作。迁移工具:Upgrade Assistant 自动扫描存量、给出迁移路径。过渡窗口:Phonograph 明确标注 Planned deprecation,死线 2026-06-30——足够长的窗口 + 明确的强制力。能力断层管理:新能力(增量索引、自动 changelog)只在 OSv2 有,倒逼存量迁移而不是无限期双轨。

对照前作《版本演化》的兼容性策略,这次迁移选的是最激进的「断代升级」而非「长期兼容层」。它的底气来自两点:本体 schema 的消费方全部在平台内(平台可以协调),以及客户关系允许强推时间表。开源生态做同样的演化(比如 RDF 存储引擎换代)会更难——消费方散布在开放的网里。这提示我们:演化的激进空间与契约的可控范围成正比,能枚举所有消费方的系统才敢断代。

小结:大版本演化 = 清单声明 + 工具迁移 + 死线治理;敢不敢断代,取决于你能不能枚举全部消费方。

与通用版本演化方法论对照

把 Foundry 机制对回前作《本体的版本演化与更新》的通用框架,逐项对号:

通用方法论 Foundry 机制
变更评审 proposal + merge checks + 受保护资源强制分支
影响分析 血缘系统 + 合并检查(消费方引用追踪)
迁移计划 Upgrade Assistant(大版本)+ 手动 rebase(日常)
兼容性策略 消费方重新生成代码(OSDK)+ Marketplace 版本包
回滚 分支不合并即无影响;已合并的回滚靠新 proposal
多环境管理 Marketplace 分发 + SuperRepo 代码化

值得注意的空白:合并后的「本体级回滚」没有一键操作——回滚也要走一次正向变更。这与数据库 schema 演化的经验一致:向前的补偿变更比向后回滚更安全(回滚可能丢弃合并后新产生的数据)。自建平台不要梦想做「时间机器」,要把「以变更对消变更」做成默认心智。

小结:通用方法论在 Foundry 里都有机制对应;唯一的空白(本体级回滚)恰好印证了「补偿优于回滚」的行业经验。

参考资料

读者留言

COMMENTS 暂无
仅本站原创文章开放留言 · 请勿留下手机号、邮箱等个人信息

还没有留言,来说第一句?