Rasqal RDF Query Library - Rasqal RDF parser utility


roqet − Rasqal RDF query utility


roqet [OPTIONS] <query-URI> [base-URI]
[OPTIONS]--exec query-string [base-URI]


roqet example.rdql
roqet -q -i rdql x.rdql http://example.org/base/
roqet -i sparql -r xml http://example.org/query.rq


The roqet utility allows querying of RDF content using the Rasqal RDF query library, printing the results in variable bindings, RDF graph or boolean format. The query is read from query-URI and the optional base-URI is used as the base URI of the query if present.


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.

−h, −−help

Show a summary of the options. −i, −−input LANGUAGE Set the input query LANGUAGE to one of’sparql’ (SPARQL Query Language for RDF, default) or ’rdql’ (RDF Data Query Language). The list of supported languages is given in the help summary given by −h.

−r, −−results FORMAT

Set the query results format.

For variable bindings, the values of FORMAT are ’simple’ for a simple text format (default), ’xml’ for the SPARQL Query Results XML format, ’xml-v2’ for the version of the 2005-05-27 working draft, and ’json’ for a JSON version of the results. The older xml formats may be removed in future releases.

For RDF graph results, the values of FORMAT are ’ntriples’ (N-Triples, default), ’rdfxml-abbrev’ (RDF/XML Abbreviated), ’rdfxml’ (RDF/XML), or ’rss-1.0’ (RSS 1.0, also an RDF/XML syntax).

The exact list of formats depends on what libraptor(3) was built with but is given correct in the usage message with −h.

−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 ’debug’, ’structure’ or ’sparql’

−e, −−exec QUERY

Execute the query in the argument QUERY instead of reading the query from a URI.

−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.

−n, −−dryrun

Prepare the query but do not execute it.

−q, −−quiet

No extra information messages.

−s, −−source URI

Query against RDF data at source 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, −−walk-query

Walk the query and display it using the API.


SPARQL Query Language for RDF, Eric Prud’hommeaux and Andy Seaborne (eds), W3C Candidate Recommendation, 6 April 2006. http://www.w3.org/TR/2006/CR-rdf-sparql-query-20060406/

SPARQL Query Results XML Format, Jeen Broekstra and Dave Beckett (eds), W3C Candidate Recommendation, 6 April 2006. http://www.w3.org/TR/2006/CR-rdf-sparql-XMLres-20060406/

SPARQL Query Results XML Format, Edited by Dave Beckett, W3C Working Draft, 27 May 2005. Work in progress. http://www.w3.org/TR/2005/WD-rdf-sparql-XMLres-20050527/

SPARQL Variable Binding Results XML Format, Edited by Dave Beckett, W3C Working Draft, 21 December 2004. Work in progress. http://www.w3.org/TR/2004/WD-rdf-sparql-XMLres-20041221/

RDQL - A Query Language for RDF, Andy Seaborne, W3C Member Submission 9 January 2004 http://www.w3.org/Submission/2004/SUBM-RDQL-20040109/





Dave Beckett

Copyright 2002-2006 Dave Beckett
2002-2005 University of Bristol