SPARQL 1.1クエリ結果JSONフォーマット

1 はじめに

このドキュメントは、SPARQL結果（SELECTとASKのクエリ形式）をJSONフォーマットでシリアル化する方法について記述しています。このフォーマットは、クエリ結果の情報を完全に表現するものとなるように設計されています。SELECTクエリの結果は、配列としてシリアル化され、個々の配列エレメントはクエリ結果の1つの「列」です。ASKクエリの結果、クエリ結果のブール値が得られます。

インターネット・メディア・タイプは、application/sparql-results+jsonに規定されています。

同じような設計でありながら、シリアル化にXMLを用いるSPARQLクエリ結果XMLフォーマット[SRX]もあります。

項の先頭で特に注記がなければ、このドキュメントのすべての項と付録は規範的です。

2 JSON結果オブジェクト

SPARQLクエリの結果は、1つのトップレベルのJSONオブジェクトとしてJSONでシリアル化されます。このオブジェクトは、「head」メンバーを持ち、また、クエリ形式により「results」メンバーか「boolean」メンバーのいずれかを持ちます。

この例は、SELECTクエリの結果を示しています。クエリ・ソリューションは、「bindings」キーの値である配列で表され、次に「results」キーの値であるオブジェクトの一部が表されます。

{
  "head": { "vars": [ "book" , "title" ]
  } ,
  "results": { 
    "bindings": [
      {
        "book": { "type": "uri" , "value": "http://example.org/book/book6" } ,
        "title": { "type": "literal" , "value": "Harry Potter and the Half-Blood Prince" }
      } ,
      {
        "book": { "type": "uri" , "value": "http://example.org/book/book7" } ,
        "title": { "type": "literal" , "value": "Harry Potter and the Deathly Hallows" }
      } ,
      {
        "book": { "type": "uri" , "value": "http://example.org/book/book5" } ,
        "title": { "type": "literal" , "value": "Harry Potter and the Order of the Phoenix" }
      } ,
      {
        "book": { "type": "uri" , "value": "http://example.org/book/book4" } ,
        "title": { "type": "literal" , "value": "Harry Potter and the Goblet of Fire" }
      } ,
      {
        "book": { "type": "uri" , "value": "http://example.org/book/book2" } ,
        "title": { "type": "literal" , "value": "Harry Potter and the Chamber of Secrets" }
      } ,
      {
        "book": { "type": "uri" , "value": "http://example.org/book/book3" } ,
        "title": { "type": "literal" , "value": "Harry Potter and the Prisoner Of Azkaban" }
      } ,
      {
        "book": { "type": "uri" , "value": "http://example.org/book/book1" } ,
        "title": { "type": "literal" , "value": "Harry Potter and the Philosopher's Stone" }
      }
    ]
  }
}

この例は、ASKクエリの結果を示しています。

{ 
  "head" : { } ,
  "boolean" : true
}

その他のキー（違う名前を持つ）もJSON結果オブジェクトに存在できますが、この仕様では定義していません。

3 変数バインディング結果

SPARQLのSELECTクエリの結果は、変数のバインディングの配列としてシリアル化されます。「head」キーの値は、クエリのSELECT句で射影されたすべての変数の配列です。

{
"head" { 
   "vars" : [ ... ] ,
   "link" : [ ... ] }

"vars" : [ "book" , "title" ] 

"link" : [ "http://example/dataset/metadata.ttl" ] 

"bindings" : [
               {
                 "a" : { ... } ,
                 "b" : { ... } 
               } ,
               {
                 "a" : { ... } ,
                 "b" : { ... } 
               }
             ]

"bindings" : []

4 ブール結果

SPARQL ASKクエリの結果は、ブール値としてシリアル化され、クエリ評価の結果を示します。

"boolean" : true 

5 例

この項は、規範的ではありません。

次のJSONは、output.srxというXMLドキュメントのシリアル化です。

{
   "head": {
       "link": [
           "http://www.w3.org/TR/rdf-sparql-XMLres/example.rq"
           ],
       "vars": [
           "x",
           "hpage",
           "name",
           "mbox",
           "age",
           "blurb",
           "friend"
           ]
       },
   "results": {
       "bindings": [
               {
                   "x" : { "type": "bnode", "value": "r1" },

                   "hpage" : { "type": "uri", "value": "http://work.example.org/alice/" },

                   "name" : {  "type": "literal", "value": "Alice" } ,
                   
		   "mbox" : {  "type": "literal", "value": "" } ,

                   "blurb" : {
                     "datatype": "http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral",
                     "type": "literal",
                     "value": "<p xmlns=\"http://www.w3.org/1999/xhtml\">My name is <b>alice</b></p>"
                   },

                   "friend" : { "type": "bnode", "value": "r2" }
               },
               {
                   "x" : { "type": "bnode", "value": "r2" },
                   
                   "hpage" : { "type": "uri", "value": "http://work.example.org/bob/" },
                   
                   "name" : { "type": "literal", "value": "Bob", "xml:lang": "en" },

                   "mbox" : { "type": "uri", "value": "mailto:bob@work.example.org" },

                   "friend" : { "type": "bnode", "value": "r1" }
               }
           ]
       }
}

6 インターネット・メディア・タイプ、ファイル拡張子、およびマッキントッシュ・ファイル・タイプ

SPARQLクエリ結果JSONフォーマットのインターネット・メディア・タイプ/MIMEタイプは、「application/sparql-results+json」です。

SPARQLクエリ結果JSONフォーマット・ファイルは、すべてのプラットフォーム上で拡張子「.srj」（すべて小文字）であることが推奨されます。

マッキントッシュHFSファイル・システム上に保存されたSPARQLクエリ結果JSONフォーマット・ファイルには、ファイル・タイプ「TEXT」が付与されていることが推奨されます。

下記のこの情報は、IANAでのレビュー、承認、および登録のためにIESGに提出する予定です。

タイプ名:

application

サブタイプ名:

sparql-results+json

必須パラメータ:

なし

任意のパラメータ:

なし

コード化に関する留意点:

SPARQLクエリ結果JSONフォーマットのコード化に関する留意点は、[JSON-RFC]で指定されている「application/json」のものと同じです。

セキュリティに関する留意点:

SPARQLクエリ結果はURIを使用します。[RFC3986]の7項を参照してください。
SPARQLクエリ結果はIRIを使用します。[RFC3987]の8項を参照してください。
SPARQLクエリ結果JSONフォーマットのセキュリティに関する留意点は、[JSON-RFC]で指定されている「application/json」のものと同じです。

互換性に関する留意点:

互換性の問題は知られていません。

公開済み仕様書:

http://www.w3.org/TR/sparql11-results-json/

このメディア・タイプを使用するアプリケーション:

現時点でこのメディア・タイプを使用するアプリケーションは知られていません。

追加情報:

マジック・ナンバー:

n/a

ファイル拡張子:

「.srj」

マッキントッシュ・ファイル・タイプ・コード:

「TEXT」

詳細情報に関する連絡先:

Andy Seaborne <public-rdf-dawg-comments@w3.org>

意図する用途:

汎用

使用上の制限:

なし

著者／改版管理者:

SPARQL仕様は、ワールド・ワイド・ウェブ・コンソーシアム（World Wide Web Consortium）のSPARQLワーキンググループ（SPARQL Working Group）の作業の成果です。W3Cは、これらの仕様の変更に対する管理権を有します。