[go: up one dir, main page]

W3C

Errata in SPARQL 1.1

$Id: errata.html,v 1.72 2023/02/09 09:40:14 aseaborne Exp $

Introduction

This document records errata and corrections suggested by the community in the SPARQL 1.1 specification as published on the 21 March 2013. Actual changes to a W3C Recommendation must be approved by a chartered W3C Working Group and the W3C Advisory Committee.

  1. Errata for SPARQL 1.1 Overview
  2. Errata for SPARQL 1.1 Query Language
  3. Errata for SPARQL 1.1 Update
  4. Errata for SPARQL 1.1 Service Description
  5. Errata for SPARQL 1.1 Federated Query
  6. Errata for SPARQL 1.1 Query Results JSON Format
  7. Errata for SPARQL 1.1 Query Results CSV and TSV Formats
  8. Errata for SPARQL Query Results XML Format (Second Edition)
  9. Errata for SPARQL 1.1 Entailment Regimes
  10. Errata for SPARQL 1.1 Protocol
  11. Errata for SPARQL 1.1 Graph Store HTTP Protocol

These corrections have no normative status as they have not been incorporated in the specification through the Recommendation Track process. Note that the SPARQL Working Group has closed; there may be issues relating to the SPARQL specifications which are not currently listed here. If you find something in one of the documents listed above that you believe may be an error and wish to have it recorded here, please post your discovery to the public-rdf-dawg-comments or public-sparql-dev mailing lists. The community has the possibility to react on the post and, unless the community strongly objects for the discovery to be recorded as an official erratum, the entry is added to this list.

The errata are separated into eleven sections, corresponding to the eleven parts of the specification.

See also w3c/sparql-12/wiki/SPARQL-Errata.


Errata for SPARQL 1.1 Overview

None yet.

Errata for SPARQL 1.1 Query Language

errata-query-1

Source: comments/2013Mar/0010

Definition of ALP

"Let V = empty multiset" ==> "Let V = empty set"

This change does not change the definition: V is only used as a set.

errata-query-2

Report: public-sparql-dev/2013AprJun/0002

In the translation of group graph patterns, the text:

For each element E in the GroupGraphPattern

should indicate that elements are processed in lexical (parse) order.

errata-query-3

Report: public-rdf-dawg-comments/2013Aug/0004.html

In the grammar rule [83] PropertyListPathNotEmpty both object lists uses should be ObjectListPath.

clarification-query-1

Report: comments/2013May/0003

The explanatory expansion of IN could clarify that the left-hand side of the IN is evaluated once only.

clarification-query-2

Report: public-rdf-dawg-comments/2013Jul/0004

Section 17.3.1 says "defined above" but there is a case of an error where extension is possible below in 17.4.1.7 (RDFterm-equals).

editorial-query-1

Report: public-rdf-dawg-comments/2013Aug/0007

In #defn_evalGraph, the line

