kanselarij/themis-same-as-service

themis-same-as-service

该服务用于处理由http://github.com/kanselarij-vlaanderen/themis-publication-consumer%E6%8F%90%E4%BE%9B%E7%9A%84%E6%95%B0%E6%8D%AE%EF%BC%8C%E5%AE%8C%E6%88%90%E6%95%B0%E6%8D%AE%E5%87%86%E5%A4%87%E4%B8%8E%E6%B8%85%E7%90%86%E5%B7%A5%E4%BD%9C%EF%BC%8C%E4%BD%BF%E6%95%B0%E6%8D%AE%E5%8F%AF%E8%A2%ABhttp://github.com/kanselarij-vlaanderen/dcat-dataset-publication-service%E5%8F%91%E5%B8%83%E3%80%82

教程

将服务添加到堆栈

在docker-compose.yml中添加该服务：

  themis-same-as:
    image: docker.xuanyuan.run/kanselarij/themis-same-as

接下来，让服务监听新的转换任务。假设堆栈中已存在delta-notifier，在./config/delta/rules的delta-notifier配置中添加以下规则：

javascript
export default [
  {
    match: {
      predicate: {
        type: 'uri',
        value: 'http://www.w3.org/ns/adms#status'
      },
      object: {
        type: 'uri',
        value: 'http://kanselarij.vo.data.gift/release-task-statuses/not-started'
      }
    },
    callback: {
      method: 'POST',
      url: 'http://themis-same-as/delta'
    },
    options: {
      resourceFormat: 'v0.0.1',
      gracePeriod: 250,
      ignoreFromSelf: true
    }
  }
];

参考

配置

可选择性配置以下环境变量：

• SELECT_BATCH_SIZE (默认值:1000): 单次SPARQL查询中选择的三元组数量

模型

使用的前缀

发布任务

类

ext:ReleaseTask

属性

发布任务状态

发布任务的状态会随进度更新，已知状态包括：

• [***]
• [***]
• [***]
• [***]
• [***]
• [***]

数据流

当状态为<http://kanselarij.vo.data.gift/release-task-statuses/not-started>的发布任务被准备时，服务被触发。任务执行包括为所有非白名单URI域创建新的Themis URI，并替换与发布任务关联的临时图中的URI。

白名单域包括：

• [***]
• [***]
• [***]
• [***]
• [***]
• [***]
• [***]
• [***]
• [***]
• http://www.w3.org
• [***]
• share://

处理过程中若发生错误，后续发布任务将被阻塞。

处理成功时，ext:ReleaseTask的状态更新为ready-for-release。

服务有一个核心假设需始终遵守：任何时刻最多运行1个发布任务。

API

POST /delta

接收来自delta-notifier的增量数据，准备与发布任务关联的数据以便实际发布。数据准备成功后，发布任务状态将更新为ready for release。该端点由外部在新发布任务创建时触发，不建议手动调用。