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
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html><head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Distinctive Features Of SQLite</title>
<style type="text/css">
body {
margin: auto;
font-family: Verdana, sans-serif;
padding: 8px 1%;
}
a { color: #044a64 }
a:visited { color: #734559 }
.logo { position:absolute; margin:3px; }
.tagline {
float:right;
text-align:right;
font-style:italic;
width:300px;
margin:12px;
margin-top:58px;
}
.menubar {
clear: both;
border-radius: 8px;
background: #044a64;
padding: 0px;
margin: 0px;
cell-spacing: 0px;
}
.toolbar {
text-align: center;
line-height: 1.6em;
margin: 0;
padding: 0px 8px;
}
.toolbar a { color: white; text-decoration: none; padding: 6px 12px; }
.toolbar a:visited { color: white; }
.toolbar a:hover { color: #044a64; background: white; }
.content { margin: 5%; }
.content dt { font-weight:bold; }
.content dd { margin-bottom: 25px; margin-left:20%; }
.content ul { padding:0px; padding-left: 15px; margin:0px; }
/* Things for "fancyformat" documents start here. */
.fancy img+p {font-style:italic}
.fancy .codeblock i { color: darkblue; }
.fancy h1,.fancy h2,.fancy h3,.fancy h4 {font-weight:normal;color:#044a64}
.fancy h2 { margin-left: 10px }
.fancy h3 { margin-left: 20px }
.fancy h4 { margin-left: 30px }
.fancy th {white-space:nowrap;text-align:left;border-bottom:solid 1px #444}
.fancy th, .fancy td {padding: 0.2em 1ex; vertical-align:top}
.fancy #toc a { color: darkblue ; text-decoration: none }
.fancy .todo { color: #AA3333 ; font-style : italic }
.fancy .todo:before { content: 'TODO:' }
.fancy p.todo { border: solid #AA3333 1px; padding: 1ex }
.fancy img { display:block; }
.fancy :link:hover, .fancy :visited:hover { background: wheat }
.fancy p,.fancy ul,.fancy ol { margin: 1em 5ex }
.fancy li p { margin: 1em 0 }
/* End of "fancyformat" specific rules. */
</style>
</head>
<body>
<div><!-- container div to satisfy validator -->
<a href="index.html">
<img class="logo" src="images/sqlite370_banner.gif" alt="SQLite Logo"
border="0"></a>
<div><!-- IE hack to prevent disappearing logo--></div>
<div class="tagline">Small. Fast. Reliable.<br>Choose any three.</div>
<table width=100% class="menubar"><tr>
<td width=100%>
<div class="toolbar">
<a href="about.html">About</a>
<a href="sitemap.html">Sitemap</a>
<a href="docs.html">Documentation</a>
<a href="download.html">Download</a>
<a href="copyright.html">License</a>
<a href="news.html">News</a>
<a href="support.html">Support</a>
</div>
<script>
gMsg = "Search SQLite Docs..."
function entersearch() {
var q = document.getElementById("q");
if( q.value == gMsg ) { q.value = "" }
q.style.color = "black"
q.style.fontStyle = "normal"
}
function leavesearch() {
var q = document.getElementById("q");
if( q.value == "" ) {
q.value = gMsg
q.style.color = "#044a64"
q.style.fontStyle = "italic"
}
}
function hideorshow(btn,obj){
var x = document.getElementById(obj);
var b = document.getElementById(btn);
if( x.style.display!='none' ){
x.style.display = 'none';
b.innerHTML='show';
}else{
x.style.display = '';
b.innerHTML='hide';
}
return false;
}
</script>
<td>
<div style="padding:0 1em 0px 0;white-space:nowrap">
<form name=f method="GET" action="http://www.sqlite.org/search">
<input id=q name=q type=text
onfocus="entersearch()" onblur="leavesearch()" style="width:24ex;padding:1px 1ex; border:solid white 1px; font-size:0.9em ; font-style:italic;color:#044a64;" value="Search SQLite Docs...">
<input type=submit value="Go" style="border:solid white 1px;background-color:#044a64;color:white;font-size:0.9em;padding:0 1ex">
</form>
</div>
</table>
<div class=startsearch></div>
<h1 align=center>Distinctive Features Of SQLite</h1>
<p>
This page highlights some of the characteristics of SQLite that are
unusual and which make SQLite different from many other SQL
database engines.
</p>
<a name="zeroconfig"></a>
<p><b>Zero-Configuration</b></p>
<blockquote>
SQLite does not need to be "installed" before it is used.
There is no "setup" procedure. There is no
server process that needs to be started, stopped, or configured.
There is
no need for an administrator to create a new database instance or assign
access permissions to users.
SQLite uses no configuration files.
Nothing needs to be done to tell the system that SQLite is running.
No actions are required to recover after a system crash or power failure.
There is nothing to troubleshoot.
<p>
SQLite just works.
<p>
Other more familiar database engines run great once you get them going.
But doing the initial installation and configuration can be
intimidatingly complex.
</blockquote>
<a name="serverless"></a>
<p><b>Serverless</b></p>
<blockquote>
Most SQL database engines are implemented as a separate server
process. Programs that want to access the database communicate
with the server using some kind of interprocess communication
(typically TCP/IP) to send requests to the server and to receive
back results. SQLite does not work this way. With SQLite, the
process that wants to access the database reads and writes
directly from the database files on disk. There is no intermediary
server process.
<p>
There are advantages and disadvantages to being serverless. The
main advantage is that there is no separate server process
to install, setup, configure, initialize, manage, and troubleshoot.
This is one reason why SQLite is a "zero-configuration" database
engine. Programs that use SQLite require no administrative support
for setting up the database engine before they are run. Any program
that is able to access the disk is able to use an SQLite database.
<p>
On the other hand, a database engine that uses a server can provide
better protection from bugs in the client application - stray pointers
in a client cannot corrupt memory on the server. And because a server
is a single persistent process, it is able control database access with
more precision, allowing for finer grain locking and better concurrency.
<p>
Most SQL database engines are client/server based. Of those that are
serverless, SQLite is the only one that this author knows of that
allows multiple applications to access the same database at the same time.
</blockquote>
<a name="onefile"></a>
<p><b>Single Database File</b></p>
<blockquote>
An SQLite database is a single ordinary disk file that can be located
anywhere in the directory hierarchy. If SQLite can read
the disk file then it can read anything in the database. If the disk
file and its directory are writable, then SQLite can change anything
in the database. Database files can easily be copied onto a USB
memory stick or emailed for sharing.
<p>
Other SQL database engines tend to store data as a large collection of
files. Often these files are in a standard location that only the
database engine itself can access. This makes the data more secure,
but also makes it harder to access. Some SQL database engines provide
the option of writing directly to disk and bypassing the filesystem
all together. This provides added performance, but at the cost of
considerable setup and maintenance complexity.
</blockquote>
<a name="onefile"></a>
<p><b>Stable Cross-Platform Database File</b></p>
<blockquote>
The SQLite file format is cross-platform. A database file written
on one machine can be copied to and used on a different machine with
a different architecture. Big-endian or little-endian, 32-bit or
64-bit does not matter. All machines use the same file format.
Furthermore, the developers have pledged to keep the file format
stable and backwards compatible, so newer versions of SQLite can
read and write older database files.
<p>
Most other SQL database engines require you to dump and restore
the database when moving from one platform to another and often
when upgrading to a newer version of the software.
</blockquote>
<a name="small"></a>
<p><b>Compact</b></p>
<blockquote>
When optimized for size, the whole SQLite library with everything enabled
is <a href="footprint.html">less than 500KiB in size</a>
(as measured on an ix86 using the "size"
utility from the GNU compiler suite.) Unneeded features can be disabled
at compile-time to further reduce the size of the library to under
300KiB if desired.
<p>
Most other SQL database engines are much larger than this. IBM boasts
that its recently released CloudScape database engine is "only" a 2MiB
jar file - an order of magnitude larger than SQLite even after it is
compressed!
Firebird boasts that its client-side library is only 350KiB. That's
as big as SQLite and does not even contain the database engine.
The Berkeley DB library from Oracle is 450KiB and it omits SQL
support, providing the programmer with only simple key/value pairs.
</blockquote>
<a name="typing"></a>
<p><b>Manifest typing</b></p>
<blockquote>
Most SQL database engines use static typing. A datatype is associated
with each column in a table and only values of that particular datatype
are allowed to be stored in that column. SQLite relaxes this restriction
by using manifest typing.
In manifest typing, the datatype is a property of the value itself, not
of the column in which the value is stored.
SQLite thus allows the user to store
any value of any datatype into any column regardless of the declared type
of that column. (There are some exceptions to this rule: An INTEGER
PRIMARY KEY column may only store integers. And SQLite attempts to coerce
values into the declared datatype of the column when it can.)
<p>
As far as we can tell, the SQL language specification allows the use
of manifest typing. Nevertheless, most other SQL database engines are
statically typed and so some people
feel that the use of manifest typing is a bug in SQLite. But the authors
of SQLite feel very strongly that this is a feature. The use of manifest
typing in SQLite is a deliberate design decision which has proven in practice
to make SQLite more reliable and easier to use, especially when used in
combination with dynamically typed programming languages such as Tcl and
Python.
</blockquote>
<a name="flex"></a>
<p><b>Variable-length records</b></p>
<blockquote>
Most other SQL database engines allocated a fixed amount of disk space
for each row in most tables. They play special tricks for handling
BLOBs and CLOBs which can be of wildly varying length. But for most
tables, if you declare a column to be a VARCHAR(100) then the database
engine will allocate
100 bytes of disk space regardless of how much information you actually
store in that column.
<p>
SQLite, in contrast, use only the amount of disk space actually
needed to store the information in a row. If you store a single
character in a VARCHAR(100) column, then only a single byte of disk
space is consumed. (Actually two bytes - there is some overhead at
the beginning of each column to record its datatype and length.)
<p>
The use of variable-length records by SQLite has a number of advantages.
It results in smaller database files, obviously. It also makes the
database run faster, since there is less information to move to and from
disk. And, the use of variable-length records makes it possible for
SQLite to employ manifest typing instead of static typing.
</blockquote>
<a name="readable"></a>
<p><b>Readable source code</b></p>
<blockquote>
The source code to SQLite is designed to be readable and accessible to
the average programmer. All procedures and data structures and many
automatic variables are carefully commented with useful information about
what they do. Boilerplate commenting is omitted.
</blockquote>
<a name="vdbe"></a>
<p><b>SQL statements compile into virtual machine code</b></p>
<blockquote>
Every SQL database engine compiles each SQL statement into some kind of
internal data structure which is then used to carry out the work of the
statement. But in most SQL engines that internal data structure is a
complex web of interlinked structures and objects. In SQLite, the compiled
form of statements is a short program in a machine-language like
representation. Users of the database can view this
<a href="opcode.html">virtual machine language</a>
by prepending the <a href="lang_explain.html">EXPLAIN</a> keyword
to a query.
<p>
The use of a virtual machine in SQLite has been a great benefit to the
library's development. The virtual machine provides a crisp, well-defined
junction between the front-end of SQLite (the part that parses SQL
statements and generates virtual machine code) and the back-end (the
part that executes the virtual machine code and computes a result.)
The virtual machine allows the developers to see clearly and in an
easily readable form what SQLite is trying to do with each statement
it compiles, which is a tremendous help in debugging.
Depending on how it is compiled, SQLite also has the capability of
tracing the execution of the virtual machine - printing each
virtual machine instruction and its result as it executes.
</blockquote>
<a name="license"></a>
<p><b>Public domain</b></p>
<blockquote>
The source code for SQLite is in the public domain. No claim of copyright
is made on any part of the core source code. (The documentation and test
code is a different matter - some sections of documentation and test logic
are governed by open-source licenses.) All contributors to the
SQLite core software have signed affidavits specifically disavowing any
copyright interest in the code. This means that anybody is able to legally
do anything they want with the SQLite source code.
<p>
There are other SQL database engines with liberal licenses that allow
the code to be broadly and freely used. But those other engines are
still governed by copyright law. SQLite is different in that copyright
law simply does not apply.
<p>
The source code files for other SQL database engines typically begin
with a comment describing your license rights to view and copy that file.
The SQLite source code contains no license since it is not governed by
copyright. Instead of a license, the SQLite source code offers a blessing:
<blockquote>
<i>May you do good and not evil<br>
May you find forgiveness for yourself and forgive others<br>
May you share freely, never taking more than you give.</i>
</blockquote>
</blockquote>
<a name="extensions"></a>
<p><b>SQL language extensions</b></p>
<blockquote>
SQLite provides a number of enhancements to the SQL language
not normally found in other database engines.
The EXPLAIN keyword and manifest typing have already been mentioned
above. SQLite also provides statements such as
<a href="lang_replace.html">REPLACE</a> and the
<a href="lang_conflict.html">ON CONFLICT</a> clause that allow for
added control over the resolution of constraint conflicts.
SQLite supports <a href="lang_attach.html">ATTACH</a> and
<a href="lang_detach.html">DETACH</a> commands that allow multiple
independent databases to be used together in the same query.
And SQLite defines APIs that allows the user to add new
<a href="c3ref/create_function.html">SQL functions</a>
and <a href="c3ref/create_collation.html">collating sequences</a>.
</blockquote>
|
