Documentation Source Text

Hex Artifact Content
Login

Artifact 6142cfe0d029159bada2ef6fdb386acb19c37ab2:


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 64 69 76 20 63 6c 61 73 73 3d 22 72 69 67  .<div class="rig
0050: 68 74 73 69 64 65 62 61 72 20 62 6f 72 64 65 72  htsidebar border
0060: 32 70 78 22 3e 0a 3c 68 34 20 61 6c 69 67 6e 3d  2px">.<h4 align=
0070: 22 63 65 6e 74 65 72 22 3e 45 78 65 63 75 74 69  "center">Executi
0080: 76 65 20 53 75 6d 6d 61 72 79 3c 2f 68 34 3e 0a  ve Summary</h4>.
0090: 3c 75 6c 3e 0a 3c 6c 69 3e 20 5b 46 75 6c 6c 2d  <ul>.<li> [Full-
00a0: 66 65 61 74 75 72 65 64 20 53 51 4c 5d 0a 3c 6c  featured SQL].<l
00b0: 69 3e 20 3c 61 20 68 72 65 66 3d 27 6d 6f 73 74  i> <a href='most
00c0: 64 65 70 6c 6f 79 65 64 2e 68 74 6d 6c 27 3e 42  deployed.html'>B
00d0: 69 6c 6c 69 6f 6e 73 20 61 6e 64 20 62 69 6c 6c  illions and bill
00e0: 69 6f 6e 73 20 6f 66 20 64 65 70 6c 6f 79 6d 65  ions of deployme
00f0: 6e 74 73 3c 2f 61 3e 0a 3c 6c 69 3e 20 3c 61 20  nts</a>.<li> <a 
0100: 68 72 65 66 3d 27 6f 6e 65 66 69 6c 65 2e 68 74  href='onefile.ht
0110: 6d 6c 27 3e 53 69 6e 67 6c 65 2d 66 69 6c 65 20  ml'>Single-file 
0120: 64 61 74 61 62 61 73 65 3c 2f 61 3e 0a 3c 6c 69  database</a>.<li
0130: 3e 20 3c 61 20 68 72 65 66 3d 27 63 6f 70 79 72  > <a href='copyr
0140: 69 67 68 74 2e 68 74 6d 6c 27 3e 50 75 62 6c 69  ight.html'>Publi
0150: 63 20 64 6f 6d 61 69 6e 20 73 6f 75 72 63 65 20  c domain source 
0160: 63 6f 64 65 3c 2f 61 3e 0a 3c 6c 69 3e 20 41 6c  code</a>.<li> Al
0170: 6c 20 73 6f 75 72 63 65 20 63 6f 64 65 20 69 6e  l source code in
0180: 20 6f 6e 65 20 66 69 6c 65 20 28 3c 61 20 68 72   one file (<a hr
0190: 65 66 3d 27 61 6d 61 6c 67 61 6d 61 74 69 6f 6e  ef='amalgamation
01a0: 2e 68 74 6d 6c 27 3e 73 71 6c 69 74 65 33 2e 63  .html'>sqlite3.c
01b0: 3c 2f 61 3e 29 0a 3c 6c 69 3e 20 3c 61 20 68 72  </a>).<li> <a hr
01c0: 65 66 3d 27 66 6f 6f 74 70 72 69 6e 74 2e 68 74  ef='footprint.ht
01d0: 6d 6c 27 3e 53 6d 61 6c 6c 20 66 6f 6f 74 70 72  ml'>Small footpr
01e0: 69 6e 74 3c 2f 61 3e 0a 3c 6c 69 3e 20 4d 61 78  int</a>.<li> Max
01f0: 20 44 42 20 73 69 7a 65 3a 20 3c 61 20 68 72 65   DB size: <a hre
0200: 66 3d 27 6c 69 6d 69 74 73 2e 68 74 6d 6c 27 3e  f='limits.html'>
0210: 31 34 30 20 74 65 72 61 62 79 74 65 73 3c 2f 61  140 terabytes</a
0220: 3e 0a 20 20 20 20 20 28 32 3c 73 75 70 3e 3c 73  >.     (2<sup><s
0230: 6d 61 6c 6c 3e 34 37 3c 2f 73 6d 61 6c 6c 3e 3c  mall>47</small><
0240: 2f 73 75 70 3e 20 62 79 74 65 73 29 0a 3c 6c 69  /sup> bytes).<li
0250: 3e 20 4d 61 78 20 72 6f 77 20 73 69 7a 65 3a 20  > Max row size: 
0260: 3c 61 20 68 72 65 66 3d 27 6c 69 6d 69 74 73 2e  <a href='limits.
0270: 68 74 6d 6c 27 3e 31 20 67 69 67 61 62 79 74 65  html'>1 gigabyte
0280: 3c 2f 61 3e 0a 3c 6c 69 3e 20 3c 61 20 68 72 65  </a>.<li> <a hre
0290: 66 3d 27 74 65 73 74 69 6e 67 2e 68 74 6d 6c 27  f='testing.html'
02a0: 3e 41 76 69 61 74 69 6f 6e 2d 67 72 61 64 65 20  >Aviation-grade 
02b0: 71 75 61 6c 69 74 79 20 61 6e 64 20 74 65 73 74  quality and test
02c0: 69 6e 67 3c 2f 61 3e 0a 3c 6c 69 3e 20 3c 61 20  ing</a>.<li> <a 
02d0: 68 72 65 66 3d 27 7a 65 72 6f 63 6f 6e 66 2e 68  href='zeroconf.h
02e0: 74 6d 6c 27 3e 5a 65 72 6f 2d 63 6f 6e 66 69 67  tml'>Zero-config
02f0: 75 72 61 74 69 6f 6e 3c 2f 61 3e 0a 3c 6c 69 3e  uration</a>.<li>
0300: 20 3c 61 20 68 72 65 66 3d 27 74 72 61 6e 73 61   <a href='transa
0310: 63 74 69 6f 6e 61 6c 2e 68 74 6d 6c 27 3e 41 43  ctional.html'>AC
0320: 49 44 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 2c  ID transactions,
0330: 20 65 76 65 6e 20 61 66 74 65 72 20 70 6f 77 65   even after powe
0340: 72 20 6c 6f 73 73 3c 2f 61 3e 0a 3c 6c 69 3e 20  r loss</a>.<li> 
0350: 3c 61 20 68 72 65 66 3d 27 66 69 6c 65 66 6f 72  <a href='filefor
0360: 6d 61 74 2e 68 74 6d 6c 27 3e 53 74 61 62 6c 65  mat.html'>Stable
0370: 2c 20 65 6e 64 75 72 69 6e 67 20 66 69 6c 65 20  , enduring file 
0380: 66 6f 72 6d 61 74 3c 2f 61 3e 0a 3c 6c 69 3e 20  format</a>.<li> 
0390: 3c 61 20 68 72 65 66 3d 27 64 6f 63 6c 69 73 74  <a href='doclist
03a0: 2e 68 74 6d 6c 27 3e 45 78 74 65 6e 73 69 76 65  .html'>Extensive
03b0: 2c 20 64 65 74 61 69 6c 65 64 20 64 6f 63 75 6d  , detailed docum
03c0: 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0a 3c 6c 69  entation</a>.<li
03d0: 3e 20 3c 61 20 68 72 65 66 3d 27 6c 74 73 2e 68  > <a href='lts.h
03e0: 74 6d 6c 27 3e 4c 6f 6e 67 2d 74 65 72 6d 20 73  tml'>Long-term s
03f0: 75 70 70 6f 72 74 3c 2f 61 3e 0a 3c 2f 64 69 76  upport</a>.</div
0400: 3e 0a 0a 3c 70 3e 53 51 4c 69 74 65 20 69 73 20  >..<p>SQLite is 
0410: 61 6e 20 69 6e 2d 70 72 6f 63 65 73 73 20 6c 69  an in-process li
0420: 62 72 61 72 79 20 74 68 61 74 20 69 6d 70 6c 65  brary that imple
0430: 6d 65 6e 74 73 20 61 0a 3c 61 20 68 72 65 66 3d  ments a.<a href=
0440: 22 73 65 6c 66 63 6f 6e 74 61 69 6e 65 64 2e 68  "selfcontained.h
0450: 74 6d 6c 22 3e 73 65 6c 66 2d 63 6f 6e 74 61 69  tml">self-contai
0460: 6e 65 64 3c 2f 61 3e 2c 20 0a 3c 61 20 68 72 65  ned</a>, .<a hre
0470: 66 3d 22 73 65 72 76 65 72 6c 65 73 73 2e 68 74  f="serverless.ht
0480: 6d 6c 22 3e 73 65 72 76 65 72 6c 65 73 73 3c 2f  ml">serverless</
0490: 61 3e 2c 0a 3c 61 20 68 72 65 66 3d 22 7a 65 72  a>,.<a href="zer
04a0: 6f 63 6f 6e 66 2e 68 74 6d 6c 22 3e 7a 65 72 6f  oconf.html">zero
04b0: 2d 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3c 2f  -configuration</
04c0: 61 3e 2c 0a 3c 61 20 68 72 65 66 3d 22 74 72 61  a>,.<a href="tra
04d0: 6e 73 61 63 74 69 6f 6e 61 6c 2e 68 74 6d 6c 22  nsactional.html"
04e0: 3e 74 72 61 6e 73 61 63 74 69 6f 6e 61 6c 3c 2f  >transactional</
04f0: 61 3e 0a 53 51 4c 20 64 61 74 61 62 61 73 65 20  a>.SQL database 
0500: 65 6e 67 69 6e 65 2e 0a 54 68 65 20 63 6f 64 65  engine..The code
0510: 20 66 6f 72 20 53 51 4c 69 74 65 20 69 73 20 69   for SQLite is i
0520: 6e 20 74 68 65 0a 3c 61 20 68 72 65 66 3d 22 63  n the.<a href="c
0530: 6f 70 79 72 69 67 68 74 2e 68 74 6d 6c 22 3e 70  opyright.html">p
0540: 75 62 6c 69 63 20 64 6f 6d 61 69 6e 3c 2f 61 3e  ublic domain</a>
0550: 20 61 6e 64 20 69 73 20 74 68 75 73 20 66 72 65   and is thus fre
0560: 65 20 66 6f 72 0a 75 73 65 20 66 6f 72 20 61 6e  e for.use for an
0570: 79 20 70 75 72 70 6f 73 65 2c 20 63 6f 6d 6d 65  y purpose, comme
0580: 72 63 69 61 6c 20 6f 72 20 70 72 69 76 61 74 65  rcial or private
0590: 2e 0a 53 51 4c 69 74 65 20 69 73 20 74 68 65 20  ..SQLite is the 
05a0: 5b 6d 6f 73 74 20 77 69 64 65 6c 79 20 64 65 70  [most widely dep
05b0: 6c 6f 79 65 64 5d 20 64 61 74 61 62 61 73 65 20  loyed] database 
05c0: 69 6e 20 74 68 65 20 77 6f 72 6c 64 0a 77 69 74  in the world.wit
05d0: 68 20 6d 6f 72 65 20 61 70 70 6c 69 63 61 74 69  h more applicati
05e0: 6f 6e 73 20 74 68 61 6e 20 77 65 20 63 61 6e 0a  ons than we can.
05f0: 63 6f 75 6e 74 2c 20 69 6e 63 6c 75 64 69 6e 67  count, including
0600: 20 73 65 76 65 72 61 6c 20 3c 61 20 68 72 65 66   several <a href
0610: 3d 22 66 61 6d 6f 75 73 2e 68 74 6d 6c 22 3e 68  ="famous.html">h
0620: 69 67 68 2d 70 72 6f 66 69 6c 65 20 70 72 6f 6a  igh-profile proj
0630: 65 63 74 73 2e 3c 2f 61 3e 3c 2f 70 3e 0a 0a 3c  ects.</a></p>..<
0640: 70 3e 53 51 4c 69 74 65 20 69 73 20 61 6e 20 65  p>SQLite is an e
0650: 6d 62 65 64 64 65 64 20 53 51 4c 20 64 61 74 61  mbedded SQL data
0660: 62 61 73 65 20 65 6e 67 69 6e 65 2e 0a 55 6e 6c  base engine..Unl
0670: 69 6b 65 20 6d 6f 73 74 20 6f 74 68 65 72 20 53  ike most other S
0680: 51 4c 20 64 61 74 61 62 61 73 65 73 2c 20 53 51  QL databases, SQ
0690: 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 68 61  Lite does not ha
06a0: 76 65 20 61 20 73 65 70 61 72 61 74 65 0a 73 65  ve a separate.se
06b0: 72 76 65 72 20 70 72 6f 63 65 73 73 2e 20 20 53  rver process.  S
06c0: 51 4c 69 74 65 20 72 65 61 64 73 20 61 6e 64 20  QLite reads and 
06d0: 77 72 69 74 65 73 20 64 69 72 65 63 74 6c 79 20  writes directly 
06e0: 74 6f 20 6f 72 64 69 6e 61 72 79 20 64 69 73 6b  to ordinary disk
06f0: 0a 66 69 6c 65 73 2e 20 20 41 20 63 6f 6d 70 6c  .files.  A compl
0700: 65 74 65 20 53 51 4c 20 64 61 74 61 62 61 73 65  ete SQL database
0710: 20 77 69 74 68 20 6d 75 6c 74 69 70 6c 65 20 74   with multiple t
0720: 61 62 6c 65 73 2c 20 69 6e 64 69 63 65 73 2c 0a  ables, indices,.
0730: 74 72 69 67 67 65 72 73 2c 20 61 6e 64 20 76 69  triggers, and vi
0740: 65 77 73 2c 20 69 73 20 63 6f 6e 74 61 69 6e 65  ews, is containe
0750: 64 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 64 69  d in a single di
0760: 73 6b 20 66 69 6c 65 2e 0a 54 68 65 20 64 61 74  sk file..The dat
0770: 61 62 61 73 65 20 5b 66 69 6c 65 20 66 6f 72 6d  abase [file form
0780: 61 74 5d 20 69 73 20 63 72 6f 73 73 2d 70 6c 61  at] is cross-pla
0790: 74 66 6f 72 6d 20 2d 20 79 6f 75 20 63 61 6e 20  tform - you can 
07a0: 66 72 65 65 6c 79 20 63 6f 70 79 20 61 20 64 61  freely copy a da
07b0: 74 61 62 61 73 65 0a 62 65 74 77 65 65 6e 20 33  tabase.between 3
07c0: 32 2d 62 69 74 20 61 6e 64 20 36 34 2d 62 69 74  2-bit and 64-bit
07d0: 20 73 79 73 74 65 6d 73 20 6f 72 20 62 65 74 77   systems or betw
07e0: 65 65 6e 20 0a 5b 68 74 74 70 3a 2f 2f 65 6e 2e  een .[http://en.
07f0: 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69  wikipedia.org/wi
0800: 6b 69 2f 45 6e 64 69 61 6e 6e 65 73 73 20 7c 20  ki/Endianness | 
0810: 62 69 67 2d 65 6e 64 69 61 6e 5d 20 61 6e 64 0a  big-endian] and.
0820: 5b 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70  [http://en.wikip
0830: 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 45 6e  edia.org/wiki/En
0840: 64 69 61 6e 6e 65 73 73 20 7c 20 6c 69 74 74 6c  dianness | littl
0850: 65 2d 65 6e 64 69 61 6e 5d 0a 61 72 63 68 69 74  e-endian].archit
0860: 65 63 74 75 72 65 73 2e 20 20 54 68 65 73 65 20  ectures.  These 
0870: 66 65 61 74 75 72 65 73 20 6d 61 6b 65 20 53 51  features make SQ
0880: 4c 69 74 65 20 61 20 70 6f 70 75 6c 61 72 20 63  Lite a popular c
0890: 68 6f 69 63 65 20 61 73 0a 61 6e 20 5b 41 70 70  hoice as.an [App
08a0: 6c 69 63 61 74 69 6f 6e 20 46 69 6c 65 20 46 6f  lication File Fo
08b0: 72 6d 61 74 5d 2e 0a 54 68 69 6e 6b 20 6f 66 20  rmat]..Think of 
08c0: 53 51 4c 69 74 65 20 6e 6f 74 20 61 73 20 61 20  SQLite not as a 
08d0: 72 65 70 6c 61 63 65 6d 65 6e 74 20 66 6f 72 20  replacement for 
08e0: 0a 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 6f 72 61  .[http://www.ora
08f0: 63 6c 65 2e 63 6f 6d 2f 64 61 74 61 62 61 73 65  cle.com/database
0900: 2f 69 6e 64 65 78 2e 68 74 6d 6c 7c 4f 72 61 63  /index.html|Orac
0910: 6c 65 5d 20 62 75 74 0a 61 73 20 61 20 72 65 70  le] but.as a rep
0920: 6c 61 63 65 6d 65 6e 74 20 66 6f 72 20 5b 68 74  lacement for [ht
0930: 74 70 3a 2f 2f 6d 61 6e 2e 68 65 2e 6e 65 74 2f  tp://man.he.net/
0940: 6d 61 6e 33 2f 66 6f 70 65 6e 7c 66 6f 70 65 6e  man3/fopen|fopen
0950: 28 29 5d 3c 2f 70 3e 0a 0a 3c 70 3e 53 51 4c 69  ()]</p>..<p>SQLi
0960: 74 65 20 69 73 20 61 20 63 6f 6d 70 61 63 74 20  te is a compact 
0970: 6c 69 62 72 61 72 79 2e 0a 57 69 74 68 20 61 6c  library..With al
0980: 6c 20 66 65 61 74 75 72 65 73 20 65 6e 61 62 6c  l features enabl
0990: 65 64 2c 20 74 68 65 20 5b 6c 69 62 72 61 72 79  ed, the [library
09a0: 20 73 69 7a 65 5d 20 63 61 6e 20 62 65 20 6c 65   size] can be le
09b0: 73 73 20 74 68 61 6e 20 35 30 30 4b 69 42 2c 0a  ss than 500KiB,.
09c0: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65  depending on the
09d0: 20 74 61 72 67 65 74 20 70 6c 61 74 66 6f 72 6d   target platform
09e0: 20 61 6e 64 20 63 6f 6d 70 69 6c 65 72 20 6f 70   and compiler op
09f0: 74 69 6d 69 7a 61 74 69 6f 6e 20 73 65 74 74 69  timization setti
0a00: 6e 67 73 2e 0a 28 36 34 2d 62 69 74 20 63 6f 64  ngs..(64-bit cod
0a10: 65 20 69 73 20 6c 61 72 67 65 72 2e 20 20 41 6e  e is larger.  An
0a20: 64 20 73 6f 6d 65 20 63 6f 6d 70 69 6c 65 72 20  d some compiler 
0a30: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 0a 73 75  optimizations.su
0a40: 63 68 20 61 73 20 61 67 67 72 65 73 73 69 76 65  ch as aggressive
0a50: 20 66 75 6e 63 74 69 6f 6e 20 69 6e 6c 69 6e 69   function inlini
0a60: 6e 67 20 61 6e 64 20 6c 6f 6f 70 20 75 6e 72 6f  ng and loop unro
0a70: 6c 6c 69 6e 67 20 63 61 6e 20 63 61 75 73 65 20  lling can cause 
0a80: 74 68 65 0a 6f 62 6a 65 63 74 20 63 6f 64 65 20  the.object code 
0a90: 74 6f 20 62 65 20 6d 75 63 68 20 6c 61 72 67 65  to be much large
0aa0: 72 2e 29 20 20 49 66 20 6f 70 74 69 6f 6e 61 6c  r.)  If optional
0ab0: 20 66 65 61 74 75 72 65 73 20 61 72 65 20 6f 6d   features are om
0ac0: 69 74 74 65 64 2c 20 74 68 65 0a 73 69 7a 65 20  itted, the.size 
0ad0: 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69  of the SQLite li
0ae0: 62 72 61 72 79 20 63 61 6e 20 62 65 20 72 65 64  brary can be red
0af0: 75 63 65 64 20 62 65 6c 6f 77 20 33 30 30 4b 69  uced below 300Ki
0b00: 42 2e 20 20 53 51 4c 69 74 65 20 63 61 6e 20 61  B.  SQLite can a
0b10: 6c 73 6f 0a 62 65 20 6d 61 64 65 20 74 6f 20 72  lso.be made to r
0b20: 75 6e 20 69 6e 20 6d 69 6e 69 6d 61 6c 20 73 74  un in minimal st
0b30: 61 63 6b 20 73 70 61 63 65 20 28 34 4b 69 42 29  ack space (4KiB)
0b40: 20 61 6e 64 0a 76 65 72 79 20 6c 69 74 74 6c 65   and.very little
0b50: 20 68 65 61 70 20 28 31 30 30 4b 69 42 29 2c 20   heap (100KiB), 
0b60: 6d 61 6b 69 6e 67 20 53 51 4c 69 74 65 20 61 20  making SQLite a 
0b70: 70 6f 70 75 6c 61 72 20 64 61 74 61 62 61 73 65  popular database
0b80: 20 65 6e 67 69 6e 65 20 0a 63 68 6f 69 63 65 20   engine .choice 
0b90: 6f 6e 20 6d 65 6d 6f 72 79 20 63 6f 6e 73 74 72  on memory constr
0ba0: 61 69 6e 65 64 20 67 61 64 67 65 74 73 20 73 75  ained gadgets su
0bb0: 63 68 20 61 73 20 63 65 6c 6c 70 68 6f 6e 65 73  ch as cellphones
0bc0: 2c 20 50 44 41 73 2c 20 61 6e 64 20 4d 50 33 20  , PDAs, and MP3 
0bd0: 70 6c 61 79 65 72 73 2e 0a 54 68 65 72 65 20 69  players..There i
0be0: 73 20 61 20 74 72 61 64 65 6f 66 66 20 62 65 74  s a tradeoff bet
0bf0: 77 65 65 6e 20 6d 65 6d 6f 72 79 20 75 73 61 67  ween memory usag
0c00: 65 20 61 6e 64 20 73 70 65 65 64 2e 20 20 0a 53  e and speed.  .S
0c10: 51 4c 69 74 65 20 67 65 6e 65 72 61 6c 6c 79 20  QLite generally 
0c20: 72 75 6e 73 20 66 61 73 74 65 72 20 74 68 65 20  runs faster the 
0c30: 6d 6f 72 65 20 6d 65 6d 6f 72 79 0a 79 6f 75 20  more memory.you 
0c40: 67 69 76 65 20 69 74 2e 20 20 4e 65 76 65 72 74  give it.  Nevert
0c50: 68 65 6c 65 73 73 2c 20 70 65 72 66 6f 72 6d 61  heless, performa
0c60: 6e 63 65 20 69 73 20 75 73 75 61 6c 6c 79 20 71  nce is usually q
0c70: 75 69 74 65 20 67 6f 6f 64 20 65 76 65 6e 0a 69  uite good even.i
0c80: 6e 20 6c 6f 77 2d 6d 65 6d 6f 72 79 20 65 6e 76  n low-memory env
0c90: 69 72 6f 6e 6d 65 6e 74 73 2e 3c 2f 70 3e 0a 0a  ironments.</p>..
0ca0: 3c 70 3e 53 51 4c 69 74 65 20 69 73 20 0a 3c 61  <p>SQLite is .<a
0cb0: 20 68 72 65 66 3d 22 74 65 73 74 69 6e 67 2e 68   href="testing.h
0cc0: 74 6d 6c 22 3e 76 65 72 79 20 63 61 72 65 66 75  tml">very carefu
0cd0: 6c 6c 79 20 74 65 73 74 65 64 3c 2f 61 3e 20 70  lly tested</a> p
0ce0: 72 69 6f 72 20 74 6f 20 65 76 65 72 79 0a 72 65  rior to every.re
0cf0: 6c 65 61 73 65 20 61 6e 64 20 68 61 73 20 61 20  lease and has a 
0d00: 72 65 70 75 74 61 74 69 6f 6e 20 66 6f 72 20 62  reputation for b
0d10: 65 69 6e 67 20 76 65 72 79 20 72 65 6c 69 61 62  eing very reliab
0d20: 6c 65 2e 0a 4d 6f 73 74 20 6f 66 20 74 68 65 20  le..Most of the 
0d30: 53 51 4c 69 74 65 20 73 6f 75 72 63 65 20 63 6f  SQLite source co
0d40: 64 65 20 69 73 20 64 65 76 6f 74 65 64 20 70 75  de is devoted pu
0d50: 72 65 6c 79 20 74 6f 20 74 65 73 74 69 6e 67 20  rely to testing 
0d60: 61 6e 64 0a 76 65 72 69 66 69 63 61 74 69 6f 6e  and.verification
0d70: 2e 20 20 41 6e 20 61 75 74 6f 6d 61 74 65 64 20  .  An automated 
0d80: 74 65 73 74 20 73 75 69 74 65 20 72 75 6e 73 20  test suite runs 
0d90: 6d 69 6c 6c 69 6f 6e 73 20 61 6e 64 20 6d 69 6c  millions and mil
0da0: 6c 69 6f 6e 73 20 6f 66 0a 74 65 73 74 20 63 61  lions of.test ca
0db0: 73 65 73 20 69 6e 76 6f 6c 76 69 6e 67 20 68 75  ses involving hu
0dc0: 6e 64 72 65 64 73 20 6f 66 20 6d 69 6c 6c 69 6f  ndreds of millio
0dd0: 6e 73 20 6f 66 20 69 6e 64 69 76 69 64 75 61 6c  ns of individual
0de0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 0a   SQL statements.
0df0: 61 6e 64 20 61 63 68 69 65 76 65 73 20 5b 74 65  and achieves [te
0e00: 73 74 20 63 6f 76 65 72 61 67 65 20 7c 20 31 30  st coverage | 10
0e10: 30 25 20 62 72 61 6e 63 68 20 74 65 73 74 20 63  0% branch test c
0e20: 6f 76 65 72 61 67 65 5d 2e 20 20 0a 53 51 4c 69  overage].  .SQLi
0e30: 74 65 20 72 65 73 70 6f 6e 64 73 20 67 72 61 63  te responds grac
0e40: 65 66 75 6c 6c 79 20 74 6f 20 6d 65 6d 6f 72 79  efully to memory
0e50: 0a 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c  .allocation fail
0e60: 75 72 65 73 20 61 6e 64 20 64 69 73 6b 20 49 2f  ures and disk I/
0e70: 4f 20 65 72 72 6f 72 73 2e 20 20 54 72 61 6e 73  O errors.  Trans
0e80: 61 63 74 69 6f 6e 73 20 61 72 65 0a 5b 68 74 74  actions are.[htt
0e90: 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61  p://en.wikipedia
0ea0: 2e 6f 72 67 2f 77 69 6b 69 2f 41 43 49 44 7c 41  .org/wiki/ACID|A
0eb0: 43 49 44 5d 0a 65 76 65 6e 20 69 66 20 69 6e 74  CID].even if int
0ec0: 65 72 72 75 70 74 65 64 20 62 79 20 73 79 73 74  errupted by syst
0ed0: 65 6d 20 63 72 61 73 68 65 73 20 6f 72 20 70 6f  em crashes or po
0ee0: 77 65 72 20 66 61 69 6c 75 72 65 73 2e 20 20 0a  wer failures.  .
0ef0: 41 6c 6c 20 6f 66 20 74 68 69 73 20 69 73 20 76  All of this is v
0f00: 65 72 69 66 69 65 64 20 62 79 0a 74 68 65 20 61  erified by.the a
0f10: 75 74 6f 6d 61 74 65 64 20 74 65 73 74 73 20 75  utomated tests u
0f20: 73 69 6e 67 20 73 70 65 63 69 61 6c 20 74 65 73  sing special tes
0f30: 74 20 68 61 72 6e 65 73 73 65 73 20 77 68 69 63  t harnesses whic
0f40: 68 20 73 69 6d 75 6c 61 74 65 20 0a 73 79 73 74  h simulate .syst
0f50: 65 6d 20 66 61 69 6c 75 72 65 73 2e 0a 4f 66 20  em failures..Of 
0f60: 63 6f 75 72 73 65 2c 20 65 76 65 6e 20 77 69 74  course, even wit
0f70: 68 20 61 6c 6c 20 74 68 69 73 20 74 65 73 74 69  h all this testi
0f80: 6e 67 2c 20 74 68 65 72 65 20 61 72 65 20 73 74  ng, there are st
0f90: 69 6c 6c 20 62 75 67 73 2e 0a 42 75 74 20 75 6e  ill bugs..But un
0fa0: 6c 69 6b 65 20 73 6f 6d 65 20 73 69 6d 69 6c 61  like some simila
0fb0: 72 20 70 72 6f 6a 65 63 74 73 20 28 65 73 70 65  r projects (espe
0fc0: 63 69 61 6c 6c 79 20 63 6f 6d 6d 65 72 63 69 61  cially commercia
0fd0: 6c 20 63 6f 6d 70 65 74 69 74 6f 72 73 29 0a 53  l competitors).S
0fe0: 51 4c 69 74 65 20 69 73 20 6f 70 65 6e 20 61 6e  QLite is open an
0ff0: 64 20 68 6f 6e 65 73 74 20 61 62 6f 75 74 20 61  d honest about a
1000: 6c 6c 20 62 75 67 73 20 61 6e 64 20 70 72 6f 76  ll bugs and prov
1010: 69 64 65 73 0a 3c 61 20 68 72 65 66 3d 22 68 74  ides.<a href="ht
1020: 74 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e  tp://www.sqlite.
1030: 6f 72 67 2f 73 72 63 2f 72 70 74 76 69 65 77 3f  org/src/rptview?
1040: 72 6e 3d 31 22 3e 62 75 67 73 20 6c 69 73 74 73  rn=1">bugs lists
1050: 3c 2f 61 3e 20 61 6e 64 0a 6d 69 6e 75 74 65 2d  </a> and.minute-
1060: 62 79 2d 6d 69 6e 75 74 65 20 3c 61 20 68 72 65  by-minute <a hre
1070: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71  f="http://www.sq
1080: 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 74 69 6d  lite.org/src/tim
1090: 65 6c 69 6e 65 22 3e 0a 63 68 72 6f 6e 6f 6c 6f  eline">.chronolo
10a0: 67 69 65 73 3c 2f 61 3e 20 6f 66 20 63 6f 64 65  gies</a> of code
10b0: 20 63 68 61 6e 67 65 73 2e 3c 2f 70 3e 0a 0a 3c   changes.</p>..<
10c0: 70 3e 54 68 65 20 53 51 4c 69 74 65 20 63 6f 64  p>The SQLite cod
10d0: 65 20 62 61 73 65 20 69 73 20 73 75 70 70 6f 72  e base is suppor
10e0: 74 65 64 20 62 79 20 61 6e 0a 3c 61 20 68 72 65  ted by an.<a hre
10f0: 66 3d 22 63 72 65 77 2e 68 74 6d 6c 22 3e 69 6e  f="crew.html">in
1100: 74 65 72 6e 61 74 69 6f 6e 61 6c 20 74 65 61 6d  ternational team
1110: 3c 2f 61 3e 20 6f 66 20 64 65 76 65 6c 6f 70 65  </a> of develope
1120: 72 73 20 77 68 6f 20 77 6f 72 6b 20 6f 6e 0a 53  rs who work on.S
1130: 51 4c 69 74 65 20 66 75 6c 6c 2d 74 69 6d 65 2e  QLite full-time.
1140: 0a 54 68 65 20 64 65 76 65 6c 6f 70 65 72 73 20  .The developers 
1150: 63 6f 6e 74 69 6e 75 65 20 74 6f 20 65 78 70 61  continue to expa
1160: 6e 64 20 74 68 65 20 63 61 70 61 62 69 6c 69 74  nd the capabilit
1170: 69 65 73 20 6f 66 20 53 51 4c 69 74 65 0a 61 6e  ies of SQLite.an
1180: 64 20 65 6e 68 61 6e 63 65 20 69 74 73 20 72 65  d enhance its re
1190: 6c 69 61 62 69 6c 69 74 79 20 61 6e 64 20 70 65  liability and pe
11a0: 72 66 6f 72 6d 61 6e 63 65 20 77 68 69 6c 65 20  rformance while 
11b0: 6d 61 69 6e 74 61 69 6e 69 6e 67 0a 62 61 63 6b  maintaining.back
11c0: 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69 6c  wards compatibil
11d0: 69 74 79 20 77 69 74 68 20 74 68 65 20 0a 3c 61  ity with the .<a
11e0: 20 68 72 65 66 3d 22 63 33 72 65 66 2f 69 6e 74   href="c3ref/int
11f0: 72 6f 2e 68 74 6d 6c 22 3e 70 75 62 6c 69 73 68  ro.html">publish
1200: 65 64 20 69 6e 74 65 72 66 61 63 65 20 73 70 65  ed interface spe
1210: 63 3c 2f 61 3e 2c 0a 3c 61 20 68 72 65 66 3d 22  c</a>,.<a href="
1220: 6c 61 6e 67 2e 68 74 6d 6c 22 3e 53 51 4c 20 73  lang.html">SQL s
1230: 79 6e 74 61 78 3c 2f 61 3e 2c 20 61 6e 64 20 64  yntax</a>, and d
1240: 61 74 61 62 61 73 65 20 5b 66 69 6c 65 20 66 6f  atabase [file fo
1250: 72 6d 61 74 5d 2e 0a 54 68 65 20 73 6f 75 72 63  rmat]..The sourc
1260: 65 20 63 6f 64 65 20 69 73 20 61 62 73 6f 6c 75  e code is absolu
1270: 74 65 6c 79 20 66 72 65 65 20 74 6f 20 61 6e 79  tely free to any
1280: 62 6f 64 79 20 77 68 6f 20 77 61 6e 74 73 20 69  body who wants i
1290: 74 2c 0a 62 75 74 20 5b 70 72 6f 66 65 73 73 69  t,.but [professi
12a0: 6f 6e 61 6c 20 73 75 70 70 6f 72 74 5d 20 69 73  onal support] is
12b0: 20 61 6c 73 6f 20 61 76 61 69 6c 61 62 6c 65 2e   also available.
12c0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 53 51 4c  </p>..<p>The SQL
12d0: 69 74 65 20 70 72 6f 6a 65 63 74 20 77 61 73 20  ite project was 
12e0: 73 74 61 72 74 65 64 20 6f 6e 20 0a 5b 68 74 74  started on .[htt
12f0: 70 73 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e  ps://www.sqlite.
1300: 6f 72 67 2f 73 72 63 2f 74 69 6d 65 6c 69 6e 65  org/src/timeline
1310: 3f 63 3d 32 30 30 30 2d 30 35 2d 32 39 2b 31 34  ?c=2000-05-29+14
1320: 3a 32 36 3a 30 30 7c 32 30 30 30 2d 30 35 2d 30  :26:00|2000-05-0
1330: 39 5d 2e 0a 54 68 65 20 66 75 74 75 72 65 20 69  9]..The future i
1340: 73 20 61 6c 77 61 79 73 20 68 61 72 64 20 74 6f  s always hard to
1350: 20 70 72 65 64 69 63 74 2c 20 62 75 74 20 74 68   predict, but th
1360: 65 20 69 6e 74 65 6e 74 20 6f 66 20 74 68 65 20  e intent of the 
1370: 64 65 76 65 6c 6f 70 65 72 73 0a 69 73 20 74 6f  developers.is to
1380: 20 73 75 70 70 6f 72 74 20 53 51 4c 69 74 65 20   support SQLite 
1390: 74 68 72 6f 75 67 68 20 74 68 65 20 79 65 61 72  through the year
13a0: 20 32 30 35 30 2e 20 20 44 65 73 69 67 6e 20 64   2050.  Design d
13b0: 65 63 69 73 69 6f 6e 73 20 61 72 65 20 6d 61 64  ecisions are mad
13c0: 65 0a 77 69 74 68 20 74 68 61 74 20 6f 62 6a 65  e.with that obje
13d0: 63 74 69 76 65 20 69 6e 20 6d 69 6e 64 2e 3c 2f  ctive in mind.</
13e0: 70 3e 0a 0a 3c 70 3e 57 65 20 74 68 65 20 64 65  p>..<p>We the de
13f0: 76 65 6c 6f 70 65 72 73 20 68 6f 70 65 20 74 68  velopers hope th
1400: 61 74 20 79 6f 75 20 66 69 6e 64 20 53 51 4c 69  at you find SQLi
1410: 74 65 20 75 73 65 66 75 6c 20 61 6e 64 20 77 65  te useful and we
1420: 0a 65 6e 74 72 65 61 74 20 79 6f 75 20 74 6f 20  .entreat you to 
1430: 75 73 65 20 69 74 20 77 65 6c 6c 3a 20 74 6f 20  use it well: to 
1440: 6d 61 6b 65 20 67 6f 6f 64 20 61 6e 64 20 62 65  make good and be
1450: 61 75 74 69 66 75 6c 20 70 72 6f 64 75 63 74 73  autiful products
1460: 20 74 68 61 74 0a 61 72 65 20 66 61 73 74 2c 20   that.are fast, 
1470: 72 65 6c 69 61 62 6c 65 2c 20 61 6e 64 20 73 69  reliable, and si
1480: 6d 70 6c 65 20 74 6f 20 75 73 65 2e 20 20 53 65  mple to use.  Se
1490: 65 6b 20 66 6f 72 67 69 76 65 6e 65 73 73 20 66  ek forgiveness f
14a0: 6f 72 20 79 6f 75 72 73 65 6c 66 0a 61 73 20 79  or yourself.as y
14b0: 6f 75 20 66 6f 72 67 69 76 65 20 6f 74 68 65 72  ou forgive other
14c0: 73 2e 20 20 41 6e 64 20 6a 75 73 74 20 61 73 20  s.  And just as 
14d0: 79 6f 75 20 68 61 76 65 20 72 65 63 65 69 76 65  you have receive
14e0: 64 20 53 51 4c 69 74 65 20 66 6f 72 20 66 72 65  d SQLite for fre
14f0: 65 2c 0a 73 6f 20 61 6c 73 6f 20 66 72 65 65 6c  e,.so also freel
1500: 79 20 67 69 76 65 2c 20 70 61 79 69 6e 67 20 74  y give, paying t
1510: 68 65 20 64 65 62 74 20 66 6f 72 77 61 72 64 2e  he debt forward.
1520: 3c 2f 70 3e 0a                                   </p>.