annotate sparql/executor.xml @ 0:7785ad38967f default tip

Uploaded
author atsuko
date Thu, 25 Aug 2011 22:14:55 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
7785ad38967f Uploaded
atsuko
parents:
diff changeset
1 <?xml version="1.0"?>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
2 <tool id="sparql query executor" name="SPARQL Query Tool" is_multi_byte="true">
7785ad38967f Uploaded
atsuko
parents:
diff changeset
3 <description>gets RDF graphs by using SPARQL.</description>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
4 <description lang="ja">SPARQLを使ってRDFグラフを取得します</description>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
5
7785ad38967f Uploaded
atsuko
parents:
diff changeset
6 <inputs>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
7 <param name="endpoint" type="text" value="" size="60" label="Endpoint URL" />
7785ad38967f Uploaded
atsuko
parents:
diff changeset
8 <param name="query" format="txt" type="data" label="Query" />
7785ad38967f Uploaded
atsuko
parents:
diff changeset
9 </inputs>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
10
7785ad38967f Uploaded
atsuko
parents:
diff changeset
11 <outputs>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
12 <data format="txt" name="output" />
7785ad38967f Uploaded
atsuko
parents:
diff changeset
13 </outputs>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
14
7785ad38967f Uploaded
atsuko
parents:
diff changeset
15 <command interpreter="ruby">executor.rb -e '$endpoint' --query-file '$query' -o '$output'</command>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
16
7785ad38967f Uploaded
atsuko
parents:
diff changeset
17 <help>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
18 **What it does**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
19
7785ad38967f Uploaded
atsuko
parents:
diff changeset
20 SPARQL is a query language for RDF graphs.
7785ad38967f Uploaded
atsuko
parents:
diff changeset
21
7785ad38967f Uploaded
atsuko
parents:
diff changeset
22 About SPARQL, see http://www.w3.org/TR/rdf-sparql-query/
7785ad38967f Uploaded
atsuko
parents:
diff changeset
23
7785ad38967f Uploaded
atsuko
parents:
diff changeset
24 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
25
7785ad38967f Uploaded
atsuko
parents:
diff changeset
26 **How to use**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
27
7785ad38967f Uploaded
atsuko
parents:
diff changeset
28 To use this tool a user first needs SPARQL query as an input.
7785ad38967f Uploaded
atsuko
parents:
diff changeset
29
7785ad38967f Uploaded
atsuko
parents:
diff changeset
30 For example::
7785ad38967f Uploaded
atsuko
parents:
diff changeset
31
7785ad38967f Uploaded
atsuko
parents:
diff changeset
32 SELECT * WHERE {
7785ad38967f Uploaded
atsuko
parents:
diff changeset
33 ?s ?p ?o
7785ad38967f Uploaded
atsuko
parents:
diff changeset
34 } LIMIT 10
7785ad38967f Uploaded
atsuko
parents:
diff changeset
35
7785ad38967f Uploaded
atsuko
parents:
diff changeset
36 Please input a SPARQL endpoint URL ( e.g. http://www.semantic-systems-biology.org/biogateway/endpoint ) and select the SPARQL query dataset.
7785ad38967f Uploaded
atsuko
parents:
diff changeset
37
7785ad38967f Uploaded
atsuko
parents:
diff changeset
38 And click the execute button.
7785ad38967f Uploaded
atsuko
parents:
diff changeset
39
7785ad38967f Uploaded
atsuko
parents:
diff changeset
40 The results can be shown on the middle pane by clicking the eye symbol on the history pane.
7785ad38967f Uploaded
atsuko
parents:
diff changeset
41
7785ad38967f Uploaded
atsuko
parents:
diff changeset
42 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
43
7785ad38967f Uploaded
atsuko
parents:
diff changeset
44 .. class:: infomark
7785ad38967f Uploaded
atsuko
parents:
diff changeset
45
7785ad38967f Uploaded
atsuko
parents:
diff changeset
46 **Note:** SPARQL results has a header line (e.g. ?S ?V ?O). If you want to remove the header line, use the `'Text Manipulation / Remove beginning' tool`_, and remove a first line.
7785ad38967f Uploaded
atsuko
parents:
diff changeset
47
7785ad38967f Uploaded
atsuko
parents:
diff changeset
48 .. _`'Text Manipulation / Remove beginning' tool`: /tool_runner?tool_id=Remove+beginning1
7785ad38967f Uploaded
atsuko
parents:
diff changeset
49
7785ad38967f Uploaded
atsuko
parents:
diff changeset
50 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
51
7785ad38967f Uploaded
atsuko
parents:
diff changeset
52 **Output**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
53
7785ad38967f Uploaded
atsuko
parents:
diff changeset
54 SPARQL results as tabular format.
7785ad38967f Uploaded
atsuko
parents:
diff changeset
55
7785ad38967f Uploaded
atsuko
parents:
diff changeset
56 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
57
7785ad38967f Uploaded
atsuko
parents:
diff changeset
58 **Example**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
59
7785ad38967f Uploaded
atsuko
parents:
diff changeset
60 If you specify example parameter, the results was::
7785ad38967f Uploaded
atsuko
parents:
diff changeset
61
7785ad38967f Uploaded
atsuko
parents:
diff changeset
62 ?s ?p ?o
7785ad38967f Uploaded
atsuko
parents:
diff changeset
63 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
64 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
65 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
66 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
67 &lt;http://www.openlinksw.com/virtrdf-data-formats#default&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
68 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
69 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
70 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
71 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
72 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
73
7785ad38967f Uploaded
atsuko
parents:
diff changeset
74 </help>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
75
7785ad38967f Uploaded
atsuko
parents:
diff changeset
76 <help lang="ja">
7785ad38967f Uploaded
atsuko
parents:
diff changeset
77 **概要**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
78
7785ad38967f Uploaded
atsuko
parents:
diff changeset
79 SPARQLはRDFグラフを取得するための問い合わせ言語です。
7785ad38967f Uploaded
atsuko
parents:
diff changeset
80
7785ad38967f Uploaded
atsuko
parents:
diff changeset
81 SPARQLに関する詳しい情報は http://www.w3.org/TR/rdf-sparql-query/ を参照してください。
7785ad38967f Uploaded
atsuko
parents:
diff changeset
82
7785ad38967f Uploaded
atsuko
parents:
diff changeset
83 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
84
7785ad38967f Uploaded
atsuko
parents:
diff changeset
85 **使い方**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
86
7785ad38967f Uploaded
atsuko
parents:
diff changeset
87 ツールを使う準備として、以下のようなSPARQLクエリーをヒストリーに用意してください::
7785ad38967f Uploaded
atsuko
parents:
diff changeset
88
7785ad38967f Uploaded
atsuko
parents:
diff changeset
89 SELECT * WHERE {
7785ad38967f Uploaded
atsuko
parents:
diff changeset
90 ?s ?p ?o
7785ad38967f Uploaded
atsuko
parents:
diff changeset
91 } LIMIT 10
7785ad38967f Uploaded
atsuko
parents:
diff changeset
92
7785ad38967f Uploaded
atsuko
parents:
diff changeset
93 クエリーをヒストリーに用意したら、このツールを表示しSPARQL endpoint URL( 例: http://www.semantic-systems-biology.org/biogateway/endpoint )を入力し、そして先ほど用意したクエリーのデータセットをSPARQL queryとして指定して下さい。
7785ad38967f Uploaded
atsuko
parents:
diff changeset
94
7785ad38967f Uploaded
atsuko
parents:
diff changeset
95 以上が完了したら、executeボタンを押して下さい。
7785ad38967f Uploaded
atsuko
parents:
diff changeset
96
7785ad38967f Uploaded
atsuko
parents:
diff changeset
97 問い合わせが行われ、結果がデータセットとしてヒストリーに積まれます。目で描かれたアイコンを押すと問い合わせ結果が真ん中のペインに表示されます。
7785ad38967f Uploaded
atsuko
parents:
diff changeset
98
7785ad38967f Uploaded
atsuko
parents:
diff changeset
99 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
100
7785ad38967f Uploaded
atsuko
parents:
diff changeset
101 .. class:: infomark
7785ad38967f Uploaded
atsuko
parents:
diff changeset
102
7785ad38967f Uploaded
atsuko
parents:
diff changeset
103 **ノート:** SPARQLの問い合わせ結果には「?S ?V ?O」のようなヘッダ行が含まれます。もしこれを取り除きたい場合は、`'Text Manipulation / Remove beginning' tool`_ ツールを利用して下さい。
7785ad38967f Uploaded
atsuko
parents:
diff changeset
104
7785ad38967f Uploaded
atsuko
parents:
diff changeset
105 .. _`'Text Manipulation / Remove beginning' tool`: /tool_runner?tool_id=Remove+beginning1
7785ad38967f Uploaded
atsuko
parents:
diff changeset
106
7785ad38967f Uploaded
atsuko
parents:
diff changeset
107 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
108
7785ad38967f Uploaded
atsuko
parents:
diff changeset
109 **出力**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
110
7785ad38967f Uploaded
atsuko
parents:
diff changeset
111 タブ区切り形式でSPARQLの問い合わせ結果が出力されます。
7785ad38967f Uploaded
atsuko
parents:
diff changeset
112
7785ad38967f Uploaded
atsuko
parents:
diff changeset
113 -----
7785ad38967f Uploaded
atsuko
parents:
diff changeset
114
7785ad38967f Uploaded
atsuko
parents:
diff changeset
115 **使用例**
7785ad38967f Uploaded
atsuko
parents:
diff changeset
116
7785ad38967f Uploaded
atsuko
parents:
diff changeset
117 上記の「使い方」で示したクエリを指定して問い合わせた場合、以下のような結果が得られます。::
7785ad38967f Uploaded
atsuko
parents:
diff changeset
118
7785ad38967f Uploaded
atsuko
parents:
diff changeset
119 ?s ?p ?o
7785ad38967f Uploaded
atsuko
parents:
diff changeset
120 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
121 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
122 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
123 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
124 &lt;http://www.openlinksw.com/virtrdf-data-formats#default&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
125 &lt;http://www.openlinksw.com/virtrdf-data-formats#default-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
126 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
127 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
128 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
129 &lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt-nullable&gt; &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt; &lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
7785ad38967f Uploaded
atsuko
parents:
diff changeset
130
7785ad38967f Uploaded
atsuko
parents:
diff changeset
131 </help>
7785ad38967f Uploaded
atsuko
parents:
diff changeset
132
7785ad38967f Uploaded
atsuko
parents:
diff changeset
133 </tool>