Web NDL Authoritiesについて

---

1. SPARQLによる検索 | 2. 例1：ある人名の生没年、標目形、標目形カナヨミを調べる | 3. 例2： 没年から典拠URI、名称実体URI、標目形、標目形カナヨミを調べる | 4. 例3：ある件名標目の上位語、下位語などを調べる | 5. 例4：ある代表分類に属する件名標目を調べる

---

このページでは、SPARQLによる検索方法について説明します。GUI上での検索方法については「ヘルプ」の該当箇所をご覧ください。

1. SPARQLによる検索

当システムは、RDF形式で典拠データをデータベースに格納しており、RDFで記述されたデータを検索・操作するためのコンピュータ言語であるSPARQLを用いて外部から検索することができます。SPARQLによるクエリは、RDFのモデルのうち、未知の部分を変数（半角クエスチョンマーク（?）で始まる名前）として変数を含むRDFグラフを記述し、変数にあてはまるURIやリテラル値を取得する、という形式になります。
変数を含むグラフのパターンは、半角波括弧（{}）で囲み、SQLと同様にWHERE句に記述します。また、取り出したい変数は、SQLと同様にSELECT句に列挙します。PREFIX句を用いて名前空間URIの接頭辞を宣言することで、URIを修飾名として記述することができます。

SPARQLを利用するAPI
SPARQL Endpoint（APIのURI）は http://id.ndl.go.jp/auth/ndla です。?queryパラメータ値としてURLエンコードしたSPARQLクエリを送ることで、レスポンスを得ることができます。一回に取得できるデータ件数の上限は100件です。
下記のフォームを用いて、SPARQLによる検索を試してみることができます。

SPARQLクエリ

クエリをここに入力してください。 HTML Table XML JSON Plain Serialized PHP

RDFとして格納されるデータ項目については、「4. RDF/XML形式によるフォーマット仕様」をご参照ください。

2. 例1：ある人名の生没年、標目形、標目形カナヨミを調べる

「夏目漱石」の典拠情報URI、名称実体URI、生年、没年、標目、標目カナヨミをそれぞれ、変数「?uri1」、「?uri2」、「?birth」、「?death」、「?heading」、「?yomi」とすると、これらの変数を含むRDFグラフは下図のようになります。

RDFグラフをクエリにすると、以下のとおりとなります。

SPARQLクエリ

PREFIX skos: <http://www.w3.org/2004/02/skos/core#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX rda: <http://RDVocab.info/ElementsGr2/> PREFIX foaf: <http://xmlns.com/foaf/0.1/> PREFIX xl: <http://www.w3.org/2008/05/skos-xl#> PREFIX ndl: <http://ndl.go.jp/dcndl/terms/> SELECT * WHERE { ?uri1 foaf:primaryTopic ?uri2. ?uri1 xl:prefLabel [ xl:literalForm ?heading; ndl:transcription ?yomi ]. ?uri2 rda:dateOfBirth ?birth. ?uri2 rda:dateOfDeath ?death. ?uri2 foaf:name "夏目漱石". FILTER (lang(?yomi) = 'ja-Kana'). } HTML Table XML JSON Plain Serialized PHP

標目形が「夏目」で始まる典拠データの生年、没年、標目形を調べるクエリは以下のとおりになります。

SPARQLクエリ

PREFIX skos: <http://www.w3.org/2004/02/skos/core#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX rda: <http://RDVocab.info/ElementsGr2/> PREFIX foaf: <http://xmlns.com/foaf/0.1/> PREFIX xl: <http://www.w3.org/2008/05/skos-xl#> PREFIX ndl: <http://ndl.go.jp/dcndl/terms/> SELECT * WHERE { ?uri1 foaf:primaryTopic ?uri2. ?uri1 xl:prefLabel [ xl:literalForm ?heading; ndl:transcription ?yomi ]. ?uri2 rda:dateOfBirth ?birth. ?uri2 rda:dateOfDeath ?death. FILTER (lang(?yomi) = 'ja-Kana'). FILTER regex(?heading, '^夏目'). } HTML Table XML JSON Plain Serialized PHP

