-
Notifications
You must be signed in to change notification settings - Fork 10
/
index.html
273 lines (208 loc) · 11.3 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>Stardog: Documentation</title>
<script type="text/javascript" src="http://use.typekit.com/muj3mlu.js"></script>
<script type="text/javascript">try{Typekit.load();}catch(e){}</script>
<link rel="shortcut icon" href="/favicon.ico" />
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>
<link media="screen" rel="stylesheet" href="/_/css/ps.css"/>
<link media="print" rel="stylesheet" href="/_/css/print.css"/>
<link media="screen" rel="stylesheet" href="/_/css/simplegrid.css"/>
</head>
<body>
<div class="grid grid-pad">
<div id="masthead">
<div class="col-3-12" id="logoquote"><a href="/"><img border=0 src="/_/img/sdog-bare.png"></a></div>
<div id="chaptertitle" class="col-9-12">
<blockquote>
<b>Functions delay binding; data structures induce binding. Moral: Structure data late in the programming process.</b>—<cite>Alan Perlis, Epigrams in Programming</cite>
</blockquote>
<h1 id="title">Stardog <span id="subtitle">Docs</span></h1>
</div>
</div>
</div>
<div class="grid grid-pad">
<div id="contentbody">
<div class="col-3-12" id="left-gutter">
<div id="tocblock">
<h1 id="toc-title">Shortcuts</h1>
<ol id="toc">
<li><a href="http://stardog.com/dl/">Download</a> Stardog</li>
<li><a href="quick-start">Quick Start Guide</a></li>
<li><a href="https://groups.google.com/a/clarkparsia.com/group/stardog/about">Support Forum</a></li>
</ol>
</div>
</div>
<div class="col-9-12" id="main-channel">
<section>
<header>
<h1 id=chapter>Introduction</h1></header>
<p>Stardog is a <a href="../docs/performance">fast</a>, lightweight, commercial RDF database for mission-critical apps: it supports <a href="http://www.w3.org/TR/2012/WD-sparql11-query-20120105/">SPARQL 1.1</a>;<n>As of @@VERSION@@, Stardog's SPARQL 1.1 support does not include: UPDATE query language; service description and federation; UPDATE protocol; no entailment regimes other than OWL 2 Direct Semantics. We will address these in upcoming 1.1.x releases.</n> HTTP and the SNARL protocol for
remote access and control; <a href="http://www.w3.org/RDF/">RDF</a> as a
data model; and <a href="http://www.w3.org/TR/owl2-overview/">OWL 2</a> for
inference and data analytics.</p>
<h2>Acquiring Stardog & Support</h2>
<p><a href="http://stardog.com/dl/">Download</a> Stardog to get started. The <a href="https://groups.google.com/a/clarkparsia.com/group/stardog/about">Stardog support forum</a>, <a
href="mailto:stardog@clarkparsia.com">stardog@clarkparsia.com</a>, is the place to report bugs, ask questions, etc.</p>
<h2>Acknowledgments</h2>
<p>Thanks to all the Stardog testers, especially Robert Butler, Al
Baker, Marko A. Rodriguez, Brian Sletten, Alin Dreghiciu, Rob Vesse,
Stephane Fallah, John "New Model Army" Goodwin, José Devezas, Chris
Halaschek-Wiener, Gavin Carothers, Brian Panulla, Ryan Kohl, Morton
Swimmer, Quentin Reul, Paul Dlug, James Leigh, Alex Tucker, Ron Zettlemoyer, Jim Rhyne. Andrea Westerinen, Huy Phan.</p>
</section>
<section><header><h1 id=chapter>The Essential Documentation</h1></header></section>
<p>This is
documentation for Stardog <b>@@VERSION@@</b> (<b>@@DATE@@</b>). Check out the
<a href="../docs/RELEASE_NOTES.txt">release notes</a> and the <a href="../docs/faq/">FAQ</a>.</p>
<h2><a href="../docs/quick-start">Quick Start Guide</a></h2>
<p>Instructions to get up-and-running very quickly with Stardog.</p>
<h2><a href="../docs/term/">Terminology</a></h2>
<p>A <a href="../docs/term/">glossary</a> of technical terms used throughout the Stardog docs.</p>
<h2><a href="../docs/compatibility/">Stardog Compatibility Policies: The Future of Queries, Data, and Programs</a></h2>
<p>A statement of the policies we will pursue in evolving Stardog beyond the 1.0 release.</p>
<h2><a href="../docs/admin/">Administration</a></h2>
<ol>
<li><a href="../docs/admin/#cli">CLI Overview</a></li>
<li><a href="../docs/admin/#admin-server">Administering a Stardog Server</a></li>
<li><a href="../docs/admin/#admin-db">Administering a Stardog Database</a></li>
<li><a href="../docs/admin/#security">Configuring Security</a></li>
<li><a href="../docs/admin/#search">Managing Search Indexes</a></li>
<li><a href="../docs/admin/#optimizing-bulk-load">Optimizing Bulk Data Loading</a></li>
<li><a href="../docs/admin/#resource-requirements">Resource Requirements for Stardog</a></li>
<li><a href="../docs/admin/#using-windows">Using Stardog on Windows</a></li>
</ol>
<h2><a href="../docs/using/">Using Stardog</a></h2>
<ol>
<li><a href="../docs/using/#using-stardog">Using Stardog</a></li>
<li><a href="../docs/using/#query">Querying a Database</a></li>
<li><a href="../docs/using/#add-remove">Adding and Removing</a></li>
<li><a href="../docs/using/#export">Exporting a Database</a></li>
<li><a href="../docs/using/#search">Searching</a></li>
</ol>
<h2><a href="../docs/security">Security</a></h2>
<ol>
<li><a href="../docs/security/#model">The User & Security Model</a></li>
<li><a href="../docs/security/#cli">Command-line Interface</a></li>
<li><a href="../docs/security/#api">Programmatic Access</a></li>
<li><a href="../docs/security/#deployment">Deploying Stardog Securely</a></li>
</ol>
<h2><a href="../docs/sdp">Integrity Constraint Validation</a></h2>
<ol>
<li><a href="../docs/sdp/#intro">Background & Terminology</a></li>
<li><a href="../docs/sdp/#validation">Validating RDF with Closed World Integrity Constraints</a></li>
</ol>
<h2><a href="../docs/owl2">OWL 2 Reasoning</a></h2>
<ol>
<li><a href="../docs/owl2/#reasoning">Using Stardog's Reasoning Capabilities</a></li>
<li><a href="../docs/owl2/#trouble">Not Getting Expected Answers?</a></li>
<li><a href="../docs/owl2/#issues">Known Issues</a></li>
<li><a href="../docs/owl2/#guidelines">Guidelines</a></li>
<li><a href="../docs/owl2/#query">Technical Background</a></li>
</ol>
<h2><a href="../docs/java/">Programming with Java</a></h2>
<ol>
<li><a href="../docs/java/#intro">Introduction</a></li>
<li><a href="../docs/java/#admin">Creating and Administering Databases</a></li>
<li><a href="../docs/java/#connection">Creating a Connection String</a></li>
<li><a href="../docs/java/#security">Security in Stardog</a></li>
<li><a href="../docs/java/#snarl">Using SNARL</a></li>
<li><a href="../docs/java/#sesame">Using Sesame</a></li>
<li><a href="../docs/java/#jena">Using Jena</a></li>
<li><a href="../docs/java/#client-server">Client-Server Stardog</a></li>
<li><a href="../docs/java/#embed">Embedded Stardog</a></li>
<li><a href="../docs/java/#pool">Connection Pooling</a></li>
<li><a href="../docs/java/#deprecation">Deprecation & Backward Compatibility</a></li>
</ol>
<h2><a href="../docs/network/">Network Programming</a></h2>
<ol>
<li><a href="../docs/network/#http">SPARQL Protocol: HTTP</a></li>
<li><a href="../docs/network/#extended-http">Extended HTTP Protocol</a></li>
<li><a href="../docs/network/#snarl">SNARL: The Native Stardog Remote API</a></li>
</ol>
<h2><a href="../docs/spring">Programming with Spring</a></h2>
<ol>
<li><a href="../docs/spring/#intro">Introduction</a></li>
<li><a href="../docs/spring/#building">Building Spring for Stardog</a></li>
<li><a href="../docs/spring/#overview">Overview</a></li>
<li><a href="../docs/spring/#use">Use</a></li>
<li><a href="../docs/spring/#examples">Examples</a></li>
</ol>
</section>
<div><a name="bugs"></a></div>
<section>
<header><h1 id="chapter">Known Issues</h1></header>
<p>As of <b>@@VERSION@@</b>, the known
issues include:</p>
<ol>
<li>multi-reader, single writer concurrency.</li>
<li>Asking for all individuals with reasoning via the query <tt>{?s a owl:Thing}</tt>
might also retrieve some classes and properties. <b>WILLFIX</b></li>
<li>Schema queries do not bind graph variables.</li>
<li>Two query bugs due to its dependence on Sesame's SPARQL parser:
<a href="https://openrdf.atlassian.net/browse/SES-1119">SES-1119</a> and <a href="https://openrdf.atlassian.net/browse/SES-1121">SES-1121</a>. <b>WILLFIX</b> </li>
<li>Read/Write permissions for the database metadata and read/write
permissions to ICV constraints are not independent. Granting read/write
permission to database metadata will grant the same permissions for ICV. <b>Work around:</b> Remove the permissions on the db metadata and assign only ICV. <b>WILLFIX</b> </li>
<li>Dropping a database with the CLI will also delete all the data
files on your Stardog home directory associated with that database. If
you want to keep the data files but only remove the database from the
system catalog, then you need to manually copy these files to another
location before deleting the database.</li>
<li>If relative URIs exist in the data files passed to create, add, or
remove commands, then they will be resolved using the constant base URI
<tt>http://api.stardog.com/</tt> iff the format of the file allows
base URIs. Turtle and RDF/XML formats allows base URIs but N-Triples format
doesn't allow base URIs and relative URIs in N-Triples data will cause
errors.</li>
<li> queries with <code>FROM NAMED</code> with a named graph that is
<em>not</em> in Stardog will <b>not</b> cause Stardog to believe that it is,
in fact, Maven, i.e., to automagically download the data from an arbitrary
HTTP URL and include it in the query. Stardog will <em>only</em> evaluate
queries over data that has been loaded into it.</li>
<li>SPARQL queries without a context or named graph are executed
against the default, unnamed graph. In Stardog, the default graph is
<em>not</em> the union of all the named graphs and the default graph. Note: this behavior is configurable via the <tt>query.all.graphs</tt> configuration parameter.</li>
</ol>
</section>
<section id="fn">
<header> <h1 class="fn">Notes</h1></header>
<ol id="notes">
<!-- footnotes get pub'd here -->
</ol>
</section>
</div>
</div>
</div>
<div class="grid grid-pad">
<div class="col-1-1">
<nav><p><a class="top" href="#" title="Back to top"><span style="font-size: 48px">⌂</a></a></p></nav>
<!-- <header><h1 class=disqus>Comments</h1></header> -->
<footer>
<p id="thefooter"></p>
</footer>
</div>
</div>
<script src="/_/js/pbk.js" type="text/javascript"></script>
<script type="text/javascript">
nodeName = "head";
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-1719955-3']);
_gaq.push(['_setDomainName', 'stardog.com']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
<script src="/_/js/sticky.js" type="text/javascript"></script>
<script>
$(document).ready(function(){
$("#tocblock").sticky({topSpacing:4});
});
</script>
</body>
</html>