Provided by: rasqal-utils_0.9.33-2.1build1_amd64 
NAME
roqet - Rasqal RDF query utility
SYNOPSIS
roqet [OPTIONS] <query-URI> [base-URI]
roqet [OPTIONS]-e query-string [base-URI]
roqet [OPTIONS]-p sparql-protocol-service-URI query-URI [base-URI]
roqet [OPTIONS]-p sparql-protocol-service-URI [-e query-string ] [base-URI]
roqet [OPTIONS]-t query results file [base-URI]
DESCRIPTION
The roqet utility allows querying of RDF content using the Rasqal RDF query library,
printing the results for variable bindings, RDF graph or boolean results in a variety of
formats. The query is read from query-URI and the optional base-URI is used as the base
URI of the query if present.
MAIN OPTIONS
roqet uses the usual GNU command line syntax, with long options starting with two dashes
(`-') if supported by the getopt_long function. Otherwise only the short options are
available.
-e, --exec QUERY
Execute the query string in the argument QUERY instead of reading the query from a
URI (when -e / --exec is not given).
-i, --input LANGUAGE
Set the input query LANGUAGE to one of the supported languages which includes
'sparql' (SPARQL Query Language for RDF, default), 'sparql11' and 'laqrs'. The
full list of supported languages and subsets is given in the help summary with the
-h / --help option.
-p, --protocol SERVICE-URI
Call the SPARQL HTTP protocol SERVICE-URI to execute the query instead of executing
it inside the Rasqal query engine locally ( when -e is given, or a query string
given)
-r, --results FORMAT
Set the query results output FORMAT
For variable bindings, the values of FORMAT vary upon what Rasqal supports but
include 'simple' for a simple text format (default), 'xml' for the SPARQL Query
Results XML format, 'csv' for SPARQL CSV, 'tsv' for SPARQL TSV, 'rdfxml' and
'turtle' for RDF syntax formats, and 'json' for a JSON version of the results.
For RDF graph results, the values of FORMAT are 'ntriples' (N-Triples, default),
'rdfxml-abbrev' (RDF/XML Abbreviated), 'rdfxml' (RDF/XML), 'turtle' (Turtle),
'json' (RDF/JSON resource centric), 'json-triples' (RDF/JSON triples) or 'rss-1.0'
(RSS 1.0, also an RDF/XML syntax).
The exact list of formats depends on what libraptor2(3) was built with but is given
correct in the usage message with -h.
-R, --results-input-format FORMAT
Set the query results input FORMAT
This is for use with -t and takes values of 'xml' for the SPARQL Query Results XML
format,, 'csv' for SPARQL CSV,, 'tsv' for SPARQL TSV, 'turtle' and 'rdfxml' for RDF
syntax formats.
-t, --results-input FILE
Read query results from FILE
OTHER OPTIONS
-c, --count
Only count the triples and produce no other output.
-d, --dump-query FORMAT
Print the parsed query out in a given FORMAT one of 'none' (default), 'debug',
'structure' or 'sparql'
-D, --data URI
Add RDF data source URI (not a named graph). If no data sources are given, the
query itself must point to the data such as via SPARQL FROM uri statements.
-E, --ignore-errors
Do not print error messages and do not exit with a non-0 status.
-f, --feature NAME(=VALUE)
Set query feature NAME to the VALUE or integer 1 if omitted. The known features
can be shown with -f help or --feature help.
-F, --format NAME
Set the data source format name for subsequent data graphs called with -D / --data
or -G / --named. The default if this is not specified is for the query engine to
guess. The name is a Raptor parser name.
-G, --named URI
Add RDF data source URI (named graph)
-h, --help
Show a summary of the options.
-n, --dryrun
Prepare the query but do not execute it.
-q, --quiet
No extra information messages.
-s, --source URI
Add RDF data source URI (named graph) URI by adding it to the list of query data
source URIs. FORMAT to 'simple' (default) or 'xml' (an experimental XML format)
-v, --version
Print the rasqal library version and exit.
-W, --warnings LEVEL
Set the warning LEVEL in the range 0 (do not warn about anything) to 100 (show
every warning). The Rasqal default is in the middle (50).
EXAMPLES
roqet sparql-query-file.rq
Run a SPARQL query contained in the local file sparql-query-file.rq. The data used would
be described in FROM statements in the query file.
roqet -q -i sparql http://example.org/sparql-query.rq
Run a SPARQL query that is in the web at URI http://example.org/sparql-query.rq without an
extra messages (quiet, -q).
roqet -q query-file.rq http://example.org/base/
Run an query (default languge SPARQL) from a local file query-file.rq but using base URI
http://example.org/base/ to resolve any relative URIs.
roqet -q -i sparql -r xml http://example.org/sparql-query.rq
Run a SPARQL query that is in the web at URI http://example.org/sparql-query.rq and format
the results in the SPARQL Query Results XML format with no extra messages.
roqet -i sparql -e 'SELECT * WHERE { ?s ?p ?o }' -D stuff.rdf
Run a SPARQL query given on the command line against data in the file stuff.rdf. The type
of the file will be guessed and likely is of format RDF/XML.
roqet -t result.srx -r html
Read a SPARQL query results in SPARQL Query Results XML format (default) and print it in
HTML.
roqet -t result.ttl -R turtle -r csv
Read a SPARQL query results in RDF/Turtle format and print it in CSV.
CONFORMING TO
SPARQL 1.1 Query Language, Steve Harris and Andy Seaborne (eds), W3C Recommendation, 21
March 2013 http://www.w3.org/TR/2013/REC-sparql11-query-20130321/
⟨http://www.w3.org/TR/2013/REC-sparql11-query-20130321/⟩
SPARQL Query Results XML Format (Second Edition), Sandro Hawke (Second Edition ed), Jeen
Broekstra and Dave Beckett (eds), W3C Recommendation, 21 March 2013.
http://www.w3.org/TR/2013/REC-rdf-sparql-XMLres-20130321/ ⟨http://www.w3.org/TR/2013/REC-
rdf-sparql-XMLres-20130321/⟩
SEE ALSO
librasqal(3),libraptor(3)
CHANGES
AUTHOR
Dave Beckett - http://www.dajobe.org/ ⟨http://www.dajobe.org/⟩
2013-12-11 roqet(1)