跳到内容
九天共学
工具实操
工具实操 / 查询与校验

Jena / SHACL

让缺失和错误,有据可查。

准备 RDF 数据,写一条查询,再用 SHACL 定位缺项、重复和类型错误。

免费学习3 节微课 · 含练习约 40 分钟心晴九天整理
先看一遍过程 · 交互图解1 / 3

报名 → 学员 → 课程

先确认本次检查的是哪份数据

适合要查询 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
只用必需匹配 ?enrollment ex:learner ?learner,缺 learner 的记录会怎样?

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
  ] .
只写 sh:minCount 1,能挡住一笔报名关联两个学员吗?

03 · 把报告接回业务

校验通过,只说明给定数据满足给定约束。

learner 指向一个 IRI,可以满足本例的格式要求,却不证明这名学员现实存在、身份正确、已经付款或有操作权限。需要这些条件时,要补数据来源、业务查询与对应约束。

Agent 可以帮助解释校验报告,但应引用实际节点与失败约束。正式系统应由程序产生校验结论,模型不能因为“看起来合理”而把 conforms:false 改写成已通过。

建立一组回归样例:正常、缺项、重复、文字值代替 IRI。修改 shapes 后把这组输入重新跑一遍,记录工具版本、数据版本和报告。这样能知道规则改动究竟影响了哪些情况。

校验报告 conforms:true,是否已经证明报名可以开通?
动手试一下

换一份数据,看报告怎么变。

这是本页的规则教学演示。完整工具运行请下载下方案例;演示不调用模型,刷新后重置。

ex:Enroll001 a ex:Enrollment ; ex:learner ex:Lin .
带走自己的案例

下载后,跑出真实结果。

三份 RDF 数据、一份 SHACL 约束、一条 SPARQL 查询,以及可复查的校验结果。

下载完整练习包
单独下载文件
网站演示用于理解机制;工具样例的运行步骤、依赖和边界写在练习包 README 中。

需要更系统的解释?接着看原课。

对应原文与出处

中文内容为原创导读与自编案例,不是官方完整译本。外部原文用于进一步核对,本站微课与练习可先独立学习。

  • 官方教程 · 现行网页

    Apache Jena SHACL

    核对数据图、形状图、validate 命令与校验报告。

  • 官方教程 · 现行网页

    Apache Jena ARQ / SPARQL

    核对查询引擎与命令行入口。

  • 正式规范 · 2017

    W3C Shapes Constraint Language

    核对 minCount、maxCount、nodeKind 与校验报告语义。

来源核验:2026-11-12 · 署名与许可说明
使用统计:关闭

帮助心晴了解哪些内容有用。默认关闭;不记录问题正文、私人笔记、手机号或聊天内容。

允许关联后,登录账号的页面与操作可由运营查看。已启用浏览器“不跟踪”时不采集。明细最多保留 90 天,后台读取或每日首次采集时清理。