Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
roqet(1)		    General Commands Manual		      roqet(1)

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	start-
       ing 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 read-
	      ing 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, de-
	      fault), 'sparql11' and 'laqrs'.  The full	list of	supported lan-
	      guages 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  re-
	      sults.

	      For  RDF	graph results, the values of FORMAT are	'ntriples' (N-
	      Triples, default), 'rdfxml-abbrev' (RDF/XML  Abbreviated),  'rd-
	      fxml'  (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' (de-
	      fault), '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 any-
	      thing) 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 for-
       mat RDF/XML.

	      roqet -t result.srx -r html

       Read a SPARQL query results in SPARQL Query  Results  XML  format  (de-
       fault) 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-XML-
       res-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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=roqet&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help