Documentation Source Text

Hex Artifact Content
Login

Artifact 9ab690f73546836925a8970d618387e3109f5ecb:


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 70   url desc} {.  p
0090: 75 74 73 20 7b 3c 74 72 3e 3c 74 64 20 76 61 6c  uts {<tr><td val
00a0: 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d  ign="top" align=
00b0: 22 72 69 67 68 74 22 3e 7d 0a 20 20 72 65 67 73  "right">}.  regs
00c0: 75 62 20 2d 61 6c 6c 20 7b 20 2b 7d 20 24 6e 61  ub -all { +} $na
00d0: 6d 65 20 7b 5c 26 6e 62 73 70 3b 7d 20 6e 61 6d  me {\&nbsp;} nam
00e0: 65 0a 20 20 70 75 74 73 20 22 3c 61 20 68 72 65  e.  puts "<a hre
00f0: 66 3d 5c 22 24 75 72 6c 5c 22 3e 24 6e 61 6d 65  f=\"$url\">$name
0100: 3c 2f 61 3e 3c 2f 74 64 3e 22 0a 20 20 70 75 74  </a></td>".  put
0110: 73 20 7b 3c 74 64 20 77 69 64 74 68 3d 22 31 30  s {<td width="10
0120: 22 3e 3c 2f 74 64 3e 7d 0a 20 20 70 75 74 73 20  "></td>}.  puts 
0130: 7b 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  {<td valign="top
0140: 22 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 3e 7d  " align="left">}
0150: 0a 20 20 70 75 74 73 20 24 64 65 73 63 0a 20 20  .  puts $desc.  
0160: 70 75 74 73 20 7b 3c 2f 74 64 3e 3c 2f 74 72 3e  puts {</td></tr>
0170: 7d 0a 7d 0a 0a 64 6f 63 20 7b 41 70 70 72 6f 70  }.}..doc {Approp
0180: 72 69 61 74 65 20 55 73 65 73 20 46 6f 72 20 53  riate Uses For S
0190: 51 4c 69 74 65 7d 20 7b 77 68 65 6e 74 6f 75 73  QLite} {whentous
01a0: 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73  e.html} {.  This
01b0: 20 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69   document descri
01c0: 62 65 73 20 73 69 74 75 61 74 69 6f 6e 73 20 77  bes situations w
01d0: 68 65 72 65 20 53 51 4c 69 74 65 20 69 73 20 61  here SQLite is a
01e0: 6e 20 61 70 70 72 6f 72 69 61 74 65 0a 20 20 64  n approriate.  d
01f0: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20 74  atabase engine t
0200: 6f 20 75 73 65 20 76 65 72 73 75 73 20 73 69 74  o use versus sit
0210: 75 61 74 69 6f 6e 73 20 77 68 65 72 65 20 61 20  uations where a 
0220: 63 6c 69 65 6e 74 2f 73 65 72 76 65 72 0a 20 20  client/server.  
0230: 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20  database engine 
0240: 6d 69 67 68 74 20 62 65 20 61 20 62 65 74 74 65  might be a bette
0250: 72 20 63 68 6f 69 63 65 2e 0a 7d 0a 0a 64 6f 63  r choice..}..doc
0260: 20 7b 44 69 73 74 69 6e 63 74 69 76 65 20 46 65   {Distinctive Fe
0270: 61 74 75 72 65 73 7d 20 7b 64 69 66 66 65 72 65  atures} {differe
0280: 6e 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69  nt.html} {.  Thi
0290: 73 20 64 6f 63 75 6d 65 6e 74 20 65 6e 75 6d 65  s document enume
02a0: 72 61 74 65 73 20 61 6e 64 20 64 65 73 63 72 69  rates and descri
02b0: 62 65 73 20 73 6f 6d 65 20 6f 66 20 74 68 65 20  bes some of the 
02c0: 66 65 61 74 75 72 65 73 20 6f 66 0a 20 20 53 51  features of.  SQ
02d0: 4c 69 74 65 20 74 68 61 74 20 6d 61 6b 65 20 69  Lite that make i
02e0: 74 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d  t different from
02f0: 20 6f 74 68 65 72 20 53 51 4c 20 64 61 74 61 62   other SQL datab
0300: 61 73 65 20 65 6e 67 69 6e 65 73 2e 0a 7d 0a 0a  ase engines..}..
0310: 64 6f 63 20 7b 53 51 4c 69 74 65 20 49 6e 20 35  doc {SQLite In 5
0320: 20 4d 69 6e 75 74 65 73 20 4f 72 20 4c 65 73 73   Minutes Or Less
0330: 7d 20 7b 71 75 69 63 6b 73 74 61 72 74 2e 68 74  } {quickstart.ht
0340: 6d 6c 7d 20 7b 0a 20 20 41 20 76 65 72 79 20 71  ml} {.  A very q
0350: 75 69 63 6b 20 69 6e 74 72 6f 64 75 63 74 69 6f  uick introductio
0360: 6e 20 74 6f 20 70 72 6f 67 72 61 6d 6d 69 6e 67  n to programming
0370: 20 77 69 74 68 20 53 51 4c 69 74 65 2e 0a 7d 0a   with SQLite..}.
0380: 0a 64 6f 63 20 7b 53 51 4c 20 53 79 6e 74 61 78  .doc {SQL Syntax
0390: 7d 20 7b 6c 61 6e 67 2e 68 74 6d 6c 7d 20 7b 0a  } {lang.html} {.
03a0: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
03b0: 64 65 73 63 72 69 62 65 73 20 74 68 65 20 53 51  describes the SQ
03c0: 4c 20 6c 61 6e 67 75 61 67 65 20 74 68 61 74 20  L language that 
03d0: 69 73 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79  is understood by
03e0: 0a 20 20 53 51 4c 69 74 65 2e 20 20 0a 7d 0a 64  .  SQLite.  .}.d
03f0: 6f 63 20 7b 56 65 72 73 69 6f 6e 20 33 20 43 2f  oc {Version 3 C/
0400: 43 2b 2b 20 41 50 49 3c 62 72 3e 52 65 66 65 72  C++ API<br>Refer
0410: 65 6e 63 65 7d 20 7b 63 61 70 69 33 72 65 66 2e  ence} {capi3ref.
0420: 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64  html} {.  This d
0430: 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65  ocument describe
0440: 73 20 65 61 63 68 20 41 50 49 20 66 75 6e 63 74  s each API funct
0450: 69 6f 6e 20 73 65 70 61 72 61 74 65 6c 79 2e 0a  ion separately..
0460: 7d 0a 64 6f 63 20 7b 53 68 61 72 69 6e 67 20 43  }.doc {Sharing C
0470: 61 63 68 65 20 4d 6f 64 65 7d 20 7b 73 68 61 72  ache Mode} {shar
0480: 65 64 63 61 63 68 65 2e 68 74 6d 6c 7d 20 7b 0a  edcache.html} {.
0490: 20 20 56 65 72 73 69 6f 6e 20 33 2e 33 2e 30 20    Version 3.3.0 
04a0: 61 6e 64 20 6c 61 74 65 72 20 73 75 70 70 6f 72  and later suppor
04b0: 74 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 66  ts the ability f
04c0: 6f 72 20 74 77 6f 20 6f 72 20 6d 6f 72 65 0a 20  or two or more. 
04d0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
04e0: 74 69 6f 6e 73 20 74 6f 20 73 68 61 72 65 20 74  tions to share t
04f0: 68 65 20 73 61 6d 65 20 70 61 67 65 20 61 6e 64  he same page and
0500: 20 73 63 68 65 6d 61 20 63 61 63 68 65 2e 0a 20   schema cache.. 
0510: 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 73   This feature is
0520: 20 75 73 65 66 75 6c 20 66 6f 72 20 63 65 72 74   useful for cert
0530: 61 69 6e 20 73 70 65 63 69 61 6c 69 7a 65 64 20  ain specialized 
0540: 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a  applications..}.
0550: 64 6f 63 20 7b 54 63 6c 20 41 50 49 7d 20 7b 74  doc {Tcl API} {t
0560: 63 6c 73 71 6c 69 74 65 2e 68 74 6d 6c 7d 20 7b  clsqlite.html} {
0570: 0a 20 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e  .  A description
0580: 20 6f 66 20 74 68 65 20 54 43 4c 20 69 6e 74 65   of the TCL inte
0590: 72 66 61 63 65 20 62 69 6e 64 69 6e 67 73 20 66  rface bindings f
05a0: 6f 72 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 64 6f  or SQLite..}..do
05b0: 63 20 7b 48 6f 77 20 53 51 4c 69 74 65 20 49 6d  c {How SQLite Im
05c0: 70 6c 65 6d 65 6e 74 73 20 41 74 6f 6d 69 63 20  plements Atomic 
05d0: 43 6f 6d 6d 69 74 7d 20 7b 61 63 2f 61 74 6f 6d  Commit} {ac/atom
05e0: 69 63 63 6f 6d 6d 69 74 2e 68 74 6d 6c 7d 20 7b  iccommit.html} {
05f0: 0a 20 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e  .  A description
0600: 20 6f 66 20 74 68 65 20 6c 6f 67 69 63 20 77 69   of the logic wi
0610: 74 68 69 6e 20 53 51 4c 69 74 65 20 74 68 61 74  thin SQLite that
0620: 20 69 6d 70 6c 65 6d 65 6e 74 73 0a 20 20 74 72   implements.  tr
0630: 61 6e 73 61 63 74 69 6f 6e 73 20 77 69 74 68 20  ansactions with 
0640: 61 74 6f 6d 69 63 20 63 6f 6d 6d 69 74 2c 20 65  atomic commit, e
0650: 76 65 6e 20 69 6e 20 74 68 65 20 66 61 63 65 20  ven in the face 
0660: 6f 66 20 70 6f 77 65 72 0a 20 20 66 61 69 6c 75  of power.  failu
0670: 72 65 73 2e 0a 7d 0a 64 6f 63 20 7b 4d 6f 76 69  res..}.doc {Movi
0680: 6e 67 20 46 72 6f 6d 20 53 51 4c 69 74 65 20 33  ng From SQLite 3
0690: 2e 34 20 74 6f 20 33 2e 35 7d 20 7b 33 34 74 6f  .4 to 3.5} {34to
06a0: 33 35 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64  35.html} {.  A d
06b0: 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 69  ocument describi
06c0: 6e 67 20 74 68 65 20 64 69 66 66 65 72 65 6e 63  ng the differenc
06d0: 65 73 20 62 65 74 77 65 65 6e 20 53 51 4c 69 74  es between SQLit
06e0: 65 20 76 65 72 73 69 6f 6e 20 33 2e 34 2e 32 0a  e version 3.4.2.
06f0: 20 20 61 6e 64 20 33 2e 35 2e 30 2e 0a 7d 0a 0a    and 3.5.0..}..
0700: 64 6f 63 20 7b 50 72 61 67 6d 61 20 63 6f 6d 6d  doc {Pragma comm
0710: 61 6e 64 73 7d 20 7b 70 72 61 67 6d 61 2e 68 74  ands} {pragma.ht
0720: 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63  ml} {.  This doc
0730: 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20  ument describes 
0740: 53 51 4c 69 74 65 20 70 65 72 66 6f 72 6d 61 6e  SQLite performan
0750: 63 65 20 74 75 6e 69 6e 67 20 6f 70 74 69 6f 6e  ce tuning option
0760: 73 20 61 6e 64 20 6f 74 68 65 72 20 0a 20 20 73  s and other .  s
0770: 70 65 63 69 61 6c 20 70 75 72 70 6f 73 65 20 64  pecial purpose d
0780: 61 74 61 62 61 73 65 20 63 6f 6d 6d 61 6e 64 73  atabase commands
0790: 2e 0a 7d 0a 64 6f 63 20 7b 53 51 4c 69 74 65 20  ..}.doc {SQLite 
07a0: 56 65 72 73 69 6f 6e 20 33 7d 20 7b 76 65 72 73  Version 3} {vers
07b0: 69 6f 6e 33 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41  ion3.html} {.  A
07c0: 20 73 75 6d 6d 61 72 79 20 6f 66 20 6f 66 20 74   summary of of t
07d0: 68 65 20 63 68 61 6e 67 65 73 20 62 65 74 77 65  he changes betwe
07e0: 65 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f  en SQLite versio
07f0: 6e 20 32 2e 38 20 61 6e 64 20 53 51 4c 69 74 65  n 2.8 and SQLite
0800: 20 76 65 72 73 69 6f 6e 20 33 2e 30 2e 0a 7d 0a   version 3.0..}.
0810: 64 6f 63 20 7b 56 65 72 73 69 6f 6e 20 33 20 43  doc {Version 3 C
0820: 2f 43 2b 2b 20 41 50 49 7d 20 7b 63 61 70 69 33  /C++ API} {capi3
0830: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64 65 73  .html} {.  A des
0840: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20  cription of the 
0850: 43 2f 43 2b 2b 20 69 6e 74 65 72 66 61 63 65 20  C/C++ interface 
0860: 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 53 51 4c  bindings for SQL
0870: 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 30 2e  ite version 3.0.
0880: 30 0a 20 20 61 6e 64 20 66 6f 6c 6c 6f 77 69 6e  0.  and followin
0890: 67 2e 0a 7d 0a 64 6f 63 20 7b 56 65 72 73 69 6f  g..}.doc {Versio
08a0: 6e 20 33 20 44 61 74 61 54 79 70 65 73 20 7d 20  n 3 DataTypes } 
08b0: 7b 64 61 74 61 74 79 70 65 33 2e 68 74 6d 6c 7d  {datatype3.html}
08c0: 20 7b 0a 20 20 53 51 4c 69 74 65 20 76 65 72 73   {.  SQLite vers
08d0: 69 6f 6e 20 33 20 69 6e 74 72 6f 64 75 63 65 73  ion 3 introduces
08e0: 20 74 68 65 20 63 6f 6e 63 65 70 74 20 6f 66 20   the concept of 
08f0: 6d 61 6e 69 66 65 73 74 20 74 79 70 69 6e 67 2c  manifest typing,
0900: 20 77 68 65 72 65 20 74 68 65 0a 20 20 74 79 70   where the.  typ
0910: 65 20 6f 66 20 61 20 76 61 6c 75 65 20 69 73 20  e of a value is 
0920: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
0930: 74 68 65 20 76 61 6c 75 65 20 69 74 73 65 6c 66  the value itself
0940: 2c 20 6e 6f 74 20 74 68 65 20 63 6f 6c 75 6d 6e  , not the column
0950: 20 74 68 61 74 0a 20 20 69 74 20 69 73 20 73 74   that.  it is st
0960: 6f 72 65 64 20 69 6e 2e 0a 20 20 54 68 69 73 20  ored in..  This 
0970: 70 61 67 65 20 64 65 73 63 72 69 62 65 73 20 64  page describes d
0980: 61 74 61 20 74 79 70 69 6e 67 20 66 6f 72 20 53  ata typing for S
0990: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 20  QLite version 3 
09a0: 69 6e 20 66 75 72 74 68 65 72 20 64 65 74 61 69  in further detai
09b0: 6c 2e 0a 7d 0a 0a 64 6f 63 20 7b 4c 6f 63 6b 69  l..}..doc {Locki
09c0: 6e 67 20 41 6e 64 20 43 6f 6e 63 75 72 72 65 6e  ng And Concurren
09d0: 63 79 3c 62 72 3e 49 6e 20 53 51 4c 69 74 65 20  cy<br>In SQLite 
09e0: 56 65 72 73 69 6f 6e 20 33 7d 20 7b 6c 6f 63 6b  Version 3} {lock
09f0: 69 6e 67 76 33 2e 68 74 6d 6c 7d 20 7b 0a 20 20  ingv3.html} {.  
0a00: 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66  A description of
0a10: 20 68 6f 77 20 74 68 65 20 6e 65 77 20 6c 6f 63   how the new loc
0a20: 6b 69 6e 67 20 63 6f 64 65 20 69 6e 20 76 65 72  king code in ver
0a30: 73 69 6f 6e 20 33 20 69 6e 63 72 65 61 73 65 73  sion 3 increases
0a40: 0a 20 20 63 6f 6e 63 75 72 72 61 6e 63 79 20 61  .  concurrancy a
0a50: 6e 64 20 64 65 63 72 65 61 73 65 73 20 74 68 65  nd decreases the
0a60: 20 70 72 6f 62 6c 65 6d 20 6f 66 20 77 72 69 74   problem of writ
0a70: 65 72 20 73 74 61 72 76 61 74 69 6f 6e 2e 0a 7d  er starvation..}
0a80: 0a 0a 64 6f 63 20 7b 4f 76 65 72 76 69 65 77 20  ..doc {Overview 
0a90: 4f 66 20 54 68 65 20 4f 70 74 69 6d 69 7a 65 72  Of The Optimizer
0aa0: 7d 20 7b 6f 70 74 6f 76 65 72 76 69 65 77 2e 68  } {optoverview.h
0ab0: 74 6d 6c 7d 20 7b 0a 20 20 41 20 71 75 69 63 6b  tml} {.  A quick
0ac0: 20 6f 76 65 72 76 69 65 77 20 6f 66 20 74 68 65   overview of the
0ad0: 20 76 61 72 69 6f 75 73 20 71 75 65 72 79 20 6f   various query o
0ae0: 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 74 68 61  ptimizations tha
0af0: 74 20 61 72 65 0a 20 20 61 74 74 65 6d 70 74 65  t are.  attempte
0b00: 64 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20  d by the SQLite 
0b10: 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 2e 0a  code generator..
0b20: 7d 0a 0a 0a 64 6f 63 20 7b 4e 75 6c 6c 20 48 61  }...doc {Null Ha
0b30: 6e 64 6c 69 6e 67 7d 20 7b 6e 75 6c 6c 73 2e 68  ndling} {nulls.h
0b40: 74 6d 6c 7d 20 7b 0a 20 20 44 69 66 66 65 72 65  tml} {.  Differe
0b50: 6e 74 20 53 51 4c 20 64 61 74 61 62 61 73 65 20  nt SQL database 
0b60: 65 6e 67 69 6e 65 73 20 68 61 6e 64 6c 65 20 4e  engines handle N
0b70: 55 4c 4c 73 20 69 6e 20 64 69 66 66 65 72 65 6e  ULLs in differen
0b80: 74 20 77 61 79 73 2e 20 20 54 68 65 0a 20 20 53  t ways.  The.  S
0b90: 51 4c 20 73 74 61 6e 64 61 72 64 73 20 61 72 65  QL standards are
0ba0: 20 61 6d 62 69 67 75 6f 75 73 2e 20 20 54 68 69   ambiguous.  Thi
0bb0: 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72  s document descr
0bc0: 69 62 65 73 20 68 6f 77 20 53 51 4c 69 74 65 20  ibes how SQLite 
0bd0: 68 61 6e 64 6c 65 73 0a 20 20 4e 55 4c 4c 73 20  handles.  NULLs 
0be0: 69 6e 20 63 6f 6d 70 61 72 69 73 6f 6e 20 77 69  in comparison wi
0bf0: 74 68 20 6f 74 68 65 72 20 53 51 4c 20 64 61 74  th other SQL dat
0c00: 61 62 61 73 65 20 65 6e 67 69 6e 65 73 2e 0a 7d  abase engines..}
0c10: 0a 0a 64 6f 63 20 7b 43 6f 70 79 72 69 67 68 74  ..doc {Copyright
0c20: 7d 20 7b 63 6f 70 79 72 69 67 68 74 2e 68 74 6d  } {copyright.htm
0c30: 6c 7d 20 7b 0a 20 20 53 51 4c 69 74 65 20 69 73  l} {.  SQLite is
0c40: 20 69 6e 20 74 68 65 20 70 75 62 6c 69 63 20 64   in the public d
0c50: 6f 6d 61 69 6e 2e 20 20 54 68 69 73 20 64 6f 63  omain.  This doc
0c60: 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20  ument describes 
0c70: 77 68 61 74 20 74 68 61 74 20 6d 65 61 6e 73 0a  what that means.
0c80: 20 20 61 6e 64 20 74 68 65 20 69 6d 70 6c 69 63    and the implic
0c90: 61 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6e 74 72  ations for contr
0ca0: 69 62 75 74 6f 72 73 2e 0a 7d 0a 0a 64 6f 63 20  ibutors..}..doc 
0cb0: 7b 55 6e 73 75 70 70 6f 72 74 65 64 20 53 51 4c  {Unsupported SQL
0cc0: 7d 20 7b 6f 6d 69 74 74 65 64 2e 68 74 6d 6c 7d  } {omitted.html}
0cd0: 20 7b 0a 20 20 54 68 69 73 20 70 61 67 65 20 64   {.  This page d
0ce0: 65 73 63 72 69 62 65 73 20 66 65 61 74 75 72 65  escribes feature
0cf0: 73 20 6f 66 20 53 51 4c 20 74 68 61 74 20 53 51  s of SQL that SQ
0d00: 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 73 75  Lite does not su
0d10: 70 70 6f 72 74 2e 0a 7d 0a 0a 64 6f 63 20 7b 56  pport..}..doc {V
0d20: 65 72 73 69 6f 6e 20 32 20 43 2f 43 2b 2b 20 41  ersion 2 C/C++ A
0d30: 50 49 7d 20 7b 63 5f 69 6e 74 65 72 66 61 63 65  PI} {c_interface
0d40: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64 65 73  .html} {.  A des
0d50: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20  cription of the 
0d60: 43 2f 43 2b 2b 20 69 6e 74 65 72 66 61 63 65 20  C/C++ interface 
0d70: 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 53 51 4c  bindings for SQL
0d80: 69 74 65 20 74 68 72 6f 75 67 68 20 76 65 72 73  ite through vers
0d90: 69 6f 6e 20 0a 20 20 32 2e 38 0a 7d 0a 0a 0a 64  ion .  2.8.}...d
0da0: 6f 63 20 7b 56 65 72 73 69 6f 6e 20 32 20 44 61  oc {Version 2 Da
0db0: 74 61 54 79 70 65 73 20 7d 20 7b 64 61 74 61 74  taTypes } {datat
0dc0: 79 70 65 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41  ypes.html} {.  A
0dd0: 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20   description of 
0de0: 68 6f 77 20 53 51 4c 69 74 65 20 76 65 72 73 69  how SQLite versi
0df0: 6f 6e 20 32 20 68 61 6e 64 6c 65 73 20 53 51 4c  on 2 handles SQL
0e00: 20 64 61 74 61 74 79 70 65 73 2e 0a 20 20 53 68   datatypes..  Sh
0e10: 6f 72 74 20 73 75 6d 6d 61 72 79 3a 20 20 45 76  ort summary:  Ev
0e20: 65 72 79 74 68 69 6e 67 20 69 73 20 61 20 73 74  erything is a st
0e30: 72 69 6e 67 2e 0a 7d 0a 0a 64 6f 63 20 7b 52 65  ring..}..doc {Re
0e40: 6c 65 61 73 65 20 48 69 73 74 6f 72 79 7d 20 7b  lease History} {
0e50: 63 68 61 6e 67 65 73 2e 68 74 6d 6c 7d 20 7b 0a  changes.html} {.
0e60: 20 20 41 20 63 68 72 6f 6e 6f 6c 6f 67 79 20 6f    A chronology o
0e70: 66 20 53 51 4c 69 74 65 20 72 65 6c 65 61 73 65  f SQLite release
0e80: 73 20 67 6f 69 6e 67 20 62 61 63 6b 20 74 6f 20  s going back to 
0e90: 76 65 72 73 69 6f 6e 20 31 2e 30 2e 30 0a 7d 0a  version 1.0.0.}.
0ea0: 0a 0a 64 6f 63 20 7b 53 70 65 65 64 20 43 6f 6d  ..doc {Speed Com
0eb0: 70 61 72 69 73 6f 6e 7d 20 7b 73 70 65 65 64 2e  parison} {speed.
0ec0: 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65 20 73 70  html} {.  The sp
0ed0: 65 65 64 20 6f 66 20 76 65 72 73 69 6f 6e 20 32  eed of version 2
0ee0: 2e 37 2e 36 20 6f 66 20 53 51 4c 69 74 65 20 69  .7.6 of SQLite i
0ef0: 73 20 63 6f 6d 70 61 72 65 64 20 61 67 61 69 6e  s compared again
0f00: 73 74 20 50 6f 73 74 67 72 65 53 51 4c 20 61 6e  st PostgreSQL an
0f10: 64 0a 20 20 4d 79 53 51 4c 2e 0a 7d 0a 0a 64 6f  d.  MySQL..}..do
0f20: 63 20 7b 41 72 63 68 69 74 65 63 74 75 72 65 7d  c {Architecture}
0f30: 20 7b 61 72 63 68 2e 68 74 6d 6c 7d 20 7b 0a 20   {arch.html} {. 
0f40: 20 41 6e 20 61 72 63 68 69 74 65 63 74 75 72 61   An architectura
0f50: 6c 20 6f 76 65 72 76 69 65 77 20 6f 66 20 74 68  l overview of th
0f60: 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79  e SQLite library
0f70: 2c 20 75 73 65 66 75 6c 20 66 6f 72 20 74 68 6f  , useful for tho
0f80: 73 65 20 77 68 6f 20 77 61 6e 74 0a 20 20 74 6f  se who want.  to
0f90: 20 68 61 63 6b 20 74 68 65 20 63 6f 64 65 2e 0a   hack the code..
0fa0: 7d 0a 0a 64 6f 63 20 7b 56 44 42 45 20 54 75 74  }..doc {VDBE Tut
0fb0: 6f 72 69 61 6c 7d 20 7b 76 64 62 65 2e 68 74 6d  orial} {vdbe.htm
0fc0: 6c 7d 20 7b 0a 20 20 54 68 65 20 56 44 42 45 20  l} {.  The VDBE 
0fd0: 69 73 20 74 68 65 20 73 75 62 73 79 73 74 65 6d  is the subsystem
0fe0: 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65 20 74   within SQLite t
0ff0: 68 61 74 20 64 6f 65 73 20 74 68 65 20 61 63 74  hat does the act
1000: 75 61 6c 20 77 6f 72 6b 20 6f 66 0a 20 20 65 78  ual work of.  ex
1010: 65 63 75 74 69 6e 67 20 53 51 4c 20 73 74 61 74  ecuting SQL stat
1020: 65 6d 65 6e 74 73 2e 20 20 54 68 69 73 20 70 61  ements.  This pa
1030: 67 65 20 64 65 73 63 72 69 62 65 73 20 74 68 65  ge describes the
1040: 20 70 72 69 6e 63 69 70 6c 65 73 20 6f 66 20 6f   principles of o
1050: 70 65 72 61 74 69 6f 6e 0a 20 20 66 6f 72 20 74  peration.  for t
1060: 68 65 20 56 44 42 45 20 69 6e 20 53 51 4c 69 74  he VDBE in SQLit
1070: 65 20 76 65 72 73 69 6f 6e 20 32 2e 37 2e 20 20  e version 2.7.  
1080: 54 68 69 73 20 69 73 20 65 73 73 65 6e 74 69 61  This is essentia
1090: 6c 20 72 65 61 64 69 6e 67 20 66 6f 72 20 61 6e  l reading for an
10a0: 79 6f 6e 65 0a 20 20 77 68 6f 20 77 61 6e 74 20  yone.  who want 
10b0: 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 20 53 51  to modify the SQ
10c0: 4c 69 74 65 20 73 6f 75 72 63 65 73 2e 0a 7d 0a  Lite sources..}.
10d0: 0a 64 6f 63 20 7b 56 44 42 45 20 4f 70 63 6f 64  .doc {VDBE Opcod
10e0: 65 73 7d 20 7b 6f 70 63 6f 64 65 2e 68 74 6d 6c  es} {opcode.html
10f0: 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 75 6d  } {.  This docum
1100: 65 6e 74 20 69 73 20 61 6e 20 61 75 74 6f 6d 61  ent is an automa
1110: 74 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65  tically generate
1120: 64 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66  d description of
1130: 20 74 68 65 20 76 61 72 69 6f 75 73 0a 20 20 6f   the various.  o
1140: 70 63 6f 64 65 73 20 74 68 61 74 20 74 68 65 20  pcodes that the 
1150: 56 44 42 45 20 75 6e 64 65 72 73 74 61 6e 64 73  VDBE understands
1160: 2e 20 20 50 72 6f 67 72 61 6d 6d 65 72 73 20 63  .  Programmers c
1170: 61 6e 20 75 73 65 20 74 68 69 73 20 64 6f 63 75  an use this docu
1180: 6d 65 6e 74 20 61 73 0a 20 20 61 20 72 65 66 65  ment as.  a refe
1190: 72 65 6e 63 65 20 74 6f 20 62 65 74 74 65 72 20  rence to better 
11a0: 75 6e 64 65 72 73 74 61 6e 64 20 74 68 65 20 6f  understand the o
11b0: 75 74 70 75 74 20 6f 66 20 45 58 50 4c 41 49 4e  utput of EXPLAIN
11c0: 20 6c 69 73 74 69 6e 67 73 20 66 72 6f 6d 0a 20   listings from. 
11d0: 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 64 6f 63 20   SQLite..}..doc 
11e0: 7b 43 6f 6d 70 69 6c 61 74 69 6f 6e 20 4f 70 74  {Compilation Opt
11f0: 69 6f 6e 73 7d 20 7b 63 6f 6d 70 69 6c 65 2e 68  ions} {compile.h
1200: 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f  tml} {.  This do
1210: 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73  cument describes
1220: 20 74 68 65 20 63 6f 6d 70 69 6c 65 20 74 69 6d   the compile tim
1230: 65 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 6d  e options that m
1240: 61 79 20 62 65 20 73 65 74 20 74 6f 20 0a 20 20  ay be set to .  
1250: 6d 6f 64 69 66 79 20 74 68 65 20 64 65 66 61 75  modify the defau
1260: 6c 74 20 62 65 68 61 76 69 6f 75 72 20 6f 66 20  lt behaviour of 
1270: 74 68 65 20 6c 69 62 72 61 72 79 20 6f 72 20 6f  the library or o
1280: 6d 69 74 20 6f 70 74 69 6f 6e 61 6c 20 66 65 61  mit optional fea
1290: 74 75 72 65 73 0a 20 20 69 6e 20 6f 72 64 65 72  tures.  in order
12a0: 20 74 6f 20 72 65 64 75 63 65 20 62 69 6e 61 72   to reduce binar
12b0: 79 20 73 69 7a 65 2e 0a 7d 0a 0a 64 6f 63 20 7b  y size..}..doc {
12c0: 42 61 63 6b 77 61 72 64 73 20 43 6f 6d 70 61 74  Backwards Compat
12d0: 69 62 69 6c 69 74 79 7d 20 7b 66 6f 72 6d 61 74  ibility} {format
12e0: 63 68 6e 67 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54  chng.html} {.  T
12f0: 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 74  his document det
1300: 61 69 6c 73 20 61 6c 6c 20 6f 66 20 74 68 65 20  ails all of the 
1310: 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 63 68 61  incompatible cha
1320: 6e 67 65 73 20 74 6f 20 74 68 65 20 53 51 4c 69  nges to the SQLi
1330: 74 65 0a 20 20 66 69 6c 65 20 66 6f 72 6d 61 74  te.  file format
1340: 20 74 68 61 74 20 68 61 76 65 20 6f 63 63 75 72   that have occur
1350: 72 65 64 20 73 69 6e 63 65 20 76 65 72 73 69 6f  red since versio
1360: 6e 20 31 2e 30 2e 30 2e 0a 7d 0a 3c 2f 74 63 6c  n 1.0.0..}.</tcl
1370: 3e 0a 3c 2f 74 61 62 6c 65 3e 0a                 >.</table>.