Documentation Source Text

Hex Artifact Content
Login

Artifact 7ae533bee87f632b7f9fa912359601619c7c7a44:


0000: 3c 74 69 74 6c 65 3e 46 65 61 74 75 72 65 73 20  <title>Features 
0010: 4f 66 20 53 51 4c 69 74 65 3c 2f 74 69 74 6c 65  Of SQLite</title
0020: 3e 0a 0a 3c 68 31 20 61 6c 69 67 6e 3d 63 65 6e  >..<h1 align=cen
0030: 74 65 72 3e 46 65 61 74 75 72 65 73 20 4f 66 20  ter>Features Of 
0040: 53 51 4c 69 74 65 3c 2f 68 31 3e 0a 0a 3c 70 3e  SQLite</h1>..<p>
0050: 3c 75 6c 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66  <ul>.<li><a href
0060: 3d 22 74 72 61 6e 73 61 63 74 69 6f 6e 61 6c 2e  ="transactional.
0070: 68 74 6d 6c 22 3e 54 72 61 6e 73 61 63 74 69 6f  html">Transactio
0080: 6e 73 3c 2f 61 3e 0a 20 20 20 20 61 72 65 20 61  ns</a>.    are a
0090: 74 6f 6d 69 63 2c 20 63 6f 6e 73 69 73 74 65 6e  tomic, consisten
00a0: 74 2c 20 69 73 6f 6c 61 74 65 64 2c 20 61 6e 64  t, isolated, and
00b0: 20 64 75 72 61 62 6c 65 20 28 41 43 49 44 29 0a   durable (ACID).
00c0: 20 20 20 20 65 76 65 6e 20 61 66 74 65 72 20 73      even after s
00d0: 79 73 74 65 6d 20 63 72 61 73 68 65 73 20 61 6e  ystem crashes an
00e0: 64 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 73  d power failures
00f0: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 3c 61 20 68 72  .</li>.<li><a hr
0100: 65 66 3d 22 7a 65 72 6f 63 6f 6e 66 2e 68 74 6d  ef="zeroconf.htm
0110: 6c 22 3e 5a 65 72 6f 2d 63 6f 6e 66 69 67 75 72  l">Zero-configur
0120: 61 74 69 6f 6e 3c 2f 61 3e 0a 20 20 20 20 20 2d  ation</a>.     -
0130: 20 6e 6f 20 73 65 74 75 70 20 6f 72 20 61 64 6d   no setup or adm
0140: 69 6e 69 73 74 72 61 74 69 6f 6e 20 6e 65 65 64  inistration need
0150: 65 64 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 49 6d 70  ed.</li>.<li>Imp
0160: 6c 65 6d 65 6e 74 73 20 6d 6f 73 74 20 6f 66 20  lements most of 
0170: 53 51 4c 39 32 2e 0a 20 20 20 20 28 3c 61 20 68  SQL92..    (<a h
0180: 72 65 66 3d 22 6f 6d 69 74 74 65 64 2e 68 74 6d  ref="omitted.htm
0190: 6c 22 3e 46 65 61 74 75 72 65 73 20 6e 6f 74 20  l">Features not 
01a0: 73 75 70 70 6f 72 74 65 64 3c 2f 61 3e 29 3c 2f  supported</a>)</
01b0: 6c 69 3e 0a 3c 6c 69 3e 41 20 63 6f 6d 70 6c 65  li>.<li>A comple
01c0: 74 65 20 64 61 74 61 62 61 73 65 20 69 73 20 73  te database is s
01d0: 74 6f 72 65 64 20 69 6e 20 61 20 0a 20 20 20 20  tored in a .    
01e0: 3c 61 20 68 72 65 66 3d 22 6f 6e 65 66 69 6c 65  <a href="onefile
01f0: 2e 68 74 6d 6c 22 3e 73 69 6e 67 6c 65 20 63 72  .html">single cr
0200: 6f 73 73 2d 70 6c 61 74 66 6f 72 6d 20 64 69 73  oss-platform dis
0210: 6b 20 66 69 6c 65 3c 2f 61 3e 2e 3c 2f 6c 69 3e  k file</a>.</li>
0220: 0a 3c 6c 69 3e 53 75 70 70 6f 72 74 73 20 74 65  .<li>Supports te
0230: 72 61 62 79 74 65 2d 73 69 7a 65 64 20 64 61 74  rabyte-sized dat
0240: 61 62 61 73 65 73 20 61 6e 64 20 67 69 67 61 62  abases and gigab
0250: 79 74 65 2d 73 69 7a 65 64 20 73 74 72 69 6e 67  yte-sized string
0260: 73 0a 20 20 20 20 61 6e 64 20 62 6c 6f 62 73 2e  s.    and blobs.
0270: 20 20 28 53 65 65 20 3c 61 20 68 72 65 66 3d 22    (See <a href="
0280: 6c 69 6d 69 74 73 2e 68 74 6d 6c 22 3e 6c 69 6d  limits.html">lim
0290: 69 74 73 2e 68 74 6d 6c 3c 2f 61 3e 2e 29 0a 3c  its.html</a>.).<
02a0: 6c 69 3e 53 6d 61 6c 6c 20 63 6f 64 65 20 66 6f  li>Small code fo
02b0: 6f 74 70 72 69 6e 74 3a 20 0a 20 20 20 20 3c 61  otprint: .    <a
02c0: 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77   href="http://ww
02d0: 77 2e 73 71 6c 69 74 65 2e 6f 72 67 2f 63 76 73  w.sqlite.org/cvs
02e0: 74 72 61 63 2f 77 69 6b 69 3f 70 3d 53 69 7a 65  trac/wiki?p=Size
02f0: 4f 66 53 71 6c 69 74 65 22 3e 0a 20 20 20 20 6c  OfSqlite">.    l
0300: 65 73 73 20 74 68 61 6e 20 33 32 35 4b 69 42 3c  ess than 325KiB<
0310: 2f 61 3e 20 66 75 6c 6c 79 20 63 6f 6e 66 69 67  /a> fully config
0320: 75 72 65 64 20 6f 72 20 6c 65 73 73 0a 20 20 20  ured or less.   
0330: 20 74 68 61 6e 20 31 39 30 4b 69 42 20 77 69 74   than 190KiB wit
0340: 68 20 6f 70 74 69 6f 6e 61 6c 20 66 65 61 74 75  h optional featu
0350: 72 65 73 20 6f 6d 69 74 74 65 64 2e 3c 2f 6c 69  res omitted.</li
0360: 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 22 73  >.<li><a href="s
0370: 70 65 65 64 2e 68 74 6d 6c 22 3e 46 61 73 74 65  peed.html">Faste
0380: 72 3c 2f 61 3e 20 74 68 61 6e 20 70 6f 70 75 6c  r</a> than popul
0390: 61 72 20 63 6c 69 65 6e 74 2f 73 65 72 76 65 72  ar client/server
03a0: 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 65 6e   database.    en
03b0: 67 69 6e 65 73 20 66 6f 72 20 6d 6f 73 74 20 63  gines for most c
03c0: 6f 6d 6d 6f 6e 20 6f 70 65 72 61 74 69 6f 6e 73  ommon operations
03d0: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 53 69 6d 70 6c  .</li>.<li>Simpl
03e0: 65 2c 20 65 61 73 79 20 74 6f 20 75 73 65 20 3c  e, easy to use <
03f0: 61 20 68 72 65 66 3d 22 63 33 72 65 66 2f 69 6e  a href="c3ref/in
0400: 74 72 6f 2e 68 74 6d 6c 22 3e 41 50 49 3c 2f 61  tro.html">API</a
0410: 3e 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 57 72 69 74  >.</li>.<li>Writ
0420: 74 65 6e 20 69 6e 20 41 4e 53 49 2d 43 2e 20 20  ten in ANSI-C.  
0430: 3c 61 20 68 72 65 66 3d 22 74 63 6c 73 71 6c 69  <a href="tclsqli
0440: 74 65 2e 68 74 6d 6c 22 3e 54 43 4c 20 62 69 6e  te.html">TCL bin
0450: 64 69 6e 67 73 3c 2f 61 3e 20 69 6e 63 6c 75 64  dings</a> includ
0460: 65 64 2e 0a 20 20 20 20 42 69 6e 64 69 6e 67 73  ed..    Bindings
0470: 20 66 6f 72 20 64 6f 7a 65 6e 73 20 6f 66 20 6f   for dozens of o
0480: 74 68 65 72 20 6c 61 6e 67 75 61 67 65 73 20 0a  ther languages .
0490: 20 20 20 20 3c 61 20 68 72 65 66 3d 22 68 74 74      <a href="htt
04a0: 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f  p://www.sqlite.o
04b0: 72 67 2f 63 76 73 74 72 61 63 2f 77 69 6b 69 3f  rg/cvstrac/wiki?
04c0: 70 3d 53 71 6c 69 74 65 57 72 61 70 70 65 72 73  p=SqliteWrappers
04d0: 22 3e 0a 20 20 20 20 61 76 61 69 6c 61 62 6c 65  ">.    available
04e0: 20 73 65 70 61 72 61 74 65 6c 79 2e 3c 2f 61 3e   separately.</a>
04f0: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 57 65 6c 6c 2d 63  </li>.<li>Well-c
0500: 6f 6d 6d 65 6e 74 65 64 20 73 6f 75 72 63 65 20  ommented source 
0510: 63 6f 64 65 20 77 69 74 68 0a 20 20 20 20 5b 74  code with.    [t
0520: 65 73 74 20 63 6f 76 65 72 61 67 65 20 7c 31 30  est coverage |10
0530: 30 25 20 62 72 61 6e 63 68 20 74 65 73 74 20 63  0% branch test c
0540: 6f 76 65 72 61 67 65 5d 2e 3c 2f 6c 69 3e 0a 3c  overage].</li>.<
0550: 6c 69 3e 41 76 61 69 6c 61 62 6c 65 20 61 73 20  li>Available as 
0560: 61 20 0a 20 20 20 20 3c 61 20 68 72 65 66 3d 22  a .    <a href="
0570: 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 2e 68 74 6d  amalgamation.htm
0580: 6c 22 3e 73 69 6e 67 6c 65 20 41 4e 53 49 2d 43  l">single ANSI-C
0590: 20 73 6f 75 72 63 65 2d 63 6f 64 65 20 66 69 6c   source-code fil
05a0: 65 3c 2f 61 3e 20 0a 20 20 20 20 74 68 61 74 20  e</a> .    that 
05b0: 79 6f 75 20 63 61 6e 20 65 61 73 69 6c 79 20 64  you can easily d
05c0: 72 6f 70 20 69 6e 74 6f 20 61 6e 6f 74 68 65 72  rop into another
05d0: 20 70 72 6f 6a 65 63 74 2e 0a 3c 6c 69 3e 3c 61   project..<li><a
05e0: 20 68 72 65 66 3d 22 73 65 6c 66 63 6f 6e 74 61   href="selfconta
05f0: 69 6e 65 64 2e 68 74 6d 6c 22 3e 53 65 6c 66 2d  ined.html">Self-
0600: 63 6f 6e 74 61 69 6e 65 64 3c 2f 61 3e 3a 0a 20  contained</a>:. 
0610: 20 20 20 6e 6f 20 65 78 74 65 72 6e 61 6c 20 64     no external d
0620: 65 70 65 6e 64 65 6e 63 69 65 73 2e 3c 2f 6c 69  ependencies.</li
0630: 3e 0a 3c 6c 69 3e 43 72 6f 73 73 2d 70 6c 61 74  >.<li>Cross-plat
0640: 66 6f 72 6d 3a 20 55 6e 69 78 20 28 4c 69 6e 75  form: Unix (Linu
0650: 78 20 61 6e 64 20 4d 61 63 20 4f 53 20 58 29 2c  x and Mac OS X),
0660: 20 4f 53 2f 32 2c 20 61 6e 64 20 57 69 6e 64 6f   OS/2, and Windo
0670: 77 73 0a 20 20 20 20 28 57 69 6e 33 32 20 61 6e  ws.    (Win32 an
0680: 64 20 57 69 6e 43 45 29 0a 20 20 20 20 61 72 65  d WinCE).    are
0690: 20 73 75 70 70 6f 72 74 65 64 20 6f 75 74 20 6f   supported out o
06a0: 66 20 74 68 65 20 62 6f 78 2e 20 20 45 61 73 79  f the box.  Easy
06b0: 20 74 6f 20 70 6f 72 74 20 74 6f 20 6f 74 68 65   to port to othe
06c0: 72 20 73 79 73 74 65 6d 73 2e 0a 3c 6c 69 3e 53  r systems..<li>S
06d0: 6f 75 72 63 65 73 20 61 72 65 20 69 6e 20 74 68  ources are in th
06e0: 65 20 3c 61 20 68 72 65 66 3d 22 63 6f 70 79 72  e <a href="copyr
06f0: 69 67 68 74 2e 68 74 6d 6c 22 3e 70 75 62 6c 69  ight.html">publi
0700: 63 20 64 6f 6d 61 69 6e 3c 2f 61 3e 2e 0a 20 20  c domain</a>..  
0710: 20 20 55 73 65 20 66 6f 72 20 61 6e 79 20 70 75    Use for any pu
0720: 72 70 6f 73 65 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e  rpose.</li>.<li>
0730: 43 6f 6d 65 73 20 77 69 74 68 20 61 20 73 74 61  Comes with a sta
0740: 6e 64 61 6c 6f 6e 65 20 3c 61 20 68 72 65 66 3d  ndalone <a href=
0750: 22 73 71 6c 69 74 65 2e 68 74 6d 6c 22 3e 63 6f  "sqlite.html">co
0760: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 69 6e 74 65 72  mmand-line inter
0770: 66 61 63 65 3c 2f 61 3e 0a 20 20 20 20 28 43 4c  face</a>.    (CL
0780: 49 29 20 63 6c 69 65 6e 74 20 74 68 61 74 20 63  I) client that c
0790: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 61 64  an be used to ad
07a0: 6d 69 6e 69 73 74 65 72 20 53 51 4c 69 74 65 20  minister SQLite 
07b0: 64 61 74 61 62 61 73 65 73 2e 3c 2f 6c 69 3e 0a  databases.</li>.
07c0: 3c 2f 75 6c 3e 0a 3c 2f 70 3e 0a 0a 3c 68 32 3e  </ul>.</p>..<h2>
07d0: 53 75 67 67 65 73 74 65 64 20 55 73 65 73 20 46  Suggested Uses F
07e0: 6f 72 20 53 51 4c 69 74 65 3a 3c 2f 68 32 3e 0a  or SQLite:</h2>.
07f0: 0a 3c 70 3e 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e  .<p><ul>.<li><p>
0800: 3c 62 3e 41 70 70 6c 69 63 61 74 69 6f 6e 20 46  <b>Application F
0810: 69 6c 65 20 46 6f 72 6d 61 74 2e 3c 2f 62 3e 0a  ile Format.</b>.
0820: 52 61 74 68 65 72 20 74 68 61 6e 20 75 73 69 6e  Rather than usin
0830: 67 20 66 6f 70 65 6e 28 29 20 74 6f 20 77 72 69  g fopen() to wri
0840: 74 65 20 58 4d 4c 20 6f 72 20 73 6f 6d 65 20 70  te XML or some p
0850: 72 6f 70 72 69 65 74 61 72 79 20 66 6f 72 6d 61  roprietary forma
0860: 74 20 69 6e 74 6f 0a 64 69 73 6b 20 66 69 6c 65  t into.disk file
0870: 73 20 75 73 65 64 20 62 79 20 79 6f 75 72 20 61  s used by your a
0880: 70 70 6c 69 63 61 74 69 6f 6e 2c 20 75 73 65 20  pplication, use 
0890: 61 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62 61  an SQLite databa
08a0: 73 65 20 69 6e 73 74 65 61 64 2e 0a 59 6f 75 27  se instead..You'
08b0: 6c 6c 20 61 76 6f 69 64 20 68 61 76 69 6e 67 20  ll avoid having 
08c0: 74 6f 20 77 72 69 74 65 20 61 6e 64 20 74 72 6f  to write and tro
08d0: 75 62 6c 65 73 68 6f 6f 74 20 61 20 70 61 72 73  ubleshoot a pars
08e0: 65 72 2c 20 79 6f 75 72 20 64 61 74 61 0a 77 69  er, your data.wi
08f0: 6c 6c 20 62 65 20 6d 6f 72 65 20 65 61 73 69 6c  ll be more easil
0900: 79 20 61 63 63 65 73 73 69 62 6c 65 20 61 6e 64  y accessible and
0910: 20 63 72 6f 73 73 2d 70 6c 61 74 66 6f 72 6d 2c   cross-platform,
0920: 20 61 6e 64 20 79 6f 75 72 20 75 70 64 61 74 65   and your update
0930: 73 0a 77 69 6c 6c 20 62 65 20 74 72 61 6e 73 61  s.will be transa
0940: 63 74 69 6f 6e 61 6c 2e 3c 2f 70 3e 3c 2f 6c 69  ctional.</p></li
0950: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 44 61 74  >..<li><p><b>Dat
0960: 61 62 61 73 65 20 46 6f 72 20 47 61 64 67 65 74  abase For Gadget
0970: 73 2e 3c 2f 62 3e 0a 53 51 4c 69 74 65 20 69 73  s.</b>.SQLite is
0980: 20 70 6f 70 75 6c 61 72 20 63 68 6f 69 63 65 20   popular choice 
0990: 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 73 65  for the database
09a0: 20 65 6e 67 69 6e 65 20 69 6e 20 63 65 6c 6c 70   engine in cellp
09b0: 68 6f 6e 65 73 2c 0a 50 44 41 73 2c 20 4d 50 33  hones,.PDAs, MP3
09c0: 20 70 6c 61 79 65 72 73 2c 20 73 65 74 2d 74 6f   players, set-to
09d0: 70 20 62 6f 78 65 73 2c 20 61 6e 64 20 6f 74 68  p boxes, and oth
09e0: 65 72 20 65 6c 65 63 74 72 6f 6e 69 63 20 67 61  er electronic ga
09f0: 64 67 65 74 73 2e 0a 53 51 4c 69 74 65 20 68 61  dgets..SQLite ha
0a00: 73 20 61 20 73 6d 61 6c 6c 20 63 6f 64 65 20 66  s a small code f
0a10: 6f 6f 74 70 72 69 6e 74 2c 20 6d 61 6b 65 73 20  ootprint, makes 
0a20: 65 66 66 69 63 69 65 6e 74 20 75 73 65 20 6f 66  efficient use of
0a30: 20 6d 65 6d 6f 72 79 2c 0a 64 69 73 6b 20 73 70   memory,.disk sp
0a40: 61 63 65 2c 20 61 6e 64 20 64 69 73 6b 20 62 61  ace, and disk ba
0a50: 6e 64 77 69 64 74 68 2c 20 69 73 20 68 69 67 68  ndwidth, is high
0a60: 6c 79 20 72 65 6c 69 61 62 6c 65 2c 20 61 6e 64  ly reliable, and
0a70: 20 72 65 71 75 69 72 65 73 0a 6e 6f 20 6d 61 69   requires.no mai
0a80: 6e 74 65 6e 61 6e 63 65 20 66 72 6f 6d 20 61 20  ntenance from a 
0a90: 44 61 74 61 62 61 73 65 20 41 64 6d 69 6e 69 73  Database Adminis
0aa0: 74 72 61 74 6f 72 2e 3c 2f 70 3e 3c 2f 6c 69 3e  trator.</p></li>
0ab0: 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 57 65 62 73  ..<li><p><b>Webs
0ac0: 69 74 65 20 44 61 74 61 62 61 73 65 2e 3c 2f 62  ite Database.</b
0ad0: 3e 0a 42 65 63 61 75 73 65 20 69 74 20 72 65 71  >.Because it req
0ae0: 75 69 72 65 73 20 6e 6f 20 63 6f 6e 66 69 67 75  uires no configu
0af0: 72 61 74 69 6f 6e 20 61 6e 64 20 73 74 6f 72 65  ration and store
0b00: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e  s information in
0b10: 20 6f 72 64 69 6e 61 72 79 0a 64 69 73 6b 20 66   ordinary.disk f
0b20: 69 6c 65 73 2c 20 53 51 4c 69 74 65 20 69 73 20  iles, SQLite is 
0b30: 61 20 70 6f 70 75 6c 61 72 20 63 68 6f 69 63 65  a popular choice
0b40: 20 61 73 20 74 68 65 20 64 61 74 61 62 61 73 65   as the database
0b50: 20 74 6f 20 62 61 63 6b 20 73 6d 61 6c 6c 0a 74   to back small.t
0b60: 6f 20 6d 65 64 69 75 6d 2d 73 69 7a 65 64 20 77  o medium-sized w
0b70: 65 62 73 69 74 65 73 2e 3c 2f 70 3e 3c 2f 6c 69  ebsites.</p></li
0b80: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 53 74 61  >..<li><p><b>Sta
0b90: 6e 64 2d 69 6e 20 46 6f 72 20 41 6e 20 45 6e 74  nd-in For An Ent
0ba0: 65 72 70 72 69 73 65 20 52 44 42 4d 53 2e 3c 2f  erprise RDBMS.</
0bb0: 62 3e 0a 53 51 4c 69 74 65 20 69 73 20 6f 66 74  b>.SQLite is oft
0bc0: 65 6e 20 75 73 65 64 20 61 73 20 61 20 73 75 72  en used as a sur
0bd0: 72 6f 67 61 74 65 20 66 6f 72 20 61 6e 20 65 6e  rogate for an en
0be0: 74 65 72 70 72 69 73 65 20 52 44 42 4d 53 20 66  terprise RDBMS f
0bf0: 6f 72 0a 64 65 6d 6f 6e 73 74 72 61 74 69 6f 6e  or.demonstration
0c00: 20 70 75 72 70 6f 73 65 73 20 6f 72 20 66 6f 72   purposes or for
0c10: 20 74 65 73 74 69 6e 67 2e 20 20 53 51 4c 69 74   testing.  SQLit
0c20: 65 20 69 73 20 66 61 73 74 20 61 6e 64 20 72 65  e is fast and re
0c30: 71 75 69 72 65 73 0a 6e 6f 20 73 65 74 75 70 2c  quires.no setup,
0c40: 20 77 68 69 63 68 20 74 61 6b 65 73 20 61 20 6c   which takes a l
0c50: 6f 74 20 6f 66 20 74 68 65 20 68 61 73 73 6c 65  ot of the hassle
0c60: 20 6f 75 74 20 6f 66 20 74 65 73 74 69 6e 67 20   out of testing 
0c70: 61 6e 64 20 77 68 69 63 68 0a 6d 61 6b 65 73 20  and which.makes 
0c80: 64 65 6d 6f 73 20 70 65 72 6b 79 20 61 6e 64 20  demos perky and 
0c90: 65 61 73 79 20 74 6f 20 6c 61 75 6e 63 68 2e 3c  easy to launch.<
0ca0: 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a     /p></li>.</ul>.