1roqet(1) General Commands Manual roqet(1)
2
6 roqet - Rasqal RDF query utility
7
9 roqet [OPTIONS] <query-URI> [base-URI]
10 roqet [OPTIONS]-e query-string [base-URI]
11 roqet [OPTIONS]-p sparql-protocol-service-URI [-e query-string ] [base-
12 URI]
13
15 The roqet utility allows querying of RDF content using the Rasqal RDF
16 query library, printing the results in variable bindings, RDF graph or
17 boolean format. The query is read from query-URI and the optional
18 base-URI is used as the base URI of the query if present.
19
21 roqet uses the usual GNU command line syntax, with long options start‐
22 ing with two dashes (`-') if supported by the getopt_long function.
23 Otherwise only the short options are available.
24 -e, --exec QUERY
26 Execute the query in the argument QUERY instead of reading the
27 query from a URI (when -e / --exec is not given).
28 -i, --input LANGUAGE
30 Set the input query LANGUAGE to one of the supported languages
31 which includes 'sparql' (SPARQL Query Language for RDF,
32 default), 'sparql11' and 'laqrs'. The full list of supported
33 languages and subsets is given in the help summary with the -h /
34 --help option.
35 -p, --protocol SERVICE-URI
37 Call the SPARQL HTTP protocol SERVICE-URI to execute the query
38 instead of executing it inside the Rasqal query engine locally.
39 -r, --results FORMAT
41 Set the query results format.
42 For variable bindings, the values of FORMAT vary upon what
44 Rasqal supports but include 'simple' for a simple text format
45 (default), 'xml' for the SPARQL Query Results XML format,
46 'rdfxml' and 'turtle' for RDF syntax formats, and 'json' for a
47 JSON version of the results.
48 For RDF graph results, the values of FORMAT are 'ntriples' (N-
50 Triples, default), 'rdfxml-abbrev' (RDF/XML Abbreviated),
51 'rdfxml' (RDF/XML), 'turtle' (Turtle), 'json' (RDF/JSON resource
52 centric), 'json-triples' (RDF/JSON triples) or 'rss-1.0' (RSS
53 1.0, also an RDF/XML syntax).
54 The exact list of formats depends on what libraptor2(3) was
56 built with but is given correct in the usage message with -h.
57
59 -c, --count
60 Only count the triples and produce no other output.
61 -d, --dump-query FORMAT
63 Print the parsed query out in a given FORMAT one of 'none'
64 (default), 'debug', 'structure' or 'sparql'
65 -D, --data URI
67 Add RDF data source URI (not a named graph). If no data sources
68 are given, the query itself must point to the data such as via
69 SPARQL FROM uri statements.
70 -E, --ignore-errors
72 Do not print error messages and do not exit with a non-0 status.
73 -f, --feature NAME(=VALUE)
75 Set query feature NAME to the VALUE or integer 1 if omitted.
76 The known features can be shown with -f help or --feature help.
77 -F, --format NAME
79 Set the data source format name for subsequent data graphs
80 called with -D / --data or -G / --named. The default if this is
81 not specified is for the query engine to guess. The name is a
82 Raptor parser name.
83 -G, --named URI
85 Add RDF data source URI (named graph)
86 -h, --help
88 Show a summary of the options.
89 -n, --dryrun
91 Prepare the query but do not execute it.
92 -q, --quiet
94 No extra information messages.
95 -s, --source URI
97 Add RDF data source URI (named graph) URI by adding it to the
98 list of query data source URIs. FORMAT to 'simple' (default) or
99 'xml' (an experimental XML format)
100 -v, --version
102 Print the rasqal library version and exit.
103 -W, --warnings LEVEL
105 Set the warning LEVEL in the range 0 (do not warn about any‐
106 thing) to 100 (show every warning). The Rasqal default is in the
107 middle (50).
108
110 roqet sparql-query-file.rq
111 Run a SPARQL query contained in the local file sparql-query-file.rq.
113 The data used would be described in FROM statements in the query file.
114 roqet -q -i sparql http://example.org/sparql-query.rq
116 Run a SPARQL query that is in the web at URI http://example.org/sparql-
118 query.rq without an extra messages (quiet, -q).
119 roqet -q query-file.rq http://example.org/base/
121 Run an query (default languge SPARQL) from a local file query-file.rq
123 but using base URI http://example.org/base/ to resolve any relative
124 URIs.
125 roqet -q -i sparql -r xml http://example.org/sparql-query.rq
127 Run a SPARQL query that is in the web at URI http://example.org/sparql-
129 query.rq and format the results in the SPARQL Query Results XML format
130 with no extra messages.
131 roqet -i sparql -e 'SELECT * WHERE { ?s ?p ?o }' -D stuff.rdf
133 Run a SPARQL query given on the command line against data in the file
135 stuff.rdf. The type of the file will be guessed and likely is of for‐
136 mat RDF/XML.
137
139 SPARQL Query Language for RDF, Eric Prud'hommeaux and Andy Seaborne
140 (eds), W3C Recommendation, 15 January 2008.
141 http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/
142 ⟨http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/⟩
143 SPARQL Query Results XML Format, Jeen Broekstra and Dave Beckett (eds),
145 W3C Recommendation, 15 January 2008. http://www.w3.org/TR/2008/REC-
146 rdf-sparql-XMLres-20080115/ ⟨http://www.w3.org/TR/2008/REC-rdf-sparql-
147 XMLres-20080115/⟩
148
150 librasqal(3),[22mlibraptor(3)
151
154 Dave Beckett - http://www.dajobe.org/ ⟨http://www.dajobe.org/⟩
155 2011-06-11 roqet(1)