XQuery (XML Query) is a query
and functional programming
language that queries and transforms collections of structured and unstructured data
, usually in the form of XML
, text and with vendor-specific extensions for other data formats (JSON
, etc.). The language is developed by the XML Query working group
of the W3C
. The work is closely coordinated with the development of XSLT
by the XSL Working Group; the two groups share responsibility for XPath
, which is a subset of XQuery.
XQuery 1.0 became a W3C Recommendation
on January 23, 2007.
XQuery 3.0 became a W3C Recommendation
on April 8, 2014.
XQuery 3.1 became a W3C Recommendation
on March 21, 2017.
XQuery is a functional, side effect-free
, expression-oriented programming language with a simple type system
, summed up by Kilpeläinen:
XQuery provides the means to extract and manipulate data from XML documents or any data source that can be viewed as XML, such as relational database
s or office documents.
XQuery contains a superset of XPath
expression syntax to address specific parts of an XML document. It supplements this with a SQL
expression" for performing joins. A FLWOR expression is constructed from the five clauses after which it is named: FOR, LET, WHERE, ORDER BY, RETURN.
The language also provides syntax allowing new XML documents to be constructed. Where the element and attribute names are known in advance, an XML-like syntax can be used; in other cases, expressions referred to as dynamic node constructors are available. All these constructs are defined as expressions within the language, and can be arbitrarily nested.
The language is based on the XQuery and XPath Data Model
(XDM) which uses a tree-structured model of the information content of an XML document, containing seven kinds of nodes: document nodes, elements, attributes, text nodes, comments, processing instructions, and namespaces.
XDM also models all values as sequences (a singleton value is considered to be a sequence of length one). The items in a sequence can either be XML nodes or atomic values. Atomic values may be integers, strings, booleans, and so on: the full list of types is based on the primitive types defined in XML Schema
Features for updating XML documents or databases, and full text search
capability, are not part of the core language, but are defined in add-on extension standards: XQuery Update Facility 1.0 supports update feature and XQuery and XPath Full Text 1.0 supports full text search in XML documents.
XQuery 3.0 adds support for full functional programming, in that functions are values that can be manipulated (stored in variables, passed to higher-order functions, and dynamically called).
The sample XQuery code below lists the unique speakers in each act of Shakespeare's play Hamlet, encoded inhamlet.xml
All XQuery constructs for performing computations are expressions
. There are no statements
, even though some of the keywords appear to suggest statement-like behaviors. To execute a function, the expression within the body is evaluated and its value is returned. Thus to write a function to double an input value, one simply writes:
declare function local:doubler($x)
To write a full query saying 'Hello World', one writes the expression:
This style is common in functional programming languages
Below are a few examples of how XQuery can be used:
#Extracting information from a database for use in a web service.
#Generating summary reports on data stored in an XML database.
#Searching textual documents on the Web for relevant information and compiling the results.
#Selecting and transforming XML data to XHTML to be published on the Web.
#Pulling data from databases to be used for the application integration.
#Splitting up an XML document that represents multiple transactions into multiple XML documents.
XQuery and XSLT compared
Although XQuery was initially conceived as a query language for large collections of XML documents, it is also capable of transforming individual documents. As such, its capabilities overlap with XSLT
, which was designed expressly to allow input XML documents to be transformed into HTML or other formats.
The XSLT 2.0 and XQuery standards were developed by separate working groups within W3C
, working together to ensure a common approach where appropriate. They share the same data model (XDM
), type system, and function library, and both include XPath
2.0 as a sublanguage.
The two languages, however, are rooted in different traditions and serve the needs of different communities. XSLT was primarily conceived as a stylesheet language whose primary goal was to render XML for the human reader on screen, on the web
(as web template language
), or on paper. XQuery was primarily conceived as a database query language
in the tradition of SQL
Because the two languages originate in different communities, XSLT is stronger in its handling of narrative documents with more flexible structure, while XQuery is stronger in its data handling (for example, when performing relational joins).
XSLT 1.0 appeared as a Recommendation in 1999, whereas XQuery 1.0 only became a Recommendation in early 2007; as a result, XSLT is still much more widely used. Both languages have similar expressive power, though XSLT 2.0 has many features that are missing from XQuery 1.0, such as grouping, number and date formatting, and greater control over XML namespaces.
Many of these features were planned for XQuery 3.0.
Any comparison must take into account the fact that XSLT 1.0 and XSLT 2.0 are very different languages. XSLT 2.0, in particular, has been heavily influenced by XQuery in its move to strong typing and schema-awareness.
Strengths and weaknesses
Usability studies have shown that XQuery is easier to learn than XSLT
, especially for users with previous experience of database languages such as SQL. This can be attributed to the fact that XQuery is a smaller language with fewer concepts to learn, and to the fact that programs are more concise. It is also true that XQuery is more orthogonal, in that any expression can be used in any syntactic context. By contrast, XSLT is a two-language system in which XPath expressions can be nested in XSLT instructions but not vice versa.
XSLT is currently stronger than XQuery for applications that involve making small changes to
a document (for example, deleting all the NOTE elements). Such applications are generally handled
in XSLT by use of a coding pattern that involves an identity template that copies all nodes unchanged, modified by specific templates that modify selected nodes. XQuery has no equivalent to this coding pattern, though in future versions it will be possible to tackle such problems using the update facilities in the language that are under development.
XQuery 1.0 lacked any kind of mechanism for dynamic binding or polymorphism; this has been remedied with the introduction of functions as first-class values in XQuery 3.0. The absence of this capability starts to become noticeable when writing large applications, or when writing code that is designed to be reusable in different environments. XSLT offers two complementary mechanisms in this area: the dynamic matching of template rules, and the ability to override rules using
, that make it possible to write applications with multiple customization layers.
The absence of these facilities from XQuery 1.0 was a deliberate design decision: it has the consequence that XQuery is very amenable to static analysis, which is essential to achieve the level of optimization needed in database query languages. This also makes it easier to detect errors in XQuery code at compile time.
The fact that XSLT 2.0 uses XML
syntax makes it rather verbose in comparison to XQuery 1.0. However, many large applications take advantage of this capability by using XSLT to read, write, or modify stylesheets dynamically as part of a processing pipeline. The use of XML syntax also enables the use of XML-based tools for managing XSLT code. By contrast, XQuery syntax is more suitable for embedding in traditional programming languages such as Java
(see XQuery API for Java
) or C#
. If necessary, XQuery code can also be expressed in an XML syntax called XQueryX. The XQueryX representation of XQuery code is rather verbose and not convenient for humans, but can easily be processed with XML tools, for example transformed with XSLT stylesheets.
Extensions and future work
Two major extensions to the XQuery were developed by the W3C:
* XQuery 1.0 and XPath 2.0 Full-Text
* XQuery Update Facility
Both reached Recommendation status as extensions to XQuery 1.0, but work on taking them forward to work with XQuery 3.0 was abandoned for lack of resources.
Work on XQuery 3.0 was published as a Recommendation on 8 April 2014, and XQuery 3.1 is a Recommendation as at February 2017.
A scripting (procedural) extension for XQuery was designed, but never completed.
The EXPath Community Group develops extensions to XQuery and other related standards (XPath
, and XForms
The following extensions are currently available:
* Packaging System
* File Module
* Binary Module
* Web Applications
is an extension of XQuery that adds support to extract and transform data from JSON
documents. JSONiq is a superset of XQuery 3.0.
It is published under the Creative Commons Attribution-ShareAlike 3.0
The EXQuery project develops standards around creating portable XQuery applications. The following standards are currently available:
* Querying XML: XQuery, XPath, and SQL/XML in context. Jim Melton and Stephen Buxton. Morgan Kaufmann, 2006. .
* XQuery: The XML Query Language. Michael Brundage. Addison-Wesley Professional, 2004. .
* XQuery from the Experts: A Guide to the W3C XML Query Language. Howard Katz (ed). Addison-Wesley, 2004. .
* An Introduction to th
Expression. Dr. Michael Howard Kay|Michael Kay (W3C XQuery Committee), 2005.
Other implementations include:
* Oracle XQuery for Hadoop:
XQuery Processor for Java
Altova's XSLT and XQuery engine
XQuery with versioning extensions
XQilla XQuery implementation
SPARQL to XQuery translator
– an open source XQuery implementation.
– XQuery implementation in IBM Db2.
– open-source XQuery 3.0 implementation
Compliance with XQuery 1.0 features
XPath/XQuery engines, including a feature matrix
*''Portions borrowed with permission from the books "XML Hacks" (O'Reilly Media) and "XQuery" (O'Reilly Media).
*''Previous version based on an article at the French language Wikipedia
W3C XML Query (XQuery)
* XQuery API for Java (XQJ) Java Specification Request
Hamlet in XML Format
(presentation - as HTML slides)
Category:Fourth-generation programming languages
Category:World Wide Web Consortium standards
Category:XML data access