Script: pvload.sh

What is first

• vload - a "provenance-free" shell script wrapper to Virtuoso's isql-vt.
• Naming sparql service description's sd:NamedGraph, so we can name a SPARQL endpoints' named graph.
• Named graphs that know where they came from, talks about provenance modeling of named graphs.

What we will cover

This page describes how to use pvload.sh to capture provenance of loading SPARQL triple store named graphs.

Let's get to it!

Usage

$ pvload.sh --help
usage: pvload.sh [--help] [-n] url [-ng named_graph]
  -n  : dry run - do not download or load into named graph.
  url : the URL to retrieve and load into a named graph.
  -ng : the named graph to place 'url'. (if not provided, -ng == 'url').

  (Setting envvar CSV2RDF4LOD_CONVERT_DEBUG_LEVEL=finest will leave temporary files after invocation.)

Environment variables that matter

• CSV2RDF4LOD_BASE_URI is used to create URIs for instances of provenance.
• CSV2RDF4LOD_PUBLISH_VIRTUOSO_SPARQL_ENDPOINT is the forward-facing URL for the SPARQL endpoint, e.g. http://opendap.tw.rpi.edu/sparql.

Loading a URL and the provenance of the load into the same named graph

Let's load one triple into the graph named http://example.org/pvload-test:

pvload.sh http://purl.org/twc/eg/sames -ng http://example.org/pvload-test

When this is done on opendap.tw.rpi.edu, a summary of the named graph can be found at http://opendap.tw.rpi.edu/graph/http/example.org/pvload-test. Because the graph that we loaded only had 1 triple, and the named graph ends up with 128, pvload.sh added 127 triples of provenance.

What is next

• Script: cache-queries.sh can be used to capture the provenance of querying a SPARQL endpoint.