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 is not given).
28 -i, --input LANGUAGE
30 Set the input query LANGUAGE to one of'sparql' (SPARQL Query
31 Language for RDF, default) or 'rdql' (RDF Data Query Language).
32 The list of supported languages is given in the help summary
33 given by -h.
34 -p, --protocol SERVICE-URI
36 Call the SPARQL HTTP protocol SERVICE-URI to execute the query
37 instead of executing it inside the Rasqal query engine locally.
38 -r, --results FORMAT
40 Set the query results format.
41 For variable bindings, the values of FORMAT vary upon what
43 Rasqal supports but include 'simple' for a simple text format
44 (default), 'xml' for the SPARQL Query Results XML format and
45 'json' for a JSON version of the results.
46 For RDF graph results, the values of FORMAT are 'ntriples' (N-
48 Triples, default), 'rdfxml-abbrev' (RDF/XML Abbreviated),
49 'rdfxml' (RDF/XML), 'turtle' (Turtle), 'json' (RDF/JSON resource
50 centric), 'json-triples' (RDF/JSON triples) or 'rss-1.0' (RSS
51 1.0, also an RDF/XML syntax).
52 The exact list of formats depends on what libraptor(3) was built
54 with but is given correct in the usage message with -h.
55
57 -c, --count
58 Only count the triples and produce no other output.
59 -d, --dump-query FORMAT
61 Print the parsed query out in a given FORMAT one of 'debug',
62 'structure' or 'sparql'
63 -D, --data URI
65 Add RDF data source URI (not a named graph). If no data sources
66 are given, the query itself must point to the data such as via
67 SPARQL or RDQL FROM uri statements.
68 -f, --feature NAME(=VALUE)
70 Set query feature NAME to the VALUE or integer 1 if omitted.
71 The known features can be shown with -f help or --feature help.
72 -F, --format NAME
74 Set the data source format name for subsequent data graphs
75 called with -D / --data or -G / --named. The default if this is
76 not specified is for the query engine to guess. The name is a
77 Raptor parser name.
78 -G, --named URI
80 Add RDF data source URI (named graph)
81 -h, --help
83 Show a summary of the options.
84 -n, --dryrun
86 Prepare the query but do not execute it.
87 -q, --quiet
89 No extra information messages.
90 -s, --source URI
92 Add RDF data source URI (named graph) URI by adding it to the
93 list of query data source URIs. FORMAT to 'simple' (default) or
94 'xml' (an experimental XML format)
95 -v, --version
97 Print the rasqal library version and exit.
98 -w, --walk-query
100 Walk the query and display it using the API.
101
103 roqet sparql-query-file.rq
104 Run a SPARQL query contained in the local file sparql-query-file.rq.
106 The data used would be described in FROM statements in the query file.
107 roqet -q -i sparql http://example.org/sparql-query.rq
109 Run a SPARQL query that is in the web at URI http://example.org/sparql-
111 query.rq without an extra messages (quiet, -q).
112 roqet -q -i rdql rdql-query-file.rdql http://example.org/base/
114 Run an RDQL query from a local file rdql-query-file.rdql but using base
116 URI http://example.org/base/ to resolve any relative URIs.
117 roqet -q -i sparql -r xml http://example.org/sparql-query.rq
119 Run a SPARQL query that is in the web at URI http://example.org/sparql-
121 query.rq and format the results in the SPARQL Query Results XML format
122 with no extra messages.
123 roqet -i sparql -e 'SELECT * WHERE { ?s ?p ?o }' -D stuff.rdf
125 Run a SPARQL query given on the command line against data in the file
127 stuff.rdf. The type of the file will be guessed and likely is of for‐
128 mat RDF/XML.
129
131 SPARQL Query Language for RDF, Eric Prud'hommeaux and Andy Seaborne
132 (eds), W3C Recommendation, 15 January 2008.
133 http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/
134 ⟨http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/⟩
135 SPARQL Query Results XML Format, Jeen Broekstra and Dave Beckett (eds),
137 W3C Recommendation, 15 January 2008. http://www.w3.org/TR/2008/REC-
138 rdf-sparql-XMLres-20080115/ ⟨http://www.w3.org/TR/2008/REC-rdf-sparql-
139 XMLres-20080115/⟩
140 RDQL - A Query Language for RDF, Andy Seaborne, W3C Member Submission 9
142 January 2004 http://www.w3.org/Submission/2004/SUBM-RDQL-20040109/
143 ⟨http://www.w3.org/Submission/2004/SUBM-RDQL-20040109/⟩
144
146 librasqal(3),[22mrasqal-config(1),libraptor(3)
147
150 Dave Beckett - http://www.dajobe.org/ ⟨http://www.dajobe.org/⟩
151 2010-10-18 roqet(1)