stain/jena

Jena 命令行工具

• Docker镜像：https://hub.docker.com/r/stain/jena/
• 基础镜像：https://hub.docker.com/r/_/openjdk/:11-jre-slim-buster
• 源码：https://github.com/stain/jena-docker/blob/master/jena/Dockerfile%EF%BC%8CApache Jena

![构建状态]([***]

此Docker镜像提供了Apache Jena的命令行工具riot及其变体（如turtle、rdfxml），此外还包含其他Jena命令行工具，如rdfcompare、tdbloader和sparql。

许可证

不同Docker层添加的文件适用不同的许可证：

• stain/jena https://github.com/stain/jena-docker/blob/master/jena/Dockerfile%EF%BC%9AApache%E8%AE%B8%E5%8F%AF%E8%AF%812.0%E7%89%88
• Apache Jena（镜像中的/jena）：Apache许可证2.0版，另见：docker run stain/jena cat /jena/NOTICE
• OpenJDK（镜像中的/usr/local/openjdk-11/）：GPL 2.0带Classpath异常，详见镜像中的/usr/local/openjdk-11/legal/
• Debian GNU/Linux（/的其余部分）：GPL 3及兼容许可证，详见镜像中的/usr/share/*/license

使用方法

bash
docker run stain/jena riot http://www.w3.org/2013/TurtleTests/SPARQL_style_prefix.ttl

关于riot的文档，可尝试：

bash
docker run stain/jena riot --help

    riot [--time] [--check|--noCheck] [--sink] [--base=IRI] [--out=FORMAT] file ...
      解析器控制
          --sink                 解析但丢弃输出
          --syntax=NAME          设置语法（否则从文件扩展名猜测语法）
          --base=URI             设置基础URI（不适用于N-triples和N-Quads）
          --check                额外检查RDF术语
          --strict               严格模式运行
          --validate             等同于 --sink --check --strict
          --rdfs=file            使用文件中的词汇表应用某些RDFS推理
          --nocheck              关闭RDF术语检查
          --stop                 遇到错误RDF术语时停止解析
      输出控制
          --output=FMT           以指定格式输出，尽可能流式处理
          --formatted=FMT        输出，使用美观打印（消耗内存）
          --stream=FMT           输出，使用流式格式
      时间
          --time                 计时操作
      符号定义
          --set                  将配置符号设置为某个值
      常规
          -v   --verbose         详细模式
          -q   --quiet           最小输出模式
          --debug                输出调试信息
          --help
          --version              版本信息

镜像的默认工作目录是/rdf，可结合Docker卷处理本地文件：

bash
docker run --volume /home/stain/Downloads:/rdf stain/jena riot db-uniprot-ls.ttl

注意riot目前没有指定输出文件的选项（见JENA-1032），因此需要使用主机shell的管道：

bash
docker run --volume /home/stain/Downloads:/rdf stain/jena riot db-uniprot-ls.ttl > /home/stain/Downloads/db-uniprot-ls.nq

要在Docker容器内执行多个riot命令：

bash
docker run -it stain/jena sh

注意此镜像基于最小化的Debian GNU/Linux安装，可使用apt命令安装额外工具。

其他命令行工具

包含Jena发行版的所有命令行工具：

bash
docker run stain/jena ls /jena/bin

• arq
• infer
• iri
• juuid
• nquads
• ntriples
• qparse
• rdfcat
• rdfcompare
• rdfcopy
• rdfparse
• rdfxml
• riot
• rset
• rsparql
• rupdate
• schemagen
• sparql
• tdbbackup
• tdbdump
• tdbloader
• tdbloader2
• tdbloader2common
• tdbloader2data
• tdbloader2index
• tdbquery
• tdbstats
• tdbupdate
• trig
• turtle
• uparse
• update
• utf8
• wwwdec
• wwwenc

示例：

stain@biggie:~/src/jena/apache-jena$ docker run stain/jena sparql -h
sparql --data=<file> --query=<query>
  控制
      --explain              解释并记录查询执行
      --repeat=N or N,M      执行N次或N次预热后执行M次（用于计时以克服Java启动成本）
      --optimize=            打开或关闭查询优化器（默认：打开）
  时间
      --time                 计时操作
  查询引擎
      --engine=EngineName    注册另一个引擎工厂[ref]
      --unengine=EngineName   注销引擎工厂
  数据集
      --data=FILE            数据集的数据 - 三元组或四元组格式
      --graph=FILE           数据集默认图的图
      --namedGraph=FILE      将图作为命名图添加到数据集
  结果
      --results              结果格式（结果集：text、XML、JSON、CSV、TSV；图：RDF序列化）
      --desc=                装配器描述文件
  查询
      --query, --file        包含查询的文件
      --syntax, --in         查询语法
      --base                 查询的基础URI
  符号定义
      --set                  将配置符号设置为某个值
      --strict               严格SPARQL模式运行（不允许任何扩展）
  常规
      -v   --verbose         详细模式
      -q   --quiet           最小输出模式
      --debug                输出调试信息
      --help
      --version              版本信息

注意需要使用docker run --volume使本地文件可被这些命令访问。

GitHub Action

@vemonet制作了一个GitHub Action https://github.com/marketplace/actions/validate-rdf-with-jena%EF%BC%8C%E5%8F%AF%E7%94%A8%E4%BA%8E%E5%9C%A8GitHub%E6%8F%90%E4%BA%A4%E6%97%B6%E9%AA%8C%E8%AF%81%E6%88%96%E8%BD%AC%E6%8D%A2RDF%E6%96%87%E4%BB%B6%EF%BC%9A

yaml
- uses: vemonet/jena-riot-action@v3.14
  with:
    input: my_file.ttl
    convert: --output=NQUADS

详见https://github.com/vemonet/jena-riot-action。

联系方式

有关Jena、riot和此Docker镜像的任何反馈，请使用users@jena邮件列表。

有关Jena或riot的任何问题，可提交bug。

有关此Docker镜像的打包问题或其https://github.com/stain/jena-docker/%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/stain/jena-docker/pulls%E6%88%96https://github.com/stain/jena-docker/issues%E3%80%82