Documentation Source Text

Hex Artifact Content
Login

Artifact 5939ce8de827d554f426d34eb48ee2b4e2cd454b:


0000: 3c 74 69 74 6c 65 3e 41 62 6f 75 74 20 53 51 4c  <title>About SQL
0010: 69 74 65 3c 2f 74 69 74 6c 65 3e 0a 0a 3c 68 31  ite</title>..<h1
0020: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 41 62   align=center>Ab
0030: 6f 75 74 20 53 51 4c 69 74 65 3c 2f 68 31 3e 0a  out SQLite</h1>.
0040: 0a 3c 74 61 62 6c 65 20 61 6c 69 67 6e 3d 22 72  .<table align="r
0050: 69 67 68 74 22 20 62 6f 72 64 65 72 3d 22 31 22  ight" border="1"
0060: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 30   cellpadding="10
0070: 22 20 68 73 70 61 63 65 3d 22 32 30 22 20 63 65  " hspace="20" ce
0080: 6c 6c 73 70 61 63 69 6e 67 3d 22 30 22 3e 0a 3c  llspacing="0">.<
0090: 74 72 3e 3c 74 64 3e 0a 3c 62 3e 53 65 65 20 41  tr><td>.<b>See A
00a0: 6c 73 6f 2e 2e 2e 3c 2f 62 3e 0a 3c 70 3e 3c 75  lso...</b>.<p><u
00b0: 6c 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66 3d  l>.<li> <a href=
00c0: 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 48 6f 6d  "index.html">Hom
00d0: 65 3c 2f 61 3e 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e  e</a> </li>.<li>
00e0: 20 3c 61 20 68 72 65 66 3d 22 66 65 61 74 75 72   <a href="featur
00f0: 65 73 2e 68 74 6d 6c 22 3e 46 65 61 74 75 72 65  es.html">Feature
0100: 73 3c 2f 61 3e 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e  s</a> </li>.<li>
0110: 20 3c 61 20 68 72 65 66 3d 22 77 68 65 6e 74 6f   <a href="whento
0120: 75 73 65 2e 68 74 6d 6c 22 3e 57 68 65 6e 20 74  use.html">When t
0130: 6f 20 75 73 65 20 53 51 4c 69 74 65 3c 2f 61 3e  o use SQLite</a>
0140: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 3c 61 20 68   </li>.<li> <a h
0150: 72 65 66 3d 22 66 61 71 2e 68 74 6d 6c 22 3e 46  ref="faq.html">F
0160: 72 65 71 75 65 6e 74 6c 79 20 41 73 6b 65 64 20  requently Asked 
0170: 51 75 65 73 74 69 6f 6e 73 3c 2f 61 3e 20 3c 2f  Questions</a> </
0180: 6c 69 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66  li>.<li> <a href
0190: 3d 22 66 61 6d 6f 75 73 2e 68 74 6d 6c 22 3e 57  ="famous.html">W
01a0: 65 6c 6c 2d 6b 6e 6f 77 6e 20 55 73 65 72 73 3c  ell-known Users<
01b0: 2f 61 3e 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 3c  /a> </li>.<li> <
01c0: 61 20 68 72 65 66 3d 22 63 68 72 6f 6e 6f 6c 6f  a href="chronolo
01d0: 67 79 2e 68 74 6d 6c 22 3e 50 72 69 6f 72 20 52  gy.html">Prior R
01e0: 65 6c 65 61 73 65 73 3c 2f 61 3e 0a 3c 6c 69 3e  eleases</a>.<li>
01f0: 20 3c 61 20 68 72 65 66 3d 22 71 75 69 63 6b 73   <a href="quicks
0200: 74 61 72 74 2e 68 74 6d 6c 22 3e 47 65 74 74 69  tart.html">Getti
0210: 6e 67 20 53 74 61 72 74 65 64 3c 2f 61 3e 20 3c  ng Started</a> <
0220: 2f 6c 69 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65  /li>.<li> <a hre
0230: 66 3d 22 6c 61 6e 67 2e 68 74 6d 6c 22 3e 53 51  f="lang.html">SQ
0240: 4c 20 53 79 6e 74 61 78 3c 2f 61 3e 0a 3c 75 6c  L Syntax</a>.<ul
0250: 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66 3d 22  >.<li> <a href="
0260: 70 72 61 67 6d 61 2e 68 74 6d 6c 23 74 6f 63 22  pragma.html#toc"
0270: 3e 50 72 61 67 6d 61 73 3c 2f 61 3e 0a 3c 6c 69  >Pragmas</a>.<li
0280: 3e 20 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f  > <a href="lang_
0290: 63 6f 72 65 66 75 6e 63 2e 68 74 6d 6c 22 3e 53  corefunc.html">S
02a0: 51 4c 20 66 75 6e 63 74 69 6f 6e 73 3c 2f 61 3e  QL functions</a>
02b0: 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66 3d 22 6c  .<li> <a href="l
02c0: 61 6e 67 5f 64 61 74 65 66 75 6e 63 2e 68 74 6d  ang_datefunc.htm
02d0: 6c 22 3e 44 61 74 65 20 26 61 6d 70 3b 20 74 69  l">Date &amp; ti
02e0: 6d 65 20 66 75 6e 63 74 69 6f 6e 73 3c 2f 61 3e  me functions</a>
02f0: 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66 3d 22 6c  .<li> <a href="l
0300: 61 6e 67 5f 61 67 67 66 75 6e 63 2e 68 74 6d 6c  ang_aggfunc.html
0310: 22 3e 41 67 67 72 65 67 61 74 65 20 66 75 6e 63  ">Aggregate func
0320: 74 69 6f 6e 73 3c 2f 61 3e 0a 3c 2f 75 6c 3e 0a  tions</a>.</ul>.
0330: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72  </li>.<li> <a hr
0340: 65 66 3d 22 63 33 72 65 66 2f 69 6e 74 72 6f 2e  ef="c3ref/intro.
0350: 68 74 6d 6c 22 3e 43 2f 43 2b 2b 20 49 6e 74 65  html">C/C++ Inte
0360: 72 66 61 63 65 20 53 70 65 63 3c 2f 61 3e 0a 3c  rface Spec</a>.<
0370: 75 6c 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66  ul>.<li> <a href
0380: 3d 22 63 69 6e 74 72 6f 2e 68 74 6d 6c 22 3e 49  ="cintro.html">I
0390: 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 61 3e 0a  ntroduction</a>.
03a0: 3c 6c 69 3e 20 3c 61 20 68 72 65 66 3d 22 63 33  <li> <a href="c3
03b0: 72 65 66 2f 66 75 6e 63 6c 69 73 74 2e 68 74 6d  ref/funclist.htm
03c0: 6c 22 3e 4c 69 73 74 20 6f 66 20 43 2d 6c 61 6e  l">List of C-lan
03d0: 67 75 61 67 65 20 41 50 49 73 3c 2f 61 3e 0a 3c  guage APIs</a>.<
03e0: 2f 75 6c 3e 0a 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20  /ul>.</li>.<li> 
03f0: 3c 61 20 68 72 65 66 3d 22 74 63 6c 73 71 6c 69  <a href="tclsqli
0400: 74 65 2e 68 74 6d 6c 22 3e 54 68 65 20 54 43 4c  te.html">The TCL
0410: 20 49 6e 74 65 72 66 61 63 65 20 53 70 65 63 3c   Interface Spec<
0420: 2f 61 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66  /a>.<li> <a href
0430: 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c  ="http://www.sql
0440: 69 74 65 2e 6f 72 67 2f 73 72 63 2f 74 69 6d 65  ite.org/src/time
0450: 6c 69 6e 65 22 3e 43 6f 6d 6d 69 74 20 48 69 73  line">Commit His
0460: 74 6f 72 79 3c 2f 61 3e 20 3c 2f 6c 69 3e 0a 3c  tory</a> </li>.<
0470: 6c 69 3e 20 3c 61 20 68 72 65 66 3d 22 68 74 74  li> <a href="htt
0480: 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f  p://www.sqlite.o
0490: 72 67 2f 73 72 63 2f 77 69 6b 69 3f 6e 61 6d 65  rg/src/wiki?name
04a0: 3d 42 75 67 2b 52 65 70 6f 72 74 73 22 3e 52 65  =Bug+Reports">Re
04b0: 70 6f 72 74 20 61 20 42 75 67 3c 2f 61 3e 20 3c  port a Bug</a> <
04c0: 2f 6c 69 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65  /li>.<li> <a hre
04d0: 66 3d 22 6e 65 77 73 2e 68 74 6d 6c 22 3e 4e 65  f="news.html">Ne
04e0: 77 73 3c 2f 61 3e 20 3c 2f 6c 69 3e 0a 3c 6c 69  ws</a> </li>.<li
04f0: 3e 20 3c 61 20 68 72 65 66 3d 22 73 69 74 65 6d  > <a href="sitem
0500: 61 70 2e 68 74 6d 6c 22 3e 53 69 74 65 6d 61 70  ap.html">Sitemap
0510: 3c 2f 61 3e 20 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e  </a> </li>.</ul>
0520: 3c 2f 70 3e 0a 3c 2f 74 61 62 6c 65 3e 0a 0a 3c  </p>.</table>..<
0530: 70 3e 53 51 4c 69 74 65 20 69 73 20 61 6e 20 69  p>SQLite is an i
0540: 6e 2d 70 72 6f 63 65 73 73 20 6c 69 62 72 61 72  n-process librar
0550: 79 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74  y that implement
0560: 73 20 61 0a 3c 61 20 68 72 65 66 3d 22 73 65 6c  s a.<a href="sel
0570: 66 63 6f 6e 74 61 69 6e 65 64 2e 68 74 6d 6c 22  fcontained.html"
0580: 3e 73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 3c  >self-contained<
0590: 2f 61 3e 2c 20 0a 3c 61 20 68 72 65 66 3d 22 73  /a>, .<a href="s
05a0: 65 72 76 65 72 6c 65 73 73 2e 68 74 6d 6c 22 3e  erverless.html">
05b0: 73 65 72 76 65 72 6c 65 73 73 3c 2f 61 3e 2c 0a  serverless</a>,.
05c0: 3c 61 20 68 72 65 66 3d 22 7a 65 72 6f 63 6f 6e  <a href="zerocon
05d0: 66 2e 68 74 6d 6c 22 3e 7a 65 72 6f 2d 63 6f 6e  f.html">zero-con
05e0: 66 69 67 75 72 61 74 69 6f 6e 3c 2f 61 3e 2c 0a  figuration</a>,.
05f0: 3c 61 20 68 72 65 66 3d 22 74 72 61 6e 73 61 63  <a href="transac
0600: 74 69 6f 6e 61 6c 2e 68 74 6d 6c 22 3e 74 72 61  tional.html">tra
0610: 6e 73 61 63 74 69 6f 6e 61 6c 3c 2f 61 3e 0a 53  nsactional</a>.S
0620: 51 4c 20 64 61 74 61 62 61 73 65 20 65 6e 67 69  QL database engi
0630: 6e 65 2e 0a 54 68 65 20 63 6f 64 65 20 66 6f 72  ne..The code for
0640: 20 53 51 4c 69 74 65 20 69 73 20 69 6e 20 74 68   SQLite is in th
0650: 65 0a 3c 61 20 68 72 65 66 3d 22 63 6f 70 79 72  e.<a href="copyr
0660: 69 67 68 74 2e 68 74 6d 6c 22 3e 70 75 62 6c 69  ight.html">publi
0670: 63 20 64 6f 6d 61 69 6e 3c 2f 61 3e 20 61 6e 64  c domain</a> and
0680: 20 69 73 20 74 68 75 73 20 66 72 65 65 20 66 6f   is thus free fo
0690: 72 0a 75 73 65 20 66 6f 72 20 61 6e 79 20 70 75  r.use for any pu
06a0: 72 70 6f 73 65 2c 20 63 6f 6d 6d 65 72 63 69 61  rpose, commercia
06b0: 6c 20 6f 72 20 70 72 69 76 61 74 65 2e 0a 53 51  l or private..SQ
06c0: 4c 69 74 65 20 69 73 20 74 68 65 20 5b 6d 6f 73  Lite is the [mos
06d0: 74 20 77 69 64 65 6c 79 20 64 65 70 6c 6f 79 65  t widely deploye
06e0: 64 5d 20 64 61 74 61 62 61 73 65 20 69 6e 20 74  d] database in t
06f0: 68 65 20 77 6f 72 6c 64 0a 77 69 74 68 20 6d 6f  he world.with mo
0700: 72 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20  re applications 
0710: 74 68 61 6e 20 77 65 20 63 61 6e 0a 63 6f 75 6e  than we can.coun
0720: 74 2c 20 69 6e 63 6c 75 64 69 6e 67 20 73 65 76  t, including sev
0730: 65 72 61 6c 20 3c 61 20 68 72 65 66 3d 22 66 61  eral <a href="fa
0740: 6d 6f 75 73 2e 68 74 6d 6c 22 3e 68 69 67 68 2d  mous.html">high-
0750: 70 72 6f 66 69 6c 65 20 70 72 6f 6a 65 63 74 73  profile projects
0760: 2e 3c 2f 61 3e 3c 2f 70 3e 0a 0a 3c 70 3e 53 51  .</a></p>..<p>SQ
0770: 4c 69 74 65 20 69 73 20 61 6e 20 65 6d 62 65 64  Lite is an embed
0780: 64 65 64 20 53 51 4c 20 64 61 74 61 62 61 73 65  ded SQL database
0790: 20 65 6e 67 69 6e 65 2e 0a 55 6e 6c 69 6b 65 20   engine..Unlike 
07a0: 6d 6f 73 74 20 6f 74 68 65 72 20 53 51 4c 20 64  most other SQL d
07b0: 61 74 61 62 61 73 65 73 2c 20 53 51 4c 69 74 65  atabases, SQLite
07c0: 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61   does not have a
07d0: 20 73 65 70 61 72 61 74 65 0a 73 65 72 76 65 72   separate.server
07e0: 20 70 72 6f 63 65 73 73 2e 20 20 53 51 4c 69 74   process.  SQLit
07f0: 65 20 72 65 61 64 73 20 61 6e 64 20 77 72 69 74  e reads and writ
0800: 65 73 20 64 69 72 65 63 74 6c 79 20 74 6f 20 6f  es directly to o
0810: 72 64 69 6e 61 72 79 20 64 69 73 6b 0a 66 69 6c  rdinary disk.fil
0820: 65 73 2e 20 20 41 20 63 6f 6d 70 6c 65 74 65 20  es.  A complete 
0830: 53 51 4c 20 64 61 74 61 62 61 73 65 20 77 69 74  SQL database wit
0840: 68 20 6d 75 6c 74 69 70 6c 65 20 74 61 62 6c 65  h multiple table
0850: 73 2c 20 69 6e 64 69 63 65 73 2c 0a 74 72 69 67  s, indices,.trig
0860: 67 65 72 73 2c 20 61 6e 64 20 76 69 65 77 73 2c  gers, and views,
0870: 20 69 73 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e   is contained in
0880: 20 61 20 73 69 6e 67 6c 65 20 64 69 73 6b 20 66   a single disk f
0890: 69 6c 65 2e 0a 54 68 65 20 64 61 74 61 62 61 73  ile..The databas
08a0: 65 20 5b 66 69 6c 65 20 66 6f 72 6d 61 74 5d 20  e [file format] 
08b0: 69 73 20 63 72 6f 73 73 2d 70 6c 61 74 66 6f 72  is cross-platfor
08c0: 6d 20 2d 20 79 6f 75 20 63 61 6e 20 66 72 65 65  m - you can free
08d0: 6c 79 20 63 6f 70 79 20 61 20 64 61 74 61 62 61  ly copy a databa
08e0: 73 65 0a 62 65 74 77 65 65 6e 20 33 32 2d 62 69  se.between 32-bi
08f0: 74 20 61 6e 64 20 36 34 2d 62 69 74 20 73 79 73  t and 64-bit sys
0900: 74 65 6d 73 20 6f 72 20 62 65 74 77 65 65 6e 20  tems or between 
0910: 0a 5b 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69  .[http://en.wiki
0920: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 45  pedia.org/wiki/E
0930: 6e 64 69 61 6e 6e 65 73 73 20 7c 20 62 69 67 2d  ndianness | big-
0940: 65 6e 64 69 61 6e 5d 20 61 6e 64 0a 5b 68 74 74  endian] and.[htt
0950: 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61  p://en.wikipedia
0960: 2e 6f 72 67 2f 77 69 6b 69 2f 45 6e 64 69 61 6e  .org/wiki/Endian
0970: 6e 65 73 73 20 7c 20 6c 69 74 74 6c 65 2d 65 6e  ness | little-en
0980: 64 69 61 6e 5d 0a 61 72 63 68 69 74 65 63 74 75  dian].architectu
0990: 72 65 73 2e 20 20 54 68 65 73 65 20 66 65 61 74  res.  These feat
09a0: 75 72 65 73 20 6d 61 6b 65 20 53 51 4c 69 74 65  ures make SQLite
09b0: 20 61 20 70 6f 70 75 6c 61 72 20 63 68 6f 69 63   a popular choic
09c0: 65 20 61 73 0a 61 6e 20 5b 41 70 70 6c 69 63 61  e as.an [Applica
09d0: 74 69 6f 6e 20 46 69 6c 65 20 46 6f 72 6d 61 74  tion File Format
09e0: 5d 2e 0a 54 68 69 6e 6b 20 6f 66 20 53 51 4c 69  ]..Think of SQLi
09f0: 74 65 20 6e 6f 74 20 61 73 20 61 20 72 65 70 6c  te not as a repl
0a00: 61 63 65 6d 65 6e 74 20 66 6f 72 20 0a 5b 68 74  acement for .[ht
0a10: 74 70 3a 2f 2f 77 77 77 2e 6f 72 61 63 6c 65 2e  tp://www.oracle.
0a20: 63 6f 6d 2f 64 61 74 61 62 61 73 65 2f 69 6e 64  com/database/ind
0a30: 65 78 2e 68 74 6d 6c 7c 4f 72 61 63 6c 65 5d 20  ex.html|Oracle] 
0a40: 62 75 74 0a 61 73 20 61 20 72 65 70 6c 61 63 65  but.as a replace
0a50: 6d 65 6e 74 20 66 6f 72 20 5b 68 74 74 70 3a 2f  ment for [http:/
0a60: 2f 6d 61 6e 2e 68 65 2e 6e 65 74 2f 6d 61 6e 33  /man.he.net/man3
0a70: 2f 66 6f 70 65 6e 7c 66 6f 70 65 6e 28 29 5d 3c  /fopen|fopen()]<
0a80: 2f 70 3e 0a 0a 3c 70 3e 53 51 4c 69 74 65 20 69  /p>..<p>SQLite i
0a90: 73 20 61 20 63 6f 6d 70 61 63 74 20 6c 69 62 72  s a compact libr
0aa0: 61 72 79 2e 0a 57 69 74 68 20 61 6c 6c 20 66 65  ary..With all fe
0ab0: 61 74 75 72 65 73 20 65 6e 61 62 6c 65 64 2c 20  atures enabled, 
0ac0: 74 68 65 20 5b 6c 69 62 72 61 72 79 20 73 69 7a  the [library siz
0ad0: 65 5d 20 63 61 6e 20 62 65 20 6c 65 73 73 20 74  e] can be less t
0ae0: 68 61 6e 20 35 30 30 4b 69 42 2c 0a 64 65 70 65  han 500KiB,.depe
0af0: 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 74 61 72  nding on the tar
0b00: 67 65 74 20 70 6c 61 74 66 6f 72 6d 20 61 6e 64  get platform and
0b10: 20 63 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6d 69   compiler optimi
0b20: 7a 61 74 69 6f 6e 20 73 65 74 74 69 6e 67 73 2e  zation settings.
0b30: 0a 28 36 34 2d 62 69 74 20 63 6f 64 65 20 69 73  .(64-bit code is
0b40: 20 6c 61 72 67 65 72 2e 20 20 41 6e 64 20 73 6f   larger.  And so
0b50: 6d 65 20 63 6f 6d 70 69 6c 65 72 20 6f 70 74 69  me compiler opti
0b60: 6d 69 7a 61 74 69 6f 6e 73 0a 73 75 63 68 20 61  mizations.such a
0b70: 73 20 61 67 67 72 65 73 73 69 76 65 20 66 75 6e  s aggressive fun
0b80: 63 74 69 6f 6e 20 69 6e 6c 69 6e 69 6e 67 20 61  ction inlining a
0b90: 6e 64 20 6c 6f 6f 70 20 75 6e 72 6f 6c 6c 69 6e  nd loop unrollin
0ba0: 67 20 63 61 6e 20 63 61 75 73 65 20 74 68 65 0a  g can cause the.
0bb0: 6f 62 6a 65 63 74 20 63 6f 64 65 20 74 6f 20 62  object code to b
0bc0: 65 20 6d 75 63 68 20 6c 61 72 67 65 72 2e 29 20  e much larger.) 
0bd0: 20 49 66 20 6f 70 74 69 6f 6e 61 6c 20 66 65 61   If optional fea
0be0: 74 75 72 65 73 20 61 72 65 20 6f 6d 69 74 74 65  tures are omitte
0bf0: 64 2c 20 74 68 65 0a 73 69 7a 65 20 6f 66 20 74  d, the.size of t
0c00: 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72  he SQLite librar
0c10: 79 20 63 61 6e 20 62 65 20 72 65 64 75 63 65 64  y can be reduced
0c20: 20 62 65 6c 6f 77 20 33 30 30 4b 69 42 2e 20 20   below 300KiB.  
0c30: 53 51 4c 69 74 65 20 63 61 6e 20 61 6c 73 6f 0a  SQLite can also.
0c40: 62 65 20 6d 61 64 65 20 74 6f 20 72 75 6e 20 69  be made to run i
0c50: 6e 20 6d 69 6e 69 6d 61 6c 20 73 74 61 63 6b 20  n minimal stack 
0c60: 73 70 61 63 65 20 28 34 4b 69 42 29 20 61 6e 64  space (4KiB) and
0c70: 0a 76 65 72 79 20 6c 69 74 74 6c 65 20 68 65 61  .very little hea
0c80: 70 20 28 31 30 30 4b 69 42 29 2c 20 6d 61 6b 69  p (100KiB), maki
0c90: 6e 67 20 53 51 4c 69 74 65 20 61 20 70 6f 70 75  ng SQLite a popu
0ca0: 6c 61 72 20 64 61 74 61 62 61 73 65 20 65 6e 67  lar database eng
0cb0: 69 6e 65 20 0a 63 68 6f 69 63 65 20 6f 6e 20 6d  ine .choice on m
0cc0: 65 6d 6f 72 79 20 63 6f 6e 73 74 72 61 69 6e 65  emory constraine
0cd0: 64 20 67 61 64 67 65 74 73 20 73 75 63 68 20 61  d gadgets such a
0ce0: 73 20 63 65 6c 6c 70 68 6f 6e 65 73 2c 20 50 44  s cellphones, PD
0cf0: 41 73 2c 20 61 6e 64 20 4d 50 33 20 70 6c 61 79  As, and MP3 play
0d00: 65 72 73 2e 0a 54 68 65 72 65 20 69 73 20 61 20  ers..There is a 
0d10: 74 72 61 64 65 6f 66 66 20 62 65 74 77 65 65 6e  tradeoff between
0d20: 20 6d 65 6d 6f 72 79 20 75 73 61 67 65 20 61 6e   memory usage an
0d30: 64 20 73 70 65 65 64 2e 20 20 0a 53 51 4c 69 74  d speed.  .SQLit
0d40: 65 20 67 65 6e 65 72 61 6c 6c 79 20 72 75 6e 73  e generally runs
0d50: 20 66 61 73 74 65 72 20 74 68 65 20 6d 6f 72 65   faster the more
0d60: 20 6d 65 6d 6f 72 79 0a 79 6f 75 20 67 69 76 65   memory.you give
0d70: 20 69 74 2e 20 20 4e 65 76 65 72 74 68 65 6c 65   it.  Neverthele
0d80: 73 73 2c 20 70 65 72 66 6f 72 6d 61 6e 63 65 20  ss, performance 
0d90: 69 73 20 75 73 75 61 6c 6c 79 20 71 75 69 74 65  is usually quite
0da0: 20 67 6f 6f 64 20 65 76 65 6e 0a 69 6e 20 6c 6f   good even.in lo
0db0: 77 2d 6d 65 6d 6f 72 79 20 65 6e 76 69 72 6f 6e  w-memory environ
0dc0: 6d 65 6e 74 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53  ments.</p>..<p>S
0dd0: 51 4c 69 74 65 20 69 73 20 0a 3c 61 20 68 72 65  QLite is .<a hre
0de0: 66 3d 22 74 65 73 74 69 6e 67 2e 68 74 6d 6c 22  f="testing.html"
0df0: 3e 76 65 72 79 20 63 61 72 65 66 75 6c 6c 79 20  >very carefully 
0e00: 74 65 73 74 65 64 3c 2f 61 3e 20 70 72 69 6f 72  tested</a> prior
0e10: 20 74 6f 20 65 76 65 72 79 0a 72 65 6c 65 61 73   to every.releas
0e20: 65 20 61 6e 64 20 68 61 73 20 61 20 72 65 70 75  e and has a repu
0e30: 74 61 74 69 6f 6e 20 66 6f 72 20 62 65 69 6e 67  tation for being
0e40: 20 76 65 72 79 20 72 65 6c 69 61 62 6c 65 2e 0a   very reliable..
0e50: 4d 6f 73 74 20 6f 66 20 74 68 65 20 53 51 4c 69  Most of the SQLi
0e60: 74 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 69  te source code i
0e70: 73 20 64 65 76 6f 74 65 64 20 70 75 72 65 6c 79  s devoted purely
0e80: 20 74 6f 20 74 65 73 74 69 6e 67 20 61 6e 64 0a   to testing and.
0e90: 76 65 72 69 66 69 63 61 74 69 6f 6e 2e 20 20 41  verification.  A
0ea0: 6e 20 61 75 74 6f 6d 61 74 65 64 20 74 65 73 74  n automated test
0eb0: 20 73 75 69 74 65 20 72 75 6e 73 20 6d 69 6c 6c   suite runs mill
0ec0: 69 6f 6e 73 20 61 6e 64 20 6d 69 6c 6c 69 6f 6e  ions and million
0ed0: 73 20 6f 66 0a 74 65 73 74 20 63 61 73 65 73 20  s of.test cases 
0ee0: 69 6e 76 6f 6c 76 69 6e 67 20 68 75 6e 64 72 65  involving hundre
0ef0: 64 73 20 6f 66 20 6d 69 6c 6c 69 6f 6e 73 20 6f  ds of millions o
0f00: 66 20 69 6e 64 69 76 69 64 75 61 6c 20 53 51 4c  f individual SQL
0f10: 20 73 74 61 74 65 6d 65 6e 74 73 0a 61 6e 64 20   statements.and 
0f20: 61 63 68 69 65 76 65 73 20 5b 74 65 73 74 20 63  achieves [test c
0f30: 6f 76 65 72 61 67 65 20 7c 20 31 30 30 25 20 62  overage | 100% b
0f40: 72 61 6e 63 68 20 74 65 73 74 20 63 6f 76 65 72  ranch test cover
0f50: 61 67 65 5d 2e 20 20 0a 53 51 4c 69 74 65 20 72  age].  .SQLite r
0f60: 65 73 70 6f 6e 64 73 20 67 72 61 63 65 66 75 6c  esponds graceful
0f70: 6c 79 20 74 6f 20 6d 65 6d 6f 72 79 0a 61 6c 6c  ly to memory.all
0f80: 6f 63 61 74 69 6f 6e 20 66 61 69 6c 75 72 65 73  ocation failures
0f90: 20 61 6e 64 20 64 69 73 6b 20 49 2f 4f 20 65 72   and disk I/O er
0fa0: 72 6f 72 73 2e 20 20 54 72 61 6e 73 61 63 74 69  rors.  Transacti
0fb0: 6f 6e 73 20 61 72 65 0a 5b 68 74 74 70 3a 2f 2f  ons are.[http://
0fc0: 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 67  en.wikipedia.org
0fd0: 2f 77 69 6b 69 2f 41 43 49 44 7c 41 43 49 44 5d  /wiki/ACID|ACID]
0fe0: 0a 65 76 65 6e 20 69 66 20 69 6e 74 65 72 72 75  .even if interru
0ff0: 70 74 65 64 20 62 79 20 73 79 73 74 65 6d 20 63  pted by system c
1000: 72 61 73 68 65 73 20 6f 72 20 70 6f 77 65 72 20  rashes or power 
1010: 66 61 69 6c 75 72 65 73 2e 20 20 0a 41 6c 6c 20  failures.  .All 
1020: 6f 66 20 74 68 69 73 20 69 73 20 76 65 72 69 66  of this is verif
1030: 69 65 64 20 62 79 0a 74 68 65 20 61 75 74 6f 6d  ied by.the autom
1040: 61 74 65 64 20 74 65 73 74 73 20 75 73 69 6e 67  ated tests using
1050: 20 73 70 65 63 69 61 6c 20 74 65 73 74 20 68 61   special test ha
1060: 72 6e 65 73 73 65 73 20 77 68 69 63 68 20 73 69  rnesses which si
1070: 6d 75 6c 61 74 65 20 0a 73 79 73 74 65 6d 20 66  mulate .system f
1080: 61 69 6c 75 72 65 73 2e 0a 4f 66 20 63 6f 75 72  ailures..Of cour
1090: 73 65 2c 20 65 76 65 6e 20 77 69 74 68 20 61 6c  se, even with al
10a0: 6c 20 74 68 69 73 20 74 65 73 74 69 6e 67 2c 20  l this testing, 
10b0: 74 68 65 72 65 20 61 72 65 20 73 74 69 6c 6c 20  there are still 
10c0: 62 75 67 73 2e 0a 42 75 74 20 75 6e 6c 69 6b 65  bugs..But unlike
10d0: 20 73 6f 6d 65 20 73 69 6d 69 6c 61 72 20 70 72   some similar pr
10e0: 6f 6a 65 63 74 73 20 28 65 73 70 65 63 69 61 6c  ojects (especial
10f0: 6c 79 20 63 6f 6d 6d 65 72 63 69 61 6c 20 63 6f  ly commercial co
1100: 6d 70 65 74 69 74 6f 72 73 29 0a 53 51 4c 69 74  mpetitors).SQLit
1110: 65 20 69 73 20 6f 70 65 6e 20 61 6e 64 20 68 6f  e is open and ho
1120: 6e 65 73 74 20 61 62 6f 75 74 20 61 6c 6c 20 62  nest about all b
1130: 75 67 73 20 61 6e 64 20 70 72 6f 76 69 64 65 73  ugs and provides
1140: 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f  .<a href="http:/
1150: 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f 72 67 2f  /www.sqlite.org/
1160: 73 72 63 2f 72 70 74 76 69 65 77 3f 72 6e 3d 32  src/rptview?rn=2
1170: 22 3e 62 75 67 73 20 6c 69 73 74 73 3c 2f 61 3e  ">bugs lists</a>
1180: 20 61 6e 64 0a 6d 69 6e 75 74 65 2d 62 79 2d 6d   and.minute-by-m
1190: 69 6e 75 74 65 20 3c 61 20 68 72 65 66 3d 22 68  inute <a href="h
11a0: 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65  ttp://www.sqlite
11b0: 2e 6f 72 67 2f 73 72 63 2f 74 69 6d 65 6c 69 6e  .org/src/timelin
11c0: 65 22 3e 0a 63 68 72 6f 6e 6f 6c 6f 67 69 65 73  e">.chronologies
11d0: 3c 2f 61 3e 20 6f 66 20 62 75 67 20 72 65 70 6f  </a> of bug repo
11e0: 72 74 73 20 61 6e 64 20 63 6f 64 65 20 63 68 61  rts and code cha
11f0: 6e 67 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  nges.</p>..<p>Th
1200: 65 20 53 51 4c 69 74 65 20 63 6f 64 65 20 62 61  e SQLite code ba
1210: 73 65 20 69 73 20 73 75 70 70 6f 72 74 65 64 20  se is supported 
1220: 62 79 20 61 6e 0a 3c 61 20 68 72 65 66 3d 22 63  by an.<a href="c
1230: 72 65 77 2e 68 74 6d 6c 22 3e 69 6e 74 65 72 6e  rew.html">intern
1240: 61 74 69 6f 6e 61 6c 20 74 65 61 6d 3c 2f 61 3e  ational team</a>
1250: 20 6f 66 20 64 65 76 65 6c 6f 70 65 72 73 20 77   of developers w
1260: 68 6f 20 77 6f 72 6b 20 6f 6e 0a 53 51 4c 69 74  ho work on.SQLit
1270: 65 20 66 75 6c 6c 2d 74 69 6d 65 2e 0a 54 68 65  e full-time..The
1280: 20 64 65 76 65 6c 6f 70 65 72 73 20 63 6f 6e 74   developers cont
1290: 69 6e 75 65 20 74 6f 20 65 78 70 61 6e 64 20 74  inue to expand t
12a0: 68 65 20 63 61 70 61 62 69 6c 69 74 69 65 73 20  he capabilities 
12b0: 6f 66 20 53 51 4c 69 74 65 0a 61 6e 64 20 65 6e  of SQLite.and en
12c0: 68 61 6e 63 65 20 69 74 73 20 72 65 6c 69 61 62  hance its reliab
12d0: 69 6c 69 74 79 20 61 6e 64 20 70 65 72 66 6f 72  ility and perfor
12e0: 6d 61 6e 63 65 20 77 68 69 6c 65 20 6d 61 69 6e  mance while main
12f0: 74 61 69 6e 69 6e 67 0a 62 61 63 6b 77 61 72 64  taining.backward
1300: 73 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20  s compatibility 
1310: 77 69 74 68 20 74 68 65 20 0a 3c 61 20 68 72 65  with the .<a hre
1320: 66 3d 22 63 33 72 65 66 2f 69 6e 74 72 6f 2e 68  f="c3ref/intro.h
1330: 74 6d 6c 22 3e 70 75 62 6c 69 73 68 65 64 20 69  tml">published i
1340: 6e 74 65 72 66 61 63 65 20 73 70 65 63 3c 2f 61  nterface spec</a
1350: 3e 2c 0a 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67  >,.<a href="lang
1360: 2e 68 74 6d 6c 22 3e 53 51 4c 20 73 79 6e 74 61  .html">SQL synta
1370: 78 3c 2f 61 3e 2c 20 61 6e 64 20 64 61 74 61 62  x</a>, and datab
1380: 61 73 65 20 5b 66 69 6c 65 20 66 6f 72 6d 61 74  ase [file format
1390: 5d 2e 0a 54 68 65 20 73 6f 75 72 63 65 20 63 6f  ]..The source co
13a0: 64 65 20 69 73 20 61 62 73 6f 6c 75 74 65 6c 79  de is absolutely
13b0: 20 66 72 65 65 20 74 6f 20 61 6e 79 62 6f 64 79   free to anybody
13c0: 20 77 68 6f 20 77 61 6e 74 73 20 69 74 2c 0a 62   who wants it,.b
13d0: 75 74 20 5b 70 72 6f 66 65 73 73 69 6f 6e 61 6c  ut [professional
13e0: 20 73 75 70 70 6f 72 74 5d 20 69 73 20 61 6c 73   support] is als
13f0: 6f 20 61 76 61 69 6c 61 62 6c 65 2e 3c 2f 70 3e  o available.</p>
1400: 0a 0a 3c 70 3e 54 68 65 20 53 51 4c 69 74 65 20  ..<p>The SQLite 
1410: 70 72 6f 6a 65 63 74 20 77 61 73 20 73 74 61 72  project was star
1420: 74 65 64 20 6f 6e 20 0a 5b 68 74 74 70 73 3a 2f  ted on .[https:/
1430: 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f 72 67 2f  /www.sqlite.org/
1440: 73 72 63 2f 74 69 6d 65 6c 69 6e 65 3f 63 3d 32  src/timeline?c=2
1450: 30 30 30 2d 30 35 2d 32 39 2b 31 34 3a 32 36 3a  000-05-29+14:26:
1460: 30 30 7c 32 30 30 30 2d 30 35 2d 30 39 5d 2e 0a  00|2000-05-09]..
1470: 54 68 65 20 66 75 74 75 72 65 20 69 73 20 61 6c  The future is al
1480: 77 61 79 73 20 68 61 72 64 20 74 6f 20 70 72 65  ways hard to pre
1490: 64 69 63 74 2c 20 62 75 74 20 74 68 65 20 69 6e  dict, but the in
14a0: 74 65 6e 74 20 6f 66 20 74 68 65 20 64 65 76 65  tent of the deve
14b0: 6c 6f 70 65 72 73 0a 69 73 20 74 6f 20 73 75 70  lopers.is to sup
14c0: 70 6f 72 74 20 53 51 4c 69 74 65 20 74 68 72 6f  port SQLite thro
14d0: 75 67 68 20 74 68 65 20 79 65 61 72 20 32 30 35  ugh the year 205
14e0: 30 2e 20 20 44 65 73 69 67 6e 20 64 65 63 69 73  0.  Design decis
14f0: 69 6f 6e 73 20 61 72 65 20 6d 61 64 65 0a 77 69  ions are made.wi
1500: 74 68 20 74 68 61 74 20 6f 62 6a 65 63 74 69 76  th that objectiv
1510: 65 20 69 6e 20 6d 69 6e 64 2e 3c 2f 70 3e 0a 0a  e in mind.</p>..
1520: 3c 70 3e 57 65 20 74 68 65 20 64 65 76 65 6c 6f  <p>We the develo
1530: 70 65 72 73 20 68 6f 70 65 20 74 68 61 74 20 79  pers hope that y
1540: 6f 75 20 66 69 6e 64 20 53 51 4c 69 74 65 20 75  ou find SQLite u
1550: 73 65 66 75 6c 20 61 6e 64 20 77 65 0a 63 68 61  seful and we.cha
1560: 72 67 65 20 79 6f 75 20 74 6f 20 75 73 65 20 69  rge you to use i
1570: 74 20 77 65 6c 6c 3a 20 74 6f 20 6d 61 6b 65 20  t well: to make 
1580: 67 6f 6f 64 20 61 6e 64 20 62 65 61 75 74 69 66  good and beautif
1590: 75 6c 20 70 72 6f 64 75 63 74 73 20 74 68 61 74  ul products that
15a0: 0a 61 72 65 20 66 61 73 74 2c 20 72 65 6c 69 61  .are fast, relia
15b0: 62 6c 65 2c 20 61 6e 64 20 73 69 6d 70 6c 65 20  ble, and simple 
15c0: 74 6f 20 75 73 65 2e 20 20 53 65 65 6b 20 66 6f  to use.  Seek fo
15d0: 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f  rgiveness for yo
15e0: 75 72 73 65 6c 66 0a 61 73 20 79 6f 75 20 66 6f  urself.as you fo
15f0: 72 67 69 76 65 20 6f 74 68 65 72 73 2e 20 20 41  rgive others.  A
1600: 6e 64 20 6a 75 73 74 20 61 73 20 79 6f 75 20 68  nd just as you h
1610: 61 76 65 20 72 65 63 65 69 76 65 64 20 53 51 4c  ave received SQL
1620: 69 74 65 20 66 6f 72 20 66 72 65 65 2c 0a 73 6f  ite for free,.so
1630: 20 61 6c 73 6f 20 66 72 65 65 6c 79 20 67 69 76   also freely giv
1640: 65 2c 20 70 61 79 69 6e 67 20 74 68 65 20 64 65  e, paying the de
1650: 62 74 20 66 6f 72 77 61 72 64 2e 3c 2f 70 3e 0a  bt forward.</p>.