Artifact
4c79c67f09e53ddee172a3859f418595cca5a14c:
- File
pages/docs.in
— part of check-in
[a192161bbc]
at
2008-04-25 02:42:29
on branch trunk
— Updates to the temporary-files document. Create a link to the document
from the main documentation index page. Also patch the journal_mode
pragma documentation.
(user:
drh
size: 5450)
0000: 3c 74 69 74 6c 65 3e 53 51 4c 69 74 65 20 44 6f <title>SQLite Do
0010: 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 74 69 74 cumentation</tit
0020: 6c 65 3e 0a 0a 3c 68 32 3e 41 76 61 69 6c 61 62 le>..<h2>Availab
0030: 6c 65 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e le Documentation
0040: 3c 2f 68 32 3e 0a 3c 74 61 62 6c 65 20 77 69 64 </h2>.<table wid
0050: 74 68 3d 22 31 30 30 25 22 20 63 65 6c 6c 70 61 th="100%" cellpa
0060: 64 64 69 6e 67 3d 22 35 22 3e 0a 0a 3c 74 63 6c dding="5">..<tcl
0070: 3e 0a 70 72 6f 63 20 64 6f 63 20 7b 6e 61 6d 65 >.proc doc {name
0080: 20 75 72 6c 20 64 65 73 63 7d 20 7b 0a 20 20 68 url desc} {. h
0090: 64 5f 70 75 74 73 20 7b 3c 74 72 3e 3c 74 64 20 d_puts {<tr><td
00a0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 valign="top" ali
00b0: 67 6e 3d 22 72 69 67 68 74 22 3e 7d 0a 20 20 72 gn="right">}. r
00c0: 65 67 73 75 62 20 2d 61 6c 6c 20 7b 20 2b 7d 20 egsub -all { +}
00d0: 24 6e 61 6d 65 20 7b 5c 26 6e 62 73 70 3b 7d 20 $name {\ }
00e0: 6e 61 6d 65 0a 20 20 68 64 5f 70 75 74 73 20 22 name. hd_puts "
00f0: 3c 61 20 68 72 65 66 3d 5c 22 24 75 72 6c 5c 22 <a href=\"$url\"
0100: 3e 24 6e 61 6d 65 3c 2f 61 3e 3c 2f 74 64 3e 22 >$name</a></td>"
0110: 0a 20 20 68 64 5f 70 75 74 73 20 7b 3c 74 64 20 . hd_puts {<td
0120: 77 69 64 74 68 3d 22 31 30 22 3e 3c 2f 74 64 3e width="10"></td>
0130: 7d 0a 20 20 68 64 5f 70 75 74 73 20 7b 3c 74 64 }. hd_puts {<td
0140: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c valign="top" al
0150: 69 67 6e 3d 22 6c 65 66 74 22 3e 7d 0a 20 20 68 ign="left">}. h
0160: 64 5f 72 65 73 6f 6c 76 65 20 24 64 65 73 63 0a d_resolve $desc.
0170: 20 20 68 64 5f 70 75 74 73 20 7b 3c 2f 74 64 3e hd_puts {</td>
0180: 3c 2f 74 72 3e 7d 0a 7d 0a 0a 64 6f 63 20 7b 41 </tr>}.}..doc {A
0190: 70 70 72 6f 70 72 69 61 74 65 20 55 73 65 73 20 ppropriate Uses
01a0: 46 6f 72 20 53 51 4c 69 74 65 7d 20 7b 77 68 65 For SQLite} {whe
01b0: 6e 74 6f 75 73 65 2e 68 74 6d 6c 7d 20 7b 0a 20 ntouse.html} {.
01c0: 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 64 This document d
01d0: 65 73 63 72 69 62 65 73 20 73 69 74 75 61 74 69 escribes situati
01e0: 6f 6e 73 20 77 68 65 72 65 20 53 51 4c 69 74 65 ons where SQLite
01f0: 20 69 73 20 61 6e 20 61 70 70 72 6f 70 72 69 61 is an appropria
0200: 74 65 0a 20 20 64 61 74 61 62 61 73 65 20 65 6e te. database en
0210: 67 69 6e 65 20 74 6f 20 75 73 65 20 76 65 72 73 gine to use vers
0220: 75 73 20 73 69 74 75 61 74 69 6f 6e 73 20 77 68 us situations wh
0230: 65 72 65 20 61 20 63 6c 69 65 6e 74 2f 73 65 72 ere a client/ser
0240: 76 65 72 0a 20 20 64 61 74 61 62 61 73 65 20 65 ver. database e
0250: 6e 67 69 6e 65 20 6d 69 67 68 74 20 62 65 20 61 ngine might be a
0260: 20 62 65 74 74 65 72 20 63 68 6f 69 63 65 2e 0a better choice..
0270: 7d 0a 0a 64 6f 63 20 7b 44 69 73 74 69 6e 63 74 }..doc {Distinct
0280: 69 76 65 20 46 65 61 74 75 72 65 73 7d 20 7b 64 ive Features} {d
0290: 69 66 66 65 72 65 6e 74 2e 68 74 6d 6c 7d 20 7b ifferent.html} {
02a0: 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 . This document
02b0: 20 65 6e 75 6d 65 72 61 74 65 73 20 61 6e 64 20 enumerates and
02c0: 64 65 73 63 72 69 62 65 73 20 73 6f 6d 65 20 6f describes some o
02d0: 66 20 74 68 65 20 66 65 61 74 75 72 65 73 20 6f f the features o
02e0: 66 0a 20 20 53 51 4c 69 74 65 20 74 68 61 74 20 f. SQLite that
02f0: 6d 61 6b 65 20 69 74 20 64 69 66 66 65 72 65 6e make it differen
0300: 74 20 66 72 6f 6d 20 6f 74 68 65 72 20 53 51 4c t from other SQL
0310: 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 database engine
0320: 73 2e 0a 7d 0a 0a 64 6f 63 20 7b 53 51 4c 69 74 s..}..doc {SQLit
0330: 65 20 49 6e 20 35 20 4d 69 6e 75 74 65 73 20 4f e In 5 Minutes O
0340: 72 20 4c 65 73 73 7d 20 7b 71 75 69 63 6b 73 74 r Less} {quickst
0350: 61 72 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 art.html} {. A
0360: 76 65 72 79 20 71 75 69 63 6b 20 69 6e 74 72 6f very quick intro
0370: 64 75 63 74 69 6f 6e 20 74 6f 20 70 72 6f 67 72 duction to progr
0380: 61 6d 6d 69 6e 67 20 77 69 74 68 20 53 51 4c 69 amming with SQLi
0390: 74 65 2e 0a 7d 0a 0a 64 6f 63 20 7b 53 51 4c 20 te..}..doc {SQL
03a0: 53 79 6e 74 61 78 7d 20 7b 6c 61 6e 67 2e 68 74 Syntax} {lang.ht
03b0: 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 ml} {. This doc
03c0: 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20 ument describes
03d0: 74 68 65 20 53 51 4c 20 6c 61 6e 67 75 61 67 65 the SQL language
03e0: 20 74 68 61 74 20 69 73 20 75 6e 64 65 72 73 74 that is underst
03f0: 6f 6f 64 20 62 79 0a 20 20 53 51 4c 69 74 65 2e ood by. SQLite.
0400: 20 20 0a 7d 0a 64 6f 63 20 7b 56 65 72 73 69 6f .}.doc {Versio
0410: 6e 20 33 20 43 2f 43 2b 2b 20 41 50 49 3c 62 72 n 3 C/C++ API<br
0420: 3e 52 65 66 65 72 65 6e 63 65 7d 20 7b 63 33 72 >Reference} {c3r
0430: 65 66 2f 69 6e 74 72 6f 2e 68 74 6d 6c 7d 20 7b ef/intro.html} {
0440: 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 . This document
0450: 20 64 65 73 63 72 69 62 65 73 20 65 61 63 68 20 describes each
0460: 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 73 65 70 API function sep
0470: 61 72 61 74 65 6c 79 2e 0a 7d 0a 64 6f 63 20 7b arately..}.doc {
0480: 46 72 65 71 75 65 6e 74 6c 79 20 41 73 6b 65 64 Frequently Asked
0490: 20 51 75 65 73 74 69 6f 6e 73 7d 20 7b 66 61 71 Questions} {faq
04a0: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65 20 74 .html} {. The t
04b0: 69 74 6c 65 20 6f 66 20 74 68 65 20 64 6f 63 75 itle of the docu
04c0: 6d 65 6e 74 20 73 61 79 73 20 61 6c 6c 2e 2e 2e ment says all...
04d0: 0a 7d 0a 64 6f 63 20 7b 53 68 61 72 69 6e 67 20 .}.doc {Sharing
04e0: 43 61 63 68 65 20 4d 6f 64 65 7d 20 7b 73 68 61 Cache Mode} {sha
04f0: 72 65 64 63 61 63 68 65 2e 68 74 6d 6c 7d 20 7b redcache.html} {
0500: 0a 20 20 56 65 72 73 69 6f 6e 20 33 2e 33 2e 30 . Version 3.3.0
0510: 20 61 6e 64 20 6c 61 74 65 72 20 73 75 70 70 6f and later suppo
0520: 72 74 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 rts the ability
0530: 66 6f 72 20 74 77 6f 20 6f 72 20 6d 6f 72 65 0a for two or more.
0540: 20 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 database conne
0550: 63 74 69 6f 6e 73 20 74 6f 20 73 68 61 72 65 20 ctions to share
0560: 74 68 65 20 73 61 6d 65 20 70 61 67 65 20 61 6e the same page an
0570: 64 20 73 63 68 65 6d 61 20 63 61 63 68 65 2e 0a d schema cache..
0580: 20 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 This feature i
0590: 73 20 75 73 65 66 75 6c 20 66 6f 72 20 63 65 72 s useful for cer
05a0: 74 61 69 6e 20 73 70 65 63 69 61 6c 69 7a 65 64 tain specialized
05b0: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d applications..}
05c0: 0a 64 6f 63 20 7b 54 63 6c 20 41 50 49 7d 20 7b .doc {Tcl API} {
05d0: 74 63 6c 73 71 6c 69 74 65 2e 68 74 6d 6c 7d 20 tclsqlite.html}
05e0: 7b 0a 20 20 41 20 64 65 73 63 72 69 70 74 69 6f {. A descriptio
05f0: 6e 20 6f 66 20 74 68 65 20 54 43 4c 20 69 6e 74 n of the TCL int
0600: 65 72 66 61 63 65 20 62 69 6e 64 69 6e 67 73 20 erface bindings
0610: 66 6f 72 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 64 for SQLite..}..d
0620: 6f 63 20 7b 54 65 6d 70 6f 72 61 72 79 20 46 69 oc {Temporary Fi
0630: 6c 65 73 20 55 73 65 64 20 42 79 20 53 51 4c 69 les Used By SQLi
0640: 74 65 7d 20 7b 74 65 6d 70 66 69 6c 65 73 2e 68 te} {tempfiles.h
0650: 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c 69 74 65 20 tml} {. SQLite
0660: 63 61 6e 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 can potentially
0670: 75 73 65 20 6d 61 6e 79 20 64 69 66 66 65 72 65 use many differe
0680: 6e 74 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c nt temporary fil
0690: 65 73 20 77 68 65 6e 0a 20 20 70 72 6f 63 65 73 es when. proces
06a0: 73 69 6e 67 20 63 65 72 74 61 69 6e 20 53 51 4c sing certain SQL
06b0: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 54 68 statements. Th
06c0: 69 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 is document desc
06d0: 72 69 62 65 73 20 74 68 65 0a 20 20 6d 61 6e 79 ribes the. many
06e0: 20 6b 69 6e 64 73 20 6f 66 20 74 65 6d 70 6f 72 kinds of tempor
06f0: 61 72 79 20 66 69 6c 65 73 20 74 68 61 74 20 53 ary files that S
0700: 51 4c 69 74 65 20 75 73 65 73 20 61 6e 64 20 6f QLite uses and o
0710: 66 66 65 72 73 20 73 75 67 67 65 73 74 69 6f 6e ffers suggestion
0720: 73 0a 20 20 66 6f 72 20 61 76 6f 69 64 69 6e 67 s. for avoiding
0730: 20 74 68 65 6d 20 6f 6e 20 73 79 73 74 65 6d 73 them on systems
0740: 20 77 68 65 72 65 20 63 72 65 61 74 69 6e 67 20 where creating
0750: 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 a temporary file
0760: 20 69 73 20 61 6e 0a 20 20 65 78 70 65 6e 73 69 is an. expensi
0770: 76 65 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 7d 0a ve operation..}.
0780: 0a 64 6f 63 20 7b 48 6f 77 20 53 51 4c 69 74 65 .doc {How SQLite
0790: 20 49 6d 70 6c 65 6d 65 6e 74 73 20 41 74 6f 6d Implements Atom
07a0: 69 63 20 43 6f 6d 6d 69 74 7d 20 7b 61 74 6f 6d ic Commit} {atom
07b0: 69 63 63 6f 6d 6d 69 74 2e 68 74 6d 6c 7d 20 7b iccommit.html} {
07c0: 0a 20 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e . A description
07d0: 20 6f 66 20 74 68 65 20 6c 6f 67 69 63 20 77 69 of the logic wi
07e0: 74 68 69 6e 20 53 51 4c 69 74 65 20 74 68 61 74 thin SQLite that
07f0: 20 69 6d 70 6c 65 6d 65 6e 74 73 0a 20 20 74 72 implements. tr
0800: 61 6e 73 61 63 74 69 6f 6e 73 20 77 69 74 68 20 ansactions with
0810: 61 74 6f 6d 69 63 20 63 6f 6d 6d 69 74 2c 20 65 atomic commit, e
0820: 76 65 6e 20 69 6e 20 74 68 65 20 66 61 63 65 20 ven in the face
0830: 6f 66 20 70 6f 77 65 72 0a 20 20 66 61 69 6c 75 of power. failu
0840: 72 65 73 2e 0a 7d 0a 64 6f 63 20 7b 4d 6f 76 69 res..}.doc {Movi
0850: 6e 67 20 46 72 6f 6d 20 53 51 4c 69 74 65 20 33 ng From SQLite 3
0860: 2e 34 20 74 6f 20 33 2e 35 7d 20 7b 33 34 74 6f .4 to 3.5} {34to
0870: 33 35 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64 35.html} {. A d
0880: 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 69 ocument describi
0890: 6e 67 20 74 68 65 20 64 69 66 66 65 72 65 6e 63 ng the differenc
08a0: 65 73 20 62 65 74 77 65 65 6e 20 53 51 4c 69 74 es between SQLit
08b0: 65 20 76 65 72 73 69 6f 6e 20 33 2e 34 2e 32 0a e version 3.4.2.
08c0: 20 20 61 6e 64 20 33 2e 35 2e 30 2e 0a 7d 0a 0a and 3.5.0..}..
08d0: 64 6f 63 20 7b 50 72 61 67 6d 61 20 63 6f 6d 6d doc {Pragma comm
08e0: 61 6e 64 73 7d 20 7b 70 72 61 67 6d 61 2e 68 74 ands} {pragma.ht
08f0: 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 ml} {. This doc
0900: 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20 ument describes
0910: 53 51 4c 69 74 65 20 70 65 72 66 6f 72 6d 61 6e SQLite performan
0920: 63 65 20 74 75 6e 69 6e 67 20 6f 70 74 69 6f 6e ce tuning option
0930: 73 20 61 6e 64 20 6f 74 68 65 72 20 0a 20 20 73 s and other . s
0940: 70 65 63 69 61 6c 20 70 75 72 70 6f 73 65 20 64 pecial purpose d
0950: 61 74 61 62 61 73 65 20 63 6f 6d 6d 61 6e 64 73 atabase commands
0960: 2e 0a 7d 0a 64 6f 63 20 7b 53 51 4c 69 74 65 20 ..}.doc {SQLite
0970: 56 65 72 73 69 6f 6e 20 33 7d 20 7b 76 65 72 73 Version 3} {vers
0980: 69 6f 6e 33 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 ion3.html} {. A
0990: 20 73 75 6d 6d 61 72 79 20 6f 66 20 6f 66 20 74 summary of of t
09a0: 68 65 20 63 68 61 6e 67 65 73 20 62 65 74 77 65 he changes betwe
09b0: 65 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f en SQLite versio
09c0: 6e 20 32 2e 38 20 61 6e 64 20 53 51 4c 69 74 65 n 2.8 and SQLite
09d0: 20 76 65 72 73 69 6f 6e 20 33 2e 30 2e 0a 7d 0a version 3.0..}.
09e0: 64 6f 63 20 7b 56 65 72 73 69 6f 6e 20 33 20 43 doc {Version 3 C
09f0: 2f 43 2b 2b 20 41 50 49 7d 20 7b 63 61 70 69 33 /C++ API} {capi3
0a00: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64 65 73 .html} {. A des
0a10: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 cription of the
0a20: 43 2f 43 2b 2b 20 69 6e 74 65 72 66 61 63 65 20 C/C++ interface
0a30: 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 53 51 4c bindings for SQL
0a40: 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 30 2e ite version 3.0.
0a50: 30 0a 20 20 61 6e 64 20 66 6f 6c 6c 6f 77 69 6e 0. and followin
0a60: 67 2e 0a 7d 0a 64 6f 63 20 7b 56 65 72 73 69 6f g..}.doc {Versio
0a70: 6e 20 33 20 44 61 74 61 54 79 70 65 73 20 7d 20 n 3 DataTypes }
0a80: 7b 64 61 74 61 74 79 70 65 33 2e 68 74 6d 6c 7d {datatype3.html}
0a90: 20 7b 0a 20 20 53 51 4c 69 74 65 20 76 65 72 73 {. SQLite vers
0aa0: 69 6f 6e 20 33 20 69 6e 74 72 6f 64 75 63 65 73 ion 3 introduces
0ab0: 20 74 68 65 20 63 6f 6e 63 65 70 74 20 6f 66 20 the concept of
0ac0: 6d 61 6e 69 66 65 73 74 20 74 79 70 69 6e 67 2c manifest typing,
0ad0: 20 77 68 65 72 65 20 74 68 65 0a 20 20 74 79 70 where the. typ
0ae0: 65 20 6f 66 20 61 20 76 61 6c 75 65 20 69 73 20 e of a value is
0af0: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
0b00: 74 68 65 20 76 61 6c 75 65 20 69 74 73 65 6c 66 the value itself
0b10: 2c 20 6e 6f 74 20 74 68 65 20 63 6f 6c 75 6d 6e , not the column
0b20: 20 74 68 61 74 0a 20 20 69 74 20 69 73 20 73 74 that. it is st
0b30: 6f 72 65 64 20 69 6e 2e 0a 20 20 54 68 69 73 20 ored in.. This
0b40: 70 61 67 65 20 64 65 73 63 72 69 62 65 73 20 64 page describes d
0b50: 61 74 61 20 74 79 70 69 6e 67 20 66 6f 72 20 53 ata typing for S
0b60: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 20 QLite version 3
0b70: 69 6e 20 66 75 72 74 68 65 72 20 64 65 74 61 69 in further detai
0b80: 6c 2e 0a 7d 0a 0a 64 6f 63 20 7b 4c 6f 63 6b 69 l..}..doc {Locki
0b90: 6e 67 20 41 6e 64 20 43 6f 6e 63 75 72 72 65 6e ng And Concurren
0ba0: 63 79 3c 62 72 3e 49 6e 20 53 51 4c 69 74 65 20 cy<br>In SQLite
0bb0: 56 65 72 73 69 6f 6e 20 33 7d 20 7b 6c 6f 63 6b Version 3} {lock
0bc0: 69 6e 67 76 33 2e 68 74 6d 6c 7d 20 7b 0a 20 20 ingv3.html} {.
0bd0: 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 A description of
0be0: 20 68 6f 77 20 74 68 65 20 6e 65 77 20 6c 6f 63 how the new loc
0bf0: 6b 69 6e 67 20 63 6f 64 65 20 69 6e 20 76 65 72 king code in ver
0c00: 73 69 6f 6e 20 33 20 69 6e 63 72 65 61 73 65 73 sion 3 increases
0c10: 0a 20 20 63 6f 6e 63 75 72 72 65 6e 63 79 20 61 . concurrency a
0c20: 6e 64 20 64 65 63 72 65 61 73 65 73 20 74 68 65 nd decreases the
0c30: 20 70 72 6f 62 6c 65 6d 20 6f 66 20 77 72 69 74 problem of writ
0c40: 65 72 20 73 74 61 72 76 61 74 69 6f 6e 2e 0a 7d er starvation..}
0c50: 0a 0a 64 6f 63 20 7b 4f 76 65 72 76 69 65 77 20 ..doc {Overview
0c60: 4f 66 20 54 68 65 20 4f 70 74 69 6d 69 7a 65 72 Of The Optimizer
0c70: 7d 20 7b 6f 70 74 6f 76 65 72 76 69 65 77 2e 68 } {optoverview.h
0c80: 74 6d 6c 7d 20 7b 0a 20 20 41 20 71 75 69 63 6b tml} {. A quick
0c90: 20 6f 76 65 72 76 69 65 77 20 6f 66 20 74 68 65 overview of the
0ca0: 20 76 61 72 69 6f 75 73 20 71 75 65 72 79 20 6f various query o
0cb0: 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 74 68 61 ptimizations tha
0cc0: 74 20 61 72 65 0a 20 20 61 74 74 65 6d 70 74 65 t are. attempte
0cd0: 64 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 d by the SQLite
0ce0: 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 2e 0a code generator..
0cf0: 7d 0a 0a 0a 64 6f 63 20 7b 4e 75 6c 6c 20 48 61 }...doc {Null Ha
0d00: 6e 64 6c 69 6e 67 7d 20 7b 6e 75 6c 6c 73 2e 68 ndling} {nulls.h
0d10: 74 6d 6c 7d 20 7b 0a 20 20 44 69 66 66 65 72 65 tml} {. Differe
0d20: 6e 74 20 53 51 4c 20 64 61 74 61 62 61 73 65 20 nt SQL database
0d30: 65 6e 67 69 6e 65 73 20 68 61 6e 64 6c 65 20 4e engines handle N
0d40: 55 4c 4c 73 20 69 6e 20 64 69 66 66 65 72 65 6e ULLs in differen
0d50: 74 20 77 61 79 73 2e 20 20 54 68 65 0a 20 20 53 t ways. The. S
0d60: 51 4c 20 73 74 61 6e 64 61 72 64 73 20 61 72 65 QL standards are
0d70: 20 61 6d 62 69 67 75 6f 75 73 2e 20 20 54 68 69 ambiguous. Thi
0d80: 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 s document descr
0d90: 69 62 65 73 20 68 6f 77 20 53 51 4c 69 74 65 20 ibes how SQLite
0da0: 68 61 6e 64 6c 65 73 0a 20 20 4e 55 4c 4c 73 20 handles. NULLs
0db0: 69 6e 20 63 6f 6d 70 61 72 69 73 6f 6e 20 77 69 in comparison wi
0dc0: 74 68 20 6f 74 68 65 72 20 53 51 4c 20 64 61 74 th other SQL dat
0dd0: 61 62 61 73 65 20 65 6e 67 69 6e 65 73 2e 0a 7d abase engines..}
0de0: 0a 0a 64 6f 63 20 7b 43 6f 70 79 72 69 67 68 74 ..doc {Copyright
0df0: 7d 20 7b 63 6f 70 79 72 69 67 68 74 2e 68 74 6d } {copyright.htm
0e00: 6c 7d 20 7b 0a 20 20 53 51 4c 69 74 65 20 69 73 l} {. SQLite is
0e10: 20 69 6e 20 74 68 65 20 70 75 62 6c 69 63 20 64 in the public d
0e20: 6f 6d 61 69 6e 2e 20 20 54 68 69 73 20 64 6f 63 omain. This doc
0e30: 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20 ument describes
0e40: 77 68 61 74 20 74 68 61 74 20 6d 65 61 6e 73 0a what that means.
0e50: 20 20 61 6e 64 20 74 68 65 20 69 6d 70 6c 69 63 and the implic
0e60: 61 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6e 74 72 ations for contr
0e70: 69 62 75 74 6f 72 73 2e 0a 7d 0a 0a 64 6f 63 20 ibutors..}..doc
0e80: 7b 55 6e 73 75 70 70 6f 72 74 65 64 20 53 51 4c {Unsupported SQL
0e90: 7d 20 7b 6f 6d 69 74 74 65 64 2e 68 74 6d 6c 7d } {omitted.html}
0ea0: 20 7b 0a 20 20 54 68 69 73 20 70 61 67 65 20 64 {. This page d
0eb0: 65 73 63 72 69 62 65 73 20 66 65 61 74 75 72 65 escribes feature
0ec0: 73 20 6f 66 20 53 51 4c 20 74 68 61 74 20 53 51 s of SQL that SQ
0ed0: 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 73 75 Lite does not su
0ee0: 70 70 6f 72 74 2e 0a 7d 0a 0a 64 6f 63 20 7b 56 pport..}..doc {V
0ef0: 65 72 73 69 6f 6e 20 32 20 43 2f 43 2b 2b 20 41 ersion 2 C/C++ A
0f00: 50 49 7d 20 7b 63 5f 69 6e 74 65 72 66 61 63 65 PI} {c_interface
0f10: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64 65 73 .html} {. A des
0f20: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 cription of the
0f30: 43 2f 43 2b 2b 20 69 6e 74 65 72 66 61 63 65 20 C/C++ interface
0f40: 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 53 51 4c bindings for SQL
0f50: 69 74 65 20 74 68 72 6f 75 67 68 20 76 65 72 73 ite through vers
0f60: 69 6f 6e 20 0a 20 20 32 2e 38 0a 7d 0a 0a 0a 64 ion . 2.8.}...d
0f70: 6f 63 20 7b 56 65 72 73 69 6f 6e 20 32 20 44 61 oc {Version 2 Da
0f80: 74 61 54 79 70 65 73 20 7d 20 7b 64 61 74 61 74 taTypes } {datat
0f90: 79 70 65 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 ypes.html} {. A
0fa0: 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 description of
0fb0: 68 6f 77 20 53 51 4c 69 74 65 20 76 65 72 73 69 how SQLite versi
0fc0: 6f 6e 20 32 20 68 61 6e 64 6c 65 73 20 53 51 4c on 2 handles SQL
0fd0: 20 64 61 74 61 74 79 70 65 73 2e 0a 20 20 53 68 datatypes.. Sh
0fe0: 6f 72 74 20 73 75 6d 6d 61 72 79 3a 20 20 45 76 ort summary: Ev
0ff0: 65 72 79 74 68 69 6e 67 20 69 73 20 61 20 73 74 erything is a st
1000: 72 69 6e 67 2e 0a 7d 0a 0a 64 6f 63 20 7b 52 65 ring..}..doc {Re
1010: 6c 65 61 73 65 20 48 69 73 74 6f 72 79 7d 20 7b lease History} {
1020: 63 68 61 6e 67 65 73 2e 68 74 6d 6c 7d 20 7b 0a changes.html} {.
1030: 20 20 41 20 63 68 72 6f 6e 6f 6c 6f 67 79 20 6f A chronology o
1040: 66 20 53 51 4c 69 74 65 20 72 65 6c 65 61 73 65 f SQLite release
1050: 73 20 67 6f 69 6e 67 20 62 61 63 6b 20 74 6f 20 s going back to
1060: 76 65 72 73 69 6f 6e 20 31 2e 30 2e 30 0a 7d 0a version 1.0.0.}.
1070: 0a 0a 64 6f 63 20 7b 53 70 65 65 64 20 43 6f 6d ..doc {Speed Com
1080: 70 61 72 69 73 6f 6e 7d 20 7b 73 70 65 65 64 2e parison} {speed.
1090: 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65 20 73 70 html} {. The sp
10a0: 65 65 64 20 6f 66 20 76 65 72 73 69 6f 6e 20 32 eed of version 2
10b0: 2e 37 2e 36 20 6f 66 20 53 51 4c 69 74 65 20 69 .7.6 of SQLite i
10c0: 73 20 63 6f 6d 70 61 72 65 64 20 61 67 61 69 6e s compared again
10d0: 73 74 20 50 6f 73 74 67 72 65 53 51 4c 20 61 6e st PostgreSQL an
10e0: 64 0a 20 20 4d 79 53 51 4c 2e 0a 7d 0a 0a 64 6f d. MySQL..}..do
10f0: 63 20 7b 41 72 63 68 69 74 65 63 74 75 72 65 7d c {Architecture}
1100: 20 7b 61 72 63 68 2e 68 74 6d 6c 7d 20 7b 0a 20 {arch.html} {.
1110: 20 41 6e 20 61 72 63 68 69 74 65 63 74 75 72 61 An architectura
1120: 6c 20 6f 76 65 72 76 69 65 77 20 6f 66 20 74 68 l overview of th
1130: 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 e SQLite library
1140: 2c 20 75 73 65 66 75 6c 20 66 6f 72 20 74 68 6f , useful for tho
1150: 73 65 20 77 68 6f 20 77 61 6e 74 0a 20 20 74 6f se who want. to
1160: 20 68 61 63 6b 20 74 68 65 20 63 6f 64 65 2e 0a hack the code..
1170: 7d 0a 0a 64 6f 63 20 7b 56 44 42 45 20 54 75 74 }..doc {VDBE Tut
1180: 6f 72 69 61 6c 7d 20 7b 76 64 62 65 2e 68 74 6d orial} {vdbe.htm
1190: 6c 7d 20 7b 0a 20 20 54 68 65 20 56 44 42 45 20 l} {. The VDBE
11a0: 69 73 20 74 68 65 20 73 75 62 73 79 73 74 65 6d is the subsystem
11b0: 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65 20 74 within SQLite t
11c0: 68 61 74 20 64 6f 65 73 20 74 68 65 20 61 63 74 hat does the act
11d0: 75 61 6c 20 77 6f 72 6b 20 6f 66 0a 20 20 65 78 ual work of. ex
11e0: 65 63 75 74 69 6e 67 20 53 51 4c 20 73 74 61 74 ecuting SQL stat
11f0: 65 6d 65 6e 74 73 2e 20 20 54 68 69 73 20 70 61 ements. This pa
1200: 67 65 20 64 65 73 63 72 69 62 65 73 20 74 68 65 ge describes the
1210: 20 70 72 69 6e 63 69 70 6c 65 73 20 6f 66 20 6f principles of o
1220: 70 65 72 61 74 69 6f 6e 0a 20 20 66 6f 72 20 74 peration. for t
1230: 68 65 20 56 44 42 45 20 69 6e 20 53 51 4c 69 74 he VDBE in SQLit
1240: 65 20 76 65 72 73 69 6f 6e 20 32 2e 37 2e 20 20 e version 2.7.
1250: 54 68 69 73 20 69 73 20 65 73 73 65 6e 74 69 61 This is essentia
1260: 6c 20 72 65 61 64 69 6e 67 20 66 6f 72 20 61 6e l reading for an
1270: 79 6f 6e 65 0a 20 20 77 68 6f 20 77 61 6e 74 20 yone. who want
1280: 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 20 53 51 to modify the SQ
1290: 4c 69 74 65 20 73 6f 75 72 63 65 73 2e 0a 7d 0a Lite sources..}.
12a0: 0a 64 6f 63 20 7b 56 44 42 45 20 4f 70 63 6f 64 .doc {VDBE Opcod
12b0: 65 73 7d 20 7b 6f 70 63 6f 64 65 2e 68 74 6d 6c es} {opcode.html
12c0: 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 75 6d } {. This docum
12d0: 65 6e 74 20 69 73 20 61 6e 20 61 75 74 6f 6d 61 ent is an automa
12e0: 74 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 tically generate
12f0: 64 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 d description of
1300: 20 74 68 65 20 76 61 72 69 6f 75 73 0a 20 20 6f the various. o
1310: 70 63 6f 64 65 73 20 74 68 61 74 20 74 68 65 20 pcodes that the
1320: 56 44 42 45 20 75 6e 64 65 72 73 74 61 6e 64 73 VDBE understands
1330: 2e 20 20 50 72 6f 67 72 61 6d 6d 65 72 73 20 63 . Programmers c
1340: 61 6e 20 75 73 65 20 74 68 69 73 20 64 6f 63 75 an use this docu
1350: 6d 65 6e 74 20 61 73 0a 20 20 61 20 72 65 66 65 ment as. a refe
1360: 72 65 6e 63 65 20 74 6f 20 62 65 74 74 65 72 20 rence to better
1370: 75 6e 64 65 72 73 74 61 6e 64 20 74 68 65 20 6f understand the o
1380: 75 74 70 75 74 20 6f 66 20 45 58 50 4c 41 49 4e utput of EXPLAIN
1390: 20 6c 69 73 74 69 6e 67 73 20 66 72 6f 6d 0a 20 listings from.
13a0: 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 64 6f 63 20 SQLite..}..doc
13b0: 7b 43 6f 6d 70 69 6c 61 74 69 6f 6e 20 4f 70 74 {Compilation Opt
13c0: 69 6f 6e 73 7d 20 7b 63 6f 6d 70 69 6c 65 2e 68 ions} {compile.h
13d0: 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f tml} {. This do
13e0: 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 cument describes
13f0: 20 74 68 65 20 63 6f 6d 70 69 6c 65 20 74 69 6d the compile tim
1400: 65 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 6d e options that m
1410: 61 79 20 62 65 20 73 65 74 20 74 6f 20 0a 20 20 ay be set to .
1420: 6d 6f 64 69 66 79 20 74 68 65 20 64 65 66 61 75 modify the defau
1430: 6c 74 20 62 65 68 61 76 69 6f 72 20 6f 66 20 74 lt behavior of t
1440: 68 65 20 6c 69 62 72 61 72 79 20 6f 72 20 6f 6d he library or om
1450: 69 74 20 6f 70 74 69 6f 6e 61 6c 20 66 65 61 74 it optional feat
1460: 75 72 65 73 0a 20 20 69 6e 20 6f 72 64 65 72 20 ures. in order
1470: 74 6f 20 72 65 64 75 63 65 20 62 69 6e 61 72 79 to reduce binary
1480: 20 73 69 7a 65 2e 0a 7d 0a 0a 64 6f 63 20 7b 42 size..}..doc {B
1490: 61 63 6b 77 61 72 64 73 20 43 6f 6d 70 61 74 69 ackwards Compati
14a0: 62 69 6c 69 74 79 7d 20 7b 66 6f 72 6d 61 74 63 bility} {formatc
14b0: 68 6e 67 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 hng.html} {. Th
14c0: 69 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 74 61 is document deta
14d0: 69 6c 73 20 61 6c 6c 20 6f 66 20 74 68 65 20 69 ils all of the i
14e0: 6e 63 6f 6d 70 61 74 69 62 6c 65 20 63 68 61 6e ncompatible chan
14f0: 67 65 73 20 74 6f 20 74 68 65 20 53 51 4c 69 74 ges to the SQLit
1500: 65 0a 20 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 e. file format
1510: 74 68 61 74 20 68 61 76 65 20 6f 63 63 75 72 72 that have occurr
1520: 65 64 20 73 69 6e 63 65 20 76 65 72 73 69 6f 6e ed since version
1530: 20 31 2e 30 2e 30 2e 0a 7d 0a 3c 2f 74 63 6c 3e 1.0.0..}.</tcl>
1540: 0a 3c 2f 74 61 62 6c 65 3e 0a .</table>.