Documentation Source Text

Hex Artifact Content
Login

Artifact 649c91bad8296e6aad5fceecd1b838d318300764:


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 {\&nbsp;} 
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 50 72 61 67 6d 61 20 63 6f 6d  .doc {Pragma com
0790: 6d 61 6e 64 73 7d 20 7b 70 72 61 67 6d 61 2e 68  mands} {pragma.h
07a0: 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f  tml} {.  This do
07b0: 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73  cument describes
07c0: 20 53 51 4c 69 74 65 20 70 65 72 66 6f 72 6d 61   SQLite performa
07d0: 6e 63 65 20 74 75 6e 69 6e 67 20 6f 70 74 69 6f  nce tuning optio
07e0: 6e 73 20 61 6e 64 20 6f 74 68 65 72 20 0a 20 20  ns and other .  
07f0: 73 70 65 63 69 61 6c 20 70 75 72 70 6f 73 65 20  special purpose 
0800: 64 61 74 61 62 61 73 65 20 63 6f 6d 6d 61 6e 64  database command
0810: 73 2e 0a 7d 0a 0a 64 6f 63 20 7b 48 6f 77 20 53  s..}..doc {How S
0820: 51 4c 69 74 65 20 49 6d 70 6c 65 6d 65 6e 74 73  QLite Implements
0830: 20 41 74 6f 6d 69 63 20 43 6f 6d 6d 69 74 7d 20   Atomic Commit} 
0840: 7b 61 74 6f 6d 69 63 63 6f 6d 6d 69 74 2e 68 74  {atomiccommit.ht
0850: 6d 6c 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69  ml} {.  A descri
0860: 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 6c 6f 67  ption of the log
0870: 69 63 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65  ic within SQLite
0880: 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73   that implements
0890: 0a 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20  .  transactions 
08a0: 77 69 74 68 20 61 74 6f 6d 69 63 20 63 6f 6d 6d  with atomic comm
08b0: 69 74 2c 20 65 76 65 6e 20 69 6e 20 74 68 65 20  it, even in the 
08c0: 66 61 63 65 20 6f 66 20 70 6f 77 65 72 0a 20 20  face of power.  
08d0: 66 61 69 6c 75 72 65 73 2e 0a 7d 0a 0a 64 6f 63  failures..}..doc
08e0: 20 7b 48 6f 77 20 53 51 4c 69 74 65 20 49 73 20   {How SQLite Is 
08f0: 54 65 73 74 65 64 7d 20 7b 74 65 73 74 69 6e 67  Tested} {testing
0900: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65 20 72  .html} {.  The r
0910: 65 6c 69 61 62 69 6c 69 74 79 20 61 6e 64 20 72  eliability and r
0920: 6f 62 75 73 74 6e 65 73 73 20 6f 66 20 53 51 4c  obustness of SQL
0930: 69 74 65 20 69 73 20 61 63 68 69 65 76 65 64 20  ite is achieved 
0940: 69 6e 20 6c 61 72 67 65 20 70 61 72 74 0a 20 20  in large part.  
0950: 62 79 20 74 68 6f 72 6f 75 67 68 20 61 6e 64 20  by thorough and 
0960: 63 61 72 65 66 75 6c 20 74 65 73 74 69 6e 67 2e  careful testing.
0970: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
0980: 69 64 65 6e 74 69 66 69 65 73 20 74 68 65 0a 20  identifies the. 
0990: 20 6d 61 6e 79 20 74 65 73 74 73 20 74 68 61 74   many tests that
09a0: 20 6f 63 63 75 72 20 62 65 66 6f 72 65 20 76 65   occur before ve
09b0: 72 79 20 72 65 6c 65 61 73 65 20 6f 66 20 53 51  ry release of SQ
09c0: 4c 69 74 65 2e 0a 7d 0a 0a 64 6f 63 20 7b 4d 6f  Lite..}..doc {Mo
09d0: 76 69 6e 67 20 46 72 6f 6d 20 53 51 4c 69 74 65  ving From SQLite
09e0: 20 33 2e 35 20 74 6f 20 33 2e 36 7d 20 7b 33 35   3.5 to 3.6} {35
09f0: 74 6f 33 36 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41  to36.html} {.  A
0a00: 20 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69   document descri
0a10: 62 69 6e 67 20 74 68 65 20 64 69 66 66 65 72 65  bing the differe
0a20: 6e 63 65 73 20 62 65 74 77 65 65 6e 20 53 51 4c  nces between SQL
0a30: 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 35 2e  ite version 3.5.
0a40: 39 0a 20 20 61 6e 64 20 33 2e 36 2e 30 2e 0a 7d  9.  and 3.6.0..}
0a50: 0a 64 6f 63 20 7b 4d 6f 76 69 6e 67 20 46 72 6f  .doc {Moving Fro
0a60: 6d 20 53 51 4c 69 74 65 20 33 2e 34 20 74 6f 20  m SQLite 3.4 to 
0a70: 33 2e 35 7d 20 7b 33 34 74 6f 33 35 2e 68 74 6d  3.5} {34to35.htm
0a80: 6c 7d 20 7b 0a 20 20 41 20 64 6f 63 75 6d 65 6e  l} {.  A documen
0a90: 74 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65  t describing the
0aa0: 20 64 69 66 66 65 72 65 6e 63 65 73 20 62 65 74   differences bet
0ab0: 77 65 65 6e 20 53 51 4c 69 74 65 20 76 65 72 73  ween SQLite vers
0ac0: 69 6f 6e 20 33 2e 34 2e 32 0a 20 20 61 6e 64 20  ion 3.4.2.  and 
0ad0: 33 2e 35 2e 30 2e 0a 7d 0a 64 6f 63 20 7b 53 51  3.5.0..}.doc {SQ
0ae0: 4c 69 74 65 20 56 65 72 73 69 6f 6e 20 33 7d 20  Lite Version 3} 
0af0: 7b 76 65 72 73 69 6f 6e 33 2e 68 74 6d 6c 7d 20  {version3.html} 
0b00: 7b 0a 20 20 41 20 73 75 6d 6d 61 72 79 20 6f 66  {.  A summary of
0b10: 20 6f 66 20 74 68 65 20 63 68 61 6e 67 65 73 20   of the changes 
0b20: 62 65 74 77 65 65 6e 20 53 51 4c 69 74 65 20 76  between SQLite v
0b30: 65 72 73 69 6f 6e 20 32 2e 38 20 61 6e 64 20 53  ersion 2.8 and S
0b40: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e  QLite version 3.
0b50: 30 2e 0a 7d 0a 0a 64 6f 63 20 7b 56 65 72 73 69  0..}..doc {Versi
0b60: 6f 6e 20 33 20 43 2f 43 2b 2b 20 41 50 49 7d 20  on 3 C/C++ API} 
0b70: 7b 63 61 70 69 33 2e 68 74 6d 6c 7d 20 7b 0a 20  {capi3.html} {. 
0b80: 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f   A description o
0b90: 66 20 74 68 65 20 43 2f 43 2b 2b 20 69 6e 74 65  f the C/C++ inte
0ba0: 72 66 61 63 65 20 62 69 6e 64 69 6e 67 73 20 66  rface bindings f
0bb0: 6f 72 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f  or SQLite versio
0bc0: 6e 20 33 2e 30 2e 30 0a 20 20 61 6e 64 20 66 6f  n 3.0.0.  and fo
0bd0: 6c 6c 6f 77 69 6e 67 2e 0a 7d 0a 64 6f 63 20 7b  llowing..}.doc {
0be0: 56 65 72 73 69 6f 6e 20 33 20 44 61 74 61 54 79  Version 3 DataTy
0bf0: 70 65 73 20 7d 20 7b 64 61 74 61 74 79 70 65 33  pes } {datatype3
0c00: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c 69 74  .html} {.  SQLit
0c10: 65 20 76 65 72 73 69 6f 6e 20 33 20 69 6e 74 72  e version 3 intr
0c20: 6f 64 75 63 65 73 20 74 68 65 20 63 6f 6e 63 65  oduces the conce
0c30: 70 74 20 6f 66 20 6d 61 6e 69 66 65 73 74 20 74  pt of manifest t
0c40: 79 70 69 6e 67 2c 20 77 68 65 72 65 20 74 68 65  yping, where the
0c50: 0a 20 20 74 79 70 65 20 6f 66 20 61 20 76 61 6c  .  type of a val
0c60: 75 65 20 69 73 20 61 73 73 6f 63 69 61 74 65 64  ue is associated
0c70: 20 77 69 74 68 20 74 68 65 20 76 61 6c 75 65 20   with the value 
0c80: 69 74 73 65 6c 66 2c 20 6e 6f 74 20 74 68 65 20  itself, not the 
0c90: 63 6f 6c 75 6d 6e 20 74 68 61 74 0a 20 20 69 74  column that.  it
0ca0: 20 69 73 20 73 74 6f 72 65 64 20 69 6e 2e 0a 20   is stored in.. 
0cb0: 20 54 68 69 73 20 70 61 67 65 20 64 65 73 63 72   This page descr
0cc0: 69 62 65 73 20 64 61 74 61 20 74 79 70 69 6e 67  ibes data typing
0cd0: 20 66 6f 72 20 53 51 4c 69 74 65 20 76 65 72 73   for SQLite vers
0ce0: 69 6f 6e 20 33 20 69 6e 20 66 75 72 74 68 65 72  ion 3 in further
0cf0: 20 64 65 74 61 69 6c 2e 0a 7d 0a 0a 64 6f 63 20   detail..}..doc 
0d00: 7b 4c 6f 63 6b 69 6e 67 20 41 6e 64 20 43 6f 6e  {Locking And Con
0d10: 63 75 72 72 65 6e 63 79 3c 62 72 3e 49 6e 20 53  currency<br>In S
0d20: 51 4c 69 74 65 20 56 65 72 73 69 6f 6e 20 33 7d  QLite Version 3}
0d30: 20 7b 6c 6f 63 6b 69 6e 67 76 33 2e 68 74 6d 6c   {lockingv3.html
0d40: 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70 74  } {.  A descript
0d50: 69 6f 6e 20 6f 66 20 68 6f 77 20 74 68 65 20 6e  ion of how the n
0d60: 65 77 20 6c 6f 63 6b 69 6e 67 20 63 6f 64 65 20  ew locking code 
0d70: 69 6e 20 76 65 72 73 69 6f 6e 20 33 20 69 6e 63  in version 3 inc
0d80: 72 65 61 73 65 73 0a 20 20 63 6f 6e 63 75 72 72  reases.  concurr
0d90: 65 6e 63 79 20 61 6e 64 20 64 65 63 72 65 61 73  ency and decreas
0da0: 65 73 20 74 68 65 20 70 72 6f 62 6c 65 6d 20 6f  es the problem o
0db0: 66 20 77 72 69 74 65 72 20 73 74 61 72 76 61 74  f writer starvat
0dc0: 69 6f 6e 2e 0a 7d 0a 0a 64 6f 63 20 7b 4f 76 65  ion..}..doc {Ove
0dd0: 72 76 69 65 77 20 4f 66 20 54 68 65 20 4f 70 74  rview Of The Opt
0de0: 69 6d 69 7a 65 72 7d 20 7b 6f 70 74 6f 76 65 72  imizer} {optover
0df0: 76 69 65 77 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41  view.html} {.  A
0e00: 20 71 75 69 63 6b 20 6f 76 65 72 76 69 65 77 20   quick overview 
0e10: 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20 71  of the various q
0e20: 75 65 72 79 20 6f 70 74 69 6d 69 7a 61 74 69 6f  uery optimizatio
0e30: 6e 73 20 74 68 61 74 20 61 72 65 0a 20 20 61 74  ns that are.  at
0e40: 74 65 6d 70 74 65 64 20 62 79 20 74 68 65 20 53  tempted by the S
0e50: 51 4c 69 74 65 20 63 6f 64 65 20 67 65 6e 65 72  QLite code gener
0e60: 61 74 6f 72 2e 0a 7d 0a 0a 0a 64 6f 63 20 7b 4e  ator..}...doc {N
0e70: 75 6c 6c 20 48 61 6e 64 6c 69 6e 67 7d 20 7b 6e  ull Handling} {n
0e80: 75 6c 6c 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 44  ulls.html} {.  D
0e90: 69 66 66 65 72 65 6e 74 20 53 51 4c 20 64 61 74  ifferent SQL dat
0ea0: 61 62 61 73 65 20 65 6e 67 69 6e 65 73 20 68 61  abase engines ha
0eb0: 6e 64 6c 65 20 4e 55 4c 4c 73 20 69 6e 20 64 69  ndle NULLs in di
0ec0: 66 66 65 72 65 6e 74 20 77 61 79 73 2e 20 20 54  fferent ways.  T
0ed0: 68 65 0a 20 20 53 51 4c 20 73 74 61 6e 64 61 72  he.  SQL standar
0ee0: 64 73 20 61 72 65 20 61 6d 62 69 67 75 6f 75 73  ds are ambiguous
0ef0: 2e 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74  .  This document
0f00: 20 64 65 73 63 72 69 62 65 73 20 68 6f 77 20 53   describes how S
0f10: 51 4c 69 74 65 20 68 61 6e 64 6c 65 73 0a 20 20  QLite handles.  
0f20: 4e 55 4c 4c 73 20 69 6e 20 63 6f 6d 70 61 72 69  NULLs in compari
0f30: 73 6f 6e 20 77 69 74 68 20 6f 74 68 65 72 20 53  son with other S
0f40: 51 4c 20 64 61 74 61 62 61 73 65 20 65 6e 67 69  QL database engi
0f50: 6e 65 73 2e 0a 7d 0a 0a 64 6f 63 20 7b 43 6f 70  nes..}..doc {Cop
0f60: 79 72 69 67 68 74 7d 20 7b 63 6f 70 79 72 69 67  yright} {copyrig
0f70: 68 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c  ht.html} {.  SQL
0f80: 69 74 65 20 69 73 20 69 6e 20 74 68 65 20 70 75  ite is in the pu
0f90: 62 6c 69 63 20 64 6f 6d 61 69 6e 2e 20 20 54 68  blic domain.  Th
0fa0: 69 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 73 63  is document desc
0fb0: 72 69 62 65 73 20 77 68 61 74 20 74 68 61 74 20  ribes what that 
0fc0: 6d 65 61 6e 73 0a 20 20 61 6e 64 20 74 68 65 20  means.  and the 
0fd0: 69 6d 70 6c 69 63 61 74 69 6f 6e 73 20 66 6f 72  implications for
0fe0: 20 63 6f 6e 74 72 69 62 75 74 6f 72 73 2e 0a 7d   contributors..}
0ff0: 0a 0a 64 6f 63 20 7b 55 6e 73 75 70 70 6f 72 74  ..doc {Unsupport
1000: 65 64 20 53 51 4c 7d 20 7b 6f 6d 69 74 74 65 64  ed SQL} {omitted
1010: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20  .html} {.  This 
1020: 70 61 67 65 20 64 65 73 63 72 69 62 65 73 20 66  page describes f
1030: 65 61 74 75 72 65 73 20 6f 66 20 53 51 4c 20 74  eatures of SQL t
1040: 68 61 74 20 53 51 4c 69 74 65 20 64 6f 65 73 20  hat SQLite does 
1050: 6e 6f 74 20 73 75 70 70 6f 72 74 2e 0a 7d 0a 0a  not support..}..
1060: 64 6f 63 20 7b 56 65 72 73 69 6f 6e 20 32 20 43  doc {Version 2 C
1070: 2f 43 2b 2b 20 41 50 49 7d 20 7b 63 5f 69 6e 74  /C++ API} {c_int
1080: 65 72 66 61 63 65 2e 68 74 6d 6c 7d 20 7b 0a 20  erface.html} {. 
1090: 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f   A description o
10a0: 66 20 74 68 65 20 43 2f 43 2b 2b 20 69 6e 74 65  f the C/C++ inte
10b0: 72 66 61 63 65 20 62 69 6e 64 69 6e 67 73 20 66  rface bindings f
10c0: 6f 72 20 53 51 4c 69 74 65 20 74 68 72 6f 75 67  or SQLite throug
10d0: 68 20 76 65 72 73 69 6f 6e 20 0a 20 20 32 2e 38  h version .  2.8
10e0: 0a 7d 0a 0a 0a 64 6f 63 20 7b 56 65 72 73 69 6f  .}...doc {Versio
10f0: 6e 20 32 20 44 61 74 61 54 79 70 65 73 20 7d 20  n 2 DataTypes } 
1100: 7b 64 61 74 61 74 79 70 65 73 2e 68 74 6d 6c 7d  {datatypes.html}
1110: 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70 74 69   {.  A descripti
1120: 6f 6e 20 6f 66 20 68 6f 77 20 53 51 4c 69 74 65  on of how SQLite
1130: 20 76 65 72 73 69 6f 6e 20 32 20 68 61 6e 64 6c   version 2 handl
1140: 65 73 20 53 51 4c 20 64 61 74 61 74 79 70 65 73  es SQL datatypes
1150: 2e 0a 20 20 53 68 6f 72 74 20 73 75 6d 6d 61 72  ..  Short summar
1160: 79 3a 20 20 45 76 65 72 79 74 68 69 6e 67 20 69  y:  Everything i
1170: 73 20 61 20 73 74 72 69 6e 67 2e 0a 7d 0a 0a 64  s a string..}..d
1180: 6f 63 20 7b 52 65 6c 65 61 73 65 20 48 69 73 74  oc {Release Hist
1190: 6f 72 79 7d 20 7b 63 68 61 6e 67 65 73 2e 68 74  ory} {changes.ht
11a0: 6d 6c 7d 20 7b 0a 20 20 41 20 63 68 72 6f 6e 6f  ml} {.  A chrono
11b0: 6c 6f 67 79 20 6f 66 20 53 51 4c 69 74 65 20 72  logy of SQLite r
11c0: 65 6c 65 61 73 65 73 20 67 6f 69 6e 67 20 62 61  eleases going ba
11d0: 63 6b 20 74 6f 20 76 65 72 73 69 6f 6e 20 31 2e  ck to version 1.
11e0: 30 2e 30 0a 7d 0a 0a 0a 64 6f 63 20 7b 53 70 65  0.0.}...doc {Spe
11f0: 65 64 20 43 6f 6d 70 61 72 69 73 6f 6e 7d 20 7b  ed Comparison} {
1200: 73 70 65 65 64 2e 68 74 6d 6c 7d 20 7b 0a 20 20  speed.html} {.  
1210: 54 68 65 20 73 70 65 65 64 20 6f 66 20 76 65 72  The speed of ver
1220: 73 69 6f 6e 20 32 2e 37 2e 36 20 6f 66 20 53 51  sion 2.7.6 of SQ
1230: 4c 69 74 65 20 69 73 20 63 6f 6d 70 61 72 65 64  Lite is compared
1240: 20 61 67 61 69 6e 73 74 20 50 6f 73 74 67 72 65   against Postgre
1250: 53 51 4c 20 61 6e 64 0a 20 20 4d 79 53 51 4c 2e  SQL and.  MySQL.
1260: 0a 7d 0a 0a 64 6f 63 20 7b 41 72 63 68 69 74 65  .}..doc {Archite
1270: 63 74 75 72 65 7d 20 7b 61 72 63 68 2e 68 74 6d  cture} {arch.htm
1280: 6c 7d 20 7b 0a 20 20 41 6e 20 61 72 63 68 69 74  l} {.  An archit
1290: 65 63 74 75 72 61 6c 20 6f 76 65 72 76 69 65 77  ectural overview
12a0: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c   of the SQLite l
12b0: 69 62 72 61 72 79 2c 20 75 73 65 66 75 6c 20 66  ibrary, useful f
12c0: 6f 72 20 74 68 6f 73 65 20 77 68 6f 20 77 61 6e  or those who wan
12d0: 74 0a 20 20 74 6f 20 68 61 63 6b 20 74 68 65 20  t.  to hack the 
12e0: 63 6f 64 65 2e 0a 7d 0a 0a 64 6f 63 20 7b 56 44  code..}..doc {VD
12f0: 42 45 20 54 75 74 6f 72 69 61 6c 7d 20 7b 76 64  BE Tutorial} {vd
1300: 62 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65  be.html} {.  The
1310: 20 56 44 42 45 20 69 73 20 74 68 65 20 73 75 62   VDBE is the sub
1320: 73 79 73 74 65 6d 20 77 69 74 68 69 6e 20 53 51  system within SQ
1330: 4c 69 74 65 20 74 68 61 74 20 64 6f 65 73 20 74  Lite that does t
1340: 68 65 20 61 63 74 75 61 6c 20 77 6f 72 6b 20 6f  he actual work o
1350: 66 0a 20 20 65 78 65 63 75 74 69 6e 67 20 53 51  f.  executing SQ
1360: 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 54  L statements.  T
1370: 68 69 73 20 70 61 67 65 20 64 65 73 63 72 69 62  his page describ
1380: 65 73 20 74 68 65 20 70 72 69 6e 63 69 70 6c 65  es the principle
1390: 73 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 0a 20  s of operation. 
13a0: 20 66 6f 72 20 74 68 65 20 56 44 42 45 20 69 6e   for the VDBE in
13b0: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20   SQLite version 
13c0: 32 2e 37 2e 20 20 54 68 69 73 20 69 73 20 65 73  2.7.  This is es
13d0: 73 65 6e 74 69 61 6c 20 72 65 61 64 69 6e 67 20  sential reading 
13e0: 66 6f 72 20 61 6e 79 6f 6e 65 0a 20 20 77 68 6f  for anyone.  who
13f0: 20 77 61 6e 74 20 74 6f 20 6d 6f 64 69 66 79 20   want to modify 
1400: 74 68 65 20 53 51 4c 69 74 65 20 73 6f 75 72 63  the SQLite sourc
1410: 65 73 2e 0a 7d 0a 0a 64 6f 63 20 7b 56 44 42 45  es..}..doc {VDBE
1420: 20 4f 70 63 6f 64 65 73 7d 20 7b 6f 70 63 6f 64   Opcodes} {opcod
1430: 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73  e.html} {.  This
1440: 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 61 6e 20   document is an 
1450: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 67 65  automatically ge
1460: 6e 65 72 61 74 65 64 20 64 65 73 63 72 69 70 74  nerated descript
1470: 69 6f 6e 20 6f 66 20 74 68 65 20 76 61 72 69 6f  ion of the vario
1480: 75 73 0a 20 20 6f 70 63 6f 64 65 73 20 74 68 61  us.  opcodes tha
1490: 74 20 74 68 65 20 56 44 42 45 20 75 6e 64 65 72  t the VDBE under
14a0: 73 74 61 6e 64 73 2e 20 20 50 72 6f 67 72 61 6d  stands.  Program
14b0: 6d 65 72 73 20 63 61 6e 20 75 73 65 20 74 68 69  mers can use thi
14c0: 73 20 64 6f 63 75 6d 65 6e 74 20 61 73 0a 20 20  s document as.  
14d0: 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 62  a reference to b
14e0: 65 74 74 65 72 20 75 6e 64 65 72 73 74 61 6e 64  etter understand
14f0: 20 74 68 65 20 6f 75 74 70 75 74 20 6f 66 20 45   the output of E
1500: 58 50 4c 41 49 4e 20 6c 69 73 74 69 6e 67 73 20  XPLAIN listings 
1510: 66 72 6f 6d 0a 20 20 53 51 4c 69 74 65 2e 0a 7d  from.  SQLite..}
1520: 0a 0a 64 6f 63 20 7b 43 6f 6d 70 69 6c 61 74 69  ..doc {Compilati
1530: 6f 6e 20 4f 70 74 69 6f 6e 73 7d 20 7b 63 6f 6d  on Options} {com
1540: 70 69 6c 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54  pile.html} {.  T
1550: 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 73  his document des
1560: 63 72 69 62 65 73 20 74 68 65 20 63 6f 6d 70 69  cribes the compi
1570: 6c 65 20 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20  le time options 
1580: 74 68 61 74 20 6d 61 79 20 62 65 20 73 65 74 20  that may be set 
1590: 74 6f 20 0a 20 20 6d 6f 64 69 66 79 20 74 68 65  to .  modify the
15a0: 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f   default behavio
15b0: 72 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72 79  r of the library
15c0: 20 6f 72 20 6f 6d 69 74 20 6f 70 74 69 6f 6e 61   or omit optiona
15d0: 6c 20 66 65 61 74 75 72 65 73 0a 20 20 69 6e 20  l features.  in 
15e0: 6f 72 64 65 72 20 74 6f 20 72 65 64 75 63 65 20  order to reduce 
15f0: 62 69 6e 61 72 79 20 73 69 7a 65 2e 0a 7d 0a 0a  binary size..}..
1600: 64 6f 63 20 7b 42 61 63 6b 77 61 72 64 73 20 43  doc {Backwards C
1610: 6f 6d 70 61 74 69 62 69 6c 69 74 79 7d 20 7b 66  ompatibility} {f
1620: 6f 72 6d 61 74 63 68 6e 67 2e 68 74 6d 6c 7d 20  ormatchng.html} 
1630: 7b 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e  {.  This documen
1640: 74 20 64 65 74 61 69 6c 73 20 61 6c 6c 20 6f 66  t details all of
1650: 20 74 68 65 20 69 6e 63 6f 6d 70 61 74 69 62 6c   the incompatibl
1660: 65 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65  e changes to the
1670: 20 53 51 4c 69 74 65 0a 20 20 66 69 6c 65 20 66   SQLite.  file f
1680: 6f 72 6d 61 74 20 74 68 61 74 20 68 61 76 65 20  ormat that have 
1690: 6f 63 63 75 72 72 65 64 20 73 69 6e 63 65 20 76  occurred since v
16a0: 65 72 73 69 6f 6e 20 31 2e 30 2e 30 2e 0a 7d 0a  ersion 1.0.0..}.
16b0: 3c 2f 74 63 6c 3e 0a 3c 2f 74 61 62 6c 65 3e 0a  </tcl>.</table>.