Marketplace 的 Dataset SemVer 1.0(数据集语义化版本)说明内容变更怎样形成版本,以及不同访问方式如何处理后续版本。访问权由 listing 上的授权、用途和条款决定。
版本号从哪里来
版本格式是 MAJOR.MINOR.PATCH,按数值比较。例如 1.10.0 比 1.9.3 新。首个已发布版本是 1.0.0,草稿没有内容版本。
平台将本次发布与上一个已发布版本比较。一个发布同时含有多种变化时,按达到的最高级别升号,并保留每项原因,先列 MAJOR,再列 MINOR、PATCH。
| 级别 | 会触发的变化 | 对读者的影响 |
|---|---|---|
| MAJOR(主版本) | 删除、重命名或改变字段类型;删除、合并或重新定义标签值;改变选取数据集记录的规则 | 可能破坏程序或模型兼容性。Live feed 不会自动跟到新的 MAJOR。 |
| MINOR(次版本) | 增加记录、可选字段或标签值 | 增加内容。同一 MAJOR 内的 Live feed 会跟进。 |
| PATCH(修订版本) | 复核后更正记录;贡献者撤回同意或法律下架后移除记录 | 修正内容。Live feed 会跟进;固定集合按受治理的纠正规则接收 PATCH。 |
| 无新版本 | 只改 listing 页面、价格或条款 | 内容未变。条款另用自己的修订号记录。 |
例如,一次发布删除 promo 字段、增加 500 条记录并更正 10 条记录,形成 MAJOR;历史会列出这三项原因,而不只显示版本号。
已有访问如何跟进
- Live feed(持续数据流)跟进授权所在 MAJOR 内的 MINOR 和 PATCH。新的 MAJOR 需要买方主动选择,不会自动套用。
- 固定集合保持激活时绑定的精确版本。受治理的 PATCH 可以更正该集合,不会把后来新增的记录加入其中。
- Deal(交易)按已签署修订中写明的版本绑定。后续 MAJOR 需要重新协商。
登录参与该 Deal 的组织后,打开 Deal URL 可回到指定历史修订。链接不会切换当前组织或授予访问权;Deal 或修订不可用时,页面不会用最新修订替代。
请以当前 listing 页面和对应协议确认访问权限。它们说明实际提供的访问方式、授权用途,以及许可与导出条件。
容易混淆的变化
撤回同意或法律下架仍是 PATCH。 记录数会减少,因为这类删除是必须执行的纠正;它不改变字段结构或标签含义。变更原因会注明移除数量。
改变记录筛选规则是 MAJOR。 例如提高最低质量等级会改变哪些记录属于数据集,即使没有改字段,新旧版本代表的人群也不同。
价格和条款变化不改变内容版本。 它们各自使用 listing 条款的修订号。
listing 的版本记录列出已保存的变更原因。页面没有显示原因时,只能按页面实际列出的信息判断版本含义。