curl で SPARQL Endpoint にリクエストを投げるパターンのおぼえがき。 SPARQL クライアントを使えない場合やバッチ処理の実行などに。
1. 基本
実行したい SPARQL Query をテキストファイルに保存して
sparql.rq
select * where {?s ?p ?o.} limit 10
以下のように実行して JSON Results を得る。
$ curl -H 'Accept: application/sparql-results+json' --data-urlencode 'query@-' http://dbpedia.org/sparql < sparql.rq
{
"head": { "link": [], "vars": ["s", "p", "o"] },
"results": { "distinct": false, "ordered": true, "bindings":
[{ "s": {...}, "p": {...}, "o": {...} }]
}
}
この方法は [query via POST with URL-encoded parameters (SPARQL 1.1 Protocol)] (https://www.w3.org/TR/2013/REC-sparql11-protocol-20130321/#query-via-post-urlencoded) に準拠したエンドポイントを想定して POST リクエストを発行するものですが、query via GET の場合には以下のように -G オプションをつけることで GET リクエストを発行することも可能です。
$ curl -G -H 'Accept: application/sparql-results+json' --data-urlencode 'query@-' http://dbpedia.org/sparql < sparql.rq
2. 出力フォーマットの変更
-
-H 'Accept: xxxxxxxxxxxxx'の xxxxxx の部分を下の表の Content-Type で適宜置き換える - Accept ヘッダを省略した場合は Endpoint のデフォルトフォーマットで返ってくるはず
- Endpoint は必ずしもすべての出力フォーマットに対応しているわけではないので注意
- csv / tsv の場合は
charset=UTF-8のように出力エンコード指定も可能だが、Endpoint が対応していないことも
| type | Content-Type |
|---|---|
| json | application/sparql-results+json |
| xml | application/sparql-results+xml |
| csv | text/csv |
| tsv | text/tab-separated-values |
3. クエリーの指定
インライン
- 短いクエリーなら
query=...のように直接 SPARQL を書いても OK
$ curl -H 'Accept: application/sparql-results+json' --data-urlencode 'query=select * where {?s ?p ?o.} limit 10' http://dbpedia.org/sparql
ファイル
-
--data-urlencodeオプションにquery@{filename}と指定すると query パラメータの値としてファイルの中身が展開される - 冒頭の
query@-は標準入力を展開する、の意味
$ curl -H 'Accept: application/sparql-results+json' --data-urlencode 'query@sparql.rq' http://dbpedia.org/sparql