blob: 000c234c60ebbbdf6f56fdd56da0bdd7de77c457 [file] [log] [blame]
ARQ : Jena SPARQL System
========================
ARQ is a complete implementation of SPARQL that can query any Jena model
or graph, including ones stored in databases.
Download
--------
See
https://jena.apache.org/download/
Also available via git:
https://git-wip-us.apache.org/repos/asf/jena.git
Maven:
GroupId: org.apache.jena
ArtifactId: jena-arq
Online demos and services
-------------------------
http://www.sparql.org/
including a SPARQL validator
http://www.sparql.org/validator.html
Documentation
-------------
http://jena.apache.org/documentation/query/index.html
Installation
------------
The apache-jena distribution includes ARQ and all it's dependencies. It
also includes scripts to run the command line tools.
https://www.apache.org/dist/jena/
Unpack zip : it unpacks into a directory, including the version number.
Maven Distribution
------------------
The maven repository contains the following files (for version VER)
jena-arq-VER.jar ARQ jar
jena-arq-VER-javadoc.jar Javadoc
jena-arq-VER-sources.jar Sources
jena-arq-VER-tests.jar ARQ testing code
jena-arq-VER-test-sources.jar Sourecs for test code
jena-arq-VER-tests.zip Datafiles for tests, and test scripts.
jena-arq-VER.pom ARQ POM
Running from the command line
-----------------------------
Some bash and bat scripts are provided to try out SPARQL queries.
In the apache-jena distribution, set JENAROOT.
export JENAROOT=$PWD
Second, ensure all scripts are executable
chmod u+x $JENAROOT/bin/*
Command line applications:
sparql -- Run a SPARQL query. A wrapper around 'query'.
arq -- Run an ARQ query. A wrapper around 'query'.
query -- Run a query.
qparse -- Parse a query
qtest -- Run tests
rset -- Read and write result sets (RDF, XML, JSON, text (out only))
For the 'query' command, files ending .rq are assumed to be SPARQL queries
and files ending .arq are ARQ queries, unless the syntax is given
explicitly. Unknown files are assumed to be SPARQL queries.
sparql --data <some data file> --query query
sparql --data <some data file> 'Query string'
Default output is a text table for SELECT queries, an RDF model for
DESCRIBE and CONSTRUCT.
Run the script with no argument to get a usage message.
Running commands as Java
------------------------
Set the classpath to "$JENAROOT/lib/*" (Linux) or "$JENAROOT\lib\*;" (Windows).
The arq command line application is:
java -cp ... arq.query ....
ARQ.Net
-------
ARQ has been run under IKVM (http://www.ikvm.net/), using IKVM to
translate the bytecodes to IL and using IKVM as a JVM.
Support and Questions
---------------------
Comments and questions about ARQ to the Jena mailing list
users@jena.apache.org
General questions and comments on SPARQL to jena-dev or
public-sparql-dev@w3.org
Formal comments specific to the SPARQL query language,
protocol or result set documents to:
public-rdf-dawg-comments@w3.org