Man Linux: Main Page and Category List

NAME

       roqet - Rasqal RDF query utility

SYNOPSIS

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

DESCRIPTION

       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.

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 in the argument QUERY instead of  reading  the
              query from a URI (when -e is not given).

       -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  vary  upon  what
              Rasqal  supports  but  include ’simple’ for a simple text format
              (default), ’xml’ for the SPARQL Query  Results  XML  format  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 libraptor(3) was built
              with but is given correct in the usage message with -h.

OTHER OPTIONS

       -c, --count
              Only count the triples and produce no other output.

       -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 or RDQL FROM uri statements.

       -d, --dump-query FORMAT
              Print the parsed query out in a given  FORMAT  one  of  ’debug’,
              ’structure’ or ’sparql’

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

       -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, --walk-query
              Walk the query and display it using the API.

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 -i rdql rdql-query-file.rdql http://example.org/base/

       Run an RDQL query from a local file rdql-query-file.rdql 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 -eSELECT * 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.

CONFORMING TO

       SPARQL  Query  Language  for  RDF, Eric Prud’hommeaux and Andy Seaborne
       (eds),      W3C      Recommendation,       15       January       2008.
       http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/

       SPARQL Query Results XML Format, Jeen Broekstra and Dave Beckett (eds),
       W3C Recommendation, 15  January  2008.   http://www.w3.org/TR/2008/REC-
       rdf-sparql-XMLres-20080115/

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

SEE ALSO

       librasqal(3),rasqal-config(1),libraptor(3)

CHANGES

AUTHOR

       Dave Beckett - http://www.dajobe.org/

                                  2009-12-15                          roqet(1)