Documentation Source Text

Hex Artifact Content
Login

Artifact b0c8fd61d46292b138ff12ddd25e210263d33e41:


0000: 0a 68 65 61 64 69 6e 67 20 7b 4f 76 65 72 76 69  .heading {Overvi
0010: 65 77 20 44 6f 63 75 6d 65 6e 74 73 7d 20 6f 76  ew Documents} ov
0020: 65 72 76 69 65 77 0a 0a 64 6f 63 20 7b 41 62 6f  erview..doc {Abo
0030: 75 74 20 53 51 4c 69 74 65 7d 20 7b 61 62 6f 75  ut SQLite} {abou
0040: 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 68 69  t.html} {.  A hi
0050: 67 68 2d 6c 65 76 65 6c 20 6f 76 65 72 76 69 65  gh-level overvie
0060: 77 20 6f 66 20 77 68 61 74 20 53 51 4c 69 74 65  w of what SQLite
0070: 20 69 73 20 61 6e 64 20 77 68 79 20 79 6f 75 20   is and why you 
0080: 6d 69 67 68 74 20 62 65 0a 20 20 69 6e 74 65 72  might be.  inter
0090: 65 73 74 65 64 20 69 6e 20 75 73 69 6e 67 20 69  ested in using i
00a0: 74 2e 0a 7d 0a 0a 64 6f 63 20 7b 41 70 70 72 6f  t..}..doc {Appro
00b0: 70 72 69 61 74 65 20 55 73 65 73 20 46 6f 72 20  priate Uses For 
00c0: 53 51 4c 69 74 65 7d 20 7b 77 68 65 6e 74 6f 75  SQLite} {whentou
00d0: 73 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69  se.html} {.  Thi
00e0: 73 20 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72  s document descr
00f0: 69 62 65 73 20 73 69 74 75 61 74 69 6f 6e 73 20  ibes situations 
0100: 77 68 65 72 65 20 53 51 4c 69 74 65 20 69 73 20  where SQLite is 
0110: 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 0a 20  an appropriate. 
0120: 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65   database engine
0130: 20 74 6f 20 75 73 65 20 76 65 72 73 75 73 20 73   to use versus s
0140: 69 74 75 61 74 69 6f 6e 73 20 77 68 65 72 65 20  ituations where 
0150: 61 20 63 6c 69 65 6e 74 2f 73 65 72 76 65 72 0a  a client/server.
0160: 20 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e    database engin
0170: 65 20 6d 69 67 68 74 20 62 65 20 61 20 62 65 74  e might be a bet
0180: 74 65 72 20 63 68 6f 69 63 65 2e 0a 7d 0a 64 6f  ter choice..}.do
0190: 63 20 7b 44 69 73 74 69 6e 63 74 69 76 65 20 46  c {Distinctive F
01a0: 65 61 74 75 72 65 73 7d 20 7b 64 69 66 66 65 72  eatures} {differ
01b0: 65 6e 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68  ent.html} {.  Th
01c0: 69 73 20 64 6f 63 75 6d 65 6e 74 20 65 6e 75 6d  is document enum
01d0: 65 72 61 74 65 73 20 61 6e 64 20 64 65 73 63 72  erates and descr
01e0: 69 62 65 73 20 73 6f 6d 65 20 6f 66 20 74 68 65  ibes some of the
01f0: 20 66 65 61 74 75 72 65 73 20 6f 66 0a 20 20 53   features of.  S
0200: 51 4c 69 74 65 20 74 68 61 74 20 6d 61 6b 65 20  QLite that make 
0210: 69 74 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f  it different fro
0220: 6d 20 6f 74 68 65 72 20 53 51 4c 20 64 61 74 61  m other SQL data
0230: 62 61 73 65 20 65 6e 67 69 6e 65 73 2e 0a 7d 0a  base engines..}.
0240: 64 6f 63 20 7b 48 6f 77 20 53 51 4c 69 74 65 20  doc {How SQLite 
0250: 49 73 20 54 65 73 74 65 64 7d 20 7b 74 65 73 74  Is Tested} {test
0260: 69 6e 67 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68  ing.html} {.  Th
0270: 65 20 72 65 6c 69 61 62 69 6c 69 74 79 20 61 6e  e reliability an
0280: 64 20 72 6f 62 75 73 74 6e 65 73 73 20 6f 66 20  d robustness of 
0290: 53 51 4c 69 74 65 20 69 73 20 61 63 68 69 65 76  SQLite is achiev
02a0: 65 64 20 69 6e 20 6c 61 72 67 65 20 70 61 72 74  ed in large part
02b0: 0a 20 20 62 79 20 74 68 6f 72 6f 75 67 68 20 61  .  by thorough a
02c0: 6e 64 20 63 61 72 65 66 75 6c 20 74 65 73 74 69  nd careful testi
02d0: 6e 67 2e 20 20 54 68 69 73 20 64 6f 63 75 6d 65  ng.  This docume
02e0: 6e 74 20 69 64 65 6e 74 69 66 69 65 73 20 74 68  nt identifies th
02f0: 65 0a 20 20 6d 61 6e 79 20 74 65 73 74 73 20 74  e.  many tests t
0300: 68 61 74 20 6f 63 63 75 72 20 62 65 66 6f 72 65  hat occur before
0310: 20 65 76 65 72 79 20 72 65 6c 65 61 73 65 20 6f   every release o
0320: 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 64 6f 63 20  f SQLite..}.doc 
0330: 7b 43 6f 70 79 72 69 67 68 74 7d 20 7b 63 6f 70  {Copyright} {cop
0340: 79 72 69 67 68 74 2e 68 74 6d 6c 7d 20 7b 0a 20  yright.html} {. 
0350: 20 53 51 4c 69 74 65 20 69 73 20 69 6e 20 74 68   SQLite is in th
0360: 65 20 70 75 62 6c 69 63 20 64 6f 6d 61 69 6e 2e  e public domain.
0370: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
0380: 64 65 73 63 72 69 62 65 73 20 77 68 61 74 20 74  describes what t
0390: 68 61 74 20 6d 65 61 6e 73 0a 20 20 61 6e 64 20  hat means.  and 
03a0: 74 68 65 20 69 6d 70 6c 69 63 61 74 69 6f 6e 73  the implications
03b0: 20 66 6f 72 20 63 6f 6e 74 72 69 62 75 74 6f 72   for contributor
03c0: 73 2e 0a 7d 0a 64 6f 63 20 7b 46 72 65 71 75 65  s..}.doc {Freque
03d0: 6e 74 6c 79 20 41 73 6b 65 64 20 51 75 65 73 74  ntly Asked Quest
03e0: 69 6f 6e 73 7d 20 7b 66 61 71 2e 68 74 6d 6c 7d  ions} {faq.html}
03f0: 20 7b 0a 20 20 54 68 65 20 74 69 74 6c 65 20 6f   {.  The title o
0400: 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 20 73  f the document s
0410: 61 79 73 20 61 6c 6c 2e 2e 2e 0a 7d 0a 64 6f 63  ays all....}.doc
0420: 20 7b 42 6f 6f 6b 73 20 41 62 6f 75 74 20 53 51   {Books About SQ
0430: 4c 69 74 65 7d 20 7b 62 6f 6f 6b 73 2e 68 74 6d  Lite} {books.htm
0440: 6c 7d 20 7b 0a 20 20 41 20 6c 69 73 74 20 6f 66  l} {.  A list of
0450: 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 77   independently w
0460: 72 69 74 74 65 6e 20 62 6f 6f 6b 73 20 61 62 6f  ritten books abo
0470: 75 74 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 68 65  ut SQLite..}..he
0480: 61 64 69 6e 67 20 7b 44 6f 63 75 6d 65 6e 74 20  ading {Document 
0490: 4c 69 73 74 73 20 41 6e 64 20 49 6e 64 65 78 65  Lists And Indexe
04a0: 73 7d 20 6c 69 73 74 73 0a 0a 64 6f 63 20 7b 41  s} lists..doc {A
04b0: 6c 70 68 61 62 65 74 69 63 61 6c 20 4c 69 73 74  lphabetical List
04c0: 69 6e 67 20 4f 66 20 44 6f 63 75 6d 65 6e 74 73  ing Of Documents
04d0: 7d 20 7b 64 6f 63 6c 69 73 74 2e 68 74 6d 6c 7d  } {doclist.html}
04e0: 20 7b 0a 20 20 41 20 6c 69 73 74 20 6f 66 20 61   {.  A list of a
04f0: 6c 6c 20 74 69 74 6c 65 64 20 70 61 67 65 73 20  ll titled pages 
0500: 6f 6e 20 74 68 69 73 20 77 65 62 73 69 74 65 2c  on this website,
0510: 20 73 6f 72 74 65 64 20 62 79 20 74 69 74 6c 65   sorted by title
0520: 2e 0a 7d 0a 64 6f 63 20 7b 57 65 62 73 69 74 65  ..}.doc {Website
0530: 20 4b 65 79 77 6f 72 64 20 49 6e 64 65 78 7d 20   Keyword Index} 
0540: 7b 6b 65 79 77 6f 72 64 5f 69 6e 64 65 78 2e 68  {keyword_index.h
0550: 74 6d 6c 7d 20 7b 0a 20 20 41 20 63 72 6f 73 73  tml} {.  A cross
0560: 2d 72 65 66 65 72 65 6e 63 65 20 66 72 6f 6d 20  -reference from 
0570: 6b 65 79 77 6f 72 64 73 20 74 6f 20 76 61 72 69  keywords to vari
0580: 6f 75 73 20 70 61 67 65 73 20 77 69 74 68 69 6e  ous pages within
0590: 20 74 68 69 73 20 77 65 62 73 69 74 65 2e 0a 7d   this website..}
05a0: 0a 64 6f 63 20 7b 50 65 72 6d 75 74 65 64 20 54  .doc {Permuted T
05b0: 69 74 6c 65 20 49 6e 64 65 78 7d 20 7b 73 69 74  itle Index} {sit
05c0: 65 6d 61 70 2e 68 74 6d 6c 23 70 69 6e 64 65 78  emap.html#pindex
05d0: 7d 20 7b 0a 20 20 41 6c 73 6f 20 6b 6e 6f 77 6e  } {.  Also known
05e0: 20 61 73 20 61 20 22 6b 65 79 77 6f 72 64 20 69   as a "keyword i
05f0: 6e 20 63 6f 6e 74 65 78 74 22 20 6f 72 20 22 4b  n context" or "K
0600: 57 49 43 22 20 69 6e 64 65 78 20 6f 72 20 61 73  WIC" index or as
0610: 20 61 20 63 6f 6e 63 6f 72 64 61 6e 63 65 2c 0a   a concordance,.
0620: 20 20 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    this document 
0630: 69 73 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20  is a listing of 
0640: 61 6c 6c 20 6f 74 68 65 72 20 64 6f 63 75 6d 65  all other docume
0650: 6e 74 73 20 73 6f 72 74 65 64 20 62 79 20 6b 65  nts sorted by ke
0660: 79 77 6f 72 64 2e 0a 7d 0a 0a 0a 68 65 61 64 69  yword..}...headi
0670: 6e 67 20 7b 53 51 4c 69 74 65 20 50 72 6f 67 72  ng {SQLite Progr
0680: 61 6d 6d 69 6e 67 20 49 6e 74 65 72 66 61 63 65  amming Interface
0690: 73 7d 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 7b  s} programming {
06a0: 0a 20 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e  .  Documentation
06b0: 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65 20   describing the 
06c0: 41 50 49 73 20 75 73 65 64 20 74 6f 20 70 72 6f  APIs used to pro
06d0: 67 72 61 6d 20 53 51 4c 69 74 65 2c 20 61 6e 64  gram SQLite, and
06e0: 20 74 68 65 20 53 51 4c 0a 20 20 64 69 61 6c 65   the SQL.  diale
06f0: 63 74 20 74 68 61 74 20 69 74 20 69 6e 74 65 72  ct that it inter
0700: 70 72 65 74 73 2e 0a 7d 0a 0a 64 6f 63 20 7b 53  prets..}..doc {S
0710: 51 4c 69 74 65 20 49 6e 20 35 20 4d 69 6e 75 74  QLite In 5 Minut
0720: 65 73 20 4f 72 20 4c 65 73 73 7d 20 7b 71 75 69  es Or Less} {qui
0730: 63 6b 73 74 61 72 74 2e 68 74 6d 6c 7d 20 7b 0a  ckstart.html} {.
0740: 20 20 41 20 76 65 72 79 20 71 75 69 63 6b 20 69    A very quick i
0750: 6e 74 72 6f 64 75 63 74 69 6f 6e 20 74 6f 20 70  ntroduction to p
0760: 72 6f 67 72 61 6d 6d 69 6e 67 20 77 69 74 68 20  rogramming with 
0770: 53 51 4c 69 74 65 2e 0a 7d 0a 64 6f 63 20 7b 49  SQLite..}.doc {I
0780: 6e 74 72 6f 64 75 63 74 69 6f 6e 20 74 6f 20 74  ntroduction to t
0790: 68 65 20 43 2f 43 2b 2b 20 41 50 49 20 7d 20 7b  he C/C++ API } {
07a0: 63 69 6e 74 72 6f 2e 68 74 6d 6c 7d 20 7b 0a 20  cintro.html} {. 
07b0: 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 69   This document i
07c0: 6e 74 72 6f 64 75 63 65 73 20 74 68 65 20 43 2f  ntroduces the C/
07d0: 43 2b 2b 20 41 50 49 2e 20 55 73 65 72 73 20 73  C++ API. Users s
07e0: 68 6f 75 6c 64 20 72 65 61 64 20 74 68 69 73 20  hould read this 
07f0: 64 6f 63 75 6d 65 6e 74 20 0a 20 20 62 65 66 6f  document .  befo
0800: 72 65 20 74 68 65 20 43 2f 43 2b 2b 20 41 50 49  re the C/C++ API
0810: 20 52 65 66 65 72 65 6e 63 65 20 47 75 69 64 65   Reference Guide
0820: 20 6c 69 6e 6b 65 64 20 62 65 6c 6f 77 2e 0a 7d   linked below..}
0830: 0a 64 6f 63 20 7b 48 6f 77 20 54 6f 20 43 6f 6d  .doc {How To Com
0840: 70 69 6c 65 20 53 51 4c 69 74 65 7d 20 7b 68 6f  pile SQLite} {ho
0850: 77 74 6f 63 6f 6d 70 69 6c 65 2e 68 74 6d 6c 7d  wtocompile.html}
0860: 20 7b 0a 20 20 49 6e 73 74 72 75 63 74 69 6f 6e   {.  Instruction
0870: 73 20 61 6e 64 20 68 69 6e 74 73 20 66 6f 72 20  s and hints for 
0880: 63 6f 6d 70 69 6c 69 6e 67 20 53 51 4c 69 74 65  compiling SQLite
0890: 20 43 20 63 6f 64 65 20 61 6e 64 20 69 6e 74 65   C code and inte
08a0: 67 72 61 74 69 6e 67 0a 20 20 74 68 61 74 20 63  grating.  that c
08b0: 6f 64 65 20 77 69 74 68 20 79 6f 75 72 20 6f 77  ode with your ow
08c0: 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0a 7d  n application..}
08d0: 0a 64 6f 63 20 7b 43 2f 43 2b 2b 20 41 50 49 20  .doc {C/C++ API 
08e0: 52 65 66 65 72 65 6e 63 65 7d 20 7b 63 33 72 65  Reference} {c3re
08f0: 66 2f 69 6e 74 72 6f 2e 68 74 6d 6c 7d 20 7b 0a  f/intro.html} {.
0900: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
0910: 64 65 73 63 72 69 62 65 73 20 65 61 63 68 20 41  describes each A
0920: 50 49 20 66 75 6e 63 74 69 6f 6e 20 73 65 70 61  PI function sepa
0930: 72 61 74 65 6c 79 2e 0a 7d 0a 64 6f 63 20 7b 52  rately..}.doc {R
0940: 65 73 75 6c 74 20 43 6f 64 65 73 7d 20 7b 72 65  esult Codes} {re
0950: 73 63 6f 64 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20  scode.html} {.  
0960: 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66  A description of
0970: 20 74 68 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66   the meanings of
0980: 20 74 68 65 20 6e 75 6d 65 72 69 63 20 72 65 73   the numeric res
0990: 75 6c 74 20 63 6f 64 65 73 0a 20 20 72 65 74 75  ult codes.  retu
09a0: 72 6e 65 64 20 62 79 20 76 61 72 69 6f 75 73 20  rned by various 
09b0: 43 2f 43 2b 2b 20 69 6e 74 65 72 66 61 63 65 73  C/C++ interfaces
09c0: 2e 0a 7d 0a 64 6f 63 20 7b 54 63 6c 20 41 50 49  ..}.doc {Tcl API
09d0: 7d 20 7b 74 63 6c 73 71 6c 69 74 65 2e 68 74 6d  } {tclsqlite.htm
09e0: 6c 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70  l} {.  A descrip
09f0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 54 43 4c 20  tion of the TCL 
0a00: 69 6e 74 65 72 66 61 63 65 20 62 69 6e 64 69 6e  interface bindin
0a10: 67 73 20 66 6f 72 20 53 51 4c 69 74 65 2e 0a 7d  gs for SQLite..}
0a20: 0a 64 6f 63 20 7b 53 51 4c 20 53 79 6e 74 61 78  .doc {SQL Syntax
0a30: 7d 20 7b 6c 61 6e 67 2e 68 74 6d 6c 7d 20 7b 0a  } {lang.html} {.
0a40: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
0a50: 64 65 73 63 72 69 62 65 73 20 74 68 65 20 53 51  describes the SQ
0a60: 4c 20 6c 61 6e 67 75 61 67 65 20 74 68 61 74 20  L language that 
0a70: 69 73 20 75 6e 64 65 72 73 74 6f 6f 64 20 62 79  is understood by
0a80: 0a 20 20 53 51 4c 69 74 65 2e 20 20 0a 7d 0a 64  .  SQLite.  .}.d
0a90: 6f 63 20 7b 50 72 61 67 6d 61 20 63 6f 6d 6d 61  oc {Pragma comma
0aa0: 6e 64 73 7d 20 7b 70 72 61 67 6d 61 2e 68 74 6d  nds} {pragma.htm
0ab0: 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 75  l} {.  This docu
0ac0: 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20 53  ment describes S
0ad0: 51 4c 69 74 65 20 70 65 72 66 6f 72 6d 61 6e 63  QLite performanc
0ae0: 65 20 74 75 6e 69 6e 67 20 6f 70 74 69 6f 6e 73  e tuning options
0af0: 20 61 6e 64 20 6f 74 68 65 72 20 0a 20 20 73 70   and other .  sp
0b00: 65 63 69 61 6c 20 70 75 72 70 6f 73 65 20 64 61  ecial purpose da
0b10: 74 61 62 61 73 65 20 63 6f 6d 6d 61 6e 64 73 2e  tabase commands.
0b20: 0a 7d 0a 64 6f 63 20 7b 43 6f 72 65 20 53 51 4c  .}.doc {Core SQL
0b30: 20 46 75 6e 63 74 69 6f 6e 73 7d 20 7b 6c 61 6e   Functions} {lan
0b40: 67 5f 63 6f 72 65 66 75 6e 63 2e 68 74 6d 6c 7d  g_corefunc.html}
0b50: 20 7b 0a 20 20 47 65 6e 65 72 61 6c 2d 70 75 72   {.  General-pur
0b60: 70 6f 73 65 20 62 75 69 6c 74 2d 69 6e 20 73 63  pose built-in sc
0b70: 61 6c 61 72 20 53 51 4c 20 66 75 6e 63 74 69 6f  alar SQL functio
0b80: 6e 73 2e 0a 7d 0a 64 6f 63 20 7b 41 67 67 72 65  ns..}.doc {Aggre
0b90: 67 61 74 65 20 53 51 4c 20 46 75 6e 63 74 69 6f  gate SQL Functio
0ba0: 6e 73 7d 20 7b 6c 61 6e 67 5f 61 67 67 66 75 6e  ns} {lang_aggfun
0bb0: 63 2e 68 74 6d 6c 7d 20 7b 0a 20 20 47 65 6e 65  c.html} {.  Gene
0bc0: 72 61 6c 2d 70 75 72 70 6f 73 65 20 62 75 69 6c  ral-purpose buil
0bd0: 74 2d 69 6e 20 61 67 67 72 65 67 61 74 65 20 53  t-in aggregate S
0be0: 51 4c 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 7d 0a  QL functions..}.
0bf0: 64 6f 63 20 7b 44 61 74 65 20 61 6e 64 20 54 69  doc {Date and Ti
0c00: 6d 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73  me SQL Functions
0c10: 7d 20 7b 6c 61 6e 67 5f 64 61 74 65 66 75 6e 63  } {lang_datefunc
0c20: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c 20 66  .html} {.  SQL f
0c30: 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 6d 61 6e  unctions for man
0c40: 69 70 75 6c 61 74 69 6e 67 20 64 61 74 65 73 20  ipulating dates 
0c50: 61 6e 64 20 74 69 6d 65 73 2e 0a 7d 0a 64 6f 63  and times..}.doc
0c60: 20 7b 44 61 74 61 54 79 70 65 73 7d 20 7b 64 61   {DataTypes} {da
0c70: 74 61 74 79 70 65 33 2e 68 74 6d 6c 7d 20 7b 0a  tatype3.html} {.
0c80: 20 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e    SQLite version
0c90: 20 33 20 69 6e 74 72 6f 64 75 63 65 73 20 74 68   3 introduces th
0ca0: 65 20 63 6f 6e 63 65 70 74 20 6f 66 20 6d 61 6e  e concept of man
0cb0: 69 66 65 73 74 20 74 79 70 69 6e 67 2c 20 77 68  ifest typing, wh
0cc0: 65 72 65 20 74 68 65 0a 20 20 74 79 70 65 20 6f  ere the.  type o
0cd0: 66 20 61 20 76 61 6c 75 65 20 69 73 20 61 73 73  f a value is ass
0ce0: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65  ociated with the
0cf0: 20 76 61 6c 75 65 20 69 74 73 65 6c 66 2c 20 6e   value itself, n
0d00: 6f 74 20 74 68 65 20 63 6f 6c 75 6d 6e 20 74 68  ot the column th
0d10: 61 74 0a 20 20 69 74 20 69 73 20 73 74 6f 72 65  at.  it is store
0d20: 64 20 69 6e 2e 0a 20 20 54 68 69 73 20 70 61 67  d in..  This pag
0d30: 65 20 64 65 73 63 72 69 62 65 73 20 64 61 74 61  e describes data
0d40: 20 74 79 70 69 6e 67 20 66 6f 72 20 53 51 4c 69   typing for SQLi
0d50: 74 65 20 76 65 72 73 69 6f 6e 20 33 20 69 6e 20  te version 3 in 
0d60: 66 75 72 74 68 65 72 20 64 65 74 61 69 6c 2e 0a  further detail..
0d70: 7d 0a 0a 68 65 61 64 69 6e 67 20 7b 53 51 4c 69  }..heading {SQLi
0d80: 74 65 20 45 78 74 65 6e 73 69 6f 6e 73 7d 20 65  te Extensions} e
0d90: 78 74 65 6e 73 69 6f 6e 73 20 7b 0a 7d 0a 64 6f  xtensions {.}.do
0da0: 63 20 7b 4a 73 6f 6e 31 20 2d 20 4a 53 4f 4e 20  c {Json1 - JSON 
0db0: 49 6e 74 65 67 72 61 74 69 6f 6e 7d 20 7b 6a 73  Integration} {js
0dc0: 6f 6e 31 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51  on1.html} {.  SQ
0dd0: 4c 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20  L functions for 
0de0: 63 72 65 61 74 69 6e 67 2c 20 70 61 72 73 69 6e  creating, parsin
0df0: 67 2c 20 61 6e 64 20 71 75 65 72 79 69 6e 67 20  g, and querying 
0e00: 4a 53 4f 4e 20 63 6f 6e 74 65 6e 74 2e 0a 7d 0a  JSON content..}.
0e10: 64 6f 63 20 7b 46 54 53 35 20 2d 20 46 75 6c 6c  doc {FTS5 - Full
0e20: 20 54 65 78 74 20 53 65 61 72 63 68 7d 20 7b 66   Text Search} {f
0e30: 74 73 35 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20  ts5.html} {.  A 
0e40: 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74  description of t
0e50: 68 65 20 53 51 4c 69 74 65 20 46 75 6c 6c 20 54  he SQLite Full T
0e60: 65 78 74 20 53 65 61 72 63 68 20 28 46 54 53 35  ext Search (FTS5
0e70: 29 20 65 78 74 65 6e 73 69 6f 6e 2e 0a 7d 0a 64  ) extension..}.d
0e80: 6f 63 20 7b 46 54 53 33 20 2d 20 46 75 6c 6c 20  oc {FTS3 - Full 
0e90: 54 65 78 74 20 53 65 61 72 63 68 7d 20 7b 66 74  Text Search} {ft
0ea0: 73 33 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64  s3.html} {.  A d
0eb0: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68  escription of th
0ec0: 65 20 53 51 4c 69 74 65 20 46 75 6c 6c 20 54 65  e SQLite Full Te
0ed0: 78 74 20 53 65 61 72 63 68 20 28 46 54 53 33 29  xt Search (FTS3)
0ee0: 20 65 78 74 65 6e 73 69 6f 6e 2e 0a 7d 0a 64 6f   extension..}.do
0ef0: 63 20 7b 52 2d 54 72 65 65 20 4d 6f 64 75 6c 65  c {R-Tree Module
0f00: 7d 20 7b 72 74 72 65 65 2e 68 74 6d 6c 7d 20 7b  } {rtree.html} {
0f10: 0a 20 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e  .  A description
0f20: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 52   of the SQLite R
0f30: 2d 54 72 65 65 20 65 78 74 65 6e 73 69 6f 6e 2e  -Tree extension.
0f40: 20 41 6e 20 52 2d 54 72 65 65 20 69 73 20 61 20   An R-Tree is a 
0f50: 73 70 65 63 69 61 6c 69 7a 65 64 0a 20 20 64 61  specialized.  da
0f60: 74 61 20 73 74 72 75 63 74 75 72 65 20 74 68 61  ta structure tha
0f70: 74 20 73 75 70 70 6f 72 74 73 20 66 61 73 74 20  t supports fast 
0f80: 6d 75 6c 74 69 2d 64 69 6d 65 6e 73 69 6f 6e 61  multi-dimensiona
0f90: 6c 20 72 61 6e 67 65 20 71 75 65 72 69 65 73 20  l range queries 
0fa0: 6f 66 74 65 6e 0a 20 20 75 73 65 64 20 69 6e 20  often.  used in 
0fb0: 67 65 6f 73 70 61 74 69 61 6c 20 73 79 73 74 65  geospatial syste
0fc0: 6d 73 2e 0a 7d 0a 64 6f 63 20 7b 53 65 73 73 69  ms..}.doc {Sessi
0fd0: 6f 6e 73 7d 20 7b 73 65 73 73 69 6f 6e 69 6e 74  ons} {sessionint
0fe0: 72 6f 2e 68 74 6d 6c 7d 20 7b 0a 7d 0a 64 6f 63  ro.html} {.}.doc
0ff0: 20 7b 52 42 55 7d 20 7b 72 62 75 2e 68 74 6d 6c   {RBU} {rbu.html
1000: 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70 74  } {.  A descript
1010: 69 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c 69 74  ion of the SQLit
1020: 65 20 52 2d 54 72 65 65 20 65 78 74 65 6e 73 69  e R-Tree extensi
1030: 6f 6e 2e 20 41 6e 20 52 2d 54 72 65 65 20 69 73  on. An R-Tree is
1040: 20 61 20 73 70 65 63 69 61 6c 69 7a 65 64 0a 20   a specialized. 
1050: 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65 20   data structure 
1060: 74 68 61 74 20 73 75 70 70 6f 72 74 73 20 66 61  that supports fa
1070: 73 74 20 6d 75 6c 74 69 2d 64 69 6d 65 6e 73 69  st multi-dimensi
1080: 6f 6e 61 6c 20 72 61 6e 67 65 20 71 75 65 72 69  onal range queri
1090: 65 73 20 6f 66 74 65 6e 0a 20 20 75 73 65 64 20  es often.  used 
10a0: 69 6e 20 67 65 6f 73 70 61 74 69 61 6c 20 73 79  in geospatial sy
10b0: 73 74 65 6d 73 2e 0a 7d 0a 64 6f 63 20 7b 53 70  stems..}.doc {Sp
10c0: 65 6c 6c 66 69 78 31 7d 20 7b 73 70 65 6c 6c 66  ellfix1} {spellf
10d0: 69 78 31 2e 68 74 6d 6c 7d 20 7b 0a 7d 0a 64 6f  ix1.html} {.}.do
10e0: 63 20 7b 44 62 73 74 61 74 20 56 69 72 74 75 61  c {Dbstat Virtua
10f0: 6c 20 54 61 62 6c 65 7d 20 7b 64 62 73 74 61 74  l Table} {dbstat
1100: 2e 68 74 6d 6c 7d 20 7b 0a 7d 0a 64 6f 63 20 7b  .html} {.}.doc {
1110: 43 73 76 20 56 69 72 74 75 61 6c 20 54 61 62 6c  Csv Virtual Tabl
1120: 65 7d 20 7b 63 73 76 2e 68 74 6d 6c 7d 20 7b 0a  e} {csv.html} {.
1130: 7d 0a 64 6f 63 20 7b 43 61 72 72 61 79 7d 20 7b  }.doc {Carray} {
1140: 63 61 72 72 61 79 2e 68 74 6d 6c 7d 20 7b 0a 7d  carray.html} {.}
1150: 0a 64 6f 63 20 7b 52 75 6e 2d 54 69 6d 65 20 4c  .doc {Run-Time L
1160: 6f 61 64 61 62 6c 65 20 45 78 74 65 6e 73 69 6f  oadable Extensio
1170: 6e 73 7d 20 7b 6c 6f 61 64 65 78 74 2e 68 74 6d  ns} {loadext.htm
1180: 6c 7d 20 7b 0a 20 20 41 20 67 65 6e 65 72 61 6c  l} {.  A general
1190: 20 6f 76 65 72 76 69 65 77 20 6f 6e 20 68 6f 77   overview on how
11a0: 20 72 75 6e 2d 74 69 6d 65 20 6c 6f 61 64 61 62   run-time loadab
11b0: 6c 65 20 65 78 74 65 6e 73 69 6f 6e 73 20 77 6f  le extensions wo
11c0: 72 6b 2c 20 68 6f 77 20 74 68 65 79 0a 20 20 61  rk, how they.  a
11d0: 72 65 20 63 6f 6d 70 69 6c 65 64 2c 20 61 6e 64  re compiled, and
11e0: 20 68 6f 77 20 64 65 76 65 6c 6f 70 65 72 73 20   how developers 
11f0: 63 61 6e 20 63 72 65 61 74 65 20 74 68 65 69 72  can create their
1200: 20 6f 77 6e 20 72 75 6e 2d 74 69 6d 65 20 6c 6f   own run-time lo
1210: 61 64 61 62 6c 65 0a 20 20 65 78 74 65 6e 73 69  adable.  extensi
1220: 6f 6e 73 20 66 6f 72 20 53 51 4c 69 74 65 2e 0a  ons for SQLite..
1230: 7d 0a 0a 0a 0a 0a 68 65 61 64 69 6e 67 20 7b 53  }.....heading {S
1240: 51 4c 69 74 65 20 46 65 61 74 75 72 65 73 7d 20  QLite Features} 
1250: 66 65 61 74 75 72 65 73 20 7b 0a 20 20 50 61 67  features {.  Pag
1260: 65 73 20 64 65 73 63 72 69 62 69 6e 67 20 73 70  es describing sp
1270: 65 63 69 66 69 63 20 66 65 61 74 75 72 65 73 20  ecific features 
1280: 6f 72 20 65 78 74 65 6e 73 69 6f 6e 20 6d 6f 64  or extension mod
1290: 75 6c 65 73 20 6f 66 20 53 51 4c 69 74 65 2e 0a  ules of SQLite..
12a0: 7d 0a 64 6f 63 20 7b 38 2b 33 20 46 69 6c 65 6e  }.doc {8+3 Filen
12b0: 61 6d 65 73 7d 20 7b 73 68 6f 72 74 6e 61 6d 65  ames} {shortname
12c0: 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 48 6f 77 20  s.html} {.  How 
12d0: 74 6f 20 6d 61 6b 65 20 53 51 4c 69 74 65 20 77  to make SQLite w
12e0: 6f 72 6b 20 6f 6e 20 66 69 6c 65 73 79 73 74 65  ork on filesyste
12f0: 6d 73 20 74 68 61 74 20 6f 6e 6c 79 20 73 75 70  ms that only sup
1300: 70 6f 72 74 20 0a 20 20 38 2b 33 20 66 69 6c 65  port .  8+3 file
1310: 6e 61 6d 65 73 2e 0a 7d 0a 64 6f 63 20 7b 41 75  names..}.doc {Au
1320: 74 6f 69 6e 63 72 65 6d 65 6e 74 7d 20 7b 61 75  toincrement} {au
1330: 74 6f 69 6e 63 2e 68 74 6d 6c 7d 20 7b 0a 20 20  toinc.html} {.  
1340: 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66  A description of
1350: 20 74 68 65 20 41 55 54 4f 49 4e 43 52 45 4d 45   the AUTOINCREME
1360: 4e 54 20 6b 65 79 77 6f 72 64 20 69 6e 20 53 51  NT keyword in SQ
1370: 4c 69 74 65 2c 20 77 68 61 74 20 69 74 20 64 6f  Lite, what it do
1380: 65 73 2c 0a 20 20 77 68 79 20 69 74 20 69 73 20  es,.  why it is 
1390: 73 6f 6d 65 74 69 6d 65 73 20 75 73 65 66 75 6c  sometimes useful
13a0: 2c 20 61 6e 64 20 77 68 79 20 69 74 20 73 68 6f  , and why it sho
13b0: 75 6c 64 20 62 65 20 61 76 6f 69 64 65 64 20 69  uld be avoided i
13c0: 66 20 6e 6f 74 0a 20 20 73 74 72 69 63 74 6c 79  f not.  strictly
13d0: 20 6e 65 63 65 73 73 61 72 79 2e 0a 7d 0a 64 6f   necessary..}.do
13e0: 63 20 7b 42 61 63 6b 75 70 20 41 50 49 7d 20 7b  c {Backup API} {
13f0: 62 61 63 6b 75 70 2e 68 74 6d 6c 7d 20 7b 0a 20  backup.html} {. 
1400: 20 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 62 61   The [sqlite3_ba
1410: 63 6b 75 70 5f 69 6e 69 74 20 7c 20 6f 6e 6c 69  ckup_init | onli
1420: 6e 65 2d 62 61 63 6b 75 70 20 69 6e 74 65 72 66  ne-backup interf
1430: 61 63 65 5d 20 63 61 6e 20 62 65 20 75 73 65 64  ace] can be used
1440: 20 74 6f 0a 20 20 63 6f 70 79 20 63 6f 6e 74 65   to.  copy conte
1450: 6e 74 20 66 72 6f 6d 20 61 20 64 69 73 6b 20 66  nt from a disk f
1460: 69 6c 65 20 69 6e 74 6f 20 61 6e 20 69 6e 2d 6d  ile into an in-m
1470: 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 20 6f  emory database o
1480: 72 20 76 69 63 65 0a 20 20 76 65 72 73 61 20 61  r vice.  versa a
1490: 6e 64 20 69 74 20 63 61 6e 20 6d 61 6b 65 20 61  nd it can make a
14a0: 20 68 6f 74 20 62 61 63 6b 75 70 20 6f 66 20 61   hot backup of a
14b0: 20 6c 69 76 65 20 64 61 74 61 62 61 73 65 2e 20   live database. 
14c0: 20 54 68 69 73 20 61 70 70 6c 69 63 61 74 69 6f   This applicatio
14d0: 6e 0a 20 20 6e 6f 74 65 20 67 69 76 65 73 20 65  n.  note gives e
14e0: 78 61 6d 70 6c 65 73 20 6f 66 20 68 6f 77 2e 0a  xamples of how..
14f0: 7d 0a 64 6f 63 20 7b 43 6f 6d 6d 61 6e 64 2d 4c  }.doc {Command-L
1500: 69 6e 65 20 53 68 65 6c 6c 7d 20 7b 63 6c 69 2e  ine Shell} {cli.
1510: 68 74 6d 6c 7d 20 7b 0a 20 20 4e 6f 74 65 73 20  html} {.  Notes 
1520: 6f 6e 20 75 73 69 6e 67 20 74 68 65 20 22 73 71  on using the "sq
1530: 6c 69 74 65 33 2e 65 78 65 22 20 63 6f 6d 6d 61  lite3.exe" comma
1540: 6e 64 2d 6c 69 6e 65 20 69 6e 74 65 72 66 61 63  nd-line interfac
1550: 65 20 74 68 61 74 0a 20 20 63 61 6e 20 62 65 20  e that.  can be 
1560: 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 2c 20  used to create, 
1570: 6d 6f 64 69 66 79 2c 20 61 6e 64 20 71 75 65 72  modify, and quer
1580: 79 20 61 72 62 69 74 72 61 72 79 20 53 51 4c 69  y arbitrary SQLi
1590: 74 65 0a 20 20 64 61 74 61 62 61 73 65 20 66 69  te.  database fi
15a0: 6c 65 73 2e 0a 7d 0a 64 6f 63 20 7b 45 72 72 6f  les..}.doc {Erro
15b0: 72 20 61 6e 64 20 57 61 72 6e 69 6e 67 20 4c 6f  r and Warning Lo
15c0: 67 7d 20 7b 65 72 72 6c 6f 67 2e 68 74 6d 6c 7d  g} {errlog.html}
15d0: 20 7b 0a 20 20 53 51 4c 69 74 65 20 73 75 70 70   {.  SQLite supp
15e0: 6f 72 74 73 20 61 6e 20 22 65 72 72 6f 72 20 61  orts an "error a
15f0: 6e 64 20 77 61 72 6e 69 6e 67 20 6c 6f 67 22 20  nd warning log" 
1600: 64 65 73 69 67 6e 20 74 6f 20 63 61 70 74 75 72  design to captur
1610: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 20 20  e information.  
1620: 61 62 6f 75 74 20 73 75 73 70 69 63 69 6f 75 73  about suspicious
1630: 20 61 6e 64 2f 6f 72 20 65 72 72 6f 72 20 65 76   and/or error ev
1640: 65 6e 74 73 20 64 75 72 69 6e 67 20 6f 70 65 72  ents during oper
1650: 61 74 69 6f 6e 2e 20 20 45 6d 62 65 64 64 65 64  ation.  Embedded
1660: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 0a 20 20   applications.  
1670: 61 72 65 20 65 6e 63 6f 75 72 61 67 65 64 20 74  are encouraged t
1680: 6f 20 65 6e 61 62 6c 65 20 74 68 65 20 65 72 72  o enable the err
1690: 6f 72 20 61 6e 64 20 77 61 72 6e 69 6e 67 20 6c  or and warning l
16a0: 6f 67 20 74 6f 20 68 65 6c 70 20 77 69 74 68 20  og to help with 
16b0: 64 65 62 75 67 67 69 6e 67 0a 20 20 61 70 70 6c  debugging.  appl
16c0: 69 63 61 74 69 6f 6e 20 70 72 6f 62 6c 65 6d 73  ication problems
16d0: 20 74 68 61 74 20 61 72 69 73 65 20 69 6e 20 74   that arise in t
16e0: 68 65 20 66 69 65 6c 64 2e 20 20 54 68 69 73 20  he field.  This 
16f0: 64 6f 63 75 6d 65 6e 74 20 65 78 70 6c 61 69 6e  document explain
1700: 73 20 68 6f 77 0a 20 20 74 6f 20 64 6f 20 74 68  s how.  to do th
1710: 61 74 2e 0a 7d 0a 64 6f 63 20 7b 46 6f 72 65 69  at..}.doc {Forei
1720: 67 6e 20 4b 65 79 20 53 75 70 70 6f 72 74 7d 20  gn Key Support} 
1730: 7b 66 6f 72 65 69 67 6e 6b 65 79 73 2e 68 74 6d  {foreignkeys.htm
1740: 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 75  l} {.  This docu
1750: 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20 74  ment describes t
1760: 68 65 20 73 75 70 70 6f 72 74 20 66 6f 72 20 66  he support for f
1770: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
1780: 72 61 69 6e 74 73 20 69 6e 74 72 6f 64 75 63 65  raints introduce
1790: 64 0a 20 20 69 6e 20 76 65 72 73 69 6f 6e 20 33  d.  in version 3
17a0: 2e 36 2e 31 39 2e 0a 7d 0a 64 6f 63 20 7b 49 6e  .6.19..}.doc {In
17b0: 64 65 78 65 73 20 4f 6e 20 45 78 70 72 65 73 73  dexes On Express
17c0: 69 6f 6e 73 7d 20 7b 65 78 70 72 69 64 78 2e 68  ions} {expridx.h
17d0: 74 6d 6c 7d 20 7b 0a 20 20 4e 6f 74 65 73 20 6f  tml} {.  Notes o
17e0: 6e 20 68 6f 77 20 74 6f 20 63 72 65 61 74 65 20  n how to create 
17f0: 69 6e 64 65 78 65 73 20 6f 6e 20 65 78 70 72 65  indexes on expre
1800: 73 73 69 6f 6e 73 20 69 6e 73 74 65 61 64 20 6f  ssions instead o
1810: 66 20 6a 75 73 74 0a 20 20 69 6e 64 69 76 69 64  f just.  individ
1820: 75 61 6c 20 63 6f 6c 75 6d 6e 73 2e 0a 7d 0a 64  ual columns..}.d
1830: 6f 63 20 7b 49 6e 74 65 72 6e 61 6c 20 76 65 72  oc {Internal ver
1840: 73 75 73 20 45 78 74 65 72 6e 61 6c 20 42 6c 6f  sus External Blo
1850: 62 20 53 74 6f 72 61 67 65 7d 20 7b 69 6e 74 65  b Storage} {inte
1860: 72 6e 2d 76 2d 65 78 74 65 72 6e 2d 62 6c 6f 62  rn-v-extern-blob
1870: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 68 6f 75 6c  .html} {.  Shoul
1880: 64 20 79 6f 75 20 73 74 6f 72 65 20 6c 61 72 67  d you store larg
1890: 65 20 42 4c 4f 42 73 20 64 69 72 65 63 74 6c 79  e BLOBs directly
18a0: 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65   in the database
18b0: 2c 20 6f 72 20 73 74 6f 72 65 20 74 68 65 6d 0a  , or store them.
18c0: 20 20 69 6e 20 66 69 6c 65 73 20 61 6e 64 20 6a    in files and j
18d0: 75 73 74 20 72 65 63 6f 72 64 20 74 68 65 20 66  ust record the f
18e0: 69 6c 65 6e 61 6d 65 20 69 6e 20 74 68 65 20 64  ilename in the d
18f0: 61 74 61 62 61 73 65 3f 20 20 54 68 69 73 20 64  atabase?  This d
1900: 6f 63 75 6d 65 6e 74 0a 20 20 73 65 65 6b 73 20  ocument.  seeks 
1910: 74 6f 20 73 68 65 64 20 6c 69 67 68 74 20 6f 6e  to shed light on
1920: 20 74 68 61 74 20 71 75 65 73 74 69 6f 6e 2e 0a   that question..
1930: 7d 0a 64 6f 63 20 7b 4c 69 6d 69 74 73 20 49 6e  }.doc {Limits In
1940: 20 53 51 4c 69 74 65 7d 20 7b 6c 69 6d 69 74 73   SQLite} {limits
1950: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20  .html} {.  This 
1960: 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62  document describ
1970: 65 73 20 6c 69 6d 69 74 61 74 69 6f 6e 73 20 6f  es limitations o
1980: 66 20 53 51 4c 69 74 65 20 28 74 68 65 20 6d 61  f SQLite (the ma
1990: 78 69 6d 75 6d 20 6c 65 6e 67 74 68 20 6f 66 20  ximum length of 
19a0: 61 0a 20 20 73 74 72 69 6e 67 20 6f 72 20 62 6c  a.  string or bl
19b0: 6f 62 2c 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  ob, the maximum 
19c0: 73 69 7a 65 20 6f 66 20 61 20 64 61 74 61 62 61  size of a databa
19d0: 73 65 2c 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  se, the maximum 
19e0: 6e 75 6d 62 65 72 20 6f 66 0a 20 20 74 61 62 6c  number of.  tabl
19f0: 65 73 20 69 6e 20 61 20 64 61 74 61 62 61 73 65  es in a database
1a00: 2c 20 65 74 63 2e 29 20 61 6e 64 20 68 6f 77 20  , etc.) and how 
1a10: 74 68 65 73 65 20 6c 69 6d 69 74 73 20 63 61 6e  these limits can
1a20: 20 62 65 20 61 6c 74 65 72 65 64 20 61 74 0a 20   be altered at. 
1a30: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 61 6e   compile-time an
1a40: 64 20 72 75 6e 2d 74 69 6d 65 2e 0a 7d 0a 64 6f  d run-time..}.do
1a50: 63 20 7b 4d 65 6d 6f 72 79 2d 4d 61 70 70 65 64  c {Memory-Mapped
1a60: 20 49 2f 4f 7d 20 7b 6d 6d 61 70 2e 68 74 6d 6c   I/O} {mmap.html
1a70: 7d 20 7b 0a 20 20 53 51 4c 69 74 65 20 73 75 70  } {.  SQLite sup
1a80: 70 6f 72 74 73 20 6d 65 6d 6f 72 79 2d 6d 61 70  ports memory-map
1a90: 70 65 64 20 49 2f 4f 2e 20 20 4c 65 61 72 6e 20  ped I/O.  Learn 
1aa0: 68 6f 77 20 74 6f 20 65 6e 61 62 6c 65 20 6d 65  how to enable me
1ab0: 6d 6f 72 79 2d 6d 61 70 70 65 64 0a 20 20 49 2f  mory-mapped.  I/
1ac0: 4f 20 61 6e 64 20 61 62 6f 75 74 20 74 68 65 20  O and about the 
1ad0: 76 61 72 69 6f 75 73 20 61 64 76 61 6e 74 61 67  various advantag
1ae0: 65 73 20 61 6e 64 20 64 69 73 61 64 76 61 6e 74  es and disadvant
1af0: 61 67 65 73 20 74 6f 20 75 73 69 6e 67 0a 20 20  ages to using.  
1b00: 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f  memory-mapped I/
1b10: 4f 20 69 6e 20 74 68 69 73 20 64 6f 63 75 6d 65  O in this docume
1b20: 6e 74 2e 0a 7d 0a 64 6f 63 20 7b 4d 75 6c 74 69  nt..}.doc {Multi
1b30: 2d 74 68 72 65 61 64 65 64 20 50 72 6f 67 72 61  -threaded Progra
1b40: 6d 73 20 61 6e 64 20 53 51 4c 69 74 65 7d 20 7b  ms and SQLite} {
1b50: 74 68 72 65 61 64 73 61 66 65 2e 68 74 6d 6c 7d  threadsafe.html}
1b60: 20 7b 0a 20 20 53 51 4c 69 74 65 20 69 73 20 73   {.  SQLite is s
1b70: 61 66 65 20 74 6f 20 75 73 65 20 69 6e 20 6d 75  afe to use in mu
1b80: 6c 74 69 2d 74 68 72 65 61 64 65 64 20 70 72 6f  lti-threaded pro
1b90: 67 72 61 6d 73 2e 20 20 54 68 69 73 20 64 6f 63  grams.  This doc
1ba0: 75 6d 65 6e 74 0a 20 20 70 72 6f 76 69 64 65 73  ument.  provides
1bb0: 20 74 68 65 20 64 65 74 61 69 6c 73 20 61 6e 64   the details and
1bc0: 20 68 69 6e 74 73 20 6f 6e 20 68 6f 77 20 74 6f   hints on how to
1bd0: 20 6d 61 78 69 6d 69 7a 65 20 70 65 72 66 6f 72   maximize perfor
1be0: 6d 61 6e 63 65 2e 0a 7d 0a 64 6f 63 20 7b 4e 75  mance..}.doc {Nu
1bf0: 6c 6c 20 48 61 6e 64 6c 69 6e 67 7d 20 7b 6e 75  ll Handling} {nu
1c00: 6c 6c 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 44 69  lls.html} {.  Di
1c10: 66 66 65 72 65 6e 74 20 53 51 4c 20 64 61 74 61  fferent SQL data
1c20: 62 61 73 65 20 65 6e 67 69 6e 65 73 20 68 61 6e  base engines han
1c30: 64 6c 65 20 4e 55 4c 4c 73 20 69 6e 20 64 69 66  dle NULLs in dif
1c40: 66 65 72 65 6e 74 20 77 61 79 73 2e 20 20 54 68  ferent ways.  Th
1c50: 65 0a 20 20 53 51 4c 20 73 74 61 6e 64 61 72 64  e.  SQL standard
1c60: 73 20 61 72 65 20 61 6d 62 69 67 75 6f 75 73 2e  s are ambiguous.
1c70: 20 20 54 68 69 73 20 28 63 69 72 63 61 20 32 30    This (circa 20
1c80: 30 33 29 20 64 6f 63 75 6d 65 6e 74 20 64 65 73  03) document des
1c90: 63 72 69 62 65 73 0a 20 20 68 6f 77 20 53 51 4c  cribes.  how SQL
1ca0: 69 74 65 20 68 61 6e 64 6c 65 73 20 4e 55 4c 4c  ite handles NULL
1cb0: 73 20 69 6e 20 63 6f 6d 70 61 72 69 73 6f 6e 20  s in comparison 
1cc0: 77 69 74 68 20 6f 74 68 65 72 20 53 51 4c 20 64  with other SQL d
1cd0: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 73 2e  atabase engines.
1ce0: 0a 7d 0a 64 6f 63 20 7b 50 61 72 74 69 61 6c 20  .}.doc {Partial 
1cf0: 49 6e 64 65 78 65 73 7d 20 7b 70 61 72 74 69 61  Indexes} {partia
1d00: 6c 69 6e 64 65 78 2e 68 74 6d 6c 7d 20 7b 0a 20  lindex.html} {. 
1d10: 20 41 20 70 61 72 74 69 61 6c 20 69 6e 64 65 78   A partial index
1d20: 20 69 73 20 61 6e 20 69 6e 64 65 78 20 74 68 61   is an index tha
1d30: 74 20 6f 6e 6c 79 20 63 6f 76 65 72 73 20 61 20  t only covers a 
1d40: 73 75 62 73 65 74 20 6f 66 20 74 68 65 20 72 6f  subset of the ro
1d50: 77 73 20 69 6e 0a 20 20 61 20 74 61 62 6c 65 2e  ws in.  a table.
1d60: 20 20 4c 65 61 72 6e 20 68 6f 77 20 74 6f 20 75    Learn how to u
1d70: 73 65 20 70 61 72 74 69 61 6c 20 69 6e 64 65 78  se partial index
1d80: 65 73 20 69 6e 20 53 51 4c 69 74 65 20 66 72 6f  es in SQLite fro
1d90: 6d 20 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 2e  m this document.
1da0: 0a 7d 0a 64 6f 63 20 7b 53 68 61 72 65 64 20 43  .}.doc {Shared C
1db0: 61 63 68 65 20 4d 6f 64 65 7d 20 7b 73 68 61 72  ache Mode} {shar
1dc0: 65 64 63 61 63 68 65 2e 68 74 6d 6c 7d 20 7b 0a  edcache.html} {.
1dd0: 20 20 56 65 72 73 69 6f 6e 20 33 2e 33 2e 30 20    Version 3.3.0 
1de0: 61 6e 64 20 6c 61 74 65 72 20 73 75 70 70 6f 72  and later suppor
1df0: 74 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 66  ts the ability f
1e00: 6f 72 20 74 77 6f 20 6f 72 20 6d 6f 72 65 0a 20  or two or more. 
1e10: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
1e20: 74 69 6f 6e 73 20 74 6f 20 73 68 61 72 65 20 74  tions to share t
1e30: 68 65 20 73 61 6d 65 20 70 61 67 65 20 61 6e 64  he same page and
1e40: 20 73 63 68 65 6d 61 20 63 61 63 68 65 2e 0a 20   schema cache.. 
1e50: 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 73   This feature is
1e60: 20 75 73 65 66 75 6c 20 66 6f 72 20 63 65 72 74   useful for cert
1e70: 61 69 6e 20 73 70 65 63 69 61 6c 69 7a 65 64 20  ain specialized 
1e80: 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 0a 7d 0a  applications..}.
1e90: 64 6f 63 20 7b 55 6e 6c 6f 63 6b 20 4e 6f 74 69  doc {Unlock Noti
1ea0: 66 79 7d 20 7b 75 6e 6c 6f 63 6b 5f 6e 6f 74 69  fy} {unlock_noti
1eb0: 66 79 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65  fy.html} {.  The
1ec0: 20 22 75 6e 6c 6f 63 6b 20 6e 6f 74 69 66 79 22   "unlock notify"
1ed0: 20 66 65 61 74 75 72 65 20 63 61 6e 20 62 65 20   feature can be 
1ee0: 75 73 65 64 20 69 6e 20 63 6f 6e 6a 75 6e 63 74  used in conjunct
1ef0: 69 6f 6e 20 77 69 74 68 0a 20 20 5b 73 68 61 72  ion with.  [shar
1f00: 65 64 20 63 61 63 68 65 20 6d 6f 64 65 5d 20 74  ed cache mode] t
1f10: 6f 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e 74  o more efficient
1f20: 6c 79 20 6d 61 6e 61 67 65 20 72 65 73 6f 75 72  ly manage resour
1f30: 63 65 20 63 6f 6e 66 6c 69 63 74 20 28 64 61 74  ce conflict (dat
1f40: 61 62 61 73 65 0a 20 20 74 61 62 6c 65 20 6c 6f  abase.  table lo
1f50: 63 6b 73 29 2e 0a 7d 0a 64 6f 63 20 7b 55 52 49  cks)..}.doc {URI
1f60: 20 46 69 6c 65 6e 61 6d 65 73 7d 20 7b 75 72 69   Filenames} {uri
1f70: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65 20 6e  .html} {.  The n
1f80: 61 6d 65 73 20 6f 66 20 64 61 74 61 62 61 73 65  ames of database
1f90: 20 66 69 6c 65 73 20 63 61 6e 20 62 65 20 73 70   files can be sp
1fa0: 65 63 69 66 69 65 64 20 75 73 69 6e 67 20 65 69  ecified using ei
1fb0: 74 68 65 72 20 61 6e 20 6f 72 64 69 6e 61 72 79  ther an ordinary
1fc0: 0a 20 20 66 69 6c 65 6e 61 6d 65 20 6f 72 20 61  .  filename or a
1fd0: 20 55 52 49 2e 20 20 55 73 69 6e 67 20 55 52 49   URI.  Using URI
1fe0: 20 66 69 6c 65 6e 61 6d 65 73 20 70 72 6f 76 69   filenames provi
1ff0: 64 65 73 20 61 64 64 69 74 69 6f 6e 61 6c 20 63  des additional c
2000: 61 70 61 62 69 6c 69 74 69 65 73 2c 0a 20 20 61  apabilities,.  a
2010: 73 20 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20  s this document 
2020: 64 65 73 63 72 69 62 65 73 2e 0a 7d 0a 64 6f 63  describes..}.doc
2030: 20 7b 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20   {WITHOUT ROWID 
2040: 54 61 62 6c 65 73 7d 20 7b 77 69 74 68 6f 75 74  Tables} {without
2050: 72 6f 77 69 64 2e 68 74 6d 6c 7d 20 7b 0a 20 20  rowid.html} {.  
2060: 54 68 65 20 57 49 54 48 4f 55 54 20 52 4f 57 49  The WITHOUT ROWI
2070: 44 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 69  D optimization i
2080: 73 20 61 20 6f 70 74 69 6f 6e 20 74 68 61 74 20  s a option that 
2090: 63 61 6e 20 73 6f 6d 65 74 69 6d 65 73 20 72 65  can sometimes re
20a0: 73 75 6c 74 0a 20 20 69 6e 20 73 6d 61 6c 6c 65  sult.  in smalle
20b0: 72 20 61 6e 64 20 66 61 73 74 65 72 20 64 61 74  r and faster dat
20c0: 61 62 61 73 65 73 2e 0a 7d 0a 64 6f 63 20 7b 57  abases..}.doc {W
20d0: 72 69 74 65 2d 41 68 65 61 64 20 4c 6f 67 20 28  rite-Ahead Log (
20e0: 57 41 4c 29 20 4d 6f 64 65 7d 20 7b 77 61 6c 2e  WAL) Mode} {wal.
20f0: 68 74 6d 6c 7d 20 7b 0a 20 20 54 72 61 6e 73 61  html} {.  Transa
2100: 63 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 20 75 73  ction control us
2110: 69 6e 67 20 61 20 77 72 69 74 65 2d 61 68 65 61  ing a write-ahea
2120: 64 20 6c 6f 67 20 6f 66 66 65 72 73 20 6d 6f 72  d log offers mor
2130: 65 20 63 6f 6e 63 75 72 72 65 6e 63 79 20 61 6e  e concurrency an
2140: 64 0a 20 20 69 73 20 6f 66 74 65 6e 20 66 61 73  d.  is often fas
2150: 74 65 72 20 74 68 61 6e 20 74 68 65 20 64 65 66  ter than the def
2160: 61 75 6c 74 20 72 6f 6c 6c 62 61 63 6b 20 74 72  ault rollback tr
2170: 61 6e 73 61 63 74 69 6f 6e 73 2e 20 20 54 68 69  ansactions.  Thi
2180: 73 20 64 6f 63 75 6d 65 6e 74 0a 20 20 65 78 70  s document.  exp
2190: 6c 61 69 6e 73 20 68 6f 77 20 74 6f 20 75 73 65  lains how to use
21a0: 20 57 41 4c 20 6d 6f 64 65 20 66 6f 72 20 69 6d   WAL mode for im
21b0: 70 72 6f 76 65 64 20 70 65 72 66 6f 72 6d 61 6e  proved performan
21c0: 63 65 2e 0a 7d 0a 0a 68 65 61 64 69 6e 67 20 7b  ce..}..heading {
21d0: 41 64 76 6f 63 61 63 79 7d 20 61 64 76 6f 63 61  Advocacy} advoca
21e0: 63 79 20 7b 0a 20 20 44 6f 63 75 6d 65 6e 74 73  cy {.  Documents
21f0: 20 74 68 61 74 20 73 74 72 69 76 65 20 74 6f 20   that strive to 
2200: 65 6e 63 6f 75 72 61 67 65 20 74 68 65 20 75 73  encourage the us
2210: 65 20 6f 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 64  e of SQLite..}.d
2220: 6f 63 20 7b 53 51 4c 69 74 65 20 41 73 20 41 6e  oc {SQLite As An
2230: 20 41 70 70 6c 69 63 61 74 69 6f 6e 20 46 69 6c   Application Fil
2240: 65 20 46 6f 72 6d 61 74 7d 20 7b 61 70 70 66 69  e Format} {appfi
2250: 6c 65 66 6f 72 6d 61 74 2e 68 74 6d 6c 7d 20 7b  leformat.html} {
2260: 0a 20 20 54 68 69 73 20 61 72 74 69 63 6c 65 20  .  This article 
2270: 61 64 76 6f 63 61 74 65 73 20 75 73 69 6e 67 20  advocates using 
2280: 53 51 4c 69 74 65 20 61 73 20 61 6e 20 61 70 70  SQLite as an app
2290: 6c 69 63 61 74 69 6f 6e 20 66 69 6c 65 20 66 6f  lication file fo
22a0: 72 6d 61 74 0a 20 20 69 6e 20 70 6c 61 63 65 20  rmat.  in place 
22b0: 6f 66 20 58 4d 4c 20 6f 72 20 4a 53 4f 4e 20 6f  of XML or JSON o
22c0: 72 20 61 20 22 70 69 6c 65 2d 6f 66 2d 66 69 6c  r a "pile-of-fil
22d0: 65 22 2e 0a 7d 0a 64 6f 63 20 7b 57 65 6c 6c 20  e"..}.doc {Well 
22e0: 4b 6e 6f 77 6e 20 55 73 65 72 73 7d 20 7b 66 61  Known Users} {fa
22f0: 6d 6f 75 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54  mous.html} {.  T
2300: 68 69 73 20 70 61 67 65 20 6c 69 73 74 73 20 61  his page lists a
2310: 20 73 6d 61 6c 6c 20 73 75 62 73 65 74 20 6f 66   small subset of
2320: 20 74 68 65 20 6d 61 6e 79 20 74 68 6f 75 73 61   the many thousa
2330: 6e 64 73 20 6f 66 20 64 65 76 69 63 65 73 0a 20  nds of devices. 
2340: 20 61 6e 64 20 61 70 70 6c 69 63 61 74 69 6f 6e   and application
2350: 20 70 72 6f 67 72 61 6d 73 20 74 68 61 74 20 6d   programs that m
2360: 61 6b 65 20 75 73 65 20 6f 66 20 53 51 4c 69 74  ake use of SQLit
2370: 65 2e 0a 7d 0a 0a 0a 68 65 61 64 69 6e 67 20 7b  e..}...heading {
2380: 53 51 4c 69 74 65 20 54 65 63 68 6e 69 63 61 6c  SQLite Technical
2390: 2f 44 65 73 69 67 6e 20 44 6f 63 75 6d 65 6e 74  /Design Document
23a0: 61 74 69 6f 6e 7d 20 74 65 63 68 6e 69 63 61 6c  ation} technical
23b0: 20 7b 0a 20 20 54 68 65 73 65 20 64 6f 63 75 6d   {.  These docum
23c0: 65 6e 74 73 20 61 72 65 20 6f 72 69 65 6e 74 65  ents are oriente
23d0: 64 20 74 6f 77 61 72 64 20 64 65 73 63 72 69 62  d toward describ
23e0: 69 6e 67 20 74 68 65 20 69 6e 74 65 72 6e 61 6c  ing the internal
23f0: 0a 20 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  .  implementatio
2400: 6e 20 64 65 74 61 69 6c 73 20 61 6e 64 20 6f 70  n details and op
2410: 65 72 61 74 69 6f 6e 20 6f 66 20 53 51 4c 69 74  eration of SQLit
2420: 65 2e 20 20 0a 7d 0a 0a 64 6f 63 20 7b 48 6f 77  e.  .}..doc {How
2430: 20 44 61 74 61 62 61 73 65 20 43 6f 72 72 75 70   Database Corrup
2440: 74 69 6f 6e 20 43 61 6e 20 4f 63 63 75 72 7d 20  tion Can Occur} 
2450: 7b 68 6f 77 74 6f 63 6f 72 72 75 70 74 2e 68 74  {howtocorrupt.ht
2460: 6d 6c 7d 20 7b 0a 20 20 53 51 4c 69 74 65 20 69  ml} {.  SQLite i
2470: 73 20 68 69 67 68 6c 79 20 72 65 73 69 73 74 61  s highly resista
2480: 6e 74 20 74 6f 20 64 61 74 61 62 61 73 65 20 63  nt to database c
2490: 6f 72 72 75 70 74 69 6f 6e 2e 20 20 42 75 74 20  orruption.  But 
24a0: 61 70 70 6c 69 63 61 74 69 6f 6e 2c 0a 20 20 4f  application,.  O
24b0: 53 2c 20 61 6e 64 20 68 61 72 64 77 61 72 65 20  S, and hardware 
24c0: 62 75 67 73 20 63 61 6e 20 73 74 69 6c 6c 20 72  bugs can still r
24d0: 65 73 75 6c 74 20 69 6e 20 63 6f 72 72 75 70 74  esult in corrupt
24e0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e   database files.
24f0: 0a 20 20 54 68 69 73 20 61 72 74 69 63 6c 65 20  .  This article 
2500: 64 65 73 63 72 69 62 65 73 20 6d 61 6e 79 20 6f  describes many o
2510: 66 20 74 68 65 20 77 61 79 73 20 74 68 61 74 20  f the ways that 
2520: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20  SQLite database 
2530: 66 69 6c 65 73 0a 20 20 63 61 6e 20 67 6f 20 63  files.  can go c
2540: 6f 72 72 75 70 74 2e 0a 7d 0a 0a 64 6f 63 20 7b  orrupt..}..doc {
2550: 54 65 6d 70 6f 72 61 72 79 20 46 69 6c 65 73 20  Temporary Files 
2560: 55 73 65 64 20 42 79 20 53 51 4c 69 74 65 7d 20  Used By SQLite} 
2570: 7b 74 65 6d 70 66 69 6c 65 73 2e 68 74 6d 6c 7d  {tempfiles.html}
2580: 20 7b 0a 20 20 53 51 4c 69 74 65 20 63 61 6e 20   {.  SQLite can 
2590: 70 6f 74 65 6e 74 69 61 6c 6c 79 20 75 73 65 20  potentially use 
25a0: 6d 61 6e 79 20 64 69 66 66 65 72 65 6e 74 20 74  many different t
25b0: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 20 77  emporary files w
25c0: 68 65 6e 0a 20 20 70 72 6f 63 65 73 73 69 6e 67  hen.  processing
25d0: 20 63 65 72 74 61 69 6e 20 53 51 4c 20 73 74 61   certain SQL sta
25e0: 74 65 6d 65 6e 74 73 2e 20 20 54 68 69 73 20 64  tements.  This d
25f0: 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65  ocument describe
2600: 73 20 74 68 65 0a 20 20 6d 61 6e 79 20 6b 69 6e  s the.  many kin
2610: 64 73 20 6f 66 20 74 65 6d 70 6f 72 61 72 79 20  ds of temporary 
2620: 66 69 6c 65 73 20 74 68 61 74 20 53 51 4c 69 74  files that SQLit
2630: 65 20 75 73 65 73 20 61 6e 64 20 6f 66 66 65 72  e uses and offer
2640: 73 20 73 75 67 67 65 73 74 69 6f 6e 73 0a 20 20  s suggestions.  
2650: 66 6f 72 20 61 76 6f 69 64 69 6e 67 20 74 68 65  for avoiding the
2660: 6d 20 6f 6e 20 73 79 73 74 65 6d 73 20 77 68 65  m on systems whe
2670: 72 65 20 63 72 65 61 74 69 6e 67 20 61 20 74 65  re creating a te
2680: 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 69 73 20  mporary file is 
2690: 61 6e 0a 20 20 65 78 70 65 6e 73 69 76 65 20 6f  an.  expensive o
26a0: 70 65 72 61 74 69 6f 6e 2e 0a 7d 0a 0a 64 6f 63  peration..}..doc
26b0: 20 7b 49 6e 2d 4d 65 6d 6f 72 79 20 44 61 74 61   {In-Memory Data
26c0: 62 61 73 65 73 7d 20 7b 69 6e 6d 65 6d 6f 72 79  bases} {inmemory
26d0: 64 62 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c  db.html} {.  SQL
26e0: 69 74 65 20 6e 6f 72 6d 61 6c 6c 79 20 73 74 6f  ite normally sto
26f0: 72 65 73 20 63 6f 6e 74 65 6e 74 20 69 6e 20 61  res content in a
2700: 20 64 69 73 6b 20 66 69 6c 65 2e 20 20 48 6f 77   disk file.  How
2710: 65 76 65 72 2c 20 69 74 20 63 61 6e 20 61 6c 73  ever, it can als
2720: 6f 0a 20 20 62 65 20 75 73 65 64 20 61 73 20 61  o.  be used as a
2730: 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61  n in-memory data
2740: 62 61 73 65 20 65 6e 67 69 6e 65 2e 20 20 54 68  base engine.  Th
2750: 69 73 20 64 6f 63 75 6d 65 6e 74 20 65 78 70 6c  is document expl
2760: 61 69 6e 73 20 68 6f 77 2e 0a 7d 0a 0a 64 6f 63  ains how..}..doc
2770: 20 7b 48 6f 77 20 53 51 4c 69 74 65 20 49 6d 70   {How SQLite Imp
2780: 6c 65 6d 65 6e 74 73 20 41 74 6f 6d 69 63 20 43  lements Atomic C
2790: 6f 6d 6d 69 74 7d 20 7b 61 74 6f 6d 69 63 63 6f  ommit} {atomicco
27a0: 6d 6d 69 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41  mmit.html} {.  A
27b0: 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20   description of 
27c0: 74 68 65 20 6c 6f 67 69 63 20 77 69 74 68 69 6e  the logic within
27d0: 20 53 51 4c 69 74 65 20 74 68 61 74 20 69 6d 70   SQLite that imp
27e0: 6c 65 6d 65 6e 74 73 0a 20 20 74 72 61 6e 73 61  lements.  transa
27f0: 63 74 69 6f 6e 73 20 77 69 74 68 20 61 74 6f 6d  ctions with atom
2800: 69 63 20 63 6f 6d 6d 69 74 2c 20 65 76 65 6e 20  ic commit, even 
2810: 69 6e 20 74 68 65 20 66 61 63 65 20 6f 66 20 70  in the face of p
2820: 6f 77 65 72 0a 20 20 66 61 69 6c 75 72 65 73 2e  ower.  failures.
2830: 0a 7d 0a 0a 64 6f 63 20 7b 44 79 6e 61 6d 69 63  .}..doc {Dynamic
2840: 20 4d 65 6d 6f 72 79 20 41 6c 6c 6f 63 61 74 69   Memory Allocati
2850: 6f 6e 20 69 6e 20 53 51 4c 69 74 65 7d 20 7b 6d  on in SQLite} {m
2860: 61 6c 6c 6f 63 2e 68 74 6d 6c 7d 20 7b 0a 20 20  alloc.html} {.  
2870: 53 51 4c 69 74 65 20 68 61 73 20 61 20 73 6f 70  SQLite has a sop
2880: 68 69 73 74 69 63 61 74 65 64 20 6d 65 6d 6f 72  histicated memor
2890: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 75 62  y allocation sub
28a0: 73 79 73 74 65 6d 20 74 68 61 74 20 63 61 6e 20  system that can 
28b0: 62 65 0a 20 20 63 6f 6e 66 69 67 75 72 65 64 20  be.  configured 
28c0: 61 6e 64 20 63 75 73 74 6f 6d 69 7a 65 64 20 74  and customized t
28d0: 6f 20 6d 65 65 74 20 6d 65 6d 6f 72 79 20 75 73  o meet memory us
28e0: 61 67 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73  age requirements
28f0: 20 6f 66 20 74 68 65 0a 20 20 61 70 70 6c 69 63   of the.  applic
2900: 61 74 69 6f 6e 20 61 6e 64 20 74 68 61 74 20 69  ation and that i
2910: 73 20 72 6f 62 75 73 74 20 61 67 61 69 6e 73 74  s robust against
2920: 20 6f 75 74 2d 6f 66 2d 6d 65 6d 6f 72 79 20 63   out-of-memory c
2930: 6f 6e 64 69 74 69 6f 6e 73 20 61 6e 64 0a 20 20  onditions and.  
2940: 6c 65 61 6b 2d 66 72 65 65 2e 20 20 54 68 69 73  leak-free.  This
2950: 20 64 6f 63 75 6d 65 6e 74 20 70 72 6f 76 69 64   document provid
2960: 65 73 20 74 68 65 20 64 65 74 61 69 6c 73 2e 0a  es the details..
2970: 7d 0a 0a 64 6f 63 20 7b 43 75 73 74 6f 6d 69 7a  }..doc {Customiz
2980: 69 6e 67 20 41 6e 64 20 50 6f 72 74 69 6e 67 20  ing And Porting 
2990: 53 51 4c 69 74 65 7d 20 7b 63 75 73 74 6f 6d 62  SQLite} {customb
29a0: 75 69 6c 64 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54  uild.html} {.  T
29b0: 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 65 78 70  his document exp
29c0: 6c 61 69 6e 73 20 68 6f 77 20 74 6f 20 63 75 73  lains how to cus
29d0: 74 6f 6d 69 7a 65 20 74 68 65 20 62 75 69 6c 64  tomize the build
29e0: 20 6f 66 20 53 51 4c 69 74 65 20 61 6e 64 0a 20   of SQLite and. 
29f0: 20 68 6f 77 20 74 6f 20 70 6f 72 74 20 53 51 4c   how to port SQL
2a00: 69 74 65 20 74 6f 20 6e 65 77 20 70 6c 61 74 66  ite to new platf
2a10: 6f 72 6d 73 2e 0a 7d 0a 0a 64 6f 63 20 7b 4c 6f  orms..}..doc {Lo
2a20: 63 6b 69 6e 67 20 41 6e 64 20 43 6f 6e 63 75 72  cking And Concur
2a30: 72 65 6e 63 79 3c 62 72 3e 49 6e 20 53 51 4c 69  rency<br>In SQLi
2a40: 74 65 20 56 65 72 73 69 6f 6e 20 33 7d 20 7b 6c  te Version 3} {l
2a50: 6f 63 6b 69 6e 67 76 33 2e 68 74 6d 6c 7d 20 7b  ockingv3.html} {
2a60: 0a 20 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e  .  A description
2a70: 20 6f 66 20 68 6f 77 20 74 68 65 20 6e 65 77 20   of how the new 
2a80: 6c 6f 63 6b 69 6e 67 20 63 6f 64 65 20 69 6e 20  locking code in 
2a90: 76 65 72 73 69 6f 6e 20 33 20 69 6e 63 72 65 61  version 3 increa
2aa0: 73 65 73 0a 20 20 63 6f 6e 63 75 72 72 65 6e 63  ses.  concurrenc
2ab0: 79 20 61 6e 64 20 64 65 63 72 65 61 73 65 73 20  y and decreases 
2ac0: 74 68 65 20 70 72 6f 62 6c 65 6d 20 6f 66 20 77  the problem of w
2ad0: 72 69 74 65 72 20 73 74 61 72 76 61 74 69 6f 6e  riter starvation
2ae0: 2e 0a 7d 0a 0a 64 6f 63 20 7b 49 73 6f 6c 61 74  ..}..doc {Isolat
2af0: 69 6f 6e 20 49 6e 20 53 51 4c 69 74 65 7d 20 7b  ion In SQLite} {
2b00: 69 73 6f 6c 61 74 69 6f 6e 2e 68 74 6d 6c 7d 20  isolation.html} 
2b10: 7b 0a 20 20 57 68 65 6e 20 77 65 20 73 61 79 20  {.  When we say 
2b20: 74 68 61 74 20 53 51 4c 69 74 65 20 74 72 61 6e  that SQLite tran
2b30: 73 61 63 74 69 6f 6e 73 20 61 72 65 20 22 73 65  sactions are "se
2b40: 72 69 61 6c 69 7a 61 62 6c 65 22 20 77 68 61 74  rializable" what
2b50: 20 65 78 61 63 74 6c 79 0a 20 20 64 6f 65 73 20   exactly.  does 
2b60: 74 68 61 74 20 6d 65 61 6e 3f 20 20 48 6f 77 20  that mean?  How 
2b70: 61 6e 64 20 77 68 65 6e 20 61 72 65 20 63 68 61  and when are cha
2b80: 6e 67 65 73 20 6d 61 64 65 20 76 69 73 69 62 6c  nges made visibl
2b90: 65 20 77 69 74 68 69 6e 20 74 68 65 0a 20 20 73  e within the.  s
2ba0: 61 6d 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e  ame database con
2bb0: 6e 65 63 74 69 6f 6e 20 61 6e 64 20 74 6f 20 6f  nection and to o
2bc0: 74 68 65 72 20 64 61 74 61 62 61 73 65 20 63 6f  ther database co
2bd0: 6e 6e 65 63 74 69 6f 6e 73 3f 0a 7d 0a 0a 64 6f  nnections?.}..do
2be0: 63 20 7b 4f 76 65 72 76 69 65 77 20 4f 66 20 54  c {Overview Of T
2bf0: 68 65 20 4f 70 74 69 6d 69 7a 65 72 7d 20 7b 6f  he Optimizer} {o
2c00: 70 74 6f 76 65 72 76 69 65 77 2e 68 74 6d 6c 7d  ptoverview.html}
2c10: 20 7b 0a 20 20 41 20 71 75 69 63 6b 20 6f 76 65   {.  A quick ove
2c20: 72 76 69 65 77 20 6f 66 20 74 68 65 20 76 61 72  rview of the var
2c30: 69 6f 75 73 20 71 75 65 72 79 20 6f 70 74 69 6d  ious query optim
2c40: 69 7a 61 74 69 6f 6e 73 20 74 68 61 74 20 61 72  izations that ar
2c50: 65 0a 20 20 61 74 74 65 6d 70 74 65 64 20 62 79  e.  attempted by
2c60: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 64 65   the SQLite code
2c70: 20 67 65 6e 65 72 61 74 6f 72 2e 0a 7d 0a 64 6f   generator..}.do
2c80: 63 20 7b 54 68 65 20 4e 65 78 74 2d 47 65 6e 65  c {The Next-Gene
2c90: 72 61 74 69 6f 6e 20 51 75 65 72 79 20 50 6c 61  ration Query Pla
2ca0: 6e 6e 65 72 7d 20 7b 71 75 65 72 79 70 6c 61 6e  nner} {queryplan
2cb0: 6e 65 72 2d 6e 67 2e 68 74 6d 6c 7d 20 7b 0a 20  ner-ng.html} {. 
2cc0: 20 41 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f   Additional info
2cd0: 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68  rmation about th
2ce0: 65 20 53 51 4c 69 74 65 20 71 75 65 72 79 20 70  e SQLite query p
2cf0: 6c 61 6e 6e 65 72 2c 20 61 6e 64 20 69 6e 20 70  lanner, and in p
2d00: 61 72 74 69 63 75 6c 61 72 0a 20 20 74 68 65 20  articular.  the 
2d10: 72 65 64 65 73 69 67 6e 20 6f 66 20 74 68 65 20  redesign of the 
2d20: 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 20 74 68  query planner th
2d30: 61 74 20 6f 63 63 75 72 72 65 64 20 66 6f 72 20  at occurred for 
2d40: 76 65 72 73 69 6f 6e 20 33 2e 38 2e 30 2e 0a 7d  version 3.8.0..}
2d50: 0a 0a 64 6f 63 20 7b 41 72 63 68 69 74 65 63 74  ..doc {Architect
2d60: 75 72 65 7d 20 7b 61 72 63 68 2e 68 74 6d 6c 7d  ure} {arch.html}
2d70: 20 7b 0a 20 20 41 6e 20 61 72 63 68 69 74 65 63   {.  An architec
2d80: 74 75 72 61 6c 20 6f 76 65 72 76 69 65 77 20 6f  tural overview o
2d90: 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62  f the SQLite lib
2da0: 72 61 72 79 2c 20 75 73 65 66 75 6c 20 66 6f 72  rary, useful for
2db0: 20 74 68 6f 73 65 20 77 68 6f 20 77 61 6e 74 0a   those who want.
2dc0: 20 20 74 6f 20 68 61 63 6b 20 74 68 65 20 63 6f    to hack the co
2dd0: 64 65 2e 0a 7d 0a 64 6f 63 20 7b 56 44 42 45 20  de..}.doc {VDBE 
2de0: 4f 70 63 6f 64 65 73 7d 20 7b 6f 70 63 6f 64 65  Opcodes} {opcode
2df0: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20  .html} {.  This 
2e00: 64 6f 63 75 6d 65 6e 74 20 69 73 20 61 6e 20 61  document is an a
2e10: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 67 65 6e  utomatically gen
2e20: 65 72 61 74 65 64 20 64 65 73 63 72 69 70 74 69  erated descripti
2e30: 6f 6e 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75  on of the variou
2e40: 73 0a 20 20 6f 70 63 6f 64 65 73 20 74 68 61 74  s.  opcodes that
2e50: 20 74 68 65 20 56 44 42 45 20 75 6e 64 65 72 73   the VDBE unders
2e60: 74 61 6e 64 73 2e 20 20 50 72 6f 67 72 61 6d 6d  tands.  Programm
2e70: 65 72 73 20 63 61 6e 20 75 73 65 20 74 68 69 73  ers can use this
2e80: 20 64 6f 63 75 6d 65 6e 74 20 61 73 0a 20 20 61   document as.  a
2e90: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 62 65   reference to be
2ea0: 74 74 65 72 20 75 6e 64 65 72 73 74 61 6e 64 20  tter understand 
2eb0: 74 68 65 20 6f 75 74 70 75 74 20 6f 66 20 45 58  the output of EX
2ec0: 50 4c 41 49 4e 20 6c 69 73 74 69 6e 67 73 20 66  PLAIN listings f
2ed0: 72 6f 6d 0a 20 20 53 51 4c 69 74 65 2e 0a 7d 0a  rom.  SQLite..}.
2ee0: 64 6f 63 20 7b 56 69 72 74 75 61 6c 20 46 69 6c  doc {Virtual Fil
2ef0: 65 73 79 73 74 65 6d 7d 20 7b 76 66 73 2e 68 74  esystem} {vfs.ht
2f00: 6d 6c 7d 20 7b 0a 20 20 54 68 65 20 22 56 46 53  ml} {.  The "VFS
2f10: 22 20 6f 62 6a 65 63 74 20 69 73 20 74 68 65 20  " object is the 
2f20: 69 6e 74 65 72 66 61 63 65 20 62 65 74 77 65 65  interface betwee
2f30: 6e 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72  n the SQLite cor
2f40: 65 20 61 6e 64 20 74 68 65 0a 20 20 75 6e 64 65  e and the.  unde
2f50: 72 6c 79 69 6e 67 20 6f 70 65 72 61 74 69 6e 67  rlying operating
2f60: 20 73 79 73 74 65 6d 2e 20 20 4c 65 61 72 6e 20   system.  Learn 
2f70: 6d 6f 72 65 20 61 62 6f 75 74 20 68 6f 77 20 74  more about how t
2f80: 68 65 20 56 46 53 20 6f 62 6a 65 63 74 0a 20 20  he VFS object.  
2f90: 77 6f 72 6b 73 20 61 6e 64 20 68 6f 77 20 74 6f  works and how to
2fa0: 20 63 72 65 61 74 65 20 6e 65 77 20 56 46 53 20   create new VFS 
2fb0: 6f 62 6a 65 63 74 73 20 66 72 6f 6d 20 74 68 69  objects from thi
2fc0: 73 20 61 72 74 69 63 6c 65 2e 0a 7d 0a 64 6f 63  s article..}.doc
2fd0: 20 7b 56 69 72 74 75 61 6c 20 54 61 62 6c 65 73   {Virtual Tables
2fe0: 7d 20 7b 76 74 61 62 2e 68 74 6d 6c 7d 20 7b 0a  } {vtab.html} {.
2ff0: 20 20 54 68 69 73 20 61 72 74 69 63 6c 65 20 64    This article d
3000: 65 73 63 72 69 62 65 73 20 74 68 65 20 76 69 72  escribes the vir
3010: 74 75 61 6c 20 74 61 62 6c 65 20 6d 65 63 68 61  tual table mecha
3020: 6e 69 73 6d 20 61 6e 64 20 41 50 49 20 69 6e 20  nism and API in 
3030: 53 51 4c 69 74 65 20 61 6e 64 20 68 6f 77 0a 20  SQLite and how. 
3040: 20 69 74 20 63 61 6e 20 62 65 20 75 73 65 64 20   it can be used 
3050: 74 6f 20 61 64 64 20 6e 65 77 20 63 61 70 61 62  to add new capab
3060: 69 6c 69 74 69 65 73 20 74 6f 20 74 68 65 20 63  ilities to the c
3070: 6f 72 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  ore SQLite libra
3080: 72 79 2e 0a 7d 0a 0a 64 6f 63 20 7b 53 51 4c 69  ry..}..doc {SQLi
3090: 74 65 20 46 69 6c 65 20 46 6f 72 6d 61 74 7d 20  te File Format} 
30a0: 7b 66 69 6c 65 66 6f 72 6d 61 74 32 2e 68 74 6d  {fileformat2.htm
30b0: 6c 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70  l} {.  A descrip
30c0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f 72 6d  tion of the form
30d0: 61 74 20 75 73 65 64 20 66 6f 72 20 53 51 4c 69  at used for SQLi
30e0: 74 65 20 64 61 74 61 62 61 73 65 20 61 6e 64 20  te database and 
30f0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 2c 20 61  journal files, a
3100: 6e 64 0a 20 20 6f 74 68 65 72 20 64 65 74 61 69  nd.  other detai
3110: 6c 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 63  ls required to c
3120: 72 65 61 74 65 20 73 6f 66 74 77 61 72 65 20 74  reate software t
3130: 6f 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 65  o read and write
3140: 20 53 51 4c 69 74 65 20 0a 20 20 64 61 74 61 62   SQLite .  datab
3150: 61 73 65 73 20 77 69 74 68 6f 75 74 20 75 73 69  ases without usi
3160: 6e 67 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 64 6f  ng SQLite..}..do
3170: 63 20 7b 43 6f 6d 70 69 6c 61 74 69 6f 6e 20 4f  c {Compilation O
3180: 70 74 69 6f 6e 73 7d 20 7b 63 6f 6d 70 69 6c 65  ptions} {compile
3190: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20  .html} {.  This 
31a0: 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62  document describ
31b0: 65 73 20 74 68 65 20 63 6f 6d 70 69 6c 65 20 74  es the compile t
31c0: 69 6d 65 20 6f 70 74 69 6f 6e 73 20 74 68 61 74  ime options that
31d0: 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 0a   may be set to .
31e0: 20 20 6d 6f 64 69 66 79 20 74 68 65 20 64 65 66    modify the def
31f0: 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20 6f 66  ault behavior of
3200: 20 74 68 65 20 6c 69 62 72 61 72 79 20 6f 72 20   the library or 
3210: 6f 6d 69 74 20 6f 70 74 69 6f 6e 61 6c 20 66 65  omit optional fe
3220: 61 74 75 72 65 73 0a 20 20 69 6e 20 6f 72 64 65  atures.  in orde
3230: 72 20 74 6f 20 72 65 64 75 63 65 20 62 69 6e 61  r to reduce bina
3240: 72 79 20 73 69 7a 65 2e 0a 7d 0a 0a 68 65 61 64  ry size..}..head
3250: 69 6e 67 20 7b 55 70 67 72 61 64 69 6e 67 20 53  ing {Upgrading S
3260: 51 4c 69 74 65 2c 20 42 61 63 6b 77 61 72 64 73  QLite, Backwards
3270: 20 43 6f 6d 70 61 74 69 62 69 6c 69 74 79 7d 20   Compatibility} 
3280: 63 6f 6d 70 61 74 0a 0a 64 6f 63 20 7b 4d 6f 76  compat..doc {Mov
3290: 69 6e 67 20 46 72 6f 6d 20 53 51 4c 69 74 65 20  ing From SQLite 
32a0: 33 2e 35 20 74 6f 20 33 2e 36 7d 20 7b 33 35 74  3.5 to 3.6} {35t
32b0: 6f 33 36 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20  o36.html} {.  A 
32c0: 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62  document describ
32d0: 69 6e 67 20 74 68 65 20 64 69 66 66 65 72 65 6e  ing the differen
32e0: 63 65 73 20 62 65 74 77 65 65 6e 20 53 51 4c 69  ces between SQLi
32f0: 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 35 2e 39  te version 3.5.9
3300: 0a 20 20 61 6e 64 20 33 2e 36 2e 30 2e 0a 7d 0a  .  and 3.6.0..}.
3310: 64 6f 63 20 7b 4d 6f 76 69 6e 67 20 46 72 6f 6d  doc {Moving From
3320: 20 53 51 4c 69 74 65 20 33 2e 34 20 74 6f 20 33   SQLite 3.4 to 3
3330: 2e 35 7d 20 7b 33 34 74 6f 33 35 2e 68 74 6d 6c  .5} {34to35.html
3340: 7d 20 7b 0a 20 20 41 20 64 6f 63 75 6d 65 6e 74  } {.  A document
3350: 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65 20   describing the 
3360: 64 69 66 66 65 72 65 6e 63 65 73 20 62 65 74 77  differences betw
3370: 65 65 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69  een SQLite versi
3380: 6f 6e 20 33 2e 34 2e 32 0a 20 20 61 6e 64 20 33  on 3.4.2.  and 3
3390: 2e 35 2e 30 2e 0a 7d 0a 64 6f 63 20 7b 52 65 6c  .5.0..}.doc {Rel
33a0: 65 61 73 65 20 48 69 73 74 6f 72 79 7d 20 7b 63  ease History} {c
33b0: 68 61 6e 67 65 73 2e 68 74 6d 6c 7d 20 7b 0a 20  hanges.html} {. 
33c0: 20 41 20 63 68 72 6f 6e 6f 6c 6f 67 79 20 6f 66   A chronology of
33d0: 20 53 51 4c 69 74 65 20 72 65 6c 65 61 73 65 73   SQLite releases
33e0: 20 67 6f 69 6e 67 20 62 61 63 6b 20 74 6f 20 76   going back to v
33f0: 65 72 73 69 6f 6e 20 31 2e 30 2e 30 0a 7d 0a 64  ersion 1.0.0.}.d
3400: 6f 63 20 7b 42 61 63 6b 77 61 72 64 73 20 43 6f  oc {Backwards Co
3410: 6d 70 61 74 69 62 69 6c 69 74 79 7d 20 7b 66 6f  mpatibility} {fo
3420: 72 6d 61 74 63 68 6e 67 2e 68 74 6d 6c 7d 20 7b  rmatchng.html} {
3430: 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74  .  This document
3440: 20 64 65 74 61 69 6c 73 20 61 6c 6c 20 6f 66 20   details all of 
3450: 74 68 65 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65  the incompatible
3460: 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20   changes to the 
3470: 53 51 4c 69 74 65 0a 20 20 66 69 6c 65 20 66 6f  SQLite.  file fo
3480: 72 6d 61 74 20 74 68 61 74 20 68 61 76 65 20 6f  rmat that have o
3490: 63 63 75 72 72 65 64 20 73 69 6e 63 65 20 76 65  ccurred since ve
34a0: 72 73 69 6f 6e 20 31 2e 30 2e 30 2e 0a 7d 0a 0a  rsion 1.0.0..}..
34b0: 64 6f 63 20 7b 50 72 69 76 61 74 65 20 42 72 61  doc {Private Bra
34c0: 6e 63 68 65 73 7d 20 7b 70 72 69 76 61 74 65 62  nches} {privateb
34d0: 72 61 6e 63 68 2e 68 74 6d 6c 7d 20 7b 0a 20 20  ranch.html} {.  
34e0: 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 73 75  This document su
34f0: 67 67 65 73 74 73 20 70 72 6f 63 65 64 75 72 65  ggests procedure
3500: 73 20 66 6f 72 20 6d 61 69 6e 74 61 69 6e 69 6e  s for maintainin
3510: 67 20 61 20 70 72 69 76 61 74 65 20 62 72 61 6e  g a private bran
3520: 63 68 0a 20 20 6f 72 20 66 6f 72 6b 20 6f 66 20  ch.  or fork of 
3530: 53 51 4c 69 74 65 20 61 6e 64 20 6b 65 65 70 69  SQLite and keepi
3540: 6e 67 20 74 68 61 74 20 62 72 61 6e 63 68 20 6f  ng that branch o
3550: 72 20 66 6f 72 6b 20 69 6e 20 73 79 6e 63 20 77  r fork in sync w
3560: 69 74 68 20 74 68 65 0a 20 20 70 75 62 6c 69 63  ith the.  public
3570: 20 53 51 4c 69 74 65 20 73 6f 75 72 63 65 20 74   SQLite source t
3580: 72 65 65 2e 0a 7d 0a 0a 0a 68 65 61 64 69 6e 67  ree..}...heading
3590: 20 7b 4f 62 73 6f 6c 65 74 65 20 44 6f 63 75 6d   {Obsolete Docum
35a0: 65 6e 74 73 7d 20 6f 62 73 6f 6c 65 74 65 20 7b  ents} obsolete {
35b0: 0a 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  .  The following
35c0: 20 64 6f 63 75 6d 65 6e 74 73 20 61 72 65 20 6e   documents are n
35d0: 6f 20 6c 6f 6e 67 65 72 20 63 75 72 72 65 6e 74  o longer current
35e0: 20 61 6e 64 20 61 72 65 20 72 65 74 61 69 6e 65   and are retaine
35f0: 64 0a 20 20 66 6f 72 20 68 69 73 74 6f 72 69 63  d.  for historic
3600: 61 6c 20 72 65 66 65 72 65 6e 63 65 20 6f 6e 6c  al reference onl
3610: 79 2e 0a 20 20 54 68 65 73 65 20 64 6f 63 75 6d  y..  These docum
3620: 65 6e 74 73 20 67 65 6e 65 72 61 6c 6c 79 20 70  ents generally p
3630: 65 72 74 61 69 6e 20 74 6f 20 6f 75 74 2d 6f 66  ertain to out-of
3640: 2d 64 61 74 65 2c 20 6f 62 73 6f 6c 65 74 65 2c  -date, obsolete,
3650: 20 61 6e 64 2f 6f 72 0a 20 20 64 65 70 72 65 63   and/or.  deprec
3660: 61 74 65 64 20 66 65 61 74 75 72 65 73 20 61 6e  ated features an
3670: 64 20 65 78 74 65 6e 73 69 6f 6e 73 2e 0a 7d 0a  d extensions..}.
3680: 64 6f 63 20 7b 41 73 79 6e 63 68 72 6f 6e 6f 75  doc {Asynchronou
3690: 73 20 49 4f 20 4d 6f 64 65 7d 20 7b 61 73 79 6e  s IO Mode} {asyn
36a0: 63 76 66 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54  cvfs.html} {.  T
36b0: 68 69 73 20 70 61 67 65 20 64 65 73 63 72 69 62  his page describ
36c0: 65 73 20 74 68 65 20 61 73 79 6e 63 68 72 6f 6e  es the asynchron
36d0: 6f 75 73 20 49 4f 20 65 78 74 65 6e 73 69 6f 6e  ous IO extension
36e0: 20 64 65 76 65 6c 6f 70 65 64 20 61 6c 6f 6e 67   developed along
36f0: 73 69 64 65 0a 20 20 53 51 4c 69 74 65 2e 20 55  side.  SQLite. U
3700: 73 69 6e 67 20 61 73 79 6e 63 68 72 6f 6e 6f 75  sing asynchronou
3710: 73 20 49 4f 20 63 61 6e 20 63 61 75 73 65 20 53  s IO can cause S
3720: 51 4c 69 74 65 20 74 6f 20 61 70 70 65 61 72 20  QLite to appear 
3730: 6d 6f 72 65 20 72 65 73 70 6f 6e 73 69 76 65 0a  more responsive.
3740: 20 20 62 79 20 64 65 6c 65 67 61 74 69 6e 67 20    by delegating 
3750: 64 61 74 61 62 61 73 65 20 77 72 69 74 65 73 20  database writes 
3760: 74 6f 20 61 20 62 61 63 6b 67 72 6f 75 6e 64 20  to a background 
3770: 74 68 72 65 61 64 2e 20 20 3c 69 3e 4e 42 3a 20  thread.  <i>NB: 
3780: 20 54 68 69 73 0a 20 20 65 78 74 65 6e 73 69 6f   This.  extensio
3790: 6e 20 69 73 20 64 65 70 72 65 63 61 74 65 64 2e  n is deprecated.
37a0: 20 20 5b 57 41 4c 20 6d 6f 64 65 5d 20 69 73 20    [WAL mode] is 
37b0: 72 65 63 6f 6d 6d 65 6e 64 65 64 20 61 73 20 61  recommended as a
37c0: 20 72 65 70 6c 61 63 65 6d 65 6e 74 2e 3c 2f 69   replacement.</i
37d0: 3e 0a 7d 0a 64 6f 63 20 7b 56 65 72 73 69 6f 6e  >.}.doc {Version
37e0: 20 32 20 43 2f 43 2b 2b 20 41 50 49 7d 20 7b 63   2 C/C++ API} {c
37f0: 5f 69 6e 74 65 72 66 61 63 65 2e 68 74 6d 6c 7d  _interface.html}
3800: 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70 74 69   {.  A descripti
3810: 6f 6e 20 6f 66 20 74 68 65 20 43 2f 43 2b 2b 20  on of the C/C++ 
3820: 69 6e 74 65 72 66 61 63 65 20 62 69 6e 64 69 6e  interface bindin
3830: 67 73 20 66 6f 72 20 53 51 4c 69 74 65 20 74 68  gs for SQLite th
3840: 72 6f 75 67 68 20 76 65 72 73 69 6f 6e 20 0a 20  rough version . 
3850: 20 32 2e 38 0a 7d 0a 64 6f 63 20 7b 56 65 72 73   2.8.}.doc {Vers
3860: 69 6f 6e 20 32 20 44 61 74 61 54 79 70 65 73 20  ion 2 DataTypes 
3870: 7d 20 7b 64 61 74 61 74 79 70 65 73 2e 68 74 6d  } {datatypes.htm
3880: 6c 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70  l} {.  A descrip
3890: 74 69 6f 6e 20 6f 66 20 68 6f 77 20 53 51 4c 69  tion of how SQLi
38a0: 74 65 20 76 65 72 73 69 6f 6e 20 32 20 68 61 6e  te version 2 han
38b0: 64 6c 65 73 20 53 51 4c 20 64 61 74 61 74 79 70  dles SQL datatyp
38c0: 65 73 2e 0a 20 20 53 68 6f 72 74 20 73 75 6d 6d  es..  Short summ
38d0: 61 72 79 3a 20 20 45 76 65 72 79 74 68 69 6e 67  ary:  Everything
38e0: 20 69 73 20 61 20 73 74 72 69 6e 67 2e 0a 7d 0a   is a string..}.
38f0: 64 6f 63 20 7b 56 44 42 45 20 54 75 74 6f 72 69  doc {VDBE Tutori
3900: 61 6c 7d 20 7b 76 64 62 65 2e 68 74 6d 6c 7d 20  al} {vdbe.html} 
3910: 7b 0a 20 20 54 68 65 20 56 44 42 45 20 69 73 20  {.  The VDBE is 
3920: 74 68 65 20 73 75 62 73 79 73 74 65 6d 20 77 69  the subsystem wi
3930: 74 68 69 6e 20 53 51 4c 69 74 65 20 74 68 61 74  thin SQLite that
3940: 20 64 6f 65 73 20 74 68 65 20 61 63 74 75 61 6c   does the actual
3950: 20 77 6f 72 6b 20 6f 66 0a 20 20 65 78 65 63 75   work of.  execu
3960: 74 69 6e 67 20 53 51 4c 20 73 74 61 74 65 6d 65  ting SQL stateme
3970: 6e 74 73 2e 20 20 54 68 69 73 20 70 61 67 65 20  nts.  This page 
3980: 64 65 73 63 72 69 62 65 73 20 74 68 65 20 70 72  describes the pr
3990: 69 6e 63 69 70 6c 65 73 20 6f 66 20 6f 70 65 72  inciples of oper
39a0: 61 74 69 6f 6e 0a 20 20 66 6f 72 20 74 68 65 20  ation.  for the 
39b0: 56 44 42 45 20 69 6e 20 53 51 4c 69 74 65 20 76  VDBE in SQLite v
39c0: 65 72 73 69 6f 6e 20 32 2e 37 2e 20 20 54 68 69  ersion 2.7.  Thi
39d0: 73 20 69 73 20 65 73 73 65 6e 74 69 61 6c 20 72  s is essential r
39e0: 65 61 64 69 6e 67 20 66 6f 72 20 61 6e 79 6f 6e  eading for anyon
39f0: 65 0a 20 20 77 68 6f 20 77 61 6e 74 20 74 6f 20  e.  who want to 
3a00: 6d 6f 64 69 66 79 20 74 68 65 20 53 51 4c 69 74  modify the SQLit
3a10: 65 20 73 6f 75 72 63 65 73 2e 0a 7d 0a 64 6f 63  e sources..}.doc
3a20: 20 7b 53 51 4c 69 74 65 20 56 65 72 73 69 6f 6e   {SQLite Version
3a30: 20 33 7d 20 7b 76 65 72 73 69 6f 6e 33 2e 68 74   3} {version3.ht
3a40: 6d 6c 7d 20 7b 0a 20 20 41 20 73 75 6d 6d 61 72  ml} {.  A summar
3a50: 79 20 6f 66 20 74 68 65 20 63 68 61 6e 67 65 73  y of the changes
3a60: 20 62 65 74 77 65 65 6e 20 53 51 4c 69 74 65 20   between SQLite 
3a70: 76 65 72 73 69 6f 6e 20 32 2e 38 20 61 6e 64 20  version 2.8 and 
3a80: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33  SQLite version 3
3a90: 2e 30 2e 0a 7d 0a 64 6f 63 20 7b 56 65 72 73 69  .0..}.doc {Versi
3aa0: 6f 6e 20 33 20 43 2f 43 2b 2b 20 41 50 49 7d 20  on 3 C/C++ API} 
3ab0: 7b 63 61 70 69 33 2e 68 74 6d 6c 7d 20 7b 0a 20  {capi3.html} {. 
3ac0: 20 41 20 73 75 6d 6d 61 72 79 20 6f 66 20 74 68   A summary of th
3ad0: 65 20 41 50 49 20 72 65 6c 61 74 65 64 20 63 68  e API related ch
3ae0: 61 6e 67 65 73 20 62 65 74 77 65 65 6e 20 53 51  anges between SQ
3af0: 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 32 2e 38  Lite version 2.8
3b00: 20 61 6e 64 20 0a 20 20 53 51 4c 69 74 65 20 76   and .  SQLite v
3b10: 65 72 73 69 6f 6e 20 33 2e 30 2e 20 0a 7d 0a 64  ersion 3.0. .}.d
3b20: 6f 63 20 7b 53 70 65 65 64 20 43 6f 6d 70 61 72  oc {Speed Compar
3b30: 69 73 6f 6e 7d 20 7b 73 70 65 65 64 2e 68 74 6d  ison} {speed.htm
3b40: 6c 7d 20 7b 0a 20 20 54 68 65 20 73 70 65 65 64  l} {.  The speed
3b50: 20 6f 66 20 76 65 72 73 69 6f 6e 20 32 2e 37 2e   of version 2.7.
3b60: 36 20 6f 66 20 53 51 4c 69 74 65 20 69 73 20 63  6 of SQLite is c
3b70: 6f 6d 70 61 72 65 64 20 61 67 61 69 6e 73 74 20  ompared against 
3b80: 50 6f 73 74 67 72 65 53 51 4c 20 61 6e 64 0a 20  PostgreSQL and. 
3b90: 20 4d 79 53 51 4c 2e 0a 7d 0a                     MySQL..}.