lvanwissen/virtuoso

Virtuoso Docker镜像

镜像概述和主要用途

Docker镜像用于托管Virtuoso，Virtuoso是一个开源的RDF数据库。该镜像基于https://github.com/openlink/virtuoso-opensource%E7%9A%84%E7%89%B9%E5%AE%9A%E6%8F%90%E4%BA%A4SHA%E6%9E%84%E5%BB%BA%E3%80%82%E9%95%9C%E5%83%8F%E6%A0%87%E7%AD%BE%E5%8C%85%E5%90%AB%E5%AE%B9%E5%99%A8%E4%B8%AD%E5%AE%89%E8%A3%85%E7%9A%84Virtuoso%E7%89%88%E6%9C%AC%EF%BC%8C%E5%BD%93%E5%89%8D%E5%8F%AF%E7%94%A8%E7%89%88%E6%9C%AC%E5%A6%82%E4%B8%8B%EF%BC%9A

• 1.3.2-virtuoso7.2.5（或virtuoso7.2.5为最新版）
• 1.3.2-virtuoso7.2.4（或virtuoso7.2.4为最新版）
• 1.3.2-virtuoso7.2.2（或virtuoso7.2.2为最新版）
• 1.3.2-virtuoso7.2.1（或virtuoso7.2.1为最新版）
• 1.3.2-virtuoso7.2.0（或virtuoso7.2.0为最新版）

核心功能和特性

• 版本化标签：镜像标签明确标识Virtuoso版本，便于版本管理
• 灵活配置：支持通过环境变量设置DBA密码、启用SPARQL更新权限
• ini参数自定义：可通过环境变量配置virtuoso.ini中的所有属性
• 数据持久化：数据库文件夹挂载于/data，确保数据持久化
• 自动数据加载：首次启动时自动加载/data/toLoad目录中的数据
• 端口暴露：暴露8890（HTTP/SPARQL）和1111（数据库服务）端口

使用场景和适用范围

适用于需要RDF数据存储、SPARQL查询服务的场景，如语义网应用、知识图谱构建、Linked Data项目等，尤其适合需要快速部署和配置Virtuoso的开发与生产环境。

使用方法和配置说明

运行Virtuoso容器

bash
docker run --name my-virtuoso \
    -p 8890:8890 -p 1111:1111 \
    -e DBA_PASSWORD=myDbaPassword \
    -e SPARQL_UPDATE=true \
    -e DEFAULT_GRAPH=http://www.example.com/my-graph \
    -v /my/path/to/the/virtuoso/db:/data \
    -d tenforce/virtuoso

• Virtuoso数据库文件夹挂载于/data
• 镜像暴露端口8890（HTTP/SPARQL端点）和1111（数据库服务）

Docker Compose配置

可通过docker-compose配置使用镜像：

yaml
db:
  image: tenforce/virtuoso:1.3.1-virtuoso7.2.2
  environment:
    SPARQL_UPDATE: "true"
    DEFAULT_GRAPH: "http://www.example.com/my-graph"
  volumes:
    - ./data/virtuoso:/data
  ports:
    - "8890:8890"

配置说明

DBA密码

通过DBA_PASSWORD环境变量在容器启动时设置dba用户密码。若未设置，将使用默认密码。

SPARQL更新权限

将SPARQL_UPDATE环境变量设置为true，可授予SPARQL端点的更新权限。

.ini配置

virtuoso.ini中的所有属性可通过环境变量配置，格式为VIRT_$SECTION_$KEY，其中$SECTION和$KEY区分大小写，需与virtuoso.ini中的驼峰式命名一致。例如，Database section中的ErrorLogFile属性应配置为VIRT_Database_ErrorLogFile=error.log。

数据导出为Quads

进入Virtuoso容器，打开ISQL并执行dump_nquads过程，导出文件将保存在/my/path/to/the/virtuoso/db/dumps中：

bash
docker exec -it my-virtuoso bash
isql-v -U dba -P $DBA_PASSWORD
SQL> dump_nquads ('dumps', 1, 10000000, 1);

更多信息参见：[***]

加载Quads数据

手动加载

将.nq格式的quad文件（可压缩）放入/my/path/to/the/virtuoso/db/dumps目录，进入容器，打开ISQL，注册并运行加载：

bash
docker exec -it my-virtuoso bash
isql-v -U dba -P $DBA_PASSWORD
SQL> ld_dir('dumps', '*.nq', 'http://foo.bar');
SQL> rdf_loader_run();

通过以下命令验证加载状态，ll_state为2表示加载完成：

sql
select * from DB.DBA.load_list;

更多信息参见：[***]

自动加载

默认情况下，容器首次启动时，Virtuoso数据库文件夹（/my/path/to/the/virtuoso/db）中的toLoad目录下的所有数据将自动加载。默认图由DEFAULT_GRAPH环境变量设置，默认为http://localhost:8890/DAV。

创建备份

通过ISQL接口执行以下命令创建Virtuoso备份：

bash
docker exec -i virtuoso_container mkdir -p backups
docker exec -i virtuoso_container isql-v <<EOF
    exec('checkpoint');
    backup_context_clear();
    backup_online('backup_',30000,0,vector('backups'));
    exit;
EOF

恢复备份

方法一：使用新容器恢复

停止运行中的容器，使用新容器恢复数据库：

bash
docker run --rm  -it -v path-to-your-database:/data tenforce/virtuoso virtuoso-t +restore-backup backups/backup_ +configfile /data/virtuoso.ini

备份恢复完成后，新容器将退出，可重启原数据库容器。

方法二：通过环境变量自动恢复

将备份文件放入/data/backups目录，使用环境变量BACKUP_PREFIX在启动时自动恢复，无需单独运行恢复容器：

bash
docker run --name my-virtuoso \
            -p 8890:8890 \
            -p 1111:1111 \
            -e DBA_PASSWORD=dba \
            -e SPARQL_UPDATE=true \
            -e BACKUP_PREFIX=backup_ \
            -v path-to-your-database:/data \
            -d tenforce/virtuoso

贡献指南

欢迎对本仓库做出贡献，请在master分支创建拉取请求。新功能将首先在tenforce/virtuoso:latest镜像上测试，验证通过后，版本分支将基于master分支进行变基。