R := Union(R, Join( eval(D(D[i]), P) , Ω(?var->i) )
is missing a right parenthesis.

editorial-query-2

Report: public-rdf-dawg-comments/2013Aug/0007

In #defn_algJoin, in the line

Join(Ω1, Ω2) = { merge(μ1, μ2) | μ1 in Ω1and μ2 in Ω2, and μ1 and μ2 are compatible }
there should be a space: s/Ω1and/Ω1 and/

errata-query-4

Report: discussion in thread public-rdf-dawg-comments/2013Aug/0010.html

CONCAT refers fn:concat for it's defintion but fn:concat is only defined for 2 or more arguments whereas CONCAT alsp allows zero arguments and one argument.

The suggested fix is to extend the definition of CONCAT to be:

See also the definition of GROUP_CONCAT.

editorial-query-3

Report: discussion in thread public-rdf-dawg-comments/2013Aug/0024.html

In Section 19.6, Bulletpoint 2 "DELETE DATA" links to "DELETE WHERE" (footnote 40) instead of footnote 39.

errata-query-5

Report: discussion in thread public-rdf-dawg-comments/2013Sep/0000.html

Need to note that aggregate functions are not allowed inside aggregate functions - add a note to the grammar notes (19.8).

errata-query-6

Report: public-sparql-dev/2013OctDec/0001 and analysis public-sparql-dev/2013OctDec/0004.

Lack of clarity on aggregate processing in the presence of errors in the aggregated expression. Affects MAX; the others end up with the same result for different reasons.

errata-query-7

Report: public-sparql-dev/2014May/0000.html.

In the expansion of LeftJoin:

LeftJoin(Ω1, Ω2, expr) =
    { merge(μ1, μ2) | μ1 in Ω1 and μ2 in Ω2, μ1 and μ2 are compatible and expr(merge(μ1, μ2)) is true }
∪
    { μ1 | μ1 in Ω1, ∀ μ2 in Ω2, μ1 and μ2 are not compatible, or Ω2 is empty }
∪
    { μ1 | μ1 in Ω1, ∃ μ2 in Ω2, μ1 and μ2 are compatible and expr(merge(μ1, μ2)) is false. }

The last clause should read:

  { μ1 | μ1 in Ω1, ∀ μ2 in Ω2, μ1 and μ2 are compatible and expr(merge(μ1, μ2)) is false }

The definition as Filter(expr, Join(Ω1, Ω2)) ∪ Diff(Ω1, Ω2, expr) is unaffected.

errata-query-7a

Report: public-sparql-dev/2015/Jun/0000.html.

Further comment following on from errata-query-7. The second and third clauses in the explanatory expansion do not work independently. When combined, they are the definition of Diff.

The definition as Filter(expr, Join(Ω1, Ω2)) ∪ Diff(Ω1, Ω2, expr) is unaffected.

errata-query-8

Report: gist-github:/kasei/2543d93652016e0bb860

The definition of Substitute should exclude variables not visible at the outermost level of the graph pattern. That is, a variable used inside a nested SELECT that is not in it's projection, should be considered a different variable. Similarly, with embedded NOT EXISTS/EXISTS expressions, variables used only within that expression, are "hidden" (these are an a nested "ASK" query).

SELECT ?s WHERE {
    ?s :p ?value .
    FILTER EXISTS {
        ?s :p ?count
        {
            SELECT (COUNT(*) AS ?count) WHERE {
                ?s :p ?other # Hidden by projection ?s : should be same-as ?anything.
            }
        }
    }
}

errata-query-9

Report: public-sparql-dev/2014OctDec/0005

The BIND example for { ?s :p ?v . {} BIND (2*?v AS ?v2) } should be:

Extend( BGP(?s :p ?v), ?v2, 2*?v )

A pattern of { BIND(2*?v AS ?v2) ?s :p ?v } would be:

Join(
   Extend( {} , ?v2, 2*?v )
   BGP(?s :p ?v)
)

errata-query-10

Report: Apache jena users mailing list 2014-12-23

The definition of substitute operation should deal with variables in the bindings set formed from any VALUES clauses.

substitute also needs to be aware of inner scoped, variables with the same name (e.g. inside nested SELECTs).

errata-query-11

Report: public-rdf-dawg-comments/2015Jun/0001

The definition of Aggregation() should replace P by Group(exprlist, P) giving:

eval(D(G), Aggregation(exprlist, func, scalarvals, Group(exprlist, P))) = Aggregation(exprlist, func, scalarvals, eval(D(G), Group(exprlist, P)))

There is also a confusion in the definition of Aggregation, between multiset and set (section 18.5.1). In Definition: Aggregation replace "multiset of partial functions" by "set of partial functions".

errata-query-12

Report: public-rdf-dawg-comments/2015Jun/0004

Clarification of the definition of Diff.

The definition of Diff should more clearly say that expressions that evaluate with an error are considered to be false.

One such working is "and expr(merge(μ, μ')) does not have an effective boolean value of true".

errata-query-13

The definition of filter does not need the ", D(G)". It is correctly used in the evaluation of filter.

errata-query-14

Report: public-sparql-dev/2015JulSep/0002

The terminology "unaggregated variables" in 18.2.4.1 needs defining or rewording.

errata-query-15

Report: public-sparql-dev/2015OctDec/0035

GRAPH use needs updating for blank nodes.

errata-query-16

Report: public-sparql-dev/2016JanMar/0005

Add suggestion ("SHOULD") that SAMPLE should return a defined value in preference to "undef" (i.e. when "error" is in the choice multiset).

errata-query-17

Report: Tweet from Gregory Wiliams (March 2018)

The blank node label rule for no reuse of the same label should let the label be reused across property paths as well as triple patterns. The rule is mentioned in section 5.1.1 "Blank Node Labels" and section 19.6 Blank Nodes and Blank Node Labels.

See also the translation step 18.2.2.4 Translate Property Path Patterns where some path become triple patterns.

editorial-query-4

Report: 2018Jun/0000

Section 9.3, last sentence:
"The equivalance to graphs patterns" => "The equivalence to graph patterns"

clarification-query-3

Report: public-rdf-dawg-comments/2018Aug/0000

The phrase "equivalent literals" should be exaplined to be the same as "literal equality" in RDF Concepts.

The example of same-value dateTimes is not sufficently differentiated as an example of same-value, not same-term.

editorial-query-6

Report: 2018Jun/0000

Section 9.3, last sentence:
"The equivalance to graphs patterns" => "The equivalence to graph patterns"

Duplicate of editorial-query-4

errata-query-18

Report: public-rdf-dawg-comments/2019Feb/0000

The table in section 18.2.2.4 has an entry "Algebra (path): X seq(P, Q) Y" with "Translation: X P ?V . ?V Q P" but the translation should be "X P ?V . ?V Q Y".

errata-query-19

Report: public-rdf-dawg-comments/2022/Jul/0000

18.2.2.6 Translate Graph Patterns uses the term "BindingValue" when it should use, and link, <a href="rDataBlockValue>DataBlockValue>DataBlockValue</a>".

errata-query-20

Report: public-sparql-dev/2022OctDec/0001

DISTINCT and project have a requirement to preserve the ordering given by OrderBy. This becomes unclear when the ordering is based on a different set of variables to the projection.

errata-query-21

Report: public-sparql-dev/2020AprJun/0000

There is a problem when aggregating when there is no GROUP BY and no matches from the WHERE clause.

Details: https://afs.github.io/sparql-agg-group-empty.html

errata-query-22

Report: public-rdf-dawg-comments/2022Dec/0000

In the definition of SUM, Sum(1, 2, 3) should involve a multiset of lists. Similar issues exist with the examples in definitions for Avg, GroupConcat, and Sample.

See also the additional note of errata-query-11

errata-query-23

Report: /public-rdf-dawg-comments/2023Jan/0000

Inconsistency between subsections 18.5.1.5 (MIN), and 18.5.1.6 (MAX)

Errata for SPARQL 1.1 Update

errata-update-1

Report: 2015Mar/0001

The example in section 3.1.3.1 has

        FILTER ( ?date > "1970-01-01T00:00:00-02:00"^^xsd:dateTime )
      

The test is the wrong way round: it should be:

        FILTER ( ?date < "1970-01-01T00:00:00-02:00"^^xsd:dateTime )
      

The text above and example data are correct.

errata-update-2

Report: 2016Mar/0000

In the bulleted list, uses of Gj should be G'j

errata-update-3

Report: 2018Apr/0000

In section 3.1.3 of https://www.w3.org/TR/2013/REC-sparql11-update-20130321 there are some links named DeleteClause and InsertClause. These should reference https://www.w3.org/TR/sparql11-query/#rDeleteClause and https://www.w3.org/TR/sparql11-query/#rInsertClause but instead reference the DELETE DATA (http://www.w3.org/TR/sparql11-query/#rDeleteData) and INSERT DATA (http://www.w3.org/TR/sparql11-query/#rInsertData).

Errata for SPARQL 1.1 Service Description

errata-sd-1

Source: public-rdf-dawg-comments/2013Apr/0000.html

Wrong/missing link in section 1.1.

Errata for SPARQL 1.1 Federated Query

errata-fq-1

Source: public-rdf-dawg-comments/2013Apr/0007.html

The last queryGroup example in section 2.4 of the document is not the right example (missing VALUES).

Errata for SPARQL 1.1 Query Results JSON Format

errata-json-results-1

Source: public-sparql-dev/2015AprJun/0014

This errata applies to the tests, not the specification itself.

Some SPARQL tests use "type": "typed-literal", where it should be "type": "literal". e.g. json-res/jsonres01.srj.

"typed-literal" existed in the pre-recommendation working group note from the original SPARQL working group.

errata-json-results-2

Source: public-sparql-dev/2018Nov/0000

The link for output.srx is 'http://www.w3.org/TR/rdf-sparql-XMLres/output.srx' but should be 'https://www.w3.org/2009/sparql/xml-results/output.srx'.

Errata for SPARQL 1.1 Query Results CSV and TSV Formats

None yet.

Errata for SPARQL Query Results XML Format (Second Edition)

errata-results-xml-1

Report: public-rdf-dawg-comments/2013Aug/0004

Incorrect XML namespaces.

errata-results-xml-2

Report: public-sparql-dev/2018JulSep/0023

xsi:schemaLocation shoud be a pair of URIs.

Errata for SPARQL 1.1 Entailment Regimes

errata-entailment-1

Report: public-rdf-dawg-comments/2014Feb/0001.html

The rdf:type labelled edge in Figure 1 (Section 1.2) from ex:MITPress to rdf:Property should go from ex:publishes to rdf:Property.

Errata for SPARQL 1.1 Protocol

None yet.

Errata for SPARQL 1.1 Graph Store HTTP Protocol

None yet.