3. 例2：没年から典拠URI、名称実体URI、標目、標目カナヨミを調べる

没年が「1962」である典拠URI、名称実体URI、標目、標目カナヨミをそれぞれ、変数「?uri1」、「?uri2」「?heading」、「?yomi」とすると、これらの変数を含むRDFグラフは下図のようになります。


RDFグラフをクエリにすると、以下のとおりとなります。

SPARQLクエリ

PREFIX skos: <http://www.w3.org/2004/02/skos/core#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX rda: <http://RDVocab.info/ElementsGr2/> PREFIX foaf: <http://xmlns.com/foaf/0.1/> PREFIX xl: <http://www.w3.org/2008/05/skos-xl#> PREFIX ndl: <http://ndl.go.jp/dcndl/terms/> SELECT * WHERE { ?uri1 foaf:primaryTopic ?uri2. ?uri1 xl:prefLabel [ xl:literalForm ?heading; ndl:transcription ?yomi ]. ?uri2 rda:dateOfDeath "1962". FILTER (lang(?yomi) = 'ja-Kana'). } ORDER BY ?yomi HTML Table XML JSON Plain Serialized PHP

100件目以降のデータを取得する場合は、OFFSET句を使用します。

SPARQLクエリ

PREFIX skos: <http://www.w3.org/2004/02/skos/core#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> PREFIX rda: <http://RDVocab.info/ElementsGr2/> PREFIX foaf: <http://xmlns.com/foaf/0.1/> PREFIX xl: <http://www.w3.org/2008/05/skos-xl#> PREFIX ndl: <http://ndl.go.jp/dcndl/terms/> SELECT * WHERE { ?uri1 foaf:primaryTopic ?uri2. ?uri1 xl:prefLabel [ xl:literalForm ?heading; ndl:transcription ?yomi ]. ?uri2 rda:dateOfDeath "1962". FILTER (lang(?yomi) = 'ja-Kana'). } ORDER BY ?yomi OFFSET 100 HTML Table XML JSON Plain Serialized PHP

4. 例3：ある件名標目の上位語、下位語などを調べる

件名標目「インターネット」の典拠URI、上位語のURI、上位語のラベルをそれぞれ変数「?uri1」、「?uri2」、「?label」とすると、これらの変数を含むRDFグラフは下図のようになります。

SPARQLクエリ

PREFIX skos: <http://www.w3.org/2004/02/skos/core#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> SELECT * WHERE { ?uri1 rdfs:label "インターネット"; skos:broader ?uri2. ?uri2 rdfs:label ?label. } HTML Table XML JSON Plain Serialized PHP

下位語、関連語、同義語を調べる場合は、「skos:broader」をそれぞれ「skos:narrower」、「skos:related」、「xl:altLabel」に置換えます。

5. 例4：ある代表分類に属する件名標目を調べる

分類記号NDLCの「DM225」に属する件名標目の典拠URI、ラベルを変数「?uri」、「?label」とすると、これらの変数を含むRDFグラフは下図のようになります。

SPARQLクエリ

PREFIX skos: <http://www.w3.org/2004/02/skos/core#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> SELECT * WHERE { ?uri1 skos:relatedMatch <http://id.ndl.go.jp/class/ndlc/DM225>; rdfs:label ?label . } HTML Table XML JSON Plain Serialized PHP

分類記号NDLCの「M87」かつNDC9の「440」に属する件名標目の典拠URI、ラベルを変数「?uri」、「?label」とすると、これらの変数を含むRDFグラフは下図のようになります。

SPARQLクエリ

PREFIX skos: <http://www.w3.org/2004/02/skos/core#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> SELECT * WHERE { ?uri1 skos:relatedMatch <http://id.ndl.go.jp/class/ndlc/DK341>, <http://id.ndl.go.jp/class/ndc9/694.5>. ?uri1 rdfs:label ?label . } HTML Table XML JSON Plain Serialized PHP