Documentation Source Text

Hex Artifact Content
Login

Artifact 91b4674b8c6ede44948f784ed2f3ee4a8ee86f3d:


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 64 6f 63  ut SQLite..}.doc
0480: 20 7b 41 6c 70 68 61 62 65 74 69 63 61 6c 20 4c   {Alphabetical L
0490: 69 73 74 69 6e 67 20 4f 66 20 44 6f 63 75 6d 65  isting Of Docume
04a0: 6e 74 73 7d 20 7b 64 6f 63 6c 69 73 74 2e 68 74  nts} {doclist.ht
04b0: 6d 6c 7d 20 7b 0a 20 20 41 20 6c 69 73 74 20 6f  ml} {.  A list o
04c0: 66 20 61 6c 6c 20 74 69 74 6c 65 64 20 70 61 67  f all titled pag
04d0: 65 73 20 6f 6e 20 74 68 69 73 20 77 65 62 73 69  es on this websi
04e0: 74 65 2c 20 73 6f 72 74 65 64 20 62 79 20 74 69  te, sorted by ti
04f0: 74 6c 65 2e 0a 7d 0a 64 6f 63 20 7b 57 65 62 73  tle..}.doc {Webs
0500: 69 74 65 20 4b 65 79 77 6f 72 64 20 49 6e 64 65  ite Keyword Inde
0510: 78 7d 20 7b 6b 65 79 77 6f 72 64 5f 69 6e 64 65  x} {keyword_inde
0520: 78 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 63 72  x.html} {.  A cr
0530: 6f 73 73 2d 72 65 66 65 72 65 6e 63 65 20 66 72  oss-reference fr
0540: 6f 6d 20 6b 65 79 77 6f 72 64 73 20 74 6f 20 76  om keywords to v
0550: 61 72 69 6f 75 73 20 70 61 67 65 73 20 77 69 74  arious pages wit
0560: 68 69 6e 20 74 68 69 73 20 77 65 62 73 69 74 65  hin this website
0570: 2e 0a 7d 0a 64 6f 63 20 7b 50 65 72 6d 75 74 65  ..}.doc {Permute
0580: 64 20 54 69 74 6c 65 20 49 6e 64 65 78 7d 20 7b  d Title Index} {
0590: 73 69 74 65 6d 61 70 2e 68 74 6d 6c 23 70 69 6e  sitemap.html#pin
05a0: 64 65 78 7d 20 7b 0a 20 20 41 6c 73 6f 20 6b 6e  dex} {.  Also kn
05b0: 6f 77 6e 20 61 73 20 61 20 22 6b 65 79 77 6f 72  own as a "keywor
05c0: 64 20 69 6e 20 63 6f 6e 74 65 78 74 22 20 6f 72  d in context" or
05d0: 20 22 4b 57 49 43 22 20 69 6e 64 65 78 20 6f 72   "KWIC" index or
05e0: 20 61 73 20 61 20 63 6f 6e 63 6f 72 64 61 6e 63   as a concordanc
05f0: 65 2c 0a 20 20 74 68 69 73 20 64 6f 63 75 6d 65  e,.  this docume
0600: 6e 74 20 69 73 20 61 20 6c 69 73 74 69 6e 67 20  nt is a listing 
0610: 6f 66 20 61 6c 6c 20 6f 74 68 65 72 20 64 6f 63  of all other doc
0620: 75 6d 65 6e 74 73 20 73 6f 72 74 65 64 20 62 79  uments sorted by
0630: 20 6b 65 79 77 6f 72 64 2e 0a 7d 0a 0a 0a 68 65   keyword..}...he
0640: 61 64 69 6e 67 20 7b 53 51 4c 69 74 65 20 50 72  ading {SQLite Pr
0650: 6f 67 72 61 6d 6d 69 6e 67 20 49 6e 74 65 72 66  ogramming Interf
0660: 61 63 65 73 7d 20 70 72 6f 67 72 61 6d 6d 69 6e  aces} programmin
0670: 67 20 7b 0a 20 20 44 6f 63 75 6d 65 6e 74 61 74  g {.  Documentat
0680: 69 6f 6e 20 64 65 73 63 72 69 62 69 6e 67 20 74  ion describing t
0690: 68 65 20 41 50 49 73 20 75 73 65 64 20 74 6f 20  he APIs used to 
06a0: 70 72 6f 67 72 61 6d 20 53 51 4c 69 74 65 2c 20  program SQLite, 
06b0: 61 6e 64 20 74 68 65 20 53 51 4c 0a 20 20 64 69  and the SQL.  di
06c0: 61 6c 65 63 74 20 74 68 61 74 20 69 74 20 69 6e  alect that it in
06d0: 74 65 72 70 72 65 74 73 2e 0a 7d 0a 0a 64 6f 63  terprets..}..doc
06e0: 20 7b 53 51 4c 69 74 65 20 49 6e 20 35 20 4d 69   {SQLite In 5 Mi
06f0: 6e 75 74 65 73 20 4f 72 20 4c 65 73 73 7d 20 7b  nutes Or Less} {
0700: 71 75 69 63 6b 73 74 61 72 74 2e 68 74 6d 6c 7d  quickstart.html}
0710: 20 7b 0a 20 20 41 20 76 65 72 79 20 71 75 69 63   {.  A very quic
0720: 6b 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 74  k introduction t
0730: 6f 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 77 69  o programming wi
0740: 74 68 20 53 51 4c 69 74 65 2e 0a 7d 0a 64 6f 63  th SQLite..}.doc
0750: 20 7b 49 6e 74 72 6f 64 75 63 74 69 6f 6e 20 74   {Introduction t
0760: 6f 20 74 68 65 20 43 2f 43 2b 2b 20 41 50 49 20  o the C/C++ API 
0770: 7d 20 7b 63 69 6e 74 72 6f 2e 68 74 6d 6c 7d 20  } {cintro.html} 
0780: 7b 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e  {.  This documen
0790: 74 20 69 6e 74 72 6f 64 75 63 65 73 20 74 68 65  t introduces the
07a0: 20 43 2f 43 2b 2b 20 41 50 49 2e 20 55 73 65 72   C/C++ API. User
07b0: 73 20 73 68 6f 75 6c 64 20 72 65 61 64 20 74 68  s should read th
07c0: 69 73 20 64 6f 63 75 6d 65 6e 74 20 0a 20 20 62  is document .  b
07d0: 65 66 6f 72 65 20 74 68 65 20 43 2f 43 2b 2b 20  efore the C/C++ 
07e0: 41 50 49 20 52 65 66 65 72 65 6e 63 65 20 47 75  API Reference Gu
07f0: 69 64 65 20 6c 69 6e 6b 65 64 20 62 65 6c 6f 77  ide linked below
0800: 2e 0a 7d 0a 64 6f 63 20 7b 48 6f 77 20 54 6f 20  ..}.doc {How To 
0810: 43 6f 6d 70 69 6c 65 20 53 51 4c 69 74 65 7d 20  Compile SQLite} 
0820: 7b 68 6f 77 74 6f 63 6f 6d 70 69 6c 65 2e 68 74  {howtocompile.ht
0830: 6d 6c 7d 20 7b 0a 20 20 49 6e 73 74 72 75 63 74  ml} {.  Instruct
0840: 69 6f 6e 73 20 61 6e 64 20 68 69 6e 74 73 20 66  ions and hints f
0850: 6f 72 20 63 6f 6d 70 69 6c 69 6e 67 20 53 51 4c  or compiling SQL
0860: 69 74 65 20 43 20 63 6f 64 65 20 61 6e 64 20 69  ite C code and i
0870: 6e 74 65 67 72 61 74 69 6e 67 0a 20 20 74 68 61  ntegrating.  tha
0880: 74 20 63 6f 64 65 20 77 69 74 68 20 79 6f 75 72  t code with your
0890: 20 6f 77 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e   own application
08a0: 2e 0a 7d 0a 64 6f 63 20 7b 43 2f 43 2b 2b 20 41  ..}.doc {C/C++ A
08b0: 50 49 20 52 65 66 65 72 65 6e 63 65 7d 20 7b 63  PI Reference} {c
08c0: 33 72 65 66 2f 69 6e 74 72 6f 2e 68 74 6d 6c 7d  3ref/intro.html}
08d0: 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65   {.  This docume
08e0: 6e 74 20 64 65 73 63 72 69 62 65 73 20 65 61 63  nt describes eac
08f0: 68 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 73  h API function s
0900: 65 70 61 72 61 74 65 6c 79 2e 0a 7d 0a 64 6f 63  eparately..}.doc
0910: 20 7b 52 65 73 75 6c 74 20 43 6f 64 65 73 7d 20   {Result Codes} 
0920: 7b 72 65 73 63 6f 64 65 2e 68 74 6d 6c 7d 20 7b  {rescode.html} {
0930: 0a 20 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e  .  A description
0940: 20 6f 66 20 74 68 65 20 6d 65 61 6e 69 6e 67 73   of the meanings
0950: 20 6f 66 20 74 68 65 20 6e 75 6d 65 72 69 63 20   of the numeric 
0960: 72 65 73 75 6c 74 20 63 6f 64 65 73 0a 20 20 72  result codes.  r
0970: 65 74 75 72 6e 65 64 20 62 79 20 76 61 72 69 6f  eturned by vario
0980: 75 73 20 43 2f 43 2b 2b 20 69 6e 74 65 72 66 61  us C/C++ interfa
0990: 63 65 73 2e 0a 7d 0a 64 6f 63 20 7b 54 63 6c 20  ces..}.doc {Tcl 
09a0: 41 50 49 7d 20 7b 74 63 6c 73 71 6c 69 74 65 2e  API} {tclsqlite.
09b0: 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64 65 73 63  html} {.  A desc
09c0: 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 54  ription of the T
09d0: 43 4c 20 69 6e 74 65 72 66 61 63 65 20 62 69 6e  CL interface bin
09e0: 64 69 6e 67 73 20 66 6f 72 20 53 51 4c 69 74 65  dings for SQLite
09f0: 2e 0a 7d 0a 64 6f 63 20 7b 53 51 4c 20 53 79 6e  ..}.doc {SQL Syn
0a00: 74 61 78 7d 20 7b 6c 61 6e 67 2e 68 74 6d 6c 7d  tax} {lang.html}
0a10: 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65   {.  This docume
0a20: 6e 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65  nt describes the
0a30: 20 53 51 4c 20 6c 61 6e 67 75 61 67 65 20 74 68   SQL language th
0a40: 61 74 20 69 73 20 75 6e 64 65 72 73 74 6f 6f 64  at is understood
0a50: 20 62 79 0a 20 20 53 51 4c 69 74 65 2e 20 20 0a   by.  SQLite.  .
0a60: 7d 0a 64 6f 63 20 7b 50 72 61 67 6d 61 20 63 6f  }.doc {Pragma co
0a70: 6d 6d 61 6e 64 73 7d 20 7b 70 72 61 67 6d 61 2e  mmands} {pragma.
0a80: 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64  html} {.  This d
0a90: 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65  ocument describe
0aa0: 73 20 53 51 4c 69 74 65 20 70 65 72 66 6f 72 6d  s SQLite perform
0ab0: 61 6e 63 65 20 74 75 6e 69 6e 67 20 6f 70 74 69  ance tuning opti
0ac0: 6f 6e 73 20 61 6e 64 20 6f 74 68 65 72 20 0a 20  ons and other . 
0ad0: 20 73 70 65 63 69 61 6c 20 70 75 72 70 6f 73 65   special purpose
0ae0: 20 64 61 74 61 62 61 73 65 20 63 6f 6d 6d 61 6e   database comman
0af0: 64 73 2e 0a 7d 0a 64 6f 63 20 7b 43 6f 72 65 20  ds..}.doc {Core 
0b00: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 7d 20 7b  SQL Functions} {
0b10: 6c 61 6e 67 5f 63 6f 72 65 66 75 6e 63 2e 68 74  lang_corefunc.ht
0b20: 6d 6c 7d 20 7b 0a 20 20 47 65 6e 65 72 61 6c 2d  ml} {.  General-
0b30: 70 75 72 70 6f 73 65 20 62 75 69 6c 74 2d 69 6e  purpose built-in
0b40: 20 73 63 61 6c 61 72 20 53 51 4c 20 66 75 6e 63   scalar SQL func
0b50: 74 69 6f 6e 73 2e 0a 7d 0a 64 6f 63 20 7b 41 67  tions..}.doc {Ag
0b60: 67 72 65 67 61 74 65 20 53 51 4c 20 46 75 6e 63  gregate SQL Func
0b70: 74 69 6f 6e 73 7d 20 7b 6c 61 6e 67 5f 61 67 67  tions} {lang_agg
0b80: 66 75 6e 63 2e 68 74 6d 6c 7d 20 7b 0a 20 20 47  func.html} {.  G
0b90: 65 6e 65 72 61 6c 2d 70 75 72 70 6f 73 65 20 62  eneral-purpose b
0ba0: 75 69 6c 74 2d 69 6e 20 61 67 67 72 65 67 61 74  uilt-in aggregat
0bb0: 65 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 2e  e SQL functions.
0bc0: 0a 7d 0a 64 6f 63 20 7b 44 61 74 65 20 61 6e 64  .}.doc {Date and
0bd0: 20 54 69 6d 65 20 53 51 4c 20 46 75 6e 63 74 69   Time SQL Functi
0be0: 6f 6e 73 7d 20 7b 6c 61 6e 67 5f 64 61 74 65 66  ons} {lang_datef
0bf0: 75 6e 63 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51  unc.html} {.  SQ
0c00: 4c 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20  L functions for 
0c10: 6d 61 6e 69 70 75 6c 61 74 69 6e 67 20 64 61 74  manipulating dat
0c20: 65 73 20 61 6e 64 20 74 69 6d 65 73 2e 0a 7d 0a  es and times..}.
0c30: 64 6f 63 20 7b 4a 53 4f 4e 20 53 51 4c 20 46 75  doc {JSON SQL Fu
0c40: 6e 63 74 69 6f 6e 73 7d 20 7b 6a 73 6f 6e 31 2e  nctions} {json1.
0c50: 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c 20 66 75  html} {.  SQL fu
0c60: 6e 63 74 69 6f 6e 73 20 66 6f 72 20 63 72 65 61  nctions for crea
0c70: 74 69 6e 67 2c 20 70 61 72 73 69 6e 67 2c 20 61  ting, parsing, a
0c80: 6e 64 20 71 75 65 72 79 69 6e 67 20 4a 53 4f 4e  nd querying JSON
0c90: 20 63 6f 6e 74 65 6e 74 2e 0a 7d 0a 64 6f 63 20   content..}.doc 
0ca0: 7b 44 61 74 61 54 79 70 65 73 7d 20 7b 64 61 74  {DataTypes} {dat
0cb0: 61 74 79 70 65 33 2e 68 74 6d 6c 7d 20 7b 0a 20  atype3.html} {. 
0cc0: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20   SQLite version 
0cd0: 33 20 69 6e 74 72 6f 64 75 63 65 73 20 74 68 65  3 introduces the
0ce0: 20 63 6f 6e 63 65 70 74 20 6f 66 20 6d 61 6e 69   concept of mani
0cf0: 66 65 73 74 20 74 79 70 69 6e 67 2c 20 77 68 65  fest typing, whe
0d00: 72 65 20 74 68 65 0a 20 20 74 79 70 65 20 6f 66  re the.  type of
0d10: 20 61 20 76 61 6c 75 65 20 69 73 20 61 73 73 6f   a value is asso
0d20: 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20  ciated with the 
0d30: 76 61 6c 75 65 20 69 74 73 65 6c 66 2c 20 6e 6f  value itself, no
0d40: 74 20 74 68 65 20 63 6f 6c 75 6d 6e 20 74 68 61  t the column tha
0d50: 74 0a 20 20 69 74 20 69 73 20 73 74 6f 72 65 64  t.  it is stored
0d60: 20 69 6e 2e 0a 20 20 54 68 69 73 20 70 61 67 65   in..  This page
0d70: 20 64 65 73 63 72 69 62 65 73 20 64 61 74 61 20   describes data 
0d80: 74 79 70 69 6e 67 20 66 6f 72 20 53 51 4c 69 74  typing for SQLit
0d90: 65 20 76 65 72 73 69 6f 6e 20 33 20 69 6e 20 66  e version 3 in f
0da0: 75 72 74 68 65 72 20 64 65 74 61 69 6c 2e 0a 7d  urther detail..}
0db0: 0a 0a 68 65 61 64 69 6e 67 20 7b 53 51 4c 69 74  ..heading {SQLit
0dc0: 65 20 46 65 61 74 75 72 65 73 20 61 6e 64 20 45  e Features and E
0dd0: 78 74 65 6e 73 69 6f 6e 73 7d 20 65 78 74 65 6e  xtensions} exten
0de0: 73 69 6f 6e 73 20 7b 0a 20 20 50 61 67 65 73 20  sions {.  Pages 
0df0: 64 65 73 63 72 69 62 69 6e 67 20 73 70 65 63 69  describing speci
0e00: 66 69 63 20 66 65 61 74 75 72 65 73 20 6f 72 20  fic features or 
0e10: 65 78 74 65 6e 73 69 6f 6e 20 6d 6f 64 75 6c 65  extension module
0e20: 73 20 6f 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 64  s of SQLite..}.d
0e30: 6f 63 20 7b 38 2b 33 20 46 69 6c 65 6e 61 6d 65  oc {8+3 Filename
0e40: 73 7d 20 7b 73 68 6f 72 74 6e 61 6d 65 73 2e 68  s} {shortnames.h
0e50: 74 6d 6c 7d 20 7b 0a 20 20 48 6f 77 20 74 6f 20  tml} {.  How to 
0e60: 6d 61 6b 65 20 53 51 4c 69 74 65 20 77 6f 72 6b  make SQLite work
0e70: 20 6f 6e 20 66 69 6c 65 73 79 73 74 65 6d 73 20   on filesystems 
0e80: 74 68 61 74 20 6f 6e 6c 79 20 73 75 70 70 6f 72  that only suppor
0e90: 74 20 0a 20 20 38 2b 33 20 66 69 6c 65 6e 61 6d  t .  8+3 filenam
0ea0: 65 73 2e 0a 7d 0a 64 6f 63 20 7b 41 75 74 6f 69  es..}.doc {Autoi
0eb0: 6e 63 72 65 6d 65 6e 74 7d 20 7b 61 75 74 6f 69  ncrement} {autoi
0ec0: 6e 63 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64  nc.html} {.  A d
0ed0: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68  escription of th
0ee0: 65 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 20  e AUTOINCREMENT 
0ef0: 6b 65 79 77 6f 72 64 20 69 6e 20 53 51 4c 69 74  keyword in SQLit
0f00: 65 2c 20 77 68 61 74 20 69 74 20 64 6f 65 73 2c  e, what it does,
0f10: 0a 20 20 77 68 79 20 69 74 20 69 73 20 73 6f 6d  .  why it is som
0f20: 65 74 69 6d 65 73 20 75 73 65 66 75 6c 2c 20 61  etimes useful, a
0f30: 6e 64 20 77 68 79 20 69 74 20 73 68 6f 75 6c 64  nd why it should
0f40: 20 62 65 20 61 76 6f 69 64 65 64 20 69 66 20 6e   be avoided if n
0f50: 6f 74 0a 20 20 73 74 72 69 63 74 6c 79 20 6e 65  ot.  strictly ne
0f60: 63 65 73 73 61 72 79 2e 0a 7d 0a 64 6f 63 20 7b  cessary..}.doc {
0f70: 42 61 63 6b 75 70 20 41 50 49 7d 20 7b 62 61 63  Backup API} {bac
0f80: 6b 75 70 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68  kup.html} {.  Th
0f90: 65 20 5b 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  e [sqlite3_backu
0fa0: 70 5f 69 6e 69 74 20 7c 20 6f 6e 6c 69 6e 65 2d  p_init | online-
0fb0: 62 61 63 6b 75 70 20 69 6e 74 65 72 66 61 63 65  backup interface
0fc0: 5d 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  ] can be used to
0fd0: 0a 20 20 63 6f 70 79 20 63 6f 6e 74 65 6e 74 20  .  copy content 
0fe0: 66 72 6f 6d 20 61 20 64 69 73 6b 20 66 69 6c 65  from a disk file
0ff0: 20 69 6e 74 6f 20 61 6e 20 69 6e 2d 6d 65 6d 6f   into an in-memo
1000: 72 79 20 64 61 74 61 62 61 73 65 20 6f 72 20 76  ry database or v
1010: 69 63 65 0a 20 20 76 65 72 73 61 20 61 6e 64 20  ice.  versa and 
1020: 69 74 20 63 61 6e 20 6d 61 6b 65 20 61 20 68 6f  it can make a ho
1030: 74 20 62 61 63 6b 75 70 20 6f 66 20 61 20 6c 69  t backup of a li
1040: 76 65 20 64 61 74 61 62 61 73 65 2e 20 20 54 68  ve database.  Th
1050: 69 73 20 61 70 70 6c 69 63 61 74 69 6f 6e 0a 20  is application. 
1060: 20 6e 6f 74 65 20 67 69 76 65 73 20 65 78 61 6d   note gives exam
1070: 70 6c 65 73 20 6f 66 20 68 6f 77 2e 0a 7d 0a 64  ples of how..}.d
1080: 6f 63 20 7b 43 6f 6d 6d 61 6e 64 2d 4c 69 6e 65  oc {Command-Line
1090: 20 53 68 65 6c 6c 7d 20 7b 63 6c 69 2e 68 74 6d   Shell} {cli.htm
10a0: 6c 7d 20 7b 0a 20 20 4e 6f 74 65 73 20 6f 6e 20  l} {.  Notes on 
10b0: 75 73 69 6e 67 20 74 68 65 20 22 73 71 6c 69 74  using the "sqlit
10c0: 65 33 2e 65 78 65 22 20 63 6f 6d 6d 61 6e 64 2d  e3.exe" command-
10d0: 6c 69 6e 65 20 69 6e 74 65 72 66 61 63 65 20 74  line interface t
10e0: 68 61 74 0a 20 20 63 61 6e 20 62 65 20 75 73 65  hat.  can be use
10f0: 64 20 74 6f 20 63 72 65 61 74 65 2c 20 6d 6f 64  d to create, mod
1100: 69 66 79 2c 20 61 6e 64 20 71 75 65 72 79 20 61  ify, and query a
1110: 72 62 69 74 72 61 72 79 20 53 51 4c 69 74 65 0a  rbitrary SQLite.
1120: 20 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73    database files
1130: 2e 0a 7d 0a 64 6f 63 20 7b 45 72 72 6f 72 20 61  ..}.doc {Error a
1140: 6e 64 20 57 61 72 6e 69 6e 67 20 4c 6f 67 7d 20  nd Warning Log} 
1150: 7b 65 72 72 6c 6f 67 2e 68 74 6d 6c 7d 20 7b 0a  {errlog.html} {.
1160: 20 20 53 51 4c 69 74 65 20 73 75 70 70 6f 72 74    SQLite support
1170: 73 20 61 6e 20 22 65 72 72 6f 72 20 61 6e 64 20  s an "error and 
1180: 77 61 72 6e 69 6e 67 20 6c 6f 67 22 20 64 65 73  warning log" des
1190: 69 67 6e 20 74 6f 20 63 61 70 74 75 72 65 20 69  ign to capture i
11a0: 6e 66 6f 72 6d 61 74 69 6f 6e 0a 20 20 61 62 6f  nformation.  abo
11b0: 75 74 20 73 75 73 70 69 63 69 6f 75 73 20 61 6e  ut suspicious an
11c0: 64 2f 6f 72 20 65 72 72 6f 72 20 65 76 65 6e 74  d/or error event
11d0: 73 20 64 75 72 69 6e 67 20 6f 70 65 72 61 74 69  s during operati
11e0: 6f 6e 2e 20 20 45 6d 62 65 64 64 65 64 20 61 70  on.  Embedded ap
11f0: 70 6c 69 63 61 74 69 6f 6e 73 0a 20 20 61 72 65  plications.  are
1200: 20 65 6e 63 6f 75 72 61 67 65 64 20 74 6f 20 65   encouraged to e
1210: 6e 61 62 6c 65 20 74 68 65 20 65 72 72 6f 72 20  nable the error 
1220: 61 6e 64 20 77 61 72 6e 69 6e 67 20 6c 6f 67 20  and warning log 
1230: 74 6f 20 68 65 6c 70 20 77 69 74 68 20 64 65 62  to help with deb
1240: 75 67 67 69 6e 67 0a 20 20 61 70 70 6c 69 63 61  ugging.  applica
1250: 74 69 6f 6e 20 70 72 6f 62 6c 65 6d 73 20 74 68  tion problems th
1260: 61 74 20 61 72 69 73 65 20 69 6e 20 74 68 65 20  at arise in the 
1270: 66 69 65 6c 64 2e 20 20 54 68 69 73 20 64 6f 63  field.  This doc
1280: 75 6d 65 6e 74 20 65 78 70 6c 61 69 6e 73 20 68  ument explains h
1290: 6f 77 0a 20 20 74 6f 20 64 6f 20 74 68 61 74 2e  ow.  to do that.
12a0: 0a 7d 0a 64 6f 63 20 7b 46 6f 72 65 69 67 6e 20  .}.doc {Foreign 
12b0: 4b 65 79 20 53 75 70 70 6f 72 74 7d 20 7b 66 6f  Key Support} {fo
12c0: 72 65 69 67 6e 6b 65 79 73 2e 68 74 6d 6c 7d 20  reignkeys.html} 
12d0: 7b 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e  {.  This documen
12e0: 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20  t describes the 
12f0: 73 75 70 70 6f 72 74 20 66 6f 72 20 66 6f 72 65  support for fore
1300: 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69  ign key constrai
1310: 6e 74 73 20 69 6e 74 72 6f 64 75 63 65 64 0a 20  nts introduced. 
1320: 20 69 6e 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e   in version 3.6.
1330: 31 39 2e 0a 7d 0a 64 6f 63 20 7b 46 75 6c 6c 20  19..}.doc {Full 
1340: 54 65 78 74 20 53 65 61 72 63 68 7d 20 7b 66 74  Text Search} {ft
1350: 73 33 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64  s3.html} {.  A d
1360: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68  escription of th
1370: 65 20 53 51 4c 69 74 65 20 46 75 6c 6c 20 54 65  e SQLite Full Te
1380: 78 74 20 53 65 61 72 63 68 20 28 46 54 53 33 29  xt Search (FTS3)
1390: 20 65 78 74 65 6e 73 69 6f 6e 2e 0a 7d 0a 64 6f   extension..}.do
13a0: 63 20 7b 49 6e 64 65 78 65 73 20 4f 6e 20 45 78  c {Indexes On Ex
13b0: 70 72 65 73 73 69 6f 6e 73 7d 20 7b 65 78 70 72  pressions} {expr
13c0: 69 64 78 2e 68 74 6d 6c 7d 20 7b 0a 20 20 4e 6f  idx.html} {.  No
13d0: 74 65 73 20 6f 6e 20 68 6f 77 20 74 6f 20 63 72  tes on how to cr
13e0: 65 61 74 65 20 69 6e 64 65 78 65 73 20 6f 6e 20  eate indexes on 
13f0: 65 78 70 72 65 73 73 69 6f 6e 73 20 69 6e 73 74  expressions inst
1400: 65 61 64 20 6f 66 20 6a 75 73 74 0a 20 20 69 6e  ead of just.  in
1410: 64 69 76 69 64 75 61 6c 20 63 6f 6c 75 6d 6e 73  dividual columns
1420: 2e 0a 7d 0a 64 6f 63 20 7b 49 6e 74 65 72 6e 61  ..}.doc {Interna
1430: 6c 20 76 65 72 73 75 73 20 45 78 74 65 72 6e 61  l versus Externa
1440: 6c 20 42 6c 6f 62 20 53 74 6f 72 61 67 65 7d 20  l Blob Storage} 
1450: 7b 69 6e 74 65 72 6e 2d 76 2d 65 78 74 65 72 6e  {intern-v-extern
1460: 2d 62 6c 6f 62 2e 68 74 6d 6c 7d 20 7b 0a 20 20  -blob.html} {.  
1470: 53 68 6f 75 6c 64 20 79 6f 75 20 73 74 6f 72 65  Should you store
1480: 20 6c 61 72 67 65 20 42 4c 4f 42 73 20 64 69 72   large BLOBs dir
1490: 65 63 74 6c 79 20 69 6e 20 74 68 65 20 64 61 74  ectly in the dat
14a0: 61 62 61 73 65 2c 20 6f 72 20 73 74 6f 72 65 20  abase, or store 
14b0: 74 68 65 6d 0a 20 20 69 6e 20 66 69 6c 65 73 20  them.  in files 
14c0: 61 6e 64 20 6a 75 73 74 20 72 65 63 6f 72 64 20  and just record 
14d0: 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 69 6e 20  the filename in 
14e0: 74 68 65 20 64 61 74 61 62 61 73 65 3f 20 20 54  the database?  T
14f0: 68 69 73 20 64 6f 63 75 6d 65 6e 74 0a 20 20 73  his document.  s
1500: 65 65 6b 73 20 74 6f 20 73 68 65 64 20 6c 69 67  eeks to shed lig
1510: 68 74 20 6f 6e 20 74 68 61 74 20 71 75 65 73 74  ht on that quest
1520: 69 6f 6e 2e 0a 7d 0a 64 6f 63 20 7b 4c 69 6d 69  ion..}.doc {Limi
1530: 74 73 20 49 6e 20 53 51 4c 69 74 65 7d 20 7b 6c  ts In SQLite} {l
1540: 69 6d 69 74 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20  imits.html} {.  
1550: 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 64 65  This document de
1560: 73 63 72 69 62 65 73 20 6c 69 6d 69 74 61 74 69  scribes limitati
1570: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 28 74  ons of SQLite (t
1580: 68 65 20 6d 61 78 69 6d 75 6d 20 6c 65 6e 67 74  he maximum lengt
1590: 68 20 6f 66 20 61 0a 20 20 73 74 72 69 6e 67 20  h of a.  string 
15a0: 6f 72 20 62 6c 6f 62 2c 20 74 68 65 20 6d 61 78  or blob, the max
15b0: 69 6d 75 6d 20 73 69 7a 65 20 6f 66 20 61 20 64  imum size of a d
15c0: 61 74 61 62 61 73 65 2c 20 74 68 65 20 6d 61 78  atabase, the max
15d0: 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 0a 20  imum number of. 
15e0: 20 74 61 62 6c 65 73 20 69 6e 20 61 20 64 61 74   tables in a dat
15f0: 61 62 61 73 65 2c 20 65 74 63 2e 29 20 61 6e 64  abase, etc.) and
1600: 20 68 6f 77 20 74 68 65 73 65 20 6c 69 6d 69 74   how these limit
1610: 73 20 63 61 6e 20 62 65 20 61 6c 74 65 72 65 64  s can be altered
1620: 20 61 74 0a 20 20 63 6f 6d 70 69 6c 65 2d 74 69   at.  compile-ti
1630: 6d 65 20 61 6e 64 20 72 75 6e 2d 74 69 6d 65 2e  me and run-time.
1640: 0a 7d 0a 64 6f 63 20 7b 4d 65 6d 6f 72 79 2d 4d  .}.doc {Memory-M
1650: 61 70 70 65 64 20 49 2f 4f 7d 20 7b 6d 6d 61 70  apped I/O} {mmap
1660: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c 69 74  .html} {.  SQLit
1670: 65 20 73 75 70 70 6f 72 74 73 20 6d 65 6d 6f 72  e supports memor
1680: 79 2d 6d 61 70 70 65 64 20 49 2f 4f 2e 20 20 4c  y-mapped I/O.  L
1690: 65 61 72 6e 20 68 6f 77 20 74 6f 20 65 6e 61 62  earn how to enab
16a0: 6c 65 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 65 64  le memory-mapped
16b0: 0a 20 20 49 2f 4f 20 61 6e 64 20 61 62 6f 75 74  .  I/O and about
16c0: 20 74 68 65 20 76 61 72 69 6f 75 73 20 61 64 76   the various adv
16d0: 61 6e 74 61 67 65 73 20 61 6e 64 20 64 69 73 61  antages and disa
16e0: 64 76 61 6e 74 61 67 65 73 20 74 6f 20 75 73 69  dvantages to usi
16f0: 6e 67 0a 20 20 6d 65 6d 6f 72 79 2d 6d 61 70 70  ng.  memory-mapp
1700: 65 64 20 49 2f 4f 20 69 6e 20 74 68 69 73 20 64  ed I/O in this d
1710: 6f 63 75 6d 65 6e 74 2e 0a 7d 0a 64 6f 63 20 7b  ocument..}.doc {
1720: 4d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 20 50  Multi-threaded P
1730: 72 6f 67 72 61 6d 73 20 61 6e 64 20 53 51 4c 69  rograms and SQLi
1740: 74 65 7d 20 7b 74 68 72 65 61 64 73 61 66 65 2e  te} {threadsafe.
1750: 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c 69 74 65  html} {.  SQLite
1760: 20 69 73 20 73 61 66 65 20 74 6f 20 75 73 65 20   is safe to use 
1770: 69 6e 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65  in multi-threade
1780: 64 20 70 72 6f 67 72 61 6d 73 2e 20 20 54 68 69  d programs.  Thi
1790: 73 20 64 6f 63 75 6d 65 6e 74 0a 20 20 70 72 6f  s document.  pro
17a0: 76 69 64 65 73 20 74 68 65 20 64 65 74 61 69 6c  vides the detail
17b0: 73 20 61 6e 64 20 68 69 6e 74 73 20 6f 6e 20 68  s and hints on h
17c0: 6f 77 20 74 6f 20 6d 61 78 69 6d 69 7a 65 20 70  ow to maximize p
17d0: 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 7d 0a 64 6f  erformance..}.do
17e0: 63 20 7b 4e 75 6c 6c 20 48 61 6e 64 6c 69 6e 67  c {Null Handling
17f0: 7d 20 7b 6e 75 6c 6c 73 2e 68 74 6d 6c 7d 20 7b  } {nulls.html} {
1800: 0a 20 20 44 69 66 66 65 72 65 6e 74 20 53 51 4c  .  Different SQL
1810: 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65   database engine
1820: 73 20 68 61 6e 64 6c 65 20 4e 55 4c 4c 73 20 69  s handle NULLs i
1830: 6e 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 73  n different ways
1840: 2e 20 20 54 68 65 0a 20 20 53 51 4c 20 73 74 61  .  The.  SQL sta
1850: 6e 64 61 72 64 73 20 61 72 65 20 61 6d 62 69 67  ndards are ambig
1860: 75 6f 75 73 2e 20 20 54 68 69 73 20 28 63 69 72  uous.  This (cir
1870: 63 61 20 32 30 30 33 29 20 64 6f 63 75 6d 65 6e  ca 2003) documen
1880: 74 20 64 65 73 63 72 69 62 65 73 0a 20 20 68 6f  t describes.  ho
1890: 77 20 53 51 4c 69 74 65 20 68 61 6e 64 6c 65 73  w SQLite handles
18a0: 20 4e 55 4c 4c 73 20 69 6e 20 63 6f 6d 70 61 72   NULLs in compar
18b0: 69 73 6f 6e 20 77 69 74 68 20 6f 74 68 65 72 20  ison with other 
18c0: 53 51 4c 20 64 61 74 61 62 61 73 65 20 65 6e 67  SQL database eng
18d0: 69 6e 65 73 2e 0a 7d 0a 64 6f 63 20 7b 50 61 72  ines..}.doc {Par
18e0: 74 69 61 6c 20 49 6e 64 65 78 65 73 7d 20 7b 70  tial Indexes} {p
18f0: 61 72 74 69 61 6c 69 6e 64 65 78 2e 68 74 6d 6c  artialindex.html
1900: 7d 20 7b 0a 20 20 41 20 70 61 72 74 69 61 6c 20  } {.  A partial 
1910: 69 6e 64 65 78 20 69 73 20 61 6e 20 69 6e 64 65  index is an inde
1920: 78 20 74 68 61 74 20 6f 6e 6c 79 20 63 6f 76 65  x that only cove
1930: 72 73 20 61 20 73 75 62 73 65 74 20 6f 66 20 74  rs a subset of t
1940: 68 65 20 72 6f 77 73 20 69 6e 0a 20 20 61 20 74  he rows in.  a t
1950: 61 62 6c 65 2e 20 20 4c 65 61 72 6e 20 68 6f 77  able.  Learn how
1960: 20 74 6f 20 75 73 65 20 70 61 72 74 69 61 6c 20   to use partial 
1970: 69 6e 64 65 78 65 73 20 69 6e 20 53 51 4c 69 74  indexes in SQLit
1980: 65 20 66 72 6f 6d 20 74 68 69 73 20 64 6f 63 75  e from this docu
1990: 6d 65 6e 74 2e 0a 7d 0a 64 6f 63 20 7b 52 2d 54  ment..}.doc {R-T
19a0: 72 65 65 73 7d 20 7b 72 74 72 65 65 2e 68 74 6d  rees} {rtree.htm
19b0: 6c 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70  l} {.  A descrip
19c0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c 69  tion of the SQLi
19d0: 74 65 20 52 2d 54 72 65 65 20 65 78 74 65 6e 73  te R-Tree extens
19e0: 69 6f 6e 2e 20 41 6e 20 52 2d 54 72 65 65 20 69  ion. An R-Tree i
19f0: 73 20 61 20 73 70 65 63 69 61 6c 69 7a 65 64 0a  s a specialized.
1a00: 20 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65    data structure
1a10: 20 74 68 61 74 20 73 75 70 70 6f 72 74 73 20 66   that supports f
1a20: 61 73 74 20 6d 75 6c 74 69 2d 64 69 6d 65 6e 73  ast multi-dimens
1a30: 69 6f 6e 61 6c 20 72 61 6e 67 65 20 71 75 65 72  ional range quer
1a40: 69 65 73 20 6f 66 74 65 6e 0a 20 20 75 73 65 64  ies often.  used
1a50: 20 69 6e 20 67 65 6f 73 70 61 74 69 61 6c 20 73   in geospatial s
1a60: 79 73 74 65 6d 73 2e 0a 7d 0a 64 6f 63 20 7b 52  ystems..}.doc {R
1a70: 75 6e 2d 54 69 6d 65 20 4c 6f 61 64 61 62 6c 65  un-Time Loadable
1a80: 20 45 78 74 65 6e 73 69 6f 6e 73 7d 20 7b 6c 6f   Extensions} {lo
1a90: 61 64 65 78 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20  adext.html} {.  
1aa0: 41 20 67 65 6e 65 72 61 6c 20 6f 76 65 72 76 69  A general overvi
1ab0: 65 77 20 6f 6e 20 68 6f 77 20 72 75 6e 2d 74 69  ew on how run-ti
1ac0: 6d 65 20 6c 6f 61 64 61 62 6c 65 20 65 78 74 65  me loadable exte
1ad0: 6e 73 69 6f 6e 73 20 77 6f 72 6b 2c 20 68 6f 77  nsions work, how
1ae0: 20 74 68 65 79 0a 20 20 61 72 65 20 63 6f 6d 70   they.  are comp
1af0: 69 6c 65 64 2c 20 61 6e 64 20 68 6f 77 20 64 65  iled, and how de
1b00: 76 65 6c 6f 70 65 72 73 20 63 61 6e 20 63 72 65  velopers can cre
1b10: 61 74 65 20 74 68 65 69 72 20 6f 77 6e 20 72 75  ate their own ru
1b20: 6e 2d 74 69 6d 65 20 6c 6f 61 64 61 62 6c 65 0a  n-time loadable.
1b30: 20 20 65 78 74 65 6e 73 69 6f 6e 73 20 66 6f 72    extensions for
1b40: 20 53 51 4c 69 74 65 2e 0a 7d 0a 64 6f 63 20 7b   SQLite..}.doc {
1b50: 53 68 61 72 65 64 20 43 61 63 68 65 20 4d 6f 64  Shared Cache Mod
1b60: 65 7d 20 7b 73 68 61 72 65 64 63 61 63 68 65 2e  e} {sharedcache.
1b70: 68 74 6d 6c 7d 20 7b 0a 20 20 56 65 72 73 69 6f  html} {.  Versio
1b80: 6e 20 33 2e 33 2e 30 20 61 6e 64 20 6c 61 74 65  n 3.3.0 and late
1b90: 72 20 73 75 70 70 6f 72 74 73 20 74 68 65 20 61  r supports the a
1ba0: 62 69 6c 69 74 79 20 66 6f 72 20 74 77 6f 20 6f  bility for two o
1bb0: 72 20 6d 6f 72 65 0a 20 20 64 61 74 61 62 61 73  r more.  databas
1bc0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 6f  e connections to
1bd0: 20 73 68 61 72 65 20 74 68 65 20 73 61 6d 65 20   share the same 
1be0: 70 61 67 65 20 61 6e 64 20 73 63 68 65 6d 61 20  page and schema 
1bf0: 63 61 63 68 65 2e 0a 20 20 54 68 69 73 20 66 65  cache..  This fe
1c00: 61 74 75 72 65 20 69 73 20 75 73 65 66 75 6c 20  ature is useful 
1c10: 66 6f 72 20 63 65 72 74 61 69 6e 20 73 70 65 63  for certain spec
1c20: 69 61 6c 69 7a 65 64 20 61 70 70 6c 69 63 61 74  ialized applicat
1c30: 69 6f 6e 73 2e 0a 7d 0a 64 6f 63 20 7b 55 6e 6c  ions..}.doc {Unl
1c40: 6f 63 6b 20 4e 6f 74 69 66 79 7d 20 7b 75 6e 6c  ock Notify} {unl
1c50: 6f 63 6b 5f 6e 6f 74 69 66 79 2e 68 74 6d 6c 7d  ock_notify.html}
1c60: 20 7b 0a 20 20 54 68 65 20 22 75 6e 6c 6f 63 6b   {.  The "unlock
1c70: 20 6e 6f 74 69 66 79 22 20 66 65 61 74 75 72 65   notify" feature
1c80: 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20   can be used in 
1c90: 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77 69 74 68  conjunction with
1ca0: 0a 20 20 5b 73 68 61 72 65 64 20 63 61 63 68 65  .  [shared cache
1cb0: 20 6d 6f 64 65 5d 20 74 6f 20 6d 6f 72 65 20 65   mode] to more e
1cc0: 66 66 69 63 69 65 6e 74 6c 79 20 6d 61 6e 61 67  fficiently manag
1cd0: 65 20 72 65 73 6f 75 72 63 65 20 63 6f 6e 66 6c  e resource confl
1ce0: 69 63 74 20 28 64 61 74 61 62 61 73 65 0a 20 20  ict (database.  
1cf0: 74 61 62 6c 65 20 6c 6f 63 6b 73 29 2e 0a 7d 0a  table locks)..}.
1d00: 64 6f 63 20 7b 55 52 49 20 46 69 6c 65 6e 61 6d  doc {URI Filenam
1d10: 65 73 7d 20 7b 75 72 69 2e 68 74 6d 6c 7d 20 7b  es} {uri.html} {
1d20: 0a 20 20 54 68 65 20 6e 61 6d 65 73 20 6f 66 20  .  The names of 
1d30: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 63  database files c
1d40: 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20  an be specified 
1d50: 75 73 69 6e 67 20 65 69 74 68 65 72 20 61 6e 20  using either an 
1d60: 6f 72 64 69 6e 61 72 79 0a 20 20 66 69 6c 65 6e  ordinary.  filen
1d70: 61 6d 65 20 6f 72 20 61 20 55 52 49 2e 20 20 55  ame or a URI.  U
1d80: 73 69 6e 67 20 55 52 49 20 66 69 6c 65 6e 61 6d  sing URI filenam
1d90: 65 73 20 70 72 6f 76 69 64 65 73 20 61 64 64 69  es provides addi
1da0: 74 69 6f 6e 61 6c 20 63 61 70 61 62 69 6c 69 74  tional capabilit
1db0: 69 65 73 2c 0a 20 20 61 73 20 74 68 69 73 20 64  ies,.  as this d
1dc0: 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65  ocument describe
1dd0: 73 2e 0a 7d 0a 64 6f 63 20 7b 57 49 54 48 4f 55  s..}.doc {WITHOU
1de0: 54 20 52 4f 57 49 44 20 54 61 62 6c 65 73 7d 20  T ROWID Tables} 
1df0: 7b 77 69 74 68 6f 75 74 72 6f 77 69 64 2e 68 74  {withoutrowid.ht
1e00: 6d 6c 7d 20 7b 0a 20 20 54 68 65 20 57 49 54 48  ml} {.  The WITH
1e10: 4f 55 54 20 52 4f 57 49 44 20 6f 70 74 69 6d 69  OUT ROWID optimi
1e20: 7a 61 74 69 6f 6e 20 69 73 20 61 20 6f 70 74 69  zation is a opti
1e30: 6f 6e 20 74 68 61 74 20 63 61 6e 20 73 6f 6d 65  on that can some
1e40: 74 69 6d 65 73 20 72 65 73 75 6c 74 0a 20 20 69  times result.  i
1e50: 6e 20 73 6d 61 6c 6c 65 72 20 61 6e 64 20 66 61  n smaller and fa
1e60: 73 74 65 72 20 64 61 74 61 62 61 73 65 73 2e 0a  ster databases..
1e70: 7d 0a 64 6f 63 20 7b 57 72 69 74 65 2d 41 68 65  }.doc {Write-Ahe
1e80: 61 64 20 4c 6f 67 20 28 57 41 4c 29 20 4d 6f 64  ad Log (WAL) Mod
1e90: 65 7d 20 7b 77 61 6c 2e 68 74 6d 6c 7d 20 7b 0a  e} {wal.html} {.
1ea0: 20 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f    Transaction co
1eb0: 6e 74 72 6f 6c 20 75 73 69 6e 67 20 61 20 77 72  ntrol using a wr
1ec0: 69 74 65 2d 61 68 65 61 64 20 6c 6f 67 20 6f 66  ite-ahead log of
1ed0: 66 65 72 73 20 6d 6f 72 65 20 63 6f 6e 63 75 72  fers more concur
1ee0: 72 65 6e 63 79 20 61 6e 64 0a 20 20 69 73 20 6f  rency and.  is o
1ef0: 66 74 65 6e 20 66 61 73 74 65 72 20 74 68 61 6e  ften faster than
1f00: 20 74 68 65 20 64 65 66 61 75 6c 74 20 72 6f 6c   the default rol
1f10: 6c 62 61 63 6b 20 74 72 61 6e 73 61 63 74 69 6f  lback transactio
1f20: 6e 73 2e 20 20 54 68 69 73 20 64 6f 63 75 6d 65  ns.  This docume
1f30: 6e 74 0a 20 20 65 78 70 6c 61 69 6e 73 20 68 6f  nt.  explains ho
1f40: 77 20 74 6f 20 75 73 65 20 57 41 4c 20 6d 6f 64  w to use WAL mod
1f50: 65 20 66 6f 72 20 69 6d 70 72 6f 76 65 64 20 70  e for improved p
1f60: 65 72 66 6f 72 6d 61 6e 63 65 2e 0a 7d 0a 0a 68  erformance..}..h
1f70: 65 61 64 69 6e 67 20 7b 41 64 76 6f 63 61 63 79  eading {Advocacy
1f80: 7d 20 61 64 76 6f 63 61 63 79 20 7b 0a 20 20 44  } advocacy {.  D
1f90: 6f 63 75 6d 65 6e 74 73 20 74 68 61 74 20 73 74  ocuments that st
1fa0: 72 69 76 65 20 74 6f 20 65 6e 63 6f 75 72 61 67  rive to encourag
1fb0: 65 20 74 68 65 20 75 73 65 20 6f 66 20 53 51 4c  e the use of SQL
1fc0: 69 74 65 2e 0a 7d 0a 64 6f 63 20 7b 53 51 4c 69  ite..}.doc {SQLi
1fd0: 74 65 20 41 73 20 41 6e 20 41 70 70 6c 69 63 61  te As An Applica
1fe0: 74 69 6f 6e 20 46 69 6c 65 20 46 6f 72 6d 61 74  tion File Format
1ff0: 7d 20 7b 61 70 70 66 69 6c 65 66 6f 72 6d 61 74  } {appfileformat
2000: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20  .html} {.  This 
2010: 61 72 74 69 63 6c 65 20 61 64 76 6f 63 61 74 65  article advocate
2020: 73 20 75 73 69 6e 67 20 53 51 4c 69 74 65 20 61  s using SQLite a
2030: 73 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e  s an application
2040: 20 66 69 6c 65 20 66 6f 72 6d 61 74 0a 20 20 69   file format.  i
2050: 6e 20 70 6c 61 63 65 20 6f 66 20 58 4d 4c 20 6f  n place of XML o
2060: 72 20 4a 53 4f 4e 20 6f 72 20 61 20 22 70 69 6c  r JSON or a "pil
2070: 65 2d 6f 66 2d 66 69 6c 65 22 2e 0a 7d 0a 64 6f  e-of-file"..}.do
2080: 63 20 7b 57 65 6c 6c 20 4b 6e 6f 77 6e 20 55 73  c {Well Known Us
2090: 65 72 73 7d 20 7b 66 61 6d 6f 75 73 2e 68 74 6d  ers} {famous.htm
20a0: 6c 7d 20 7b 0a 20 20 54 68 69 73 20 70 61 67 65  l} {.  This page
20b0: 20 6c 69 73 74 73 20 61 20 73 6d 61 6c 6c 20 73   lists a small s
20c0: 75 62 73 65 74 20 6f 66 20 74 68 65 20 6d 61 6e  ubset of the man
20d0: 79 20 74 68 6f 75 73 61 6e 64 73 20 6f 66 20 64  y thousands of d
20e0: 65 76 69 63 65 73 0a 20 20 61 6e 64 20 61 70 70  evices.  and app
20f0: 6c 69 63 61 74 69 6f 6e 20 70 72 6f 67 72 61 6d  lication program
2100: 73 20 74 68 61 74 20 6d 61 6b 65 20 75 73 65 20  s that make use 
2110: 6f 66 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 0a 68  of SQLite..}...h
2120: 65 61 64 69 6e 67 20 7b 53 51 4c 69 74 65 20 54  eading {SQLite T
2130: 65 63 68 6e 69 63 61 6c 2f 44 65 73 69 67 6e 20  echnical/Design 
2140: 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 7d 20 74  Documentation} t
2150: 65 63 68 6e 69 63 61 6c 20 7b 0a 20 20 54 68 65  echnical {.  The
2160: 73 65 20 64 6f 63 75 6d 65 6e 74 73 20 61 72 65  se documents are
2170: 20 6f 72 69 65 6e 74 65 64 20 74 6f 77 61 72 64   oriented toward
2180: 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65 20   describing the 
2190: 69 6e 74 65 72 6e 61 6c 0a 20 20 69 6d 70 6c 65  internal.  imple
21a0: 6d 65 6e 74 61 74 69 6f 6e 20 64 65 74 61 69 6c  mentation detail
21b0: 73 20 61 6e 64 20 6f 70 65 72 61 74 69 6f 6e 20  s and operation 
21c0: 6f 66 20 53 51 4c 69 74 65 2e 20 20 0a 7d 0a 0a  of SQLite.  .}..
21d0: 64 6f 63 20 7b 48 6f 77 20 44 61 74 61 62 61 73  doc {How Databas
21e0: 65 20 43 6f 72 72 75 70 74 69 6f 6e 20 43 61 6e  e Corruption Can
21f0: 20 4f 63 63 75 72 7d 20 7b 68 6f 77 74 6f 63 6f   Occur} {howtoco
2200: 72 72 75 70 74 2e 68 74 6d 6c 7d 20 7b 0a 20 20  rrupt.html} {.  
2210: 53 51 4c 69 74 65 20 69 73 20 68 69 67 68 6c 79  SQLite is highly
2220: 20 72 65 73 69 73 74 61 6e 74 20 74 6f 20 64 61   resistant to da
2230: 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f  tabase corruptio
2240: 6e 2e 20 20 42 75 74 20 61 70 70 6c 69 63 61 74  n.  But applicat
2250: 69 6f 6e 2c 0a 20 20 4f 53 2c 20 61 6e 64 20 68  ion,.  OS, and h
2260: 61 72 64 77 61 72 65 20 62 75 67 73 20 63 61 6e  ardware bugs can
2270: 20 73 74 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e   still result in
2280: 20 63 6f 72 72 75 70 74 20 64 61 74 61 62 61 73   corrupt databas
2290: 65 20 66 69 6c 65 73 2e 0a 20 20 54 68 69 73 20  e files..  This 
22a0: 61 72 74 69 63 6c 65 20 64 65 73 63 72 69 62 65  article describe
22b0: 73 20 6d 61 6e 79 20 6f 66 20 74 68 65 20 77 61  s many of the wa
22c0: 79 73 20 74 68 61 74 20 53 51 4c 69 74 65 20 64  ys that SQLite d
22d0: 61 74 61 62 61 73 65 20 66 69 6c 65 73 0a 20 20  atabase files.  
22e0: 63 61 6e 20 67 6f 20 63 6f 72 72 75 70 74 2e 0a  can go corrupt..
22f0: 7d 0a 0a 64 6f 63 20 7b 54 65 6d 70 6f 72 61 72  }..doc {Temporar
2300: 79 20 46 69 6c 65 73 20 55 73 65 64 20 42 79 20  y Files Used By 
2310: 53 51 4c 69 74 65 7d 20 7b 74 65 6d 70 66 69 6c  SQLite} {tempfil
2320: 65 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 53 51 4c  es.html} {.  SQL
2330: 69 74 65 20 63 61 6e 20 70 6f 74 65 6e 74 69 61  ite can potentia
2340: 6c 6c 79 20 75 73 65 20 6d 61 6e 79 20 64 69 66  lly use many dif
2350: 66 65 72 65 6e 74 20 74 65 6d 70 6f 72 61 72 79  ferent temporary
2360: 20 66 69 6c 65 73 20 77 68 65 6e 0a 20 20 70 72   files when.  pr
2370: 6f 63 65 73 73 69 6e 67 20 63 65 72 74 61 69 6e  ocessing certain
2380: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e   SQL statements.
2390: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
23a0: 64 65 73 63 72 69 62 65 73 20 74 68 65 0a 20 20  describes the.  
23b0: 6d 61 6e 79 20 6b 69 6e 64 73 20 6f 66 20 74 65  many kinds of te
23c0: 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 20 74 68  mporary files th
23d0: 61 74 20 53 51 4c 69 74 65 20 75 73 65 73 20 61  at SQLite uses a
23e0: 6e 64 20 6f 66 66 65 72 73 20 73 75 67 67 65 73  nd offers sugges
23f0: 74 69 6f 6e 73 0a 20 20 66 6f 72 20 61 76 6f 69  tions.  for avoi
2400: 64 69 6e 67 20 74 68 65 6d 20 6f 6e 20 73 79 73  ding them on sys
2410: 74 65 6d 73 20 77 68 65 72 65 20 63 72 65 61 74  tems where creat
2420: 69 6e 67 20 61 20 74 65 6d 70 6f 72 61 72 79 20  ing a temporary 
2430: 66 69 6c 65 20 69 73 20 61 6e 0a 20 20 65 78 70  file is an.  exp
2440: 65 6e 73 69 76 65 20 6f 70 65 72 61 74 69 6f 6e  ensive operation
2450: 2e 0a 7d 0a 0a 64 6f 63 20 7b 49 6e 2d 4d 65 6d  ..}..doc {In-Mem
2460: 6f 72 79 20 44 61 74 61 62 61 73 65 73 7d 20 7b  ory Databases} {
2470: 69 6e 6d 65 6d 6f 72 79 64 62 2e 68 74 6d 6c 7d  inmemorydb.html}
2480: 20 7b 0a 20 20 53 51 4c 69 74 65 20 6e 6f 72 6d   {.  SQLite norm
2490: 61 6c 6c 79 20 73 74 6f 72 65 73 20 63 6f 6e 74  ally stores cont
24a0: 65 6e 74 20 69 6e 20 61 20 64 69 73 6b 20 66 69  ent in a disk fi
24b0: 6c 65 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 74  le.  However, it
24c0: 20 63 61 6e 20 61 6c 73 6f 0a 20 20 62 65 20 75   can also.  be u
24d0: 73 65 64 20 61 73 20 61 6e 20 69 6e 2d 6d 65 6d  sed as an in-mem
24e0: 6f 72 79 20 64 61 74 61 62 61 73 65 20 65 6e 67  ory database eng
24f0: 69 6e 65 2e 20 20 54 68 69 73 20 64 6f 63 75 6d  ine.  This docum
2500: 65 6e 74 20 65 78 70 6c 61 69 6e 73 20 68 6f 77  ent explains how
2510: 2e 0a 7d 0a 0a 64 6f 63 20 7b 48 6f 77 20 53 51  ..}..doc {How SQ
2520: 4c 69 74 65 20 49 6d 70 6c 65 6d 65 6e 74 73 20  Lite Implements 
2530: 41 74 6f 6d 69 63 20 43 6f 6d 6d 69 74 7d 20 7b  Atomic Commit} {
2540: 61 74 6f 6d 69 63 63 6f 6d 6d 69 74 2e 68 74 6d  atomiccommit.htm
2550: 6c 7d 20 7b 0a 20 20 41 20 64 65 73 63 72 69 70  l} {.  A descrip
2560: 74 69 6f 6e 20 6f 66 20 74 68 65 20 6c 6f 67 69  tion of the logi
2570: 63 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65 20  c within SQLite 
2580: 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 0a  that implements.
2590: 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 77    transactions w
25a0: 69 74 68 20 61 74 6f 6d 69 63 20 63 6f 6d 6d 69  ith atomic commi
25b0: 74 2c 20 65 76 65 6e 20 69 6e 20 74 68 65 20 66  t, even in the f
25c0: 61 63 65 20 6f 66 20 70 6f 77 65 72 0a 20 20 66  ace of power.  f
25d0: 61 69 6c 75 72 65 73 2e 0a 7d 0a 0a 64 6f 63 20  ailures..}..doc 
25e0: 7b 44 79 6e 61 6d 69 63 20 4d 65 6d 6f 72 79 20  {Dynamic Memory 
25f0: 41 6c 6c 6f 63 61 74 69 6f 6e 20 69 6e 20 53 51  Allocation in SQ
2600: 4c 69 74 65 7d 20 7b 6d 61 6c 6c 6f 63 2e 68 74  Lite} {malloc.ht
2610: 6d 6c 7d 20 7b 0a 20 20 53 51 4c 69 74 65 20 68  ml} {.  SQLite h
2620: 61 73 20 61 20 73 6f 70 68 69 73 74 69 63 61 74  as a sophisticat
2630: 65 64 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61  ed memory alloca
2640: 74 69 6f 6e 20 73 75 62 73 79 73 74 65 6d 20 74  tion subsystem t
2650: 68 61 74 20 63 61 6e 20 62 65 0a 20 20 63 6f 6e  hat can be.  con
2660: 66 69 67 75 72 65 64 20 61 6e 64 20 63 75 73 74  figured and cust
2670: 6f 6d 69 7a 65 64 20 74 6f 20 6d 65 65 74 20 6d  omized to meet m
2680: 65 6d 6f 72 79 20 75 73 61 67 65 20 72 65 71 75  emory usage requ
2690: 69 72 65 6d 65 6e 74 73 20 6f 66 20 74 68 65 0a  irements of the.
26a0: 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 61 6e    application an
26b0: 64 20 74 68 61 74 20 69 73 20 72 6f 62 75 73 74  d that is robust
26c0: 20 61 67 61 69 6e 73 74 20 6f 75 74 2d 6f 66 2d   against out-of-
26d0: 6d 65 6d 6f 72 79 20 63 6f 6e 64 69 74 69 6f 6e  memory condition
26e0: 73 20 61 6e 64 0a 20 20 6c 65 61 6b 2d 66 72 65  s and.  leak-fre
26f0: 65 2e 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e  e.  This documen
2700: 74 20 70 72 6f 76 69 64 65 73 20 74 68 65 20 64  t provides the d
2710: 65 74 61 69 6c 73 2e 0a 7d 0a 0a 64 6f 63 20 7b  etails..}..doc {
2720: 43 75 73 74 6f 6d 69 7a 69 6e 67 20 41 6e 64 20  Customizing And 
2730: 50 6f 72 74 69 6e 67 20 53 51 4c 69 74 65 7d 20  Porting SQLite} 
2740: 7b 63 75 73 74 6f 6d 62 75 69 6c 64 2e 68 74 6d  {custombuild.htm
2750: 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63 75  l} {.  This docu
2760: 6d 65 6e 74 20 65 78 70 6c 61 69 6e 73 20 68 6f  ment explains ho
2770: 77 20 74 6f 20 63 75 73 74 6f 6d 69 7a 65 20 74  w to customize t
2780: 68 65 20 62 75 69 6c 64 20 6f 66 20 53 51 4c 69  he build of SQLi
2790: 74 65 20 61 6e 64 0a 20 20 68 6f 77 20 74 6f 20  te and.  how to 
27a0: 70 6f 72 74 20 53 51 4c 69 74 65 20 74 6f 20 6e  port SQLite to n
27b0: 65 77 20 70 6c 61 74 66 6f 72 6d 73 2e 0a 7d 0a  ew platforms..}.
27c0: 0a 64 6f 63 20 7b 4c 6f 63 6b 69 6e 67 20 41 6e  .doc {Locking An
27d0: 64 20 43 6f 6e 63 75 72 72 65 6e 63 79 3c 62 72  d Concurrency<br
27e0: 3e 49 6e 20 53 51 4c 69 74 65 20 56 65 72 73 69  >In SQLite Versi
27f0: 6f 6e 20 33 7d 20 7b 6c 6f 63 6b 69 6e 67 76 33  on 3} {lockingv3
2800: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64 65 73  .html} {.  A des
2810: 63 72 69 70 74 69 6f 6e 20 6f 66 20 68 6f 77 20  cription of how 
2820: 74 68 65 20 6e 65 77 20 6c 6f 63 6b 69 6e 67 20  the new locking 
2830: 63 6f 64 65 20 69 6e 20 76 65 72 73 69 6f 6e 20  code in version 
2840: 33 20 69 6e 63 72 65 61 73 65 73 0a 20 20 63 6f  3 increases.  co
2850: 6e 63 75 72 72 65 6e 63 79 20 61 6e 64 20 64 65  ncurrency and de
2860: 63 72 65 61 73 65 73 20 74 68 65 20 70 72 6f 62  creases the prob
2870: 6c 65 6d 20 6f 66 20 77 72 69 74 65 72 20 73 74  lem of writer st
2880: 61 72 76 61 74 69 6f 6e 2e 0a 7d 0a 0a 64 6f 63  arvation..}..doc
2890: 20 7b 49 73 6f 6c 61 74 69 6f 6e 20 49 6e 20 53   {Isolation In S
28a0: 51 4c 69 74 65 7d 20 7b 69 73 6f 6c 61 74 69 6f  QLite} {isolatio
28b0: 6e 2e 68 74 6d 6c 7d 20 7b 0a 20 20 57 68 65 6e  n.html} {.  When
28c0: 20 77 65 20 73 61 79 20 74 68 61 74 20 53 51 4c   we say that SQL
28d0: 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 73  ite transactions
28e0: 20 61 72 65 20 22 73 65 72 69 61 6c 69 7a 61 62   are "serializab
28f0: 6c 65 22 20 77 68 61 74 20 65 78 61 63 74 6c 79  le" what exactly
2900: 0a 20 20 64 6f 65 73 20 74 68 61 74 20 6d 65 61  .  does that mea
2910: 6e 3f 20 20 48 6f 77 20 61 6e 64 20 77 68 65 6e  n?  How and when
2920: 20 61 72 65 20 63 68 61 6e 67 65 73 20 6d 61 64   are changes mad
2930: 65 20 76 69 73 69 62 6c 65 20 77 69 74 68 69 6e  e visible within
2940: 20 74 68 65 0a 20 20 73 61 6d 65 20 64 61 74 61   the.  same data
2950: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  base connection 
2960: 61 6e 64 20 74 6f 20 6f 74 68 65 72 20 64 61 74  and to other dat
2970: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
2980: 73 3f 0a 7d 0a 0a 64 6f 63 20 7b 4f 76 65 72 76  s?.}..doc {Overv
2990: 69 65 77 20 4f 66 20 54 68 65 20 4f 70 74 69 6d  iew Of The Optim
29a0: 69 7a 65 72 7d 20 7b 6f 70 74 6f 76 65 72 76 69  izer} {optovervi
29b0: 65 77 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 71  ew.html} {.  A q
29c0: 75 69 63 6b 20 6f 76 65 72 76 69 65 77 20 6f 66  uick overview of
29d0: 20 74 68 65 20 76 61 72 69 6f 75 73 20 71 75 65   the various que
29e0: 72 79 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73  ry optimizations
29f0: 20 74 68 61 74 20 61 72 65 0a 20 20 61 74 74 65   that are.  atte
2a00: 6d 70 74 65 64 20 62 79 20 74 68 65 20 53 51 4c  mpted by the SQL
2a10: 69 74 65 20 63 6f 64 65 20 67 65 6e 65 72 61 74  ite code generat
2a20: 6f 72 2e 0a 7d 0a 64 6f 63 20 7b 54 68 65 20 4e  or..}.doc {The N
2a30: 65 78 74 2d 47 65 6e 65 72 61 74 69 6f 6e 20 51  ext-Generation Q
2a40: 75 65 72 79 20 50 6c 61 6e 6e 65 72 7d 20 7b 71  uery Planner} {q
2a50: 75 65 72 79 70 6c 61 6e 6e 65 72 2d 6e 67 2e 68  ueryplanner-ng.h
2a60: 74 6d 6c 7d 20 7b 0a 20 20 41 64 64 69 74 69 6f  tml} {.  Additio
2a70: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  nal information 
2a80: 61 62 6f 75 74 20 74 68 65 20 53 51 4c 69 74 65  about the SQLite
2a90: 20 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 2c 20   query planner, 
2aa0: 61 6e 64 20 69 6e 20 70 61 72 74 69 63 75 6c 61  and in particula
2ab0: 72 0a 20 20 74 68 65 20 72 65 64 65 73 69 67 6e  r.  the redesign
2ac0: 20 6f 66 20 74 68 65 20 71 75 65 72 79 20 70 6c   of the query pl
2ad0: 61 6e 6e 65 72 20 74 68 61 74 20 6f 63 63 75 72  anner that occur
2ae0: 72 65 64 20 66 6f 72 20 76 65 72 73 69 6f 6e 20  red for version 
2af0: 33 2e 38 2e 30 2e 0a 7d 0a 0a 64 6f 63 20 7b 41  3.8.0..}..doc {A
2b00: 72 63 68 69 74 65 63 74 75 72 65 7d 20 7b 61 72  rchitecture} {ar
2b10: 63 68 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 6e 20  ch.html} {.  An 
2b20: 61 72 63 68 69 74 65 63 74 75 72 61 6c 20 6f 76  architectural ov
2b30: 65 72 76 69 65 77 20 6f 66 20 74 68 65 20 53 51  erview of the SQ
2b40: 4c 69 74 65 20 6c 69 62 72 61 72 79 2c 20 75 73  Lite library, us
2b50: 65 66 75 6c 20 66 6f 72 20 74 68 6f 73 65 20 77  eful for those w
2b60: 68 6f 20 77 61 6e 74 0a 20 20 74 6f 20 68 61 63  ho want.  to hac
2b70: 6b 20 74 68 65 20 63 6f 64 65 2e 0a 7d 0a 64 6f  k the code..}.do
2b80: 63 20 7b 56 44 42 45 20 4f 70 63 6f 64 65 73 7d  c {VDBE Opcodes}
2b90: 20 7b 6f 70 63 6f 64 65 2e 68 74 6d 6c 7d 20 7b   {opcode.html} {
2ba0: 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74  .  This document
2bb0: 20 69 73 20 61 6e 20 61 75 74 6f 6d 61 74 69 63   is an automatic
2bc0: 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 64 20 64  ally generated d
2bd0: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68  escription of th
2be0: 65 20 76 61 72 69 6f 75 73 0a 20 20 6f 70 63 6f  e various.  opco
2bf0: 64 65 73 20 74 68 61 74 20 74 68 65 20 56 44 42  des that the VDB
2c00: 45 20 75 6e 64 65 72 73 74 61 6e 64 73 2e 20 20  E understands.  
2c10: 50 72 6f 67 72 61 6d 6d 65 72 73 20 63 61 6e 20  Programmers can 
2c20: 75 73 65 20 74 68 69 73 20 64 6f 63 75 6d 65 6e  use this documen
2c30: 74 20 61 73 0a 20 20 61 20 72 65 66 65 72 65 6e  t as.  a referen
2c40: 63 65 20 74 6f 20 62 65 74 74 65 72 20 75 6e 64  ce to better und
2c50: 65 72 73 74 61 6e 64 20 74 68 65 20 6f 75 74 70  erstand the outp
2c60: 75 74 20 6f 66 20 45 58 50 4c 41 49 4e 20 6c 69  ut of EXPLAIN li
2c70: 73 74 69 6e 67 73 20 66 72 6f 6d 0a 20 20 53 51  stings from.  SQ
2c80: 4c 69 74 65 2e 0a 7d 0a 64 6f 63 20 7b 56 69 72  Lite..}.doc {Vir
2c90: 74 75 61 6c 20 46 69 6c 65 73 79 73 74 65 6d 7d  tual Filesystem}
2ca0: 20 7b 76 66 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20   {vfs.html} {.  
2cb0: 54 68 65 20 22 56 46 53 22 20 6f 62 6a 65 63 74  The "VFS" object
2cc0: 20 69 73 20 74 68 65 20 69 6e 74 65 72 66 61 63   is the interfac
2cd0: 65 20 62 65 74 77 65 65 6e 20 74 68 65 20 53 51  e between the SQ
2ce0: 4c 69 74 65 20 63 6f 72 65 20 61 6e 64 20 74 68  Lite core and th
2cf0: 65 0a 20 20 75 6e 64 65 72 6c 79 69 6e 67 20 6f  e.  underlying o
2d00: 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 2e  perating system.
2d10: 20 20 4c 65 61 72 6e 20 6d 6f 72 65 20 61 62 6f    Learn more abo
2d20: 75 74 20 68 6f 77 20 74 68 65 20 56 46 53 20 6f  ut how the VFS o
2d30: 62 6a 65 63 74 0a 20 20 77 6f 72 6b 73 20 61 6e  bject.  works an
2d40: 64 20 68 6f 77 20 74 6f 20 63 72 65 61 74 65 20  d how to create 
2d50: 6e 65 77 20 56 46 53 20 6f 62 6a 65 63 74 73 20  new VFS objects 
2d60: 66 72 6f 6d 20 74 68 69 73 20 61 72 74 69 63 6c  from this articl
2d70: 65 2e 0a 7d 0a 64 6f 63 20 7b 56 69 72 74 75 61  e..}.doc {Virtua
2d80: 6c 20 54 61 62 6c 65 73 7d 20 7b 76 74 61 62 2e  l Tables} {vtab.
2d90: 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 61  html} {.  This a
2da0: 72 74 69 63 6c 65 20 64 65 73 63 72 69 62 65 73  rticle describes
2db0: 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62   the virtual tab
2dc0: 6c 65 20 6d 65 63 68 61 6e 69 73 6d 20 61 6e 64  le mechanism and
2dd0: 20 41 50 49 20 69 6e 20 53 51 4c 69 74 65 20 61   API in SQLite a
2de0: 6e 64 20 68 6f 77 0a 20 20 69 74 20 63 61 6e 20  nd how.  it can 
2df0: 62 65 20 75 73 65 64 20 74 6f 20 61 64 64 20 6e  be used to add n
2e00: 65 77 20 63 61 70 61 62 69 6c 69 74 69 65 73 20  ew capabilities 
2e10: 74 6f 20 74 68 65 20 63 6f 72 65 20 53 51 4c 69  to the core SQLi
2e20: 74 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a 64  te library..}..d
2e30: 6f 63 20 7b 53 51 4c 69 74 65 20 46 69 6c 65 20  oc {SQLite File 
2e40: 46 6f 72 6d 61 74 7d 20 7b 66 69 6c 65 66 6f 72  Format} {filefor
2e50: 6d 61 74 32 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41  mat2.html} {.  A
2e60: 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20   description of 
2e70: 74 68 65 20 66 6f 72 6d 61 74 20 75 73 65 64 20  the format used 
2e80: 66 6f 72 20 53 51 4c 69 74 65 20 64 61 74 61 62  for SQLite datab
2e90: 61 73 65 20 61 6e 64 20 6a 6f 75 72 6e 61 6c 20  ase and journal 
2ea0: 66 69 6c 65 73 2c 20 61 6e 64 0a 20 20 6f 74 68  files, and.  oth
2eb0: 65 72 20 64 65 74 61 69 6c 73 20 72 65 71 75 69  er details requi
2ec0: 72 65 64 20 74 6f 20 63 72 65 61 74 65 20 73 6f  red to create so
2ed0: 66 74 77 61 72 65 20 74 6f 20 72 65 61 64 20 61  ftware to read a
2ee0: 6e 64 20 77 72 69 74 65 20 53 51 4c 69 74 65 20  nd write SQLite 
2ef0: 0a 20 20 64 61 74 61 62 61 73 65 73 20 77 69 74  .  databases wit
2f00: 68 6f 75 74 20 75 73 69 6e 67 20 53 51 4c 69 74  hout using SQLit
2f10: 65 2e 0a 7d 0a 0a 64 6f 63 20 7b 43 6f 6d 70 69  e..}..doc {Compi
2f20: 6c 61 74 69 6f 6e 20 4f 70 74 69 6f 6e 73 7d 20  lation Options} 
2f30: 7b 63 6f 6d 70 69 6c 65 2e 68 74 6d 6c 7d 20 7b  {compile.html} {
2f40: 0a 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74  .  This document
2f50: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 63   describes the c
2f60: 6f 6d 70 69 6c 65 20 74 69 6d 65 20 6f 70 74 69  ompile time opti
2f70: 6f 6e 73 20 74 68 61 74 20 6d 61 79 20 62 65 20  ons that may be 
2f80: 73 65 74 20 74 6f 20 0a 20 20 6d 6f 64 69 66 79  set to .  modify
2f90: 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 65 68   the default beh
2fa0: 61 76 69 6f 72 20 6f 66 20 74 68 65 20 6c 69 62  avior of the lib
2fb0: 72 61 72 79 20 6f 72 20 6f 6d 69 74 20 6f 70 74  rary or omit opt
2fc0: 69 6f 6e 61 6c 20 66 65 61 74 75 72 65 73 0a 20  ional features. 
2fd0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 72 65 64   in order to red
2fe0: 75 63 65 20 62 69 6e 61 72 79 20 73 69 7a 65 2e  uce binary size.
2ff0: 0a 7d 0a 0a 68 65 61 64 69 6e 67 20 7b 55 70 67  .}..heading {Upg
3000: 72 61 64 69 6e 67 20 53 51 4c 69 74 65 2c 20 42  rading SQLite, B
3010: 61 63 6b 77 61 72 64 73 20 43 6f 6d 70 61 74 69  ackwards Compati
3020: 62 69 6c 69 74 79 7d 20 63 6f 6d 70 61 74 0a 0a  bility} compat..
3030: 64 6f 63 20 7b 4d 6f 76 69 6e 67 20 46 72 6f 6d  doc {Moving From
3040: 20 53 51 4c 69 74 65 20 33 2e 35 20 74 6f 20 33   SQLite 3.5 to 3
3050: 2e 36 7d 20 7b 33 35 74 6f 33 36 2e 68 74 6d 6c  .6} {35to36.html
3060: 7d 20 7b 0a 20 20 41 20 64 6f 63 75 6d 65 6e 74  } {.  A document
3070: 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65 20   describing the 
3080: 64 69 66 66 65 72 65 6e 63 65 73 20 62 65 74 77  differences betw
3090: 65 65 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69  een SQLite versi
30a0: 6f 6e 20 33 2e 35 2e 39 0a 20 20 61 6e 64 20 33  on 3.5.9.  and 3
30b0: 2e 36 2e 30 2e 0a 7d 0a 64 6f 63 20 7b 4d 6f 76  .6.0..}.doc {Mov
30c0: 69 6e 67 20 46 72 6f 6d 20 53 51 4c 69 74 65 20  ing From SQLite 
30d0: 33 2e 34 20 74 6f 20 33 2e 35 7d 20 7b 33 34 74  3.4 to 3.5} {34t
30e0: 6f 33 35 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20  o35.html} {.  A 
30f0: 64 6f 63 75 6d 65 6e 74 20 64 65 73 63 72 69 62  document describ
3100: 69 6e 67 20 74 68 65 20 64 69 66 66 65 72 65 6e  ing the differen
3110: 63 65 73 20 62 65 74 77 65 65 6e 20 53 51 4c 69  ces between SQLi
3120: 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 34 2e 32  te version 3.4.2
3130: 0a 20 20 61 6e 64 20 33 2e 35 2e 30 2e 0a 7d 0a  .  and 3.5.0..}.
3140: 64 6f 63 20 7b 52 65 6c 65 61 73 65 20 48 69 73  doc {Release His
3150: 74 6f 72 79 7d 20 7b 63 68 61 6e 67 65 73 2e 68  tory} {changes.h
3160: 74 6d 6c 7d 20 7b 0a 20 20 41 20 63 68 72 6f 6e  tml} {.  A chron
3170: 6f 6c 6f 67 79 20 6f 66 20 53 51 4c 69 74 65 20  ology of SQLite 
3180: 72 65 6c 65 61 73 65 73 20 67 6f 69 6e 67 20 62  releases going b
3190: 61 63 6b 20 74 6f 20 76 65 72 73 69 6f 6e 20 31  ack to version 1
31a0: 2e 30 2e 30 0a 7d 0a 64 6f 63 20 7b 42 61 63 6b  .0.0.}.doc {Back
31b0: 77 61 72 64 73 20 43 6f 6d 70 61 74 69 62 69 6c  wards Compatibil
31c0: 69 74 79 7d 20 7b 66 6f 72 6d 61 74 63 68 6e 67  ity} {formatchng
31d0: 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20  .html} {.  This 
31e0: 64 6f 63 75 6d 65 6e 74 20 64 65 74 61 69 6c 73  document details
31f0: 20 61 6c 6c 20 6f 66 20 74 68 65 20 69 6e 63 6f   all of the inco
3200: 6d 70 61 74 69 62 6c 65 20 63 68 61 6e 67 65 73  mpatible changes
3210: 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65 0a 20   to the SQLite. 
3220: 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 74 68 61   file format tha
3230: 74 20 68 61 76 65 20 6f 63 63 75 72 72 65 64 20  t have occurred 
3240: 73 69 6e 63 65 20 76 65 72 73 69 6f 6e 20 31 2e  since version 1.
3250: 30 2e 30 2e 0a 7d 0a 0a 64 6f 63 20 7b 50 72 69  0.0..}..doc {Pri
3260: 76 61 74 65 20 42 72 61 6e 63 68 65 73 7d 20 7b  vate Branches} {
3270: 70 72 69 76 61 74 65 62 72 61 6e 63 68 2e 68 74  privatebranch.ht
3280: 6d 6c 7d 20 7b 0a 20 20 54 68 69 73 20 64 6f 63  ml} {.  This doc
3290: 75 6d 65 6e 74 20 73 75 67 67 65 73 74 73 20 70  ument suggests p
32a0: 72 6f 63 65 64 75 72 65 73 20 66 6f 72 20 6d 61  rocedures for ma
32b0: 69 6e 74 61 69 6e 69 6e 67 20 61 20 70 72 69 76  intaining a priv
32c0: 61 74 65 20 62 72 61 6e 63 68 0a 20 20 6f 72 20  ate branch.  or 
32d0: 66 6f 72 6b 20 6f 66 20 53 51 4c 69 74 65 20 61  fork of SQLite a
32e0: 6e 64 20 6b 65 65 70 69 6e 67 20 74 68 61 74 20  nd keeping that 
32f0: 62 72 61 6e 63 68 20 6f 72 20 66 6f 72 6b 20 69  branch or fork i
3300: 6e 20 73 79 6e 63 20 77 69 74 68 20 74 68 65 0a  n sync with the.
3310: 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 20    public SQLite 
3320: 73 6f 75 72 63 65 20 74 72 65 65 2e 0a 7d 0a 0a  source tree..}..
3330: 0a 68 65 61 64 69 6e 67 20 7b 4f 62 73 6f 6c 65  .heading {Obsole
3340: 74 65 20 44 6f 63 75 6d 65 6e 74 73 7d 20 6f 62  te Documents} ob
3350: 73 6f 6c 65 74 65 20 7b 0a 20 20 54 68 65 20 66  solete {.  The f
3360: 6f 6c 6c 6f 77 69 6e 67 20 64 6f 63 75 6d 65 6e  ollowing documen
3370: 74 73 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72  ts are no longer
3380: 20 63 75 72 72 65 6e 74 20 61 6e 64 20 61 72 65   current and are
3390: 20 72 65 74 61 69 6e 65 64 0a 20 20 66 6f 72 20   retained.  for 
33a0: 68 69 73 74 6f 72 69 63 61 6c 20 72 65 66 65 72  historical refer
33b0: 65 6e 63 65 20 6f 6e 6c 79 2e 0a 20 20 54 68 65  ence only..  The
33c0: 73 65 20 64 6f 63 75 6d 65 6e 74 73 20 67 65 6e  se documents gen
33d0: 65 72 61 6c 6c 79 20 70 65 72 74 61 69 6e 20 74  erally pertain t
33e0: 6f 20 6f 75 74 2d 6f 66 2d 64 61 74 65 2c 20 6f  o out-of-date, o
33f0: 62 73 6f 6c 65 74 65 2c 20 61 6e 64 2f 6f 72 0a  bsolete, and/or.
3400: 20 20 64 65 70 72 65 63 61 74 65 64 20 66 65 61    deprecated fea
3410: 74 75 72 65 73 20 61 6e 64 20 65 78 74 65 6e 73  tures and extens
3420: 69 6f 6e 73 2e 0a 7d 0a 64 6f 63 20 7b 41 73 79  ions..}.doc {Asy
3430: 6e 63 68 72 6f 6e 6f 75 73 20 49 4f 20 4d 6f 64  nchronous IO Mod
3440: 65 7d 20 7b 61 73 79 6e 63 76 66 73 2e 68 74 6d  e} {asyncvfs.htm
3450: 6c 7d 20 7b 0a 20 20 54 68 69 73 20 70 61 67 65  l} {.  This page
3460: 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 61   describes the a
3470: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49 4f 20 65  synchronous IO e
3480: 78 74 65 6e 73 69 6f 6e 20 64 65 76 65 6c 6f 70  xtension develop
3490: 65 64 20 61 6c 6f 6e 67 73 69 64 65 0a 20 20 53  ed alongside.  S
34a0: 51 4c 69 74 65 2e 20 55 73 69 6e 67 20 61 73 79  QLite. Using asy
34b0: 6e 63 68 72 6f 6e 6f 75 73 20 49 4f 20 63 61 6e  nchronous IO can
34c0: 20 63 61 75 73 65 20 53 51 4c 69 74 65 20 74 6f   cause SQLite to
34d0: 20 61 70 70 65 61 72 20 6d 6f 72 65 20 72 65 73   appear more res
34e0: 70 6f 6e 73 69 76 65 0a 20 20 62 79 20 64 65 6c  ponsive.  by del
34f0: 65 67 61 74 69 6e 67 20 64 61 74 61 62 61 73 65  egating database
3500: 20 77 72 69 74 65 73 20 74 6f 20 61 20 62 61 63   writes to a bac
3510: 6b 67 72 6f 75 6e 64 20 74 68 72 65 61 64 2e 20  kground thread. 
3520: 20 3c 69 3e 4e 42 3a 20 20 54 68 69 73 0a 20 20   <i>NB:  This.  
3530: 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 64 65 70  extension is dep
3540: 72 65 63 61 74 65 64 2e 20 20 5b 57 41 4c 20 6d  recated.  [WAL m
3550: 6f 64 65 5d 20 69 73 20 72 65 63 6f 6d 6d 65 6e  ode] is recommen
3560: 64 65 64 20 61 73 20 61 20 72 65 70 6c 61 63 65  ded as a replace
3570: 6d 65 6e 74 2e 3c 2f 69 3e 0a 7d 0a 64 6f 63 20  ment.</i>.}.doc 
3580: 7b 56 65 72 73 69 6f 6e 20 32 20 43 2f 43 2b 2b  {Version 2 C/C++
3590: 20 41 50 49 7d 20 7b 63 5f 69 6e 74 65 72 66 61   API} {c_interfa
35a0: 63 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41 20 64  ce.html} {.  A d
35b0: 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68  escription of th
35c0: 65 20 43 2f 43 2b 2b 20 69 6e 74 65 72 66 61 63  e C/C++ interfac
35d0: 65 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20 53  e bindings for S
35e0: 51 4c 69 74 65 20 74 68 72 6f 75 67 68 20 76 65  QLite through ve
35f0: 72 73 69 6f 6e 20 0a 20 20 32 2e 38 0a 7d 0a 64  rsion .  2.8.}.d
3600: 6f 63 20 7b 56 65 72 73 69 6f 6e 20 32 20 44 61  oc {Version 2 Da
3610: 74 61 54 79 70 65 73 20 7d 20 7b 64 61 74 61 74  taTypes } {datat
3620: 79 70 65 73 2e 68 74 6d 6c 7d 20 7b 0a 20 20 41  ypes.html} {.  A
3630: 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20   description of 
3640: 68 6f 77 20 53 51 4c 69 74 65 20 76 65 72 73 69  how SQLite versi
3650: 6f 6e 20 32 20 68 61 6e 64 6c 65 73 20 53 51 4c  on 2 handles SQL
3660: 20 64 61 74 61 74 79 70 65 73 2e 0a 20 20 53 68   datatypes..  Sh
3670: 6f 72 74 20 73 75 6d 6d 61 72 79 3a 20 20 45 76  ort summary:  Ev
3680: 65 72 79 74 68 69 6e 67 20 69 73 20 61 20 73 74  erything is a st
3690: 72 69 6e 67 2e 0a 7d 0a 64 6f 63 20 7b 56 44 42  ring..}.doc {VDB
36a0: 45 20 54 75 74 6f 72 69 61 6c 7d 20 7b 76 64 62  E Tutorial} {vdb
36b0: 65 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54 68 65 20  e.html} {.  The 
36c0: 56 44 42 45 20 69 73 20 74 68 65 20 73 75 62 73  VDBE is the subs
36d0: 79 73 74 65 6d 20 77 69 74 68 69 6e 20 53 51 4c  ystem within SQL
36e0: 69 74 65 20 74 68 61 74 20 64 6f 65 73 20 74 68  ite that does th
36f0: 65 20 61 63 74 75 61 6c 20 77 6f 72 6b 20 6f 66  e actual work of
3700: 0a 20 20 65 78 65 63 75 74 69 6e 67 20 53 51 4c  .  executing SQL
3710: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 54 68   statements.  Th
3720: 69 73 20 70 61 67 65 20 64 65 73 63 72 69 62 65  is page describe
3730: 73 20 74 68 65 20 70 72 69 6e 63 69 70 6c 65 73  s the principles
3740: 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 0a 20 20   of operation.  
3750: 66 6f 72 20 74 68 65 20 56 44 42 45 20 69 6e 20  for the VDBE in 
3760: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 32  SQLite version 2
3770: 2e 37 2e 20 20 54 68 69 73 20 69 73 20 65 73 73  .7.  This is ess
3780: 65 6e 74 69 61 6c 20 72 65 61 64 69 6e 67 20 66  ential reading f
3790: 6f 72 20 61 6e 79 6f 6e 65 0a 20 20 77 68 6f 20  or anyone.  who 
37a0: 77 61 6e 74 20 74 6f 20 6d 6f 64 69 66 79 20 74  want to modify t
37b0: 68 65 20 53 51 4c 69 74 65 20 73 6f 75 72 63 65  he SQLite source
37c0: 73 2e 0a 7d 0a 64 6f 63 20 7b 53 51 4c 69 74 65  s..}.doc {SQLite
37d0: 20 56 65 72 73 69 6f 6e 20 33 7d 20 7b 76 65 72   Version 3} {ver
37e0: 73 69 6f 6e 33 2e 68 74 6d 6c 7d 20 7b 0a 20 20  sion3.html} {.  
37f0: 41 20 73 75 6d 6d 61 72 79 20 6f 66 20 74 68 65  A summary of the
3800: 20 63 68 61 6e 67 65 73 20 62 65 74 77 65 65 6e   changes between
3810: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20   SQLite version 
3820: 32 2e 38 20 61 6e 64 20 53 51 4c 69 74 65 20 76  2.8 and SQLite v
3830: 65 72 73 69 6f 6e 20 33 2e 30 2e 0a 7d 0a 64 6f  ersion 3.0..}.do
3840: 63 20 7b 56 65 72 73 69 6f 6e 20 33 20 43 2f 43  c {Version 3 C/C
3850: 2b 2b 20 41 50 49 7d 20 7b 63 61 70 69 33 2e 68  ++ API} {capi3.h
3860: 74 6d 6c 7d 20 7b 0a 20 20 41 20 73 75 6d 6d 61  tml} {.  A summa
3870: 72 79 20 6f 66 20 74 68 65 20 41 50 49 20 72 65  ry of the API re
3880: 6c 61 74 65 64 20 63 68 61 6e 67 65 73 20 62 65  lated changes be
3890: 74 77 65 65 6e 20 53 51 4c 69 74 65 20 76 65 72  tween SQLite ver
38a0: 73 69 6f 6e 20 32 2e 38 20 61 6e 64 20 0a 20 20  sion 2.8 and .  
38b0: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33  SQLite version 3
38c0: 2e 30 2e 20 0a 7d 0a 64 6f 63 20 7b 53 70 65 65  .0. .}.doc {Spee
38d0: 64 20 43 6f 6d 70 61 72 69 73 6f 6e 7d 20 7b 73  d Comparison} {s
38e0: 70 65 65 64 2e 68 74 6d 6c 7d 20 7b 0a 20 20 54  peed.html} {.  T
38f0: 68 65 20 73 70 65 65 64 20 6f 66 20 76 65 72 73  he speed of vers
3900: 69 6f 6e 20 32 2e 37 2e 36 20 6f 66 20 53 51 4c  ion 2.7.6 of SQL
3910: 69 74 65 20 69 73 20 63 6f 6d 70 61 72 65 64 20  ite is compared 
3920: 61 67 61 69 6e 73 74 20 50 6f 73 74 67 72 65 53  against PostgreS
3930: 51 4c 20 61 6e 64 0a 20 20 4d 79 53 51 4c 2e 0a  QL and.  MySQL..
3940: 7d 0a                                            }.