Jena / SHACL
让缺失和错误,有据可查。
准备 RDF 数据,写一条查询,再用 SHACL 定位缺项、重复和类型错误。
报名 → 学员 → 课程
先确认本次检查的是哪份数据
适合要查询 RDF、核对数据是否满足明确约束的人。先掌握输入图、约束图和报告,再考虑接入 Agent。
01 · 先查出一条事实
同一份图,分别用查询和校验回答不同的问题。
RDF 用主语、谓语、宾语表示事实。案例中的 Enroll001 是报名记录,learner 连接到 Lin,course 连接到 IntroCourse。示例域名 example.org 只作标识,不代表真实学员或接口。
Apache Jena 的 ARQ 组件能执行 SPARQL 查询。下载案例中的 query.rq 会查出每条报名的学员;用 OPTIONAL 保留缺少 learner 的记录,这样缺项不会悄悄消失在普通关联查询里。
查询结果回答“找到了什么”;SHACL 回答“给定数据是否满足这些约束”。二者不能互相替代。安装命令行工具时,按 Apache 当前下载页核对 Java 版本,本案例以 Jena 6.2.0、Java 21+ 为验证基线。
PREFIX ex: <https://example.org/jiutian/>
SELECT ?enrollment ?learner WHERE {
?enrollment a ex:Enrollment .
OPTIONAL { ?enrollment ex:learner ?learner }
}
ORDER BY ?enrollment跟着做这三步
- 打开 valid.ttl,指出一条三元组。
- 运行 query.rq,再把输入换成 missing.ttl。
- 解释 OPTIONAL 为什么保留了缺学员的报名。
02 · 写清“有且只有一个”
先检查一项,再增加约束,让失败的原因容易解释。
EnrollmentShape 以 ex:Enrollment 为目标类,检查 ex:learner 属性。sh:minCount 1 表示至少有一个值;sh:maxCount 1 表示最多有一个值;sh:nodeKind sh:IRI 要求值是 IRI,而不是一个普通文字。
三个输入文件分别有一个学员、缺少学员、有两个学员。使用 Jena shacl validate 指定 shapes.ttl 与输入图;在报告中检查 sh:conforms 和 sh:result,而不是只看终端是否出现一段文字。
一条记录可能同时触发多条约束。报告应保留 focusNode、resultPath、constraintComponent 等信息,这样才能定位到具体记录和约束。不能把“出现报告”当成“校验通过”。
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix ex: <https://example.org/jiutian/> .
ex:EnrollmentShape a sh:NodeShape ;
sh:targetClass ex:Enrollment ;
sh:property [
sh:path ex:learner ;
sh:minCount 1 ; sh:maxCount 1 ;
sh:nodeKind sh:IRI
] .跟着做这三步
- 先运行 valid.ttl,确认报告 conforms 为 true。
- 换成 missing.ttl,观察 MinCount 失败。
- 再运行 duplicate.ttl,观察 MaxCount 失败。
03 · 把报告接回业务
校验通过,只说明给定数据满足给定约束。
learner 指向一个 IRI,可以满足本例的格式要求,却不证明这名学员现实存在、身份正确、已经付款或有操作权限。需要这些条件时,要补数据来源、业务查询与对应约束。
Agent 可以帮助解释校验报告,但应引用实际节点与失败约束。正式系统应由程序产生校验结论,模型不能因为“看起来合理”而把 conforms:false 改写成已通过。
建立一组回归样例:正常、缺项、重复、文字值代替 IRI。修改 shapes 后把这组输入重新跑一遍,记录工具版本、数据版本和报告。这样能知道规则改动究竟影响了哪些情况。
跟着做这三步
- 给一条失败报告写一句能定位问题的说明。
- 再加入 learner 为文字的反例。
- 写下一项通过本例仍然不能证明的业务事实。
换一份数据,看报告怎么变。
这是本页的规则教学演示。完整工具运行请下载下方案例;演示不调用模型,刷新后重置。
ex:Enroll001 a ex:Enrollment ; ex:learner ex:Lin .需要更系统的解释?接着看原课。
对应原文与出处
中文内容为原创导读与自编案例,不是官方完整译本。外部原文用于进一步核对,本站微课与练习可先独立学习。
- 官方教程 · 现行网页
Apache Jena SHACL
核对数据图、形状图、validate 命令与校验报告。
- 官方教程 · 现行网页
Apache Jena ARQ / SPARQL
核对查询引擎与命令行入口。
- 正式规范 · 2017
W3C Shapes Constraint Language
核对 minCount、maxCount、nodeKind 与校验报告语义。