SPARQL over HTTP (soh)

A command line utility for accessing SPARQL servers

Download

You can download this tool as part of our Toolkit

Documentation

soh operates in one of three modes:

Mode	Function
query	Makes SPARQL Queries
update	Makes SPARQL Updates
protocol	Makes SPARQL Graph Store protocol requests

The mode must always be specified as the first argument to the tool.

Query Mode

Command Usage is:

soh.exe query [options]

e.g. Query a endpoint with the query specified at the command line

soh.exe query --service http://dbpedia.org/sparql "SELECT * WHERE {?s a ?type} LIMIT 10"

e.g. Query an endpoint with the query taken from a file

soh.exe query --service http://dbpedia.org/sparql --query query.rq

Supported Options

Option	Purpose
--service URI or --server URI	Either argument can be used to set the SPARQL endpoint to which the query is sent
--query QUERY or --file FILE	Either of these arguments may be used to specify that the query should be taken from a file rather than the 1st anonymous argument. --query has precedence if both are specified
--accept mime/type	Used to specify the Mime Type you'd like the query results in
--v or --verbose	Used to enable Verbose mode
--nobom	Used to disable the use of BOM for UTF-8 output
#--version##	Displays the version and quits
--h or --help	Displays the help and quits

Update Mode

Command Usage is:

soh.exe update [options]

e.g. Update an endpoint specifying the update at the command line

soh.exe update service http://example.org/update "LOAD <http://dbpedia.org/resource/Ilkeston>"

e.g. Update an endpoint specifying the update using a file.

soh.exe update service http://example.org/update --update update.ru

Supported Options

Option	Purpose
--service URI or --server URI	Either argument can be used to set the SPARQL endpoint to which the update is sent
--update UPDATE or --file FILE	Either of these arguments may be used to specify that the update should be taken from a file rather than the 1st anonymous argument. --update has precedence if both are specified
--v or --verbose	Used to enable Verbose mode
--nobom	Used to disable the use of BOM for UTF-8 output
--version	Displays the version and quits
--h or --help	Displays the help and quits

Protocol Mode

Command Usage is:

soh.exe protocol [head|get|post|put|delete] datasetURI graph [file] [options]

e.g. Upload a RDF file to the default graoh

soh.exe protocol put http://example.org/dataset/data default example.rdf

e.g. Delete a given graph

soh.exe protocol delete http://example.org/dataset/data http://example.org/someGraph

Note

• The 2nd argument must be a supported HTTP method (case insensitive).
• The 3rd argument must be a SPARQL Uniform HTTP Protocol server endpoint URI
• The 4th argument must be either a Graph URI or default to indicate that either a Named Graph or the Default Graph should be affected
• The file argument is required only for the put and post methods. Using it with any other method will cause an error

Supported Options

Option	Purpose
--accept mime/type	Used to specify the MIME Type you'd like to GET graphs in
--v or --verbose	Used to enable Verbose mode
--nobom	Used to disable the use of BOM for UTF-8 output
--nocache	Disables the use of GET request caching so data retrieved is always fresh data
--version	Displays the version and quits
--h or --help	Displays the help and quits