Documentation Source Text

Hex Artifact Content
Login

Artifact da958567bfa21cc219dcb8a644b5c1d2e3f7c07d3bc5060c8e06e18d8bc9ecd8:


0000: 3c 74 69 74 6c 65 3e 53 51 4c 69 74 65 20 46 72  <title>SQLite Fr
0010: 65 71 75 65 6e 74 6c 79 20 41 73 6b 65 64 20 51  equently Asked Q
0020: 75 65 73 74 69 6f 6e 73 3c 2f 74 69 74 6c 65 3e  uestions</title>
0030: 0a 0a 3c 74 63 6c 3e 0a 73 65 74 20 63 6e 74 20  ..<tcl>.set cnt 
0040: 31 0a 70 72 6f 63 20 66 61 71 20 7b 71 75 65 73  1.proc faq {ques
0050: 74 69 6f 6e 20 61 6e 73 77 65 72 7d 20 7b 0a 20  tion answer} {. 
0060: 20 73 65 74 20 3a 3a 66 61 71 28 24 3a 3a 63 6e   set ::faq($::cn
0070: 74 29 20 5b 6c 69 73 74 20 5b 73 74 72 69 6e 67  t) [list [string
0080: 20 74 72 69 6d 20 24 71 75 65 73 74 69 6f 6e 5d   trim $question]
0090: 20 5b 73 74 72 69 6e 67 20 74 72 69 6d 20 24 61   [string trim $a
00a0: 6e 73 77 65 72 5d 5d 0a 20 20 69 6e 63 72 20 3a  nswer]].  incr :
00b0: 3a 63 6e 74 0a 7d 0a 0a 23 23 23 23 23 23 23 23  :cnt.}..########
00c0: 23 23 23 23 23 0a 23 20 45 6e 74 65 72 20 71 75  #####.# Enter qu
00d0: 65 73 74 69 6f 6e 73 20 61 6e 64 20 61 6e 73 77  estions and answ
00e0: 65 72 73 20 68 65 72 65 2e 0a 0a 66 61 71 20 7b  ers here...faq {
00f0: 0a 20 20 48 6f 77 20 64 6f 20 49 20 63 72 65 61  .  How do I crea
0100: 74 65 20 61 6e 20 41 55 54 4f 49 4e 43 52 45 4d  te an AUTOINCREM
0110: 45 4e 54 20 66 69 65 6c 64 3f 0a 7d 20 7b 0a 20  ENT field?.} {. 
0120: 20 3c 70 3e 53 68 6f 72 74 20 61 6e 73 77 65 72   <p>Short answer
0130: 3a 20 41 20 63 6f 6c 75 6d 6e 20 64 65 63 6c 61  : A column decla
0140: 72 65 64 20 5b 49 4e 54 45 47 45 52 20 50 52 49  red [INTEGER PRI
0150: 4d 41 52 59 20 4b 45 59 5d 20 77 69 6c 6c 0a 20  MARY KEY] will. 
0160: 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 2e 3c   autoincrement.<
0170: 2f 70 3e 0a 0a 20 20 3c 70 3e 4c 6f 6e 67 65 72  /p>..  <p>Longer
0180: 20 61 6e 73 77 65 72 3a 0a 20 20 49 66 20 79 6f   answer:.  If yo
0190: 75 20 64 65 63 6c 61 72 65 20 61 20 63 6f 6c 75  u declare a colu
01a0: 6d 6e 20 6f 66 20 61 20 74 61 62 6c 65 20 74 6f  mn of a table to
01b0: 20 62 65 20 5b 49 4e 54 45 47 45 52 20 50 52 49   be [INTEGER PRI
01c0: 4d 41 52 59 20 4b 45 59 5d 2c 20 74 68 65 6e 0a  MARY KEY], then.
01d0: 20 20 77 68 65 6e 65 76 65 72 20 79 6f 75 20 69    whenever you i
01e0: 6e 73 65 72 74 20 61 20 4e 55 4c 4c 0a 20 20 69  nsert a NULL.  i
01f0: 6e 74 6f 20 74 68 61 74 20 63 6f 6c 75 6d 6e 20  nto that column 
0200: 6f 66 20 74 68 65 20 74 61 62 6c 65 2c 20 74 68  of the table, th
0210: 65 20 4e 55 4c 4c 20 69 73 20 61 75 74 6f 6d 61  e NULL is automa
0220: 74 69 63 61 6c 6c 79 20 63 6f 6e 76 65 72 74 65  tically converte
0230: 64 0a 20 20 69 6e 74 6f 20 61 6e 20 69 6e 74 65  d.  into an inte
0240: 67 65 72 20 77 68 69 63 68 20 69 73 20 6f 6e 65  ger which is one
0250: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68   greater than th
0260: 65 20 6c 61 72 67 65 73 74 20 76 61 6c 75 65 20  e largest value 
0270: 6f 66 20 74 68 61 74 0a 20 20 63 6f 6c 75 6d 6e  of that.  column
0280: 20 6f 76 65 72 20 61 6c 6c 20 6f 74 68 65 72 20   over all other 
0290: 72 6f 77 73 20 69 6e 20 74 68 65 20 74 61 62 6c  rows in the tabl
02a0: 65 2c 20 6f 72 20 31 20 69 66 20 74 68 65 20 74  e, or 1 if the t
02b0: 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 20  able is empty.. 
02c0: 20 4f 72 2c 20 69 66 20 74 68 65 20 6c 61 72 67   Or, if the larg
02d0: 65 73 74 20 65 78 69 73 74 69 6e 67 20 69 6e 74  est existing int
02e0: 65 67 65 72 20 6b 65 79 20 39 32 32 33 33 37 32  eger key 9223372
02f0: 30 33 36 38 35 34 37 37 35 38 30 37 20 69 73 20  036854775807 is 
0300: 69 6e 20 75 73 65 20 74 68 65 6e 20 61 6e 0a 20  in use then an. 
0310: 20 75 6e 75 73 65 64 20 6b 65 79 20 76 61 6c 75   unused key valu
0320: 65 20 69 73 20 63 68 6f 73 65 6e 20 61 74 20 72  e is chosen at r
0330: 61 6e 64 6f 6d 2e 0a 20 20 46 6f 72 20 65 78 61  andom..  For exa
0340: 6d 70 6c 65 2c 20 73 75 70 70 6f 73 65 20 79 6f  mple, suppose yo
0350: 75 20 68 61 76 65 20 61 20 74 61 62 6c 65 20 6c  u have a table l
0360: 69 6b 65 20 74 68 69 73 3a 0a 3c 62 6c 6f 63 6b  ike this:.<block
0370: 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 43 52 45 41  quote><pre>.CREA
0380: 54 45 20 54 41 42 4c 45 20 74 31 28 0a 20 20 61  TE TABLE t1(.  a
0390: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59   INTEGER PRIMARY
03a0: 20 4b 45 59 2c 0a 20 20 62 20 49 4e 54 45 47 45   KEY,.  b INTEGE
03b0: 52 0a 29 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  R.);.</pre></blo
03c0: 63 6b 71 75 6f 74 65 3e 0a 20 20 3c 70 3e 57 69  ckquote>.  <p>Wi
03d0: 74 68 20 74 68 69 73 20 74 61 62 6c 65 2c 20 74  th this table, t
03e0: 68 65 20 73 74 61 74 65 6d 65 6e 74 3c 2f 70 3e  he statement</p>
03f0: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
0400: 65 3e 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74  e>.INSERT INTO t
0410: 31 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c 31 32  1 VALUES(NULL,12
0420: 33 29 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63  3);.</pre></bloc
0430: 6b 71 75 6f 74 65 3e 0a 20 20 3c 70 3e 69 73 20  kquote>.  <p>is 
0440: 6c 6f 67 69 63 61 6c 6c 79 20 65 71 75 69 76 61  logically equiva
0450: 6c 65 6e 74 20 74 6f 20 73 61 79 69 6e 67 3a 3c  lent to saying:<
0460: 2f 70 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  /p>.<blockquote>
0470: 3c 70 72 65 3e 0a 49 4e 53 45 52 54 20 49 4e 54  <pre>.INSERT INT
0480: 4f 20 74 31 20 56 41 4c 55 45 53 28 28 53 45 4c  O t1 VALUES((SEL
0490: 45 43 54 20 6d 61 78 28 61 29 20 46 52 4f 4d 20  ECT max(a) FROM 
04a0: 74 31 29 2b 31 2c 31 32 33 29 3b 0a 3c 2f 70 72  t1)+1,123);.</pr
04b0: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
04c0: 0a 20 20 3c 70 3e 54 68 65 72 65 20 69 73 20 61  .  <p>There is a
04d0: 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 64 0a   function named.
04e0: 20 20 5b 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f    [sqlite3_last_
04f0: 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 29 5d 20  insert_rowid()] 
0500: 77 68 69 63 68 20 77 69 6c 6c 20 72 65 74 75 72  which will retur
0510: 6e 20 74 68 65 20 69 6e 74 65 67 65 72 20 6b 65  n the integer ke
0520: 79 0a 20 20 66 6f 72 20 74 68 65 20 6d 6f 73 74  y.  for the most
0530: 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 20 6f   recent insert o
0540: 70 65 72 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 20  peration.</p>.. 
0550: 20 3c 70 3e 4e 6f 74 65 20 74 68 61 74 20 74 68   <p>Note that th
0560: 65 20 69 6e 74 65 67 65 72 20 6b 65 79 20 69 73  e integer key is
0570: 20 6f 6e 65 20 67 72 65 61 74 65 72 20 74 68 61   one greater tha
0580: 6e 20 74 68 65 20 6c 61 72 67 65 73 74 0a 20 20  n the largest.  
0590: 6b 65 79 20 74 68 61 74 20 77 61 73 20 69 6e 20  key that was in 
05a0: 74 68 65 20 74 61 62 6c 65 20 6a 75 73 74 20 70  the table just p
05b0: 72 69 6f 72 20 74 6f 20 74 68 65 20 69 6e 73 65  rior to the inse
05c0: 72 74 2e 20 20 54 68 65 20 6e 65 77 20 6b 65 79  rt.  The new key
05d0: 0a 20 20 77 69 6c 6c 20 62 65 20 75 6e 69 71 75  .  will be uniqu
05e0: 65 20 6f 76 65 72 20 61 6c 6c 20 6b 65 79 73 20  e over all keys 
05f0: 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 68 65  currently in the
0600: 20 74 61 62 6c 65 2c 20 62 75 74 20 69 74 20 6d   table, but it m
0610: 69 67 68 74 0a 20 20 6f 76 65 72 6c 61 70 20 77  ight.  overlap w
0620: 69 74 68 20 6b 65 79 73 20 74 68 61 74 20 68 61  ith keys that ha
0630: 76 65 20 62 65 65 6e 20 70 72 65 76 69 6f 75 73  ve been previous
0640: 6c 79 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20  ly deleted from 
0650: 74 68 65 0a 20 20 74 61 62 6c 65 2e 20 20 54 6f  the.  table.  To
0660: 20 63 72 65 61 74 65 20 6b 65 79 73 20 74 68 61   create keys tha
0670: 74 20 61 72 65 20 75 6e 69 71 75 65 20 6f 76 65  t are unique ove
0680: 72 20 74 68 65 20 6c 69 66 65 74 69 6d 65 20 6f  r the lifetime o
0690: 66 20 74 68 65 0a 20 20 74 61 62 6c 65 2c 20 61  f the.  table, a
06a0: 64 64 20 74 68 65 20 5b 41 55 54 4f 49 4e 43 52  dd the [AUTOINCR
06b0: 45 4d 45 4e 54 5d 20 6b 65 79 77 6f 72 64 20 74  EMENT] keyword t
06c0: 6f 20 74 68 65 20 5b 49 4e 54 45 47 45 52 20 50  o the [INTEGER P
06d0: 52 49 4d 41 52 59 20 4b 45 59 5d 0a 20 20 64 65  RIMARY KEY].  de
06e0: 63 6c 61 72 61 74 69 6f 6e 2e 20 20 54 68 65 6e  claration.  Then
06f0: 20 74 68 65 20 6b 65 79 20 63 68 6f 73 65 6e 20   the key chosen 
0700: 77 69 6c 6c 20 62 65 20 6f 6e 65 20 6d 6f 72 65  will be one more
0710: 20 74 68 61 6e 20 74 68 65 0a 20 20 6c 61 72 67   than the.  larg
0720: 65 73 74 20 6b 65 79 20 74 68 61 74 20 68 61 73  est key that has
0730: 20 65 76 65 72 20 65 78 69 73 74 65 64 20 69 6e   ever existed in
0740: 20 74 68 61 74 20 74 61 62 6c 65 2e 20 20 49 66   that table.  If
0750: 20 74 68 65 20 6c 61 72 67 65 73 74 0a 20 20 70   the largest.  p
0760: 6f 73 73 69 62 6c 65 20 6b 65 79 20 68 61 73 20  ossible key has 
0770: 70 72 65 76 69 6f 75 73 6c 79 20 65 78 69 73 74  previously exist
0780: 65 64 20 69 6e 20 74 68 61 74 20 74 61 62 6c 65  ed in that table
0790: 2c 20 74 68 65 6e 20 74 68 65 20 5b 49 4e 53 45  , then the [INSE
07a0: 52 54 5d 0a 20 20 77 69 6c 6c 20 66 61 69 6c 20  RT].  will fail 
07b0: 77 69 74 68 20 61 6e 20 5b 53 51 4c 49 54 45 5f  with an [SQLITE_
07c0: 46 55 4c 4c 5d 20 65 72 72 6f 72 20 63 6f 64 65  FULL] error code
07d0: 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20  .</p>.}..faq {. 
07e0: 20 57 68 61 74 20 64 61 74 61 74 79 70 65 73 20   What datatypes 
07f0: 64 6f 65 73 20 53 51 4c 69 74 65 20 73 75 70 70  does SQLite supp
0800: 6f 72 74 3f 0a 7d 20 7b 0a 20 20 53 51 4c 69 74  ort?.} {.  SQLit
0810: 65 20 75 73 65 73 20 5b 64 79 6e 61 6d 69 63 20  e uses [dynamic 
0820: 74 79 70 69 6e 67 5d 2e 20 20 43 6f 6e 74 65 6e  typing].  Conten
0830: 74 20 63 61 6e 20 62 65 20 73 74 6f 72 65 64 20  t can be stored 
0840: 61 73 20 49 4e 54 45 47 45 52 2c 0a 20 20 52 45  as INTEGER,.  RE
0850: 41 4c 2c 20 54 45 58 54 2c 20 42 4c 4f 42 2c 20  AL, TEXT, BLOB, 
0860: 6f 72 20 61 73 20 4e 55 4c 4c 2e 0a 7d 0a 0a 66  or as NULL..}..f
0870: 61 71 20 7b 0a 20 20 53 51 4c 69 74 65 20 6c 65  aq {.  SQLite le
0880: 74 73 20 6d 65 20 69 6e 73 65 72 74 20 61 20 73  ts me insert a s
0890: 74 72 69 6e 67 20 69 6e 74 6f 20 61 20 64 61 74  tring into a dat
08a0: 61 62 61 73 65 20 63 6f 6c 75 6d 6e 20 6f 66 20  abase column of 
08b0: 74 79 70 65 20 69 6e 74 65 67 65 72 21 0a 7d 20  type integer!.} 
08c0: 7b 0a 20 20 3c 70 3e 54 68 69 73 20 69 73 20 61  {.  <p>This is a
08d0: 20 66 65 61 74 75 72 65 2c 20 6e 6f 74 20 61 20   feature, not a 
08e0: 62 75 67 2e 20 20 53 51 4c 69 74 65 20 75 73 65  bug.  SQLite use
08f0: 73 20 5b 64 79 6e 61 6d 69 63 20 74 79 70 69 6e  s [dynamic typin
0900: 67 5d 2e 20 0a 20 20 49 74 20 64 6f 65 73 20 6e  g]. .  It does n
0910: 6f 74 20 65 6e 66 6f 72 63 65 20 64 61 74 61 20  ot enforce data 
0920: 74 79 70 65 20 20 63 6f 6e 73 74 72 61 69 6e 74  type  constraint
0930: 73 2e 20 20 44 61 74 61 20 6f 66 20 61 6e 79 20  s.  Data of any 
0940: 74 79 70 65 20 63 61 6e 0a 20 20 28 75 73 75 61  type can.  (usua
0950: 6c 6c 79 29 20 62 65 20 69 6e 73 65 72 74 65 64  lly) be inserted
0960: 20 69 6e 74 6f 20 61 6e 79 20 63 6f 6c 75 6d 6e   into any column
0970: 2e 20 20 59 6f 75 20 63 61 6e 20 70 75 74 20 61  .  You can put a
0980: 72 62 69 74 72 61 72 79 20 6c 65 6e 67 74 68 0a  rbitrary length.
0990: 20 20 73 74 72 69 6e 67 73 20 69 6e 74 6f 20 69    strings into i
09a0: 6e 74 65 67 65 72 20 63 6f 6c 75 6d 6e 73 2c 20  nteger columns, 
09b0: 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e  floating point n
09c0: 75 6d 62 65 72 73 20 69 6e 20 62 6f 6f 6c 65 61  umbers in boolea
09d0: 6e 20 63 6f 6c 75 6d 6e 73 2c 0a 20 20 6f 72 20  n columns,.  or 
09e0: 64 61 74 65 73 20 69 6e 20 63 68 61 72 61 63 74  dates in charact
09f0: 65 72 20 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65  er columns.  The
0a00: 20 5b 64 61 74 61 74 79 70 65 5d 20 79 6f 75 20   [datatype] you 
0a10: 61 73 73 69 67 6e 20 74 6f 20 61 20 63 6f 6c 75  assign to a colu
0a20: 6d 6e 20 69 6e 20 74 68 65 0a 20 20 43 52 45 41  mn in the.  CREA
0a30: 54 45 20 54 41 42 4c 45 20 63 6f 6d 6d 61 6e 64  TE TABLE command
0a40: 20 64 6f 65 73 20 6e 6f 74 20 72 65 73 74 72 69   does not restri
0a50: 63 74 20 77 68 61 74 20 64 61 74 61 20 63 61 6e  ct what data can
0a60: 20 62 65 20 70 75 74 20 69 6e 74 6f 0a 20 20 74   be put into.  t
0a70: 68 61 74 20 63 6f 6c 75 6d 6e 2e 20 20 45 76 65  hat column.  Eve
0a80: 72 79 20 63 6f 6c 75 6d 6e 20 69 73 20 61 62 6c  ry column is abl
0a90: 65 20 74 6f 20 68 6f 6c 64 0a 20 20 61 6e 20 61  e to hold.  an a
0aa0: 72 62 69 74 72 61 72 79 20 6c 65 6e 67 74 68 20  rbitrary length 
0ab0: 73 74 72 69 6e 67 2e 20 20 28 54 68 65 72 65 20  string.  (There 
0ac0: 69 73 20 6f 6e 65 20 65 78 63 65 70 74 69 6f 6e  is one exception
0ad0: 3a 20 43 6f 6c 75 6d 6e 73 20 6f 66 0a 20 20 74  : Columns of.  t
0ae0: 79 70 65 20 5b 49 4e 54 45 47 45 52 20 50 52 49  ype [INTEGER PRI
0af0: 4d 41 52 59 20 4b 45 59 5d 20 6d 61 79 20 6f 6e  MARY KEY] may on
0b00: 6c 79 20 68 6f 6c 64 20 61 20 36 34 2d 62 69 74  ly hold a 64-bit
0b10: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 2e   signed integer.
0b20: 0a 20 20 41 6e 20 65 72 72 6f 72 20 77 69 6c 6c  .  An error will
0b30: 20 72 65 73 75 6c 74 0a 20 20 69 66 20 79 6f 75   result.  if you
0b40: 20 74 72 79 20 74 6f 20 70 75 74 20 61 6e 79 74   try to put anyt
0b50: 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20  hing other than 
0b60: 61 6e 20 69 6e 74 65 67 65 72 20 69 6e 74 6f 20  an integer into 
0b70: 61 6e 0a 20 20 5b 49 4e 54 45 47 45 52 20 50 52  an.  [INTEGER PR
0b80: 49 4d 41 52 59 20 4b 45 59 5d 20 63 6f 6c 75 6d  IMARY KEY] colum
0b90: 6e 2e 29 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 42 75  n.)</p>..  <p>Bu
0ba0: 74 20 53 51 4c 69 74 65 20 64 6f 65 73 20 75 73  t SQLite does us
0bb0: 65 20 74 68 65 20 64 65 63 6c 61 72 65 64 20 74  e the declared t
0bc0: 79 70 65 20 6f 66 20 61 20 63 6f 6c 75 6d 6e 20  ype of a column 
0bd0: 61 73 20 61 20 68 69 6e 74 0a 20 20 74 68 61 74  as a hint.  that
0be0: 20 79 6f 75 20 70 72 65 66 65 72 20 76 61 6c 75   you prefer valu
0bf0: 65 73 20 69 6e 20 74 68 61 74 20 66 6f 72 6d 61  es in that forma
0c00: 74 2e 20 20 53 6f 2c 20 66 6f 72 20 65 78 61 6d  t.  So, for exam
0c10: 70 6c 65 2c 20 69 66 20 61 0a 20 20 63 6f 6c 75  ple, if a.  colu
0c20: 6d 6e 20 69 73 20 6f 66 20 74 79 70 65 20 49 4e  mn is of type IN
0c30: 54 45 47 45 52 20 61 6e 64 20 79 6f 75 20 74 72  TEGER and you tr
0c40: 79 20 74 6f 20 69 6e 73 65 72 74 20 61 20 73 74  y to insert a st
0c50: 72 69 6e 67 20 69 6e 74 6f 0a 20 20 74 68 61 74  ring into.  that
0c60: 20 63 6f 6c 75 6d 6e 2c 20 53 51 4c 69 74 65 20   column, SQLite 
0c70: 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20  will attempt to 
0c80: 63 6f 6e 76 65 72 74 20 74 68 65 20 73 74 72 69  convert the stri
0c90: 6e 67 20 69 6e 74 6f 20 61 6e 0a 20 20 69 6e 74  ng into an.  int
0ca0: 65 67 65 72 2e 20 20 49 66 20 69 74 20 63 61 6e  eger.  If it can
0cb0: 2c 20 69 74 20 69 6e 73 65 72 74 73 20 74 68 65  , it inserts the
0cc0: 20 69 6e 74 65 67 65 72 20 69 6e 73 74 65 61 64   integer instead
0cd0: 2e 20 20 49 66 20 6e 6f 74 2c 0a 20 20 69 74 20  .  If not,.  it 
0ce0: 69 6e 73 65 72 74 73 20 74 68 65 20 73 74 72 69  inserts the stri
0cf0: 6e 67 2e 20 20 54 68 69 73 20 66 65 61 74 75 72  ng.  This featur
0d00: 65 20 69 73 20 63 61 6c 6c 65 64 20 5b 61 66 66  e is called [aff
0d10: 69 6e 69 74 79 20 7c 20 74 79 70 65 20 61 66 66  inity | type aff
0d20: 69 6e 69 74 79 5d 2e 0a 20 20 3c 2f 70 3e 0a 7d  inity]..  </p>.}
0d30: 0a 0a 66 61 71 20 7b 0a 20 20 57 68 79 20 64 6f  ..faq {.  Why do
0d40: 65 73 6e 27 74 20 53 51 4c 69 74 65 20 61 6c 6c  esn't SQLite all
0d50: 6f 77 20 6d 65 20 74 6f 20 75 73 65 20 27 30 27  ow me to use '0'
0d60: 20 61 6e 64 20 27 30 2e 30 27 20 61 73 20 74 68   and '0.0' as th
0d70: 65 20 70 72 69 6d 61 72 79 0a 20 20 6b 65 79 20  e primary.  key 
0d80: 6f 6e 20 74 77 6f 20 64 69 66 66 65 72 65 6e 74  on two different
0d90: 20 72 6f 77 73 20 6f 66 20 74 68 65 20 73 61 6d   rows of the sam
0da0: 65 20 74 61 62 6c 65 3f 0a 7d 20 7b 0a 20 20 3c  e table?.} {.  <
0db0: 70 3e 54 68 69 73 20 70 72 6f 62 6c 65 6d 20 6f  p>This problem o
0dc0: 63 63 75 72 73 20 77 68 65 6e 20 79 6f 75 72 20  ccurs when your 
0dd0: 70 72 69 6d 61 72 79 20 6b 65 79 20 69 73 20 61  primary key is a
0de0: 20 6e 75 6d 65 72 69 63 20 74 79 70 65 2e 20 20   numeric type.  
0df0: 43 68 61 6e 67 65 20 74 68 65 0a 20 20 5b 64 61  Change the.  [da
0e00: 74 61 74 79 70 65 5d 20 6f 66 20 79 6f 75 72 20  tatype] of your 
0e10: 70 72 69 6d 61 72 79 20 6b 65 79 20 74 6f 20 54  primary key to T
0e20: 45 58 54 20 61 6e 64 20 69 74 20 73 68 6f 75 6c  EXT and it shoul
0e30: 64 20 77 6f 72 6b 2e 3c 2f 70 3e 0a 0a 20 20 3c  d work.</p>..  <
0e40: 70 3e 45 76 65 72 79 20 72 6f 77 20 6d 75 73 74  p>Every row must
0e50: 20 68 61 76 65 20 61 20 75 6e 69 71 75 65 20 70   have a unique p
0e60: 72 69 6d 61 72 79 20 6b 65 79 2e 20 20 46 6f 72  rimary key.  For
0e70: 20 61 20 63 6f 6c 75 6d 6e 20 77 69 74 68 20 61   a column with a
0e80: 0a 20 20 6e 75 6d 65 72 69 63 20 74 79 70 65 2c  .  numeric type,
0e90: 20 53 51 4c 69 74 65 20 74 68 69 6e 6b 73 20 74   SQLite thinks t
0ea0: 68 61 74 20 3c 62 3e 27 30 27 3c 2f 62 3e 20 61  hat <b>'0'</b> a
0eb0: 6e 64 20 3c 62 3e 27 30 2e 30 27 3c 2f 62 3e 20  nd <b>'0.0'</b> 
0ec0: 61 72 65 20 74 68 65 0a 20 20 73 61 6d 65 20 76  are the.  same v
0ed0: 61 6c 75 65 20 62 65 63 61 75 73 65 20 74 68 65  alue because the
0ee0: 79 20 63 6f 6d 70 61 72 65 20 65 71 75 61 6c 20  y compare equal 
0ef0: 74 6f 20 6f 6e 65 20 61 6e 6f 74 68 65 72 20 6e  to one another n
0f00: 75 6d 65 72 69 63 61 6c 6c 79 2e 0a 20 20 28 53  umerically..  (S
0f10: 65 65 20 74 68 65 20 70 72 65 76 69 6f 75 73 20  ee the previous 
0f20: 71 75 65 73 74 69 6f 6e 2e 29 20 20 48 65 6e 63  question.)  Henc
0f30: 65 20 74 68 65 20 76 61 6c 75 65 73 20 61 72 65  e the values are
0f40: 20 6e 6f 74 20 75 6e 69 71 75 65 2e 3c 2f 70 3e   not unique.</p>
0f50: 0a 7d 0a 20 20 20 20 20 20 20 20 0a 0a 66 61 71  .}.        ..faq
0f60: 20 7b 0a 20 20 43 61 6e 20 6d 75 6c 74 69 70 6c   {.  Can multipl
0f70: 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 6f  e applications o
0f80: 72 20 6d 75 6c 74 69 70 6c 65 20 69 6e 73 74 61  r multiple insta
0f90: 6e 63 65 73 20 6f 66 20 74 68 65 20 73 61 6d 65  nces of the same
0fa0: 0a 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 61  .  application a
0fb0: 63 63 65 73 73 20 61 20 73 69 6e 67 6c 65 20 64  ccess a single d
0fc0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 74 20  atabase file at 
0fd0: 74 68 65 20 73 61 6d 65 20 74 69 6d 65 3f 0a 7d  the same time?.}
0fe0: 20 7b 0a 20 20 3c 70 3e 4d 75 6c 74 69 70 6c 65   {.  <p>Multiple
0ff0: 20 70 72 6f 63 65 73 73 65 73 20 63 61 6e 20 68   processes can h
1000: 61 76 65 20 74 68 65 20 73 61 6d 65 20 64 61 74  ave the same dat
1010: 61 62 61 73 65 20 6f 70 65 6e 20 61 74 20 74 68  abase open at th
1020: 65 20 73 61 6d 65 0a 20 20 74 69 6d 65 2e 20 20  e same.  time.  
1030: 4d 75 6c 74 69 70 6c 65 20 70 72 6f 63 65 73 73  Multiple process
1040: 65 73 20 63 61 6e 20 62 65 20 64 6f 69 6e 67 20  es can be doing 
1050: 61 20 53 45 4c 45 43 54 0a 20 20 61 74 20 74 68  a SELECT.  at th
1060: 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 42 75  e same time.  Bu
1070: 74 20 6f 6e 6c 79 20 6f 6e 65 20 70 72 6f 63 65  t only one proce
1080: 73 73 20 63 61 6e 20 62 65 20 6d 61 6b 69 6e 67  ss can be making
1090: 20 63 68 61 6e 67 65 73 20 74 6f 0a 20 20 74 68   changes to.  th
10a0: 65 20 64 61 74 61 62 61 73 65 20 61 74 20 61 6e  e database at an
10b0: 79 20 6d 6f 6d 65 6e 74 20 69 6e 20 74 69 6d 65  y moment in time
10c0: 2c 20 68 6f 77 65 76 65 72 2e 3c 2f 70 3e 0a 0a  , however.</p>..
10d0: 20 20 3c 70 3e 53 51 4c 69 74 65 20 75 73 65 73    <p>SQLite uses
10e0: 20 72 65 61 64 65 72 2f 77 72 69 74 65 72 20 6c   reader/writer l
10f0: 6f 63 6b 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20  ocks to control 
1100: 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 64 61  access to the da
1110: 74 61 62 61 73 65 2e 0a 20 20 28 55 6e 64 65 72  tabase..  (Under
1120: 20 57 69 6e 39 35 2f 39 38 2f 4d 45 20 77 68 69   Win95/98/ME whi
1130: 63 68 20 6c 61 63 6b 73 20 73 75 70 70 6f 72 74  ch lacks support
1140: 20 66 6f 72 20 72 65 61 64 65 72 2f 77 72 69 74   for reader/writ
1150: 65 72 20 6c 6f 63 6b 73 2c 20 61 0a 20 20 70 72  er locks, a.  pr
1160: 6f 62 61 62 69 6c 69 73 74 69 63 20 73 69 6d 75  obabilistic simu
1170: 6c 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69  lation is used i
1180: 6e 73 74 65 61 64 2e 29 0a 20 20 42 75 74 20 75  nstead.).  But u
1190: 73 65 20 63 61 75 74 69 6f 6e 3a 20 74 68 69 73  se caution: this
11a0: 20 6c 6f 63 6b 69 6e 67 20 6d 65 63 68 61 6e 69   locking mechani
11b0: 73 6d 20 6d 69 67 68 74 0a 20 20 6e 6f 74 20 77  sm might.  not w
11c0: 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79 20 69 66  ork correctly if
11d0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
11e0: 6c 65 20 69 73 20 6b 65 70 74 20 6f 6e 20 61 6e  le is kept on an
11f0: 20 4e 46 53 20 66 69 6c 65 73 79 73 74 65 6d 2e   NFS filesystem.
1200: 0a 20 20 54 68 69 73 20 69 73 20 62 65 63 61 75  .  This is becau
1210: 73 65 20 66 63 6e 74 6c 28 29 20 66 69 6c 65 20  se fcntl() file 
1220: 6c 6f 63 6b 69 6e 67 20 69 73 20 62 72 6f 6b 65  locking is broke
1230: 6e 20 6f 6e 20 6d 61 6e 79 20 4e 46 53 20 69 6d  n on many NFS im
1240: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 2e 0a 20  plementations.. 
1250: 20 59 6f 75 20 73 68 6f 75 6c 64 20 61 76 6f 69   You should avoi
1260: 64 20 70 75 74 74 69 6e 67 20 53 51 4c 69 74 65  d putting SQLite
1270: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20   database files 
1280: 6f 6e 20 4e 46 53 20 69 66 20 6d 75 6c 74 69 70  on NFS if multip
1290: 6c 65 0a 20 20 70 72 6f 63 65 73 73 65 73 20 6d  le.  processes m
12a0: 69 67 68 74 20 74 72 79 20 74 6f 20 61 63 63 65  ight try to acce
12b0: 73 73 20 74 68 65 20 66 69 6c 65 20 61 74 20 74  ss the file at t
12c0: 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 4f  he same time.  O
12d0: 6e 20 57 69 6e 64 6f 77 73 2c 0a 20 20 4d 69 63  n Windows,.  Mic
12e0: 72 6f 73 6f 66 74 27 73 20 64 6f 63 75 6d 65 6e  rosoft's documen
12f0: 74 61 74 69 6f 6e 20 73 61 79 73 20 74 68 61 74  tation says that
1300: 20 6c 6f 63 6b 69 6e 67 20 6d 61 79 20 6e 6f 74   locking may not
1310: 20 77 6f 72 6b 20 75 6e 64 65 72 20 46 41 54 0a   work under FAT.
1320: 20 20 66 69 6c 65 73 79 73 74 65 6d 73 20 69 66    filesystems if
1330: 20 79 6f 75 20 61 72 65 20 6e 6f 74 20 72 75 6e   you are not run
1340: 6e 69 6e 67 20 74 68 65 20 53 68 61 72 65 2e 65  ning the Share.e
1350: 78 65 20 64 61 65 6d 6f 6e 2e 20 20 50 65 6f 70  xe daemon.  Peop
1360: 6c 65 20 77 68 6f 0a 20 20 68 61 76 65 20 61 20  le who.  have a 
1370: 6c 6f 74 20 6f 66 20 65 78 70 65 72 69 65 6e 63  lot of experienc
1380: 65 20 77 69 74 68 20 57 69 6e 64 6f 77 73 20 74  e with Windows t
1390: 65 6c 6c 20 6d 65 20 74 68 61 74 20 66 69 6c 65  ell me that file
13a0: 20 6c 6f 63 6b 69 6e 67 20 6f 66 0a 20 20 6e 65   locking of.  ne
13b0: 74 77 6f 72 6b 20 66 69 6c 65 73 20 69 73 20 76  twork files is v
13c0: 65 72 79 20 62 75 67 67 79 20 61 6e 64 20 69 73  ery buggy and is
13d0: 20 6e 6f 74 20 64 65 70 65 6e 64 61 62 6c 65 2e   not dependable.
13e0: 20 20 49 66 20 77 68 61 74 20 74 68 65 79 0a 20    If what they. 
13f0: 20 73 61 79 20 69 73 20 74 72 75 65 2c 20 73 68   say is true, sh
1400: 61 72 69 6e 67 20 61 6e 20 53 51 4c 69 74 65 20  aring an SQLite 
1410: 64 61 74 61 62 61 73 65 20 62 65 74 77 65 65 6e  database between
1420: 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 57 69 6e   two or more Win
1430: 64 6f 77 73 0a 20 20 6d 61 63 68 69 6e 65 73 20  dows.  machines 
1440: 6d 69 67 68 74 20 63 61 75 73 65 20 75 6e 65 78  might cause unex
1450: 70 65 63 74 65 64 20 70 72 6f 62 6c 65 6d 73 2e  pected problems.
1460: 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 57 65 20 61 72  </p>..  <p>We ar
1470: 65 20 61 77 61 72 65 20 6f 66 20 6e 6f 20 6f 74  e aware of no ot
1480: 68 65 72 20 3c 69 3e 65 6d 62 65 64 64 65 64 3c  her <i>embedded<
1490: 2f 69 3e 20 53 51 4c 20 64 61 74 61 62 61 73 65  /i> SQL database
14a0: 20 65 6e 67 69 6e 65 20 74 68 61 74 0a 20 20 73   engine that.  s
14b0: 75 70 70 6f 72 74 73 20 61 73 20 6d 75 63 68 20  upports as much 
14c0: 63 6f 6e 63 75 72 72 65 6e 63 79 20 61 73 20 53  concurrency as S
14d0: 51 4c 69 74 65 2e 20 20 53 51 4c 69 74 65 20 61  QLite.  SQLite a
14e0: 6c 6c 6f 77 73 20 6d 75 6c 74 69 70 6c 65 20 70  llows multiple p
14f0: 72 6f 63 65 73 73 65 73 0a 20 20 74 6f 20 68 61  rocesses.  to ha
1500: 76 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ve the database 
1510: 66 69 6c 65 20 6f 70 65 6e 20 61 74 20 6f 6e 63  file open at onc
1520: 65 2c 20 61 6e 64 20 66 6f 72 20 6d 75 6c 74 69  e, and for multi
1530: 70 6c 65 20 70 72 6f 63 65 73 73 65 73 20 74 6f  ple processes to
1540: 0a 20 20 72 65 61 64 20 74 68 65 20 64 61 74 61  .  read the data
1550: 62 61 73 65 20 61 74 20 6f 6e 63 65 2e 20 20 57  base at once.  W
1560: 68 65 6e 20 61 6e 79 20 70 72 6f 63 65 73 73 20  hen any process 
1570: 77 61 6e 74 73 20 74 6f 20 77 72 69 74 65 2c 20  wants to write, 
1580: 69 74 20 6d 75 73 74 0a 20 20 6c 6f 63 6b 20 74  it must.  lock t
1590: 68 65 20 65 6e 74 69 72 65 20 64 61 74 61 62 61  he entire databa
15a0: 73 65 20 66 69 6c 65 20 66 6f 72 20 74 68 65 20  se file for the 
15b0: 64 75 72 61 74 69 6f 6e 20 6f 66 20 69 74 73 20  duration of its 
15c0: 75 70 64 61 74 65 2e 20 20 42 75 74 20 74 68 61  update.  But tha
15d0: 74 0a 20 20 6e 6f 72 6d 61 6c 6c 79 20 6f 6e 6c  t.  normally onl
15e0: 79 20 74 61 6b 65 73 20 61 20 66 65 77 20 6d 69  y takes a few mi
15f0: 6c 6c 69 73 65 63 6f 6e 64 73 2e 20 20 4f 74 68  lliseconds.  Oth
1600: 65 72 20 70 72 6f 63 65 73 73 65 73 20 6a 75 73  er processes jus
1610: 74 20 77 61 69 74 20 6f 6e 0a 20 20 74 68 65 20  t wait on.  the 
1620: 77 72 69 74 65 72 20 74 6f 20 66 69 6e 69 73 68  writer to finish
1630: 20 74 68 65 6e 20 63 6f 6e 74 69 6e 75 65 20 61   then continue a
1640: 62 6f 75 74 20 74 68 65 69 72 20 62 75 73 69 6e  bout their busin
1650: 65 73 73 2e 20 20 4f 74 68 65 72 20 65 6d 62 65  ess.  Other embe
1660: 64 64 65 64 0a 20 20 53 51 4c 20 64 61 74 61 62  dded.  SQL datab
1670: 61 73 65 20 65 6e 67 69 6e 65 73 20 74 79 70 69  ase engines typi
1680: 63 61 6c 6c 79 20 6f 6e 6c 79 20 61 6c 6c 6f 77  cally only allow
1690: 20 61 20 73 69 6e 67 6c 65 20 70 72 6f 63 65 73   a single proces
16a0: 73 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f 0a  s to connect to.
16b0: 20 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61    the database a
16c0: 74 20 6f 6e 63 65 2e 3c 2f 70 3e 0a 0a 20 20 3c  t once.</p>..  <
16d0: 70 3e 48 6f 77 65 76 65 72 2c 20 63 6c 69 65 6e  p>However, clien
16e0: 74 2f 73 65 72 76 65 72 20 64 61 74 61 62 61 73  t/server databas
16f0: 65 20 65 6e 67 69 6e 65 73 20 28 73 75 63 68 20  e engines (such 
1700: 61 73 20 50 6f 73 74 67 72 65 53 51 4c 2c 20 4d  as PostgreSQL, M
1710: 79 53 51 4c 2c 0a 20 20 6f 72 20 4f 72 61 63 6c  ySQL,.  or Oracl
1720: 65 29 20 75 73 75 61 6c 6c 79 20 73 75 70 70 6f  e) usually suppo
1730: 72 74 20 61 20 68 69 67 68 65 72 20 6c 65 76 65  rt a higher leve
1740: 6c 20 6f 66 20 63 6f 6e 63 75 72 72 65 6e 63 79  l of concurrency
1750: 20 61 6e 64 20 61 6c 6c 6f 77 0a 20 20 6d 75 6c   and allow.  mul
1760: 74 69 70 6c 65 20 70 72 6f 63 65 73 73 65 73 20  tiple processes 
1770: 74 6f 20 62 65 20 77 72 69 74 69 6e 67 20 74 6f  to be writing to
1780: 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61   the same databa
1790: 73 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74  se at the same t
17a0: 69 6d 65 2e 0a 20 20 54 68 69 73 20 69 73 20 70  ime..  This is p
17b0: 6f 73 73 69 62 6c 65 20 69 6e 20 61 20 63 6c 69  ossible in a cli
17c0: 65 6e 74 2f 73 65 72 76 65 72 20 64 61 74 61 62  ent/server datab
17d0: 61 73 65 20 62 65 63 61 75 73 65 20 74 68 65 72  ase because ther
17e0: 65 20 69 73 20 61 6c 77 61 79 73 20 61 0a 20 20  e is always a.  
17f0: 73 69 6e 67 6c 65 20 77 65 6c 6c 2d 63 6f 6e 74  single well-cont
1800: 72 6f 6c 6c 65 64 20 73 65 72 76 65 72 20 70 72  rolled server pr
1810: 6f 63 65 73 73 20 61 76 61 69 6c 61 62 6c 65 20  ocess available 
1820: 74 6f 20 63 6f 6f 72 64 69 6e 61 74 65 20 61 63  to coordinate ac
1830: 63 65 73 73 2e 0a 20 20 49 66 20 79 6f 75 72 20  cess..  If your 
1840: 61 70 70 6c 69 63 61 74 69 6f 6e 20 68 61 73 20  application has 
1850: 61 20 6e 65 65 64 20 66 6f 72 20 61 20 6c 6f 74  a need for a lot
1860: 20 6f 66 20 63 6f 6e 63 75 72 72 65 6e 63 79 2c   of concurrency,
1870: 20 74 68 65 6e 20 79 6f 75 20 73 68 6f 75 6c 64   then you should
1880: 0a 20 20 63 6f 6e 73 69 64 65 72 20 75 73 69 6e  .  consider usin
1890: 67 20 61 20 63 6c 69 65 6e 74 2f 73 65 72 76 65  g a client/serve
18a0: 72 20 64 61 74 61 62 61 73 65 2e 20 20 42 75 74  r database.  But
18b0: 20 65 78 70 65 72 69 65 6e 63 65 20 73 75 67 67   experience sugg
18c0: 65 73 74 73 20 74 68 61 74 0a 20 20 6d 6f 73 74  ests that.  most
18d0: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 6e 65   applications ne
18e0: 65 64 20 6d 75 63 68 20 6c 65 73 73 20 63 6f 6e  ed much less con
18f0: 63 75 72 72 65 6e 63 79 20 74 68 61 6e 20 74 68  currency than th
1900: 65 69 72 20 64 65 73 69 67 6e 65 72 73 20 69 6d  eir designers im
1910: 61 67 69 6e 65 2e 0a 20 20 3c 2f 70 3e 0a 0a 20  agine..  </p>.. 
1920: 20 3c 70 3e 57 68 65 6e 20 53 51 4c 69 74 65 20   <p>When SQLite 
1930: 74 72 69 65 73 20 74 6f 20 61 63 63 65 73 73 20  tries to access 
1940: 61 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 6c  a file that is l
1950: 6f 63 6b 65 64 20 62 79 20 61 6e 6f 74 68 65 72  ocked by another
1960: 0a 20 20 70 72 6f 63 65 73 73 2c 20 74 68 65 20  .  process, the 
1970: 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72  default behavior
1980: 20 69 73 20 74 6f 20 72 65 74 75 72 6e 20 53 51   is to return SQ
1990: 4c 49 54 45 5f 42 55 53 59 2e 20 20 59 6f 75 20  LITE_BUSY.  You 
19a0: 63 61 6e 0a 20 20 61 64 6a 75 73 74 20 74 68 69  can.  adjust thi
19b0: 73 20 62 65 68 61 76 69 6f 72 20 66 72 6f 6d 20  s behavior from 
19c0: 43 20 63 6f 64 65 20 75 73 69 6e 67 20 74 68 65  C code using the
19d0: 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 62 75 73   .  [sqlite3_bus
19e0: 79 5f 68 61 6e 64 6c 65 72 28 29 5d 20 6f 72 20  y_handler()] or 
19f0: 5b 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 74 69  [sqlite3_busy_ti
1a00: 6d 65 6f 75 74 28 29 5d 0a 20 20 41 50 49 20 66  meout()].  API f
1a10: 75 6e 63 74 69 6f 6e 73 2e 3c 2f 70 3e 0a 7d 0a  unctions.</p>.}.
1a20: 0a 66 61 71 20 7b 0a 20 20 49 73 20 53 51 4c 69  .faq {.  Is SQLi
1a30: 74 65 20 74 68 72 65 61 64 73 61 66 65 3f 0a 7d  te threadsafe?.}
1a40: 20 7b 0a 20 20 3c 70 3e 5b 68 74 74 70 3a 2f 2f   {.  <p>[http://
1a50: 77 77 77 2e 65 65 63 73 2e 62 65 72 6b 65 6c 65  www.eecs.berkele
1a60: 79 2e 65 64 75 2f 50 75 62 73 2f 54 65 63 68 52  y.edu/Pubs/TechR
1a70: 70 74 73 2f 32 30 30 36 2f 45 45 43 53 2d 32 30  pts/2006/EECS-20
1a80: 30 36 2d 31 2e 70 64 66 20 7c 20 54 68 72 65 61  06-1.pdf | Threa
1a90: 64 73 20 61 72 65 20 65 76 69 6c 5d 2e 0a 20 20  ds are evil]..  
1aa0: 41 76 6f 69 64 20 74 68 65 6d 2e 0a 0a 20 20 3c  Avoid them...  <
1ab0: 70 3e 53 51 4c 69 74 65 20 69 73 20 74 68 72 65  p>SQLite is thre
1ac0: 61 64 73 61 66 65 2e 20 20 57 65 20 6d 61 6b 65  adsafe.  We make
1ad0: 20 74 68 69 73 20 63 6f 6e 63 65 73 73 69 6f 6e   this concession
1ae0: 20 73 69 6e 63 65 20 6d 61 6e 79 20 75 73 65 72   since many user
1af0: 73 20 63 68 6f 6f 73 65 0a 20 20 74 6f 20 69 67  s choose.  to ig
1b00: 6e 6f 72 65 20 74 68 65 20 61 64 76 69 63 65 20  nore the advice 
1b10: 67 69 76 65 6e 20 69 6e 20 74 68 65 20 70 72 65  given in the pre
1b20: 76 69 6f 75 73 20 70 61 72 61 67 72 61 70 68 2e  vious paragraph.
1b30: 0a 20 20 42 75 74 20 69 6e 20 6f 72 64 65 72 20  .  But in order 
1b40: 74 6f 20 62 65 20 74 68 72 65 61 64 2d 73 61 66  to be thread-saf
1b50: 65 2c 20 53 51 4c 69 74 65 20 6d 75 73 74 20 62  e, SQLite must b
1b60: 65 20 63 6f 6d 70 69 6c 65 64 0a 20 20 77 69 74  e compiled.  wit
1b70: 68 20 74 68 65 20 53 51 4c 49 54 45 5f 54 48 52  h the SQLITE_THR
1b80: 45 41 44 53 41 46 45 20 70 72 65 70 72 6f 63 65  EADSAFE preproce
1b90: 73 73 6f 72 20 6d 61 63 72 6f 20 73 65 74 20 74  ssor macro set t
1ba0: 6f 20 31 2e 20 20 42 6f 74 68 20 74 68 65 20 57  o 1.  Both the W
1bb0: 69 6e 64 6f 77 73 0a 20 20 61 6e 64 20 4c 69 6e  indows.  and Lin
1bc0: 75 78 20 70 72 65 63 6f 6d 70 69 6c 65 64 20 62  ux precompiled b
1bd0: 69 6e 61 72 69 65 73 20 69 6e 20 74 68 65 20 64  inaries in the d
1be0: 69 73 74 72 69 62 75 74 69 6f 6e 20 61 72 65 20  istribution are 
1bf0: 63 6f 6d 70 69 6c 65 64 20 74 68 69 73 20 77 61  compiled this wa
1c00: 79 2e 0a 20 20 49 66 20 79 6f 75 20 61 72 65 20  y..  If you are 
1c10: 75 6e 73 75 72 65 20 69 66 20 74 68 65 20 53 51  unsure if the SQ
1c20: 4c 69 74 65 20 6c 69 62 72 61 72 79 20 79 6f 75  Lite library you
1c30: 20 61 72 65 20 6c 69 6e 6b 69 6e 67 20 61 67 61   are linking aga
1c40: 69 6e 73 74 20 69 73 20 63 6f 6d 70 69 6c 65 64  inst is compiled
1c50: 0a 20 20 74 6f 20 62 65 20 74 68 72 65 61 64 73  .  to be threads
1c60: 61 66 65 20 79 6f 75 20 63 61 6e 20 63 61 6c 6c  afe you can call
1c70: 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 74 68   the [sqlite3_th
1c80: 72 65 61 64 73 61 66 65 28 29 5d 0a 20 20 69 6e  readsafe()].  in
1c90: 74 65 72 66 61 63 65 20 74 6f 20 66 69 6e 64 20  terface to find 
1ca0: 6f 75 74 2e 0a 20 20 3c 2f 70 3e 0a 0a 20 20 3c  out..  </p>..  <
1cb0: 70 3e 53 51 4c 69 74 65 20 69 73 20 74 68 72 65  p>SQLite is thre
1cc0: 61 64 73 61 66 65 20 62 65 63 61 75 73 65 20 69  adsafe because i
1cd0: 74 20 75 73 65 73 20 6d 75 74 65 78 65 73 20 74  t uses mutexes t
1ce0: 6f 20 73 65 72 69 61 6c 69 7a 65 0a 20 20 61 63  o serialize.  ac
1cf0: 63 65 73 73 20 74 6f 20 63 6f 6d 6d 6f 6e 20 64  cess to common d
1d00: 61 74 61 20 73 74 72 75 63 74 75 72 65 73 2e 20  ata structures. 
1d10: 20 48 6f 77 65 76 65 72 2c 20 74 68 65 20 77 6f   However, the wo
1d20: 72 6b 20 6f 66 20 61 63 71 75 69 72 69 6e 67 20  rk of acquiring 
1d30: 61 6e 64 0a 20 20 72 65 6c 65 61 73 69 6e 67 20  and.  releasing 
1d40: 74 68 65 73 65 20 6d 75 74 65 78 65 73 20 77 69  these mutexes wi
1d50: 6c 6c 20 73 6c 6f 77 20 53 51 4c 69 74 65 20 64  ll slow SQLite d
1d60: 6f 77 6e 20 73 6c 69 67 68 74 6c 79 2e 20 20 48  own slightly.  H
1d70: 65 6e 63 65 2c 20 69 66 20 79 6f 75 0a 20 20 64  ence, if you.  d
1d80: 6f 20 6e 6f 74 20 6e 65 65 64 20 53 51 4c 69 74  o not need SQLit
1d90: 65 20 74 6f 20 62 65 20 74 68 72 65 61 64 73 61  e to be threadsa
1da0: 66 65 2c 20 79 6f 75 20 73 68 6f 75 6c 64 20 64  fe, you should d
1db0: 69 73 61 62 6c 65 20 74 68 65 20 6d 75 74 65 78  isable the mutex
1dc0: 65 73 0a 20 20 66 6f 72 20 6d 61 78 69 6d 75 6d  es.  for maximum
1dd0: 20 70 65 72 66 6f 72 6d 61 6e 63 65 2e 20 20 53   performance.  S
1de0: 65 65 20 74 68 65 20 5b 74 68 72 65 61 64 69 6e  ee the [threadin
1df0: 67 20 6d 6f 64 65 5d 20 64 6f 63 75 6d 65 6e 74  g mode] document
1e00: 61 74 69 6f 6e 20 66 6f 72 0a 20 20 61 64 64 69  ation for.  addi
1e10: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
1e20: 6f 6e 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 55 6e  on.</p>..  <p>Un
1e30: 64 65 72 20 55 6e 69 78 2c 20 79 6f 75 20 73 68  der Unix, you sh
1e40: 6f 75 6c 64 20 6e 6f 74 20 63 61 72 72 79 20 61  ould not carry a
1e50: 6e 20 6f 70 65 6e 20 53 51 4c 69 74 65 20 64 61  n open SQLite da
1e60: 74 61 62 61 73 65 20 61 63 72 6f 73 73 0a 20 20  tabase across.  
1e70: 61 20 66 6f 72 6b 28 29 20 73 79 73 74 65 6d 20  a fork() system 
1e80: 63 61 6c 6c 20 69 6e 74 6f 20 74 68 65 20 63 68  call into the ch
1e90: 69 6c 64 20 70 72 6f 63 65 73 73 2e 3c 2f 70 3e  ild process.</p>
1ea0: 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 48 6f 77 20  .}..faq {.  How 
1eb0: 64 6f 20 49 20 6c 69 73 74 20 61 6c 6c 20 74 61  do I list all ta
1ec0: 62 6c 65 73 2f 69 6e 64 69 63 65 73 20 63 6f 6e  bles/indices con
1ed0: 74 61 69 6e 65 64 20 69 6e 20 61 6e 20 53 51 4c  tained in an SQL
1ee0: 69 74 65 20 64 61 74 61 62 61 73 65 0a 7d 20 7b  ite database.} {
1ef0: 0a 20 20 3c 70 3e 49 66 20 79 6f 75 20 61 72 65  .  <p>If you are
1f00: 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 3c 62 3e   running the <b>
1f10: 73 71 6c 69 74 65 33 3c 2f 62 3e 20 63 6f 6d 6d  sqlite3</b> comm
1f20: 61 6e 64 2d 6c 69 6e 65 20 61 63 63 65 73 73 20  and-line access 
1f30: 70 72 6f 67 72 61 6d 0a 20 20 79 6f 75 20 63 61  program.  you ca
1f40: 6e 20 74 79 70 65 20 22 3c 62 3e 2e 74 61 62 6c  n type "<b>.tabl
1f50: 65 73 3c 2f 62 3e 22 20 74 6f 20 67 65 74 20 61  es</b>" to get a
1f60: 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 74 61 62   list of all tab
1f70: 6c 65 73 2e 20 20 4f 72 20 79 6f 75 0a 20 20 63  les.  Or you.  c
1f80: 61 6e 20 74 79 70 65 20 22 3c 62 3e 2e 73 63 68  an type "<b>.sch
1f90: 65 6d 61 3c 2f 62 3e 22 20 74 6f 20 73 65 65 20  ema</b>" to see 
1fa0: 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 64 61 74  the complete dat
1fb0: 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 6e 63  abase schema inc
1fc0: 6c 75 64 69 6e 67 0a 20 20 61 6c 6c 20 74 61 62  luding.  all tab
1fd0: 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 73 2e  les and indices.
1fe0: 20 20 45 69 74 68 65 72 20 6f 66 20 74 68 65 73    Either of thes
1ff0: 65 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62  e commands can b
2000: 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 0a 20 20  e followed by.  
2010: 61 20 4c 49 4b 45 20 70 61 74 74 65 72 6e 20 74  a LIKE pattern t
2020: 68 61 74 20 77 69 6c 6c 20 72 65 73 74 72 69 63  hat will restric
2030: 74 20 74 68 65 20 74 61 62 6c 65 73 20 74 68 61  t the tables tha
2040: 74 20 61 72 65 20 64 69 73 70 6c 61 79 65 64 2e  t are displayed.
2050: 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 46 72 6f 6d 20  </p>..  <p>From 
2060: 77 69 74 68 69 6e 20 61 20 43 2f 43 2b 2b 20 70  within a C/C++ p
2070: 72 6f 67 72 61 6d 20 28 6f 72 20 61 20 73 63 72  rogram (or a scr
2080: 69 70 74 20 75 73 69 6e 67 20 54 63 6c 2f 52 75  ipt using Tcl/Ru
2090: 62 79 2f 50 65 72 6c 2f 50 79 74 68 6f 6e 0a 20  by/Perl/Python. 
20a0: 20 62 69 6e 64 69 6e 67 73 29 20 79 6f 75 20 63   bindings) you c
20b0: 61 6e 20 67 65 74 20 61 63 63 65 73 73 20 74 6f  an get access to
20c0: 20 74 61 62 6c 65 20 61 6e 64 20 69 6e 64 65 78   table and index
20d0: 20 6e 61 6d 65 73 20 62 79 20 64 6f 69 6e 67 20   names by doing 
20e0: 61 20 53 45 4c 45 43 54 0a 20 20 6f 6e 20 61 20  a SELECT.  on a 
20f0: 73 70 65 63 69 61 6c 20 74 61 62 6c 65 20 6e 61  special table na
2100: 6d 65 64 20 22 3c 62 3e 53 51 4c 49 54 45 5f 4d  med "<b>SQLITE_M
2110: 41 53 54 45 52 3c 2f 62 3e 22 2e 20 20 45 76 65  ASTER</b>".  Eve
2120: 72 79 20 53 51 4c 69 74 65 20 64 61 74 61 62 61  ry SQLite databa
2130: 73 65 0a 20 20 68 61 73 20 61 6e 20 53 51 4c 49  se.  has an SQLI
2140: 54 45 5f 4d 41 53 54 45 52 20 74 61 62 6c 65 20  TE_MASTER table 
2150: 74 68 61 74 20 64 65 66 69 6e 65 73 20 74 68 65  that defines the
2160: 20 73 63 68 65 6d 61 20 66 6f 72 20 74 68 65 20   schema for the 
2170: 64 61 74 61 62 61 73 65 2e 0a 20 20 54 68 65 20  database..  The 
2180: 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74 61  SQLITE_MASTER ta
2190: 62 6c 65 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74  ble looks like t
21a0: 68 69 73 3a 3c 2f 70 3e 0a 3c 62 6c 6f 63 6b 71  his:</p>.<blockq
21b0: 75 6f 74 65 3e 3c 70 72 65 3e 0a 43 52 45 41 54  uote><pre>.CREAT
21c0: 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d  E TABLE sqlite_m
21d0: 61 73 74 65 72 20 28 0a 20 20 74 79 70 65 20 54  aster (.  type T
21e0: 45 58 54 2c 0a 20 20 6e 61 6d 65 20 54 45 58 54  EXT,.  name TEXT
21f0: 2c 0a 20 20 74 62 6c 5f 6e 61 6d 65 20 54 45 58  ,.  tbl_name TEX
2200: 54 2c 0a 20 20 72 6f 6f 74 70 61 67 65 20 49 4e  T,.  rootpage IN
2210: 54 45 47 45 52 2c 0a 20 20 73 71 6c 20 54 45 58  TEGER,.  sql TEX
2220: 54 0a 29 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  T.);.</pre></blo
2230: 63 6b 71 75 6f 74 65 3e 0a 20 20 3c 70 3e 46 6f  ckquote>.  <p>Fo
2240: 72 20 74 61 62 6c 65 73 2c 20 74 68 65 20 3c 62  r tables, the <b
2250: 3e 74 79 70 65 3c 2f 62 3e 20 66 69 65 6c 64 20  >type</b> field 
2260: 77 69 6c 6c 20 61 6c 77 61 79 73 20 62 65 20 3c  will always be <
2270: 62 3e 27 74 61 62 6c 65 27 3c 2f 62 3e 20 61 6e  b>'table'</b> an
2280: 64 20 74 68 65 0a 20 20 3c 62 3e 6e 61 6d 65 3c  d the.  <b>name<
2290: 2f 62 3e 20 66 69 65 6c 64 20 77 69 6c 6c 20 62  /b> field will b
22a0: 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  e the name of th
22b0: 65 20 74 61 62 6c 65 2e 20 20 53 6f 20 74 6f 20  e table.  So to 
22c0: 67 65 74 20 61 20 6c 69 73 74 20 6f 66 0a 20 20  get a list of.  
22d0: 61 6c 6c 20 74 61 62 6c 65 73 20 69 6e 20 74 68  all tables in th
22e0: 65 20 64 61 74 61 62 61 73 65 2c 20 75 73 65 20  e database, use 
22f0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 53 45  the following SE
2300: 4c 45 43 54 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70  LECT command:</p
2310: 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70  >.<blockquote><p
2320: 72 65 3e 0a 53 45 4c 45 43 54 20 6e 61 6d 65 20  re>.SELECT name 
2330: 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74  FROM sqlite_mast
2340: 65 72 0a 57 48 45 52 45 20 74 79 70 65 3d 27 74  er.WHERE type='t
2350: 61 62 6c 65 27 0a 4f 52 44 45 52 20 42 59 20 6e  able'.ORDER BY n
2360: 61 6d 65 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  ame;.</pre></blo
2370: 63 6b 71 75 6f 74 65 3e 0a 20 20 3c 70 3e 46 6f  ckquote>.  <p>Fo
2380: 72 20 69 6e 64 69 63 65 73 2c 20 3c 62 3e 74 79  r indices, <b>ty
2390: 70 65 3c 2f 62 3e 20 69 73 20 65 71 75 61 6c 20  pe</b> is equal 
23a0: 74 6f 20 3c 62 3e 27 69 6e 64 65 78 27 3c 2f 62  to <b>'index'</b
23b0: 3e 2c 20 3c 62 3e 6e 61 6d 65 3c 2f 62 3e 20 69  >, <b>name</b> i
23c0: 73 20 74 68 65 0a 20 20 6e 61 6d 65 20 6f 66 20  s the.  name of 
23d0: 74 68 65 20 69 6e 64 65 78 20 61 6e 64 20 3c 62  the index and <b
23e0: 3e 74 62 6c 5f 6e 61 6d 65 3c 2f 62 3e 20 69 73  >tbl_name</b> is
23f0: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65   the name of the
2400: 20 74 61 62 6c 65 20 74 6f 20 77 68 69 63 68 0a   table to which.
2410: 20 20 74 68 65 20 69 6e 64 65 78 20 62 65 6c 6f    the index belo
2420: 6e 67 73 2e 20 20 46 6f 72 20 62 6f 74 68 20 74  ngs.  For both t
2430: 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65  ables and indice
2440: 73 2c 20 74 68 65 20 3c 62 3e 73 71 6c 3c 2f 62  s, the <b>sql</b
2450: 3e 20 66 69 65 6c 64 20 69 73 0a 20 20 74 68 65  > field is.  the
2460: 20 74 65 78 74 20 6f 66 20 74 68 65 20 6f 72 69   text of the ori
2470: 67 69 6e 61 6c 20 43 52 45 41 54 45 20 54 41 42  ginal CREATE TAB
2480: 4c 45 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44  LE or CREATE IND
2490: 45 58 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61  EX statement tha
24a0: 74 0a 20 20 63 72 65 61 74 65 64 20 74 68 65 20  t.  created the 
24b0: 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20  table or index. 
24c0: 20 46 6f 72 20 61 75 74 6f 6d 61 74 69 63 61 6c   For automatical
24d0: 6c 79 20 63 72 65 61 74 65 64 20 69 6e 64 69 63  ly created indic
24e0: 65 73 20 28 75 73 65 64 0a 20 20 74 6f 20 69 6d  es (used.  to im
24f0: 70 6c 65 6d 65 6e 74 20 74 68 65 20 50 52 49 4d  plement the PRIM
2500: 41 52 59 20 4b 45 59 20 6f 72 20 55 4e 49 51 55  ARY KEY or UNIQU
2510: 45 20 63 6f 6e 73 74 72 61 69 6e 74 73 29 20 74  E constraints) t
2520: 68 65 20 3c 62 3e 73 71 6c 3c 2f 62 3e 20 66 69  he <b>sql</b> fi
2530: 65 6c 64 0a 20 20 69 73 20 4e 55 4c 4c 2e 3c 2f  eld.  is NULL.</
2540: 70 3e 0a 0a 20 20 3c 70 3e 54 68 65 20 53 51 4c  p>..  <p>The SQL
2550: 49 54 45 5f 4d 41 53 54 45 52 20 74 61 62 6c 65  ITE_MASTER table
2560: 20 69 73 20 72 65 61 64 2d 6f 6e 6c 79 2e 20 20   is read-only.  
2570: 59 6f 75 20 63 61 6e 6e 6f 74 20 63 68 61 6e 67  You cannot chang
2580: 65 20 74 68 69 73 20 74 61 62 6c 65 0a 20 20 75  e this table.  u
2590: 73 69 6e 67 20 55 50 44 41 54 45 2c 20 49 4e 53  sing UPDATE, INS
25a0: 45 52 54 2c 20 6f 72 20 44 45 4c 45 54 45 2e 20  ERT, or DELETE. 
25b0: 20 54 68 65 20 74 61 62 6c 65 20 69 73 20 61 75   The table is au
25c0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 70 64 61  tomatically upda
25d0: 74 65 64 20 62 79 0a 20 20 43 52 45 41 54 45 20  ted by.  CREATE 
25e0: 54 41 42 4c 45 2c 20 43 52 45 41 54 45 20 49 4e  TABLE, CREATE IN
25f0: 44 45 58 2c 20 44 52 4f 50 20 54 41 42 4c 45 2c  DEX, DROP TABLE,
2600: 20 61 6e 64 20 44 52 4f 50 20 49 4e 44 45 58 20   and DROP INDEX 
2610: 63 6f 6d 6d 61 6e 64 73 2e 3c 2f 70 3e 0a 0a 20  commands.</p>.. 
2620: 20 3c 70 3e 54 65 6d 70 6f 72 61 72 79 20 74 61   <p>Temporary ta
2630: 62 6c 65 73 20 64 6f 20 6e 6f 74 20 61 70 70 65  bles do not appe
2640: 61 72 20 69 6e 20 74 68 65 20 53 51 4c 49 54 45  ar in the SQLITE
2650: 5f 4d 41 53 54 45 52 20 74 61 62 6c 65 2e 20 20  _MASTER table.  
2660: 54 65 6d 70 6f 72 61 72 79 0a 20 20 74 61 62 6c  Temporary.  tabl
2670: 65 73 20 61 6e 64 20 74 68 65 69 72 20 69 6e 64  es and their ind
2680: 69 63 65 73 20 61 6e 64 20 74 72 69 67 67 65 72  ices and trigger
2690: 73 20 6f 63 63 75 72 20 69 6e 20 61 6e 6f 74 68  s occur in anoth
26a0: 65 72 20 73 70 65 63 69 61 6c 20 74 61 62 6c 65  er special table
26b0: 0a 20 20 6e 61 6d 65 64 20 53 51 4c 49 54 45 5f  .  named SQLITE_
26c0: 54 45 4d 50 5f 4d 41 53 54 45 52 2e 20 20 53 51  TEMP_MASTER.  SQ
26d0: 4c 49 54 45 5f 54 45 4d 50 5f 4d 41 53 54 45 52  LITE_TEMP_MASTER
26e0: 20 77 6f 72 6b 73 20 6a 75 73 74 20 6c 69 6b 65   works just like
26f0: 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 0a 20   SQLITE_MASTER. 
2700: 20 65 78 63 65 70 74 20 74 68 61 74 20 69 74 20   except that it 
2710: 69 73 20 6f 6e 6c 79 20 76 69 73 69 62 6c 65 20  is only visible 
2720: 74 6f 20 74 68 65 20 61 70 70 6c 69 63 61 74 69  to the applicati
2730: 6f 6e 20 74 68 61 74 20 63 72 65 61 74 65 64 20  on that created 
2740: 74 68 65 20 0a 20 20 74 65 6d 70 6f 72 61 72 79  the .  temporary
2750: 20 74 61 62 6c 65 73 2e 20 20 54 6f 20 67 65 74   tables.  To get
2760: 20 61 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 74   a list of all t
2770: 61 62 6c 65 73 2c 20 62 6f 74 68 20 70 65 72 6d  ables, both perm
2780: 61 6e 65 6e 74 20 61 6e 64 0a 20 20 74 65 6d 70  anent and.  temp
2790: 6f 72 61 72 79 2c 20 6f 6e 65 20 63 61 6e 20 75  orary, one can u
27a0: 73 65 20 61 20 63 6f 6d 6d 61 6e 64 20 73 69 6d  se a command sim
27b0: 69 6c 61 72 20 74 6f 20 74 68 65 20 66 6f 6c 6c  ilar to the foll
27c0: 6f 77 69 6e 67 3a 0a 3c 62 6c 6f 63 6b 71 75 6f  owing:.<blockquo
27d0: 74 65 3e 3c 70 72 65 3e 0a 53 45 4c 45 43 54 20  te><pre>.SELECT 
27e0: 6e 61 6d 65 20 46 52 4f 4d 20 0a 20 20 20 28 53  name FROM .   (S
27f0: 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 73 71 6c  ELECT * FROM sql
2800: 69 74 65 5f 6d 61 73 74 65 72 20 55 4e 49 4f 4e  ite_master UNION
2810: 20 41 4c 4c 0a 20 20 20 20 53 45 4c 45 43 54 20   ALL.    SELECT 
2820: 2a 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 74 65  * FROM sqlite_te
2830: 6d 70 5f 6d 61 73 74 65 72 29 0a 57 48 45 52 45  mp_master).WHERE
2840: 20 74 79 70 65 3d 27 74 61 62 6c 65 27 0a 4f 52   type='table'.OR
2850: 44 45 52 20 42 59 20 6e 61 6d 65 0a 3c 2f 70 72  DER BY name.</pr
2860: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
2870: 7d 0a 0a 66 61 71 20 7b 0a 20 20 41 72 65 20 74  }..faq {.  Are t
2880: 68 65 72 65 20 61 6e 79 20 6b 6e 6f 77 6e 20 73  here any known s
2890: 69 7a 65 20 6c 69 6d 69 74 73 20 74 6f 20 53 51  ize limits to SQ
28a0: 4c 69 74 65 20 64 61 74 61 62 61 73 65 73 3f 0a  Lite databases?.
28b0: 7d 20 7b 0a 20 20 3c 70 3e 53 65 65 20 3c 61 20  } {.  <p>See <a 
28c0: 68 72 65 66 3d 22 6c 69 6d 69 74 73 2e 68 74 6d  href="limits.htm
28d0: 6c 22 3e 6c 69 6d 69 74 73 2e 68 74 6d 6c 3c 2f  l">limits.html</
28e0: 61 3e 20 66 6f 72 20 61 20 66 75 6c 6c 20 64 69  a> for a full di
28f0: 73 63 75 73 73 69 6f 6e 20 6f 66 0a 20 20 74 68  scussion of.  th
2900: 65 20 6c 69 6d 69 74 73 20 6f 66 20 53 51 4c 69  e limits of SQLi
2910: 74 65 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b  te.</p>.}..faq {
2920: 0a 20 20 57 68 61 74 20 69 73 20 74 68 65 20 6d  .  What is the m
2930: 61 78 69 6d 75 6d 20 73 69 7a 65 20 6f 66 20 61  aximum size of a
2940: 20 56 41 52 43 48 41 52 20 69 6e 20 53 51 4c 69   VARCHAR in SQLi
2950: 74 65 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 53 51 4c  te?.} {.  <p>SQL
2960: 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 65 6e 66  ite does not enf
2970: 6f 72 63 65 20 74 68 65 20 6c 65 6e 67 74 68 20  orce the length 
2980: 6f 66 20 61 20 56 41 52 43 48 41 52 2e 20 20 59  of a VARCHAR.  Y
2990: 6f 75 20 63 61 6e 20 64 65 63 6c 61 72 65 0a 20  ou can declare. 
29a0: 20 61 20 56 41 52 43 48 41 52 28 31 30 29 20 61   a VARCHAR(10) a
29b0: 6e 64 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 62  nd SQLite will b
29c0: 65 20 68 61 70 70 79 20 74 6f 20 73 74 6f 72 65  e happy to store
29d0: 20 61 20 35 30 30 2d 6d 69 6c 6c 69 6f 6e 20 63   a 500-million c
29e0: 68 61 72 61 63 74 65 72 0a 20 20 73 74 72 69 6e  haracter.  strin
29f0: 67 20 74 68 65 72 65 2e 20 20 41 6e 64 20 69 74  g there.  And it
2a00: 20 77 69 6c 6c 20 6b 65 65 70 20 61 6c 6c 20 35   will keep all 5
2a10: 30 30 2d 6d 69 6c 6c 69 6f 6e 20 63 68 61 72 61  00-million chara
2a20: 63 74 65 72 73 20 69 6e 74 61 63 74 2e 0a 20 20  cters intact..  
2a30: 59 6f 75 72 20 63 6f 6e 74 65 6e 74 20 69 73 20  Your content is 
2a40: 6e 65 76 65 72 20 74 72 75 6e 63 61 74 65 64 2e  never truncated.
2a50: 20 20 53 51 4c 69 74 65 20 75 6e 64 65 72 73 74    SQLite underst
2a60: 61 6e 64 73 20 74 68 65 20 63 6f 6c 75 6d 6e 20  ands the column 
2a70: 74 79 70 65 0a 20 20 6f 66 20 22 56 41 52 43 48  type.  of "VARCH
2a80: 41 52 28 3c 69 3e 4e 3c 2f 69 3e 29 22 20 74 6f  AR(<i>N</i>)" to
2a90: 20 62 65 20 74 68 65 20 73 61 6d 65 20 61 73 20   be the same as 
2aa0: 22 54 45 58 54 22 2c 20 72 65 67 61 72 64 6c 65  "TEXT", regardle
2ab0: 73 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 0a  ss of the value.
2ac0: 20 20 6f 66 20 3c 69 3e 4e 3c 2f 69 3e 2e 0a 20    of <i>N</i>.. 
2ad0: 20 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20   </p>.}..faq {. 
2ae0: 20 44 6f 65 73 20 53 51 4c 69 74 65 20 73 75 70   Does SQLite sup
2af0: 70 6f 72 74 20 61 20 42 4c 4f 42 20 74 79 70 65  port a BLOB type
2b00: 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 53 51 4c 69 74  ?.} {.  <p>SQLit
2b10: 65 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20  e allows you to 
2b20: 73 74 6f 72 65 20 42 4c 4f 42 20 64 61 74 61 20  store BLOB data 
2b30: 69 6e 20 61 6e 79 20 0a 20 20 63 6f 6c 75 6d 6e  in any .  column
2b40: 2c 20 65 76 65 6e 20 63 6f 6c 75 6d 6e 73 20 74  , even columns t
2b50: 68 61 74 20 61 72 65 20 64 65 63 6c 61 72 65 64  hat are declared
2b60: 20 74 6f 20 68 6f 6c 64 20 73 6f 6d 65 20 6f 74   to hold some ot
2b70: 68 65 72 20 74 79 70 65 2e 0a 20 20 42 4c 4f 42  her type..  BLOB
2b80: 73 20 63 61 6e 20 65 76 65 6e 20 62 65 20 75 73  s can even be us
2b90: 65 64 20 61 73 20 50 52 49 4d 41 52 59 20 4b 45  ed as PRIMARY KE
2ba0: 59 73 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b  Ys.</p>.}..faq {
2bb0: 0a 20 20 48 6f 77 20 64 6f 20 49 20 61 64 64 20  .  How do I add 
2bc0: 6f 72 20 64 65 6c 65 74 65 20 63 6f 6c 75 6d 6e  or delete column
2bd0: 73 20 66 72 6f 6d 20 61 6e 20 65 78 69 73 74 69  s from an existi
2be0: 6e 67 20 74 61 62 6c 65 20 69 6e 20 53 51 4c 69  ng table in SQLi
2bf0: 74 65 2e 0a 7d 20 7b 0a 20 20 3c 70 3e 53 51 4c  te..} {.  <p>SQL
2c00: 69 74 65 20 68 61 73 20 6c 69 6d 69 74 65 64 20  ite has limited 
2c10: 0a 20 20 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67  .  <a href="lang
2c20: 5f 61 6c 74 65 72 74 61 62 6c 65 2e 68 74 6d 6c  _altertable.html
2c30: 22 3e 41 4c 54 45 52 20 54 41 42 4c 45 3c 2f 61  ">ALTER TABLE</a
2c40: 3e 20 73 75 70 70 6f 72 74 20 74 68 61 74 20 79  > support that y
2c50: 6f 75 20 63 61 6e 0a 20 20 75 73 65 20 74 6f 20  ou can.  use to 
2c60: 61 64 64 20 61 20 63 6f 6c 75 6d 6e 20 74 6f 20  add a column to 
2c70: 74 68 65 20 65 6e 64 20 6f 66 20 61 20 74 61 62  the end of a tab
2c80: 6c 65 20 6f 72 20 74 6f 20 63 68 61 6e 67 65 20  le or to change 
2c90: 74 68 65 20 6e 61 6d 65 20 6f 66 0a 20 20 61 20  the name of.  a 
2ca0: 74 61 62 6c 65 2e 20 20 0a 20 20 49 66 20 79 6f  table.  .  If yo
2cb0: 75 20 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 6d  u want to make m
2cc0: 6f 72 65 20 63 6f 6d 70 6c 65 78 20 63 68 61 6e  ore complex chan
2cd0: 67 65 73 20 69 6e 20 74 68 65 20 73 74 72 75 63  ges in the struc
2ce0: 74 75 72 65 20 6f 66 20 61 20 74 61 62 6c 65 2c  ture of a table,
2cf0: 0a 20 20 79 6f 75 20 77 69 6c 6c 20 68 61 76 65  .  you will have
2d00: 20 74 6f 20 72 65 63 72 65 61 74 65 20 74 68 65   to recreate the
2d10: 0a 20 20 74 61 62 6c 65 2e 20 20 59 6f 75 20 63  .  table.  You c
2d20: 61 6e 20 73 61 76 65 20 65 78 69 73 74 69 6e 67  an save existing
2d30: 20 64 61 74 61 20 74 6f 20 61 20 74 65 6d 70 6f   data to a tempo
2d40: 72 61 72 79 20 74 61 62 6c 65 2c 20 64 72 6f 70  rary table, drop
2d50: 20 74 68 65 0a 20 20 6f 6c 64 20 74 61 62 6c 65   the.  old table
2d60: 2c 20 63 72 65 61 74 65 20 74 68 65 20 6e 65 77  , create the new
2d70: 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 63 6f 70   table, then cop
2d80: 79 20 74 68 65 20 64 61 74 61 20 62 61 63 6b 20  y the data back 
2d90: 69 6e 20 66 72 6f 6d 0a 20 20 74 68 65 20 74 65  in from.  the te
2da0: 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 2e 3c 2f  mporary table.</
2db0: 70 3e 0a 0a 20 20 3c 70 3e 46 6f 72 20 65 78 61  p>..  <p>For exa
2dc0: 6d 70 6c 65 2c 20 73 75 70 70 6f 73 65 20 79 6f  mple, suppose yo
2dd0: 75 20 68 61 76 65 20 61 20 74 61 62 6c 65 20 6e  u have a table n
2de0: 61 6d 65 64 20 22 74 31 22 20 77 69 74 68 20 63  amed "t1" with c
2df0: 6f 6c 75 6d 6e 73 0a 20 20 6e 61 6d 65 73 20 22  olumns.  names "
2e00: 61 22 2c 20 22 62 22 2c 20 61 6e 64 20 22 63 22  a", "b", and "c"
2e10: 20 61 6e 64 20 74 68 61 74 20 79 6f 75 20 77 61   and that you wa
2e20: 6e 74 20 74 6f 20 64 65 6c 65 74 65 20 63 6f 6c  nt to delete col
2e30: 75 6d 6e 20 22 63 22 20 66 72 6f 6d 0a 20 20 74  umn "c" from.  t
2e40: 68 69 73 20 74 61 62 6c 65 2e 20 20 54 68 65 20  his table.  The 
2e50: 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 65 70 73 20  following steps 
2e60: 69 6c 6c 75 73 74 72 61 74 65 20 68 6f 77 20 74  illustrate how t
2e70: 68 69 73 20 63 6f 75 6c 64 20 62 65 20 64 6f 6e  his could be don
2e80: 65 3a 0a 20 20 3c 2f 70 3e 0a 0a 20 20 3c 62 6c  e:.  </p>..  <bl
2e90: 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 42  ockquote><pre>.B
2ea0: 45 47 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e  EGIN TRANSACTION
2eb0: 3b 0a 43 52 45 41 54 45 20 54 45 4d 50 4f 52 41  ;.CREATE TEMPORA
2ec0: 52 59 20 54 41 42 4c 45 20 74 31 5f 62 61 63 6b  RY TABLE t1_back
2ed0: 75 70 28 61 2c 62 29 3b 0a 49 4e 53 45 52 54 20  up(a,b);.INSERT 
2ee0: 49 4e 54 4f 20 74 31 5f 62 61 63 6b 75 70 20 53  INTO t1_backup S
2ef0: 45 4c 45 43 54 20 61 2c 62 20 46 52 4f 4d 20 74  ELECT a,b FROM t
2f00: 31 3b 0a 44 52 4f 50 20 54 41 42 4c 45 20 74 31  1;.DROP TABLE t1
2f10: 3b 0a 43 52 45 41 54 45 20 54 41 42 4c 45 20 74  ;.CREATE TABLE t
2f20: 31 28 61 2c 62 29 3b 0a 49 4e 53 45 52 54 20 49  1(a,b);.INSERT I
2f30: 4e 54 4f 20 74 31 20 53 45 4c 45 43 54 20 61 2c  NTO t1 SELECT a,
2f40: 62 20 46 52 4f 4d 20 74 31 5f 62 61 63 6b 75 70  b FROM t1_backup
2f50: 3b 0a 44 52 4f 50 20 54 41 42 4c 45 20 74 31 5f  ;.DROP TABLE t1_
2f60: 62 61 63 6b 75 70 3b 0a 43 4f 4d 4d 49 54 3b 0a  backup;.COMMIT;.
2f70: 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f  </pre></blockquo
2f80: 74 65 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 49  te>.}..faq {.  I
2f90: 20 64 65 6c 65 74 65 64 20 61 20 6c 6f 74 20 6f   deleted a lot o
2fa0: 66 20 64 61 74 61 20 62 75 74 20 74 68 65 20 64  f data but the d
2fb0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 64 69 64  atabase file did
2fc0: 20 6e 6f 74 20 67 65 74 20 61 6e 79 0a 20 20 73   not get any.  s
2fd0: 6d 61 6c 6c 65 72 2e 20 20 49 73 20 74 68 69 73  maller.  Is this
2fe0: 20 61 20 62 75 67 3f 0a 7d 20 7b 0a 20 20 3c 70   a bug?.} {.  <p
2ff0: 3e 4e 6f 2e 20 20 57 68 65 6e 20 79 6f 75 20 64  >No.  When you d
3000: 65 6c 65 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f  elete informatio
3010: 6e 20 66 72 6f 6d 20 61 6e 20 53 51 4c 69 74 65  n from an SQLite
3020: 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 0a 20   database, the. 
3030: 20 75 6e 75 73 65 64 20 64 69 73 6b 20 73 70 61   unused disk spa
3040: 63 65 20 69 73 20 61 64 64 65 64 20 74 6f 20 61  ce is added to a
3050: 6e 20 69 6e 74 65 72 6e 61 6c 20 22 66 72 65 65  n internal "free
3060: 2d 6c 69 73 74 22 20 61 6e 64 20 69 73 20 72 65  -list" and is re
3070: 75 73 65 64 0a 20 20 74 68 65 20 6e 65 78 74 20  used.  the next 
3080: 74 69 6d 65 20 79 6f 75 20 69 6e 73 65 72 74 20  time you insert 
3090: 64 61 74 61 2e 20 20 54 68 65 20 64 69 73 6b 20  data.  The disk 
30a0: 73 70 61 63 65 20 69 73 20 6e 6f 74 20 6c 6f 73  space is not los
30b0: 74 2e 20 20 42 75 74 0a 20 20 6e 65 69 74 68 65  t.  But.  neithe
30c0: 72 20 69 73 20 69 74 20 72 65 74 75 72 6e 65 64  r is it returned
30d0: 20 74 6f 20 74 68 65 20 6f 70 65 72 61 74 69 6e   to the operatin
30e0: 67 20 73 79 73 74 65 6d 2e 3c 2f 70 3e 0a 0a 20  g system.</p>.. 
30f0: 20 3c 70 3e 49 66 20 79 6f 75 20 64 65 6c 65 74   <p>If you delet
3100: 65 20 61 20 6c 6f 74 20 6f 66 20 64 61 74 61 20  e a lot of data 
3110: 61 6e 64 20 77 61 6e 74 20 74 6f 20 73 68 72 69  and want to shri
3120: 6e 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 20  nk the database 
3130: 66 69 6c 65 2c 0a 20 20 72 75 6e 20 74 68 65 20  file,.  run the 
3140: 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f 76 61  <a href="lang_va
3150: 63 75 75 6d 2e 68 74 6d 6c 22 3e 56 41 43 55 55  cuum.html">VACUU
3160: 4d 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 2e 0a 20  M</a> command.. 
3170: 20 56 41 43 55 55 4d 20 77 69 6c 6c 20 72 65 63   VACUUM will rec
3180: 6f 6e 73 74 72 75 63 74 0a 20 20 74 68 65 20 64  onstruct.  the d
3190: 61 74 61 62 61 73 65 20 66 72 6f 6d 20 73 63 72  atabase from scr
31a0: 61 74 63 68 2e 20 20 54 68 69 73 20 77 69 6c 6c  atch.  This will
31b0: 20 6c 65 61 76 65 20 74 68 65 20 64 61 74 61 62   leave the datab
31c0: 61 73 65 20 77 69 74 68 20 61 6e 20 65 6d 70 74  ase with an empt
31d0: 79 0a 20 20 66 72 65 65 2d 6c 69 73 74 20 61 6e  y.  free-list an
31e0: 64 20 61 20 66 69 6c 65 20 74 68 61 74 20 69 73  d a file that is
31f0: 20 6d 69 6e 69 6d 61 6c 20 69 6e 20 73 69 7a 65   minimal in size
3200: 2e 20 20 4e 6f 74 65 2c 20 68 6f 77 65 76 65 72  .  Note, however
3210: 2c 20 74 68 61 74 20 74 68 65 0a 20 20 56 41 43  , that the.  VAC
3220: 55 55 4d 20 63 61 6e 20 74 61 6b 65 20 73 6f 6d  UUM can take som
3230: 65 20 74 69 6d 65 20 74 6f 20 72 75 6e 20 61 6e  e time to run an
3240: 64 20 69 74 20 63 61 6e 20 75 73 65 20 75 70 20  d it can use up 
3250: 74 6f 20 74 77 69 63 65 0a 20 20 61 73 20 6d 75  to twice.  as mu
3260: 63 68 20 74 65 6d 70 6f 72 61 72 79 20 64 69 73  ch temporary dis
3270: 6b 20 73 70 61 63 65 20 61 73 20 74 68 65 20 6f  k space as the o
3280: 72 69 67 69 6e 61 6c 20 66 69 6c 65 20 77 68 69  riginal file whi
3290: 6c 65 20 69 74 20 69 73 20 72 75 6e 6e 69 6e 67  le it is running
32a0: 2e 0a 20 20 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 41  ..  </p>..  <p>A
32b0: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 74 6f  n alternative to
32c0: 20 75 73 69 6e 67 20 74 68 65 20 56 41 43 55 55   using the VACUU
32d0: 4d 20 63 6f 6d 6d 61 6e 64 0a 20 20 69 73 20 61  M command.  is a
32e0: 75 74 6f 2d 76 61 63 75 75 6d 20 6d 6f 64 65 2c  uto-vacuum mode,
32f0: 20 65 6e 61 62 6c 65 64 20 75 73 69 6e 67 20 74   enabled using t
3300: 68 65 20 0a 20 20 3c 61 20 68 72 65 66 3d 22 70  he .  <a href="p
3310: 72 61 67 6d 61 2e 68 74 6d 6c 23 70 72 61 67 6d  ragma.html#pragm
3320: 61 5f 61 75 74 6f 5f 76 61 63 75 75 6d 22 3e 61  a_auto_vacuum">a
3330: 75 74 6f 5f 76 61 63 75 75 6d 20 70 72 61 67 6d  uto_vacuum pragm
3340: 61 3c 2f 61 3e 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61  a</a>.</p>.}..fa
3350: 71 20 7b 0a 20 20 43 61 6e 20 49 20 75 73 65 20  q {.  Can I use 
3360: 53 51 4c 69 74 65 20 69 6e 20 6d 79 20 63 6f 6d  SQLite in my com
3370: 6d 65 72 63 69 61 6c 20 70 72 6f 64 75 63 74 20  mercial product 
3380: 77 69 74 68 6f 75 74 20 70 61 79 69 6e 67 20 72  without paying r
3390: 6f 79 61 6c 74 69 65 73 3f 0a 7d 20 7b 0a 20 20  oyalties?.} {.  
33a0: 3c 70 3e 59 65 73 2e 20 20 53 51 4c 69 74 65 20  <p>Yes.  SQLite 
33b0: 69 73 20 69 6e 20 74 68 65 20 0a 20 20 3c 61 20  is in the .  <a 
33c0: 68 72 65 66 3d 22 63 6f 70 79 72 69 67 68 74 2e  href="copyright.
33d0: 68 74 6d 6c 22 3e 70 75 62 6c 69 63 20 64 6f 6d  html">public dom
33e0: 61 69 6e 3c 2f 61 3e 2e 20 20 4e 6f 20 63 6c 61  ain</a>.  No cla
33f0: 69 6d 20 6f 66 20 6f 77 6e 65 72 73 68 69 70 20  im of ownership 
3400: 69 73 20 6d 61 64 65 0a 20 20 74 6f 20 61 6e 79  is made.  to any
3410: 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 64   part of the cod
3420: 65 2e 20 20 59 6f 75 20 63 61 6e 20 64 6f 20 61  e.  You can do a
3430: 6e 79 74 68 69 6e 67 20 79 6f 75 20 77 61 6e 74  nything you want
3440: 20 77 69 74 68 20 69 74 2e 3c 2f 70 3e 0a 7d 0a   with it.</p>.}.
3450: 0a 66 61 71 20 7b 0a 20 20 48 6f 77 20 64 6f 20  .faq {.  How do 
3460: 49 20 75 73 65 20 61 20 73 74 72 69 6e 67 20 6c  I use a string l
3470: 69 74 65 72 61 6c 20 74 68 61 74 20 63 6f 6e 74  iteral that cont
3480: 61 69 6e 73 20 61 6e 20 65 6d 62 65 64 64 65 64  ains an embedded
3490: 20 73 69 6e 67 6c 65 2d 71 75 6f 74 65 20 28 27   single-quote ('
34a0: 29 0a 20 20 63 68 61 72 61 63 74 65 72 3f 0a 7d  ).  character?.}
34b0: 20 7b 0a 20 20 3c 70 3e 54 68 65 20 53 51 4c 20   {.  <p>The SQL 
34c0: 73 74 61 6e 64 61 72 64 20 73 70 65 63 69 66 69  standard specifi
34d0: 65 73 20 74 68 61 74 20 73 69 6e 67 6c 65 2d 71  es that single-q
34e0: 75 6f 74 65 73 20 69 6e 20 73 74 72 69 6e 67 73  uotes in strings
34f0: 20 61 72 65 20 65 73 63 61 70 65 64 0a 20 20 62   are escaped.  b
3500: 79 20 70 75 74 74 69 6e 67 20 74 77 6f 20 73 69  y putting two si
3510: 6e 67 6c 65 20 71 75 6f 74 65 73 20 69 6e 20 61  ngle quotes in a
3520: 20 72 6f 77 2e 20 20 53 51 4c 20 77 6f 72 6b 73   row.  SQL works
3530: 20 6c 69 6b 65 20 74 68 65 20 50 61 73 63 61 6c   like the Pascal
3540: 20 70 72 6f 67 72 61 6d 6d 69 6e 67 0a 20 20 6c   programming.  l
3550: 61 6e 67 75 61 67 65 20 69 6e 20 74 68 69 73 20  anguage in this 
3560: 72 65 67 61 72 64 2e 20 45 78 61 6d 70 6c 65 3a  regard. Example:
3570: 0a 20 20 3c 2f 70 3e 0a 0a 20 20 3c 62 6c 6f 63  .  </p>..  <bloc
3580: 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 20 20 20  kquote><pre>.   
3590: 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 78 79 7a   INSERT INTO xyz
35a0: 20 56 41 4c 55 45 53 28 27 35 20 4f 27 27 63 6c   VALUES('5 O''cl
35b0: 6f 63 6b 27 29 3b 0a 20 20 3c 2f 70 72 65 3e 3c  ock');.  </pre><
35c0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 7d 0a 0a  /blockquote>.}..
35d0: 66 61 71 20 7b 0a 20 20 57 68 61 74 20 69 73 20  faq {.  What is 
35e0: 61 6e 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41  an SQLITE_SCHEMA
35f0: 20 65 72 72 6f 72 2c 20 61 6e 64 20 77 68 79 20   error, and why 
3600: 61 6d 20 49 20 67 65 74 74 69 6e 67 20 6f 6e 65  am I getting one
3610: 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 41 6e 20 5b 53  ?.} {.  <p>An [S
3620: 51 4c 49 54 45 5f 53 43 48 45 4d 41 5d 20 65 72  QLITE_SCHEMA] er
3630: 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 20  ror is returned 
3640: 77 68 65 6e 20 61 20 0a 20 20 70 72 65 70 61 72  when a .  prepar
3650: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ed SQL statement
3660: 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 76 61   is no longer va
3670: 6c 69 64 20 61 6e 64 20 63 61 6e 6e 6f 74 20 62  lid and cannot b
3680: 65 20 65 78 65 63 75 74 65 64 2e 0a 20 20 57 68  e executed..  Wh
3690: 65 6e 20 74 68 69 73 20 6f 63 63 75 72 73 2c 20  en this occurs, 
36a0: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6d 75  the statement mu
36b0: 73 74 20 62 65 20 72 65 63 6f 6d 70 69 6c 65 64  st be recompiled
36c0: 20 66 72 6f 6d 20 53 51 4c 20 75 73 69 6e 67 20   from SQL using 
36d0: 0a 20 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  .  the [sqlite3_
36e0: 70 72 65 70 61 72 65 28 29 5d 20 41 50 49 2e 0a  prepare()] API..
36f0: 20 20 41 6e 20 53 51 4c 49 54 45 5f 53 43 48 45    An SQLITE_SCHE
3700: 4d 41 20 65 72 72 6f 72 20 63 61 6e 20 6f 6e 6c  MA error can onl
3710: 79 20 6f 63 63 75 72 20 77 68 65 6e 20 75 73 69  y occur when usi
3720: 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  ng the [sqlite3_
3730: 70 72 65 70 61 72 65 28 29 5d 2c 0a 20 20 61 6e  prepare()],.  an
3740: 64 20 5b 73 71 6c 69 74 65 33 5f 73 74 65 70 28  d [sqlite3_step(
3750: 29 5d 20 69 6e 74 65 72 66 61 63 65 73 20 74 6f  )] interfaces to
3760: 20 72 75 6e 20 53 51 4c 2e 0a 20 20 59 6f 75 20   run SQL..  You 
3770: 77 69 6c 6c 20 6e 65 76 65 72 20 72 65 63 65 69  will never recei
3780: 76 65 20 61 6e 20 5b 53 51 4c 49 54 45 5f 53 43  ve an [SQLITE_SC
3790: 48 45 4d 41 5d 20 65 72 72 6f 72 20 66 72 6f 6d  HEMA] error from
37a0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 65 78 65 63  .  [sqlite3_exec
37b0: 28 29 5d 2e 20 20 4e 6f 72 20 77 69 6c 6c 20 79  ()].  Nor will y
37c0: 6f 75 20 72 65 63 65 69 76 65 20 61 6e 20 65 72  ou receive an er
37d0: 72 6f 72 20 69 66 20 79 6f 75 0a 20 20 70 72 65  ror if you.  pre
37e0: 70 61 72 65 20 73 74 61 74 65 6d 65 6e 74 73 20  pare statements 
37f0: 75 73 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f 70  using [sqlite3_p
3800: 72 65 70 61 72 65 5f 76 32 28 29 5d 20 69 6e 73  repare_v2()] ins
3810: 74 65 61 64 20 6f 66 0a 20 20 5b 73 71 6c 69 74  tead of.  [sqlit
3820: 65 33 5f 70 72 65 70 61 72 65 28 29 5d 2e 3c 2f  e3_prepare()].</
3830: 70 3e 0a 0a 20 20 3c 70 3e 54 68 65 20 5b 73 71  p>..  <p>The [sq
3840: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32  lite3_prepare_v2
3850: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20 63 72  ()] interface cr
3860: 65 61 74 65 73 20 61 0a 20 20 5b 70 72 65 70 61  eates a.  [prepa
3870: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 5d 20 74  red statement] t
3880: 68 61 74 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74  hat will automat
3890: 69 63 61 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65  ically recompile
38a0: 20 69 74 73 65 6c 66 20 69 66 0a 20 20 74 68 65   itself if.  the
38b0: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 2e   schema changes.
38c0: 20 20 54 68 65 20 65 61 73 69 65 73 74 20 77 61    The easiest wa
38d0: 79 20 74 6f 20 64 65 61 6c 20 77 69 74 68 0a 20  y to deal with. 
38e0: 20 5b 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 5d   [SQLITE_SCHEMA]
38f0: 20 65 72 72 6f 72 73 20 69 73 20 74 6f 20 61 6c   errors is to al
3900: 77 61 79 73 20 75 73 65 20 5b 73 71 6c 69 74 65  ways use [sqlite
3910: 33 5f 70 72 65 70 61 72 65 5f 76 32 28 29 5d 0a  3_prepare_v2()].
3920: 20 20 69 6e 73 74 65 61 64 20 6f 66 20 5b 73 71    instead of [sq
3930: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 5d  lite3_prepare()]
3940: 2e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 57 68 79  ..}..faq {.  Why
3950: 20 64 6f 65 73 20 52 4f 55 4e 44 28 39 2e 39 35   does ROUND(9.95
3960: 2c 31 29 20 20 72 65 74 75 72 6e 20 39 2e 39 20  ,1)  return 9.9 
3970: 69 6e 73 74 65 61 64 20 6f 66 20 31 30 2e 30 3f  instead of 10.0?
3980: 0a 20 20 53 68 6f 75 6c 64 6e 27 74 20 39 2e 39  .  Shouldn't 9.9
3990: 35 20 72 6f 75 6e 64 20 75 70 3f 0a 7d 20 7b 0a  5 round up?.} {.
39a0: 20 20 3c 70 3e 53 51 4c 69 74 65 20 75 73 65 73    <p>SQLite uses
39b0: 20 62 69 6e 61 72 79 20 61 72 69 74 68 6d 65 74   binary arithmet
39c0: 69 63 20 61 6e 64 20 69 6e 20 62 69 6e 61 72 79  ic and in binary
39d0: 2c 20 74 68 65 72 65 20 69 73 20 6e 6f 0a 20 20  , there is no.  
39e0: 77 61 79 20 74 6f 20 77 72 69 74 65 20 39 2e 39  way to write 9.9
39f0: 35 20 69 6e 20 61 20 66 69 6e 69 74 65 20 6e 75  5 in a finite nu
3a00: 6d 62 65 72 20 6f 66 20 62 69 74 73 2e 20 20 54  mber of bits.  T
3a10: 68 65 20 63 6c 6f 73 65 73 74 20 74 6f 0a 20 20  he closest to.  
3a20: 79 6f 75 20 63 61 6e 20 67 65 74 20 74 6f 20 39  you can get to 9
3a30: 2e 39 35 20 69 6e 20 61 20 36 34 2d 62 69 74 20  .95 in a 64-bit 
3a40: 49 45 45 45 20 66 6c 6f 61 74 20 28 77 68 69 63  IEEE float (whic
3a50: 68 20 69 73 20 77 68 61 74 0a 20 20 53 51 4c 69  h is what.  SQLi
3a60: 74 65 20 75 73 65 73 29 20 69 73 20 39 2e 39 34  te uses) is 9.94
3a70: 39 39 39 39 39 39 39 39 39 39 39 39 39 32 38 39  9999999999999289
3a80: 34 35 37 32 36 34 32 33 39 38 39 39 38 31 34 31  4572642398998141
3a90: 32 38 38 37 35 37 33 32 34 32 31 38 37 35 2e 0a  28875732421875..
3aa0: 20 20 53 6f 20 77 68 65 6e 20 79 6f 75 20 74 79    So when you ty
3ab0: 70 65 20 22 39 2e 39 35 22 2c 20 53 51 4c 69 74  pe "9.95", SQLit
3ac0: 65 20 72 65 61 6c 6c 79 20 75 6e 64 65 72 73 74  e really underst
3ad0: 61 6e 64 73 20 74 68 65 20 6e 75 6d 62 65 72 20  ands the number 
3ae0: 74 6f 20 62 65 0a 20 20 74 68 65 20 6d 75 63 68  to be.  the much
3af0: 20 6c 6f 6e 67 65 72 20 76 61 6c 75 65 20 73 68   longer value sh
3b00: 6f 77 6e 20 61 62 6f 76 65 2e 20 20 41 6e 64 20  own above.  And 
3b10: 74 68 61 74 20 76 61 6c 75 65 20 72 6f 75 6e 64  that value round
3b20: 73 20 64 6f 77 6e 2e 3c 2f 70 3e 0a 0a 20 20 3c  s down.</p>..  <
3b30: 70 3e 54 68 69 73 20 6b 69 6e 64 20 6f 66 20 70  p>This kind of p
3b40: 72 6f 62 6c 65 6d 20 63 6f 6d 65 73 20 75 70 20  roblem comes up 
3b50: 61 6c 6c 20 74 68 65 20 74 69 6d 65 20 77 68 65  all the time whe
3b60: 6e 20 64 65 61 6c 69 6e 67 20 77 69 74 68 0a 20  n dealing with. 
3b70: 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20   floating point 
3b80: 62 69 6e 61 72 79 20 6e 75 6d 62 65 72 73 2e 20  binary numbers. 
3b90: 20 54 68 65 20 67 65 6e 65 72 61 6c 20 72 75 6c   The general rul
3ba0: 65 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 69 73  e to remember is
3bb0: 0a 20 20 74 68 61 74 20 6d 6f 73 74 20 66 72 61  .  that most fra
3bc0: 63 74 69 6f 6e 61 6c 20 6e 75 6d 62 65 72 73 20  ctional numbers 
3bd0: 74 68 61 74 20 68 61 76 65 20 61 20 66 69 6e 69  that have a fini
3be0: 74 65 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f  te representatio
3bf0: 6e 20 69 6e 20 64 65 63 69 6d 61 6c 0a 20 20 28  n in decimal.  (
3c00: 61 2e 6b 2e 61 20 22 62 61 73 65 2d 31 30 22 29  a.k.a "base-10")
3c10: 0a 20 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 61  .  do not have a
3c20: 20 66 69 6e 69 74 65 20 72 65 70 72 65 73 65 6e   finite represen
3c30: 74 61 74 69 6f 6e 20 69 6e 20 62 69 6e 61 72 79  tation in binary
3c40: 20 28 61 2e 6b 2e 61 20 22 62 61 73 65 2d 32 22   (a.k.a "base-2"
3c50: 29 2e 0a 20 20 41 6e 64 20 73 6f 20 74 68 65 79  )..  And so they
3c60: 20 61 72 65 0a 20 20 61 70 70 72 6f 78 69 6d 61   are.  approxima
3c70: 74 65 64 20 75 73 69 6e 67 20 74 68 65 20 63 6c  ted using the cl
3c80: 6f 73 65 73 74 20 62 69 6e 61 72 79 20 6e 75 6d  osest binary num
3c90: 62 65 72 20 61 76 61 69 6c 61 62 6c 65 2e 20 20  ber available.  
3ca0: 54 68 61 74 0a 20 20 61 70 70 72 6f 78 69 6d 61  That.  approxima
3cb0: 74 69 6f 6e 20 69 73 20 75 73 75 61 6c 6c 79 20  tion is usually 
3cc0: 76 65 72 79 20 63 6c 6f 73 65 2c 20 62 75 74 20  very close, but 
3cd0: 69 74 20 77 69 6c 6c 20 62 65 20 73 6c 69 67 68  it will be sligh
3ce0: 74 6c 79 20 6f 66 66 0a 20 20 61 6e 64 20 69 6e  tly off.  and in
3cf0: 20 73 6f 6d 65 20 63 61 73 65 73 20 63 61 6e 20   some cases can 
3d00: 63 61 75 73 65 20 79 6f 75 72 20 72 65 73 75 6c  cause your resul
3d10: 74 73 20 74 6f 20 62 65 20 61 20 6c 69 74 74 6c  ts to be a littl
3d20: 65 20 64 69 66 66 65 72 65 6e 74 0a 20 20 66 72  e different.  fr
3d30: 6f 6d 20 77 68 61 74 20 79 6f 75 20 6d 69 67 68  om what you migh
3d40: 74 20 65 78 70 65 63 74 2e 3c 2f 70 3e 0a 7d 0a  t expect.</p>.}.
3d50: 0a 66 61 71 20 7b 0a 20 20 49 20 67 65 74 20 73  .faq {.  I get s
3d60: 6f 6d 65 20 63 6f 6d 70 69 6c 65 72 20 77 61 72  ome compiler war
3d70: 6e 69 6e 67 73 20 77 68 65 6e 20 49 20 63 6f 6d  nings when I com
3d80: 70 69 6c 65 20 53 51 4c 69 74 65 2e 0a 20 20 49  pile SQLite..  I
3d90: 73 6e 27 74 20 74 68 69 73 20 61 20 70 72 6f 62  sn't this a prob
3da0: 6c 65 6d 3f 20 20 44 6f 65 73 6e 27 74 20 69 74  lem?  Doesn't it
3db0: 20 69 6e 64 69 63 61 74 65 20 70 6f 6f 72 20 63   indicate poor c
3dc0: 6f 64 65 20 71 75 61 6c 69 74 79 3f 0a 7d 20 7b  ode quality?.} {
3dd0: 0a 20 20 3c 70 3e 51 75 61 6c 69 74 79 20 61 73  .  <p>Quality as
3de0: 73 75 72 61 6e 63 65 20 69 6e 20 53 51 4c 69 74  surance in SQLit
3df0: 65 20 69 73 20 64 6f 6e 65 20 75 73 69 6e 67 20  e is done using 
3e00: 0a 20 20 5b 74 65 73 74 20 63 6f 76 65 72 61 67  .  [test coverag
3e10: 65 20 7c 20 66 75 6c 6c 2d 63 6f 76 65 72 61 67  e | full-coverag
3e20: 65 20 74 65 73 74 69 6e 67 5d 2c 0a 20 20 6e 6f  e testing],.  no
3e30: 74 20 62 79 20 63 6f 6d 70 69 6c 65 72 20 77 61  t by compiler wa
3e40: 72 6e 69 6e 67 73 20 6f 72 20 6f 74 68 65 72 20  rnings or other 
3e50: 73 74 61 74 69 63 20 63 6f 64 65 20 61 6e 61 6c  static code anal
3e60: 79 73 69 73 20 74 6f 6f 6c 73 2e 0a 20 20 49 6e  ysis tools..  In
3e70: 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 77 65   other words, we
3e80: 20 76 65 72 69 66 79 20 74 68 61 74 20 53 51 4c   verify that SQL
3e90: 69 74 65 20 61 63 74 75 61 6c 6c 79 20 67 65 74  ite actually get
3ea0: 73 20 74 68 65 0a 20 20 63 6f 72 72 65 63 74 20  s the.  correct 
3eb0: 61 6e 73 77 65 72 2c 20 6e 6f 74 20 74 68 61 74  answer, not that
3ec0: 20 69 74 20 6d 65 72 65 6c 79 20 73 61 74 69 73   it merely satis
3ed0: 66 69 65 73 20 73 74 79 6c 69 73 74 69 63 20 63  fies stylistic c
3ee0: 6f 6e 73 74 72 61 69 6e 74 73 2e 0a 20 20 4d 6f  onstraints..  Mo
3ef0: 73 74 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65  st of the SQLite
3f00: 20 63 6f 64 65 20 62 61 73 65 20 69 73 20 64 65   code base is de
3f10: 76 6f 74 65 64 20 70 75 72 65 6c 79 20 74 6f 20  voted purely to 
3f20: 74 65 73 74 69 6e 67 2e 0a 20 20 54 68 65 20 53  testing..  The S
3f30: 51 4c 69 74 65 20 74 65 73 74 20 73 75 69 74 65  QLite test suite
3f40: 20 72 75 6e 73 20 74 65 6e 73 20 6f 66 20 74 68   runs tens of th
3f50: 6f 75 73 61 6e 64 73 20 6f 66 20 73 65 70 61 72  ousands of separ
3f60: 61 74 65 20 74 65 73 74 20 63 61 73 65 73 20 61  ate test cases a
3f70: 6e 64 0a 20 20 6d 61 6e 79 20 6f 66 20 74 68 6f  nd.  many of tho
3f80: 73 65 20 74 65 73 74 20 63 61 73 65 73 20 61 72  se test cases ar
3f90: 65 20 70 61 72 61 6d 65 74 65 72 69 7a 65 64 20  e parameterized 
3fa0: 73 6f 20 74 68 61 74 20 68 75 6e 64 72 65 64 73  so that hundreds
3fb0: 20 6f 66 20 6d 69 6c 6c 69 6f 6e 73 0a 20 20 6f   of millions.  o
3fc0: 66 20 74 65 73 74 73 20 69 6e 76 6f 6c 76 69 6e  f tests involvin
3fd0: 67 20 62 69 6c 6c 69 6f 6e 73 20 6f 66 20 53 51  g billions of SQ
3fe0: 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65  L statements are
3ff0: 20 72 75 6e 20 61 6e 64 20 65 76 61 6c 75 61 74   run and evaluat
4000: 65 64 0a 20 20 66 6f 72 20 63 6f 72 72 65 63 74  ed.  for correct
4010: 6e 65 73 73 20 70 72 69 6f 72 20 74 6f 20 65 76  ness prior to ev
4020: 65 72 79 20 72 65 6c 65 61 73 65 2e 20 20 54 68  ery release.  Th
4030: 65 20 64 65 76 65 6c 6f 70 65 72 73 20 75 73 65  e developers use
4040: 20 63 6f 64 65 0a 20 20 63 6f 76 65 72 61 67 65   code.  coverage
4050: 20 74 6f 6f 6c 73 20 74 6f 20 76 65 72 69 66 79   tools to verify
4060: 20 74 68 61 74 20 61 6c 6c 20 70 61 74 68 73 20   that all paths 
4070: 74 68 72 6f 75 67 68 20 74 68 65 20 63 6f 64 65  through the code
4080: 20 61 72 65 20 74 65 73 74 65 64 2e 0a 20 20 57   are tested..  W
4090: 68 65 6e 65 76 65 72 20 61 20 62 75 67 20 69 73  henever a bug is
40a0: 20 66 6f 75 6e 64 20 69 6e 20 53 51 4c 69 74 65   found in SQLite
40b0: 2c 20 6e 65 77 20 74 65 73 74 20 63 61 73 65 73  , new test cases
40c0: 20 61 72 65 20 77 72 69 74 74 65 6e 20 74 6f 0a   are written to.
40d0: 20 20 65 78 68 69 62 69 74 20 74 68 65 20 62 75    exhibit the bu
40e0: 67 20 73 6f 20 74 68 61 74 20 74 68 65 20 62 75  g so that the bu
40f0: 67 20 63 61 6e 6e 6f 74 20 72 65 63 75 72 20 75  g cannot recur u
4100: 6e 64 65 74 65 63 74 65 64 20 69 6e 20 74 68 65  ndetected in the
4110: 20 66 75 74 75 72 65 2e 3c 2f 70 3e 0a 0a 20 20   future.</p>..  
4120: 3c 70 3e 44 75 72 69 6e 67 20 74 65 73 74 69 6e  <p>During testin
4130: 67 2c 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69  g, the SQLite li
4140: 62 72 61 72 79 20 69 73 20 63 6f 6d 70 69 6c 65  brary is compile
4150: 64 20 77 69 74 68 20 73 70 65 63 69 61 6c 0a 20  d with special. 
4160: 20 69 6e 73 74 72 75 6d 65 6e 74 61 74 69 6f 6e   instrumentation
4170: 20 74 68 61 74 20 61 6c 6c 6f 77 73 20 74 68 65   that allows the
4180: 20 74 65 73 74 20 73 63 72 69 70 74 73 20 74 6f   test scripts to
4190: 20 73 69 6d 75 6c 61 74 65 20 61 20 77 69 64 65   simulate a wide
41a0: 0a 20 20 76 61 72 69 65 74 79 20 6f 66 20 66 61  .  variety of fa
41b0: 69 6c 75 72 65 73 20 69 6e 20 6f 72 64 65 72 20  ilures in order 
41c0: 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 53  to verify that S
41d0: 51 4c 69 74 65 20 72 65 63 6f 76 65 72 73 0a 20  QLite recovers. 
41e0: 20 63 6f 72 72 65 63 74 6c 79 2e 20 20 4d 65 6d   correctly.  Mem
41f0: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69  ory allocation i
4200: 73 20 63 61 72 65 66 75 6c 6c 79 20 74 72 61 63  s carefully trac
4210: 6b 65 64 20 61 6e 64 20 6e 6f 20 6d 65 6d 6f 72  ked and no memor
4220: 79 0a 20 20 6c 65 61 6b 73 20 6f 63 63 75 72 2c  y.  leaks occur,
4230: 20 65 76 65 6e 20 66 6f 6c 6c 6f 77 69 6e 67 20   even following 
4240: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f  memory allocatio
4250: 6e 20 66 61 69 6c 75 72 65 73 2e 20 20 41 20 63  n failures.  A c
4260: 75 73 74 6f 6d 0a 20 20 56 46 53 20 6c 61 79 65  ustom.  VFS laye
4270: 72 20 69 73 20 75 73 65 64 20 74 6f 20 73 69 6d  r is used to sim
4280: 75 6c 61 74 65 20 6f 70 65 72 61 74 69 6e 67 20  ulate operating 
4290: 73 79 73 74 65 6d 20 63 72 61 73 68 65 73 20 61  system crashes a
42a0: 6e 64 20 70 6f 77 65 72 0a 20 20 66 61 69 6c 75  nd power.  failu
42b0: 72 65 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  res in order to 
42c0: 65 6e 73 75 72 65 20 74 68 61 74 20 74 72 61 6e  ensure that tran
42d0: 73 61 63 74 69 6f 6e 73 20 61 72 65 20 61 74 6f  sactions are ato
42e0: 6d 69 63 20 61 63 72 6f 73 73 0a 20 20 74 68 65  mic across.  the
42f0: 73 65 20 65 76 65 6e 74 73 2e 20 20 41 20 6d 65  se events.  A me
4300: 63 68 61 6e 69 73 6d 20 66 6f 72 20 64 65 6c 69  chanism for deli
4310: 62 65 72 61 74 65 6c 79 20 69 6e 6a 65 63 74 69  berately injecti
4320: 6e 67 20 49 2f 4f 20 65 72 72 6f 72 73 0a 20 20  ng I/O errors.  
4330: 73 68 6f 77 73 20 74 68 61 74 20 53 51 4c 69 74  shows that SQLit
4340: 65 20 69 73 20 72 65 73 69 6c 69 65 6e 74 20 74  e is resilient t
4350: 6f 20 73 75 63 68 20 6d 61 6c 66 75 6e 63 74 69  o such malfuncti
4360: 6f 6e 73 2e 20 20 28 41 73 20 61 6e 0a 20 20 65  ons.  (As an.  e
4370: 78 70 65 72 69 6d 65 6e 74 2c 20 74 72 79 20 69  xperiment, try i
4380: 6e 64 75 63 69 6e 67 20 74 68 65 73 65 20 6b 69  nducing these ki
4390: 6e 64 73 20 6f 66 20 65 72 72 6f 72 73 20 6f 6e  nds of errors on
43a0: 20 6f 74 68 65 72 20 53 51 4c 20 64 61 74 61 62   other SQL datab
43b0: 61 73 65 0a 20 20 65 6e 67 69 6e 65 73 20 61 6e  ase.  engines an
43c0: 64 20 73 65 65 20 77 68 61 74 20 68 61 70 70 65  d see what happe
43d0: 6e 73 21 29 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 57  ns!)</p>..  <p>W
43e0: 65 20 61 6c 73 6f 20 72 75 6e 20 53 51 4c 69 74  e also run SQLit
43f0: 65 20 75 73 69 6e 67 20 5b 68 74 74 70 3a 2f 2f  e using [http://
4400: 76 61 6c 67 72 69 6e 64 2e 6f 72 67 20 7c 20 56  valgrind.org | V
4410: 61 6c 67 72 69 6e 64 5d 0a 20 20 6f 6e 20 4c 69  algrind].  on Li
4420: 6e 75 78 20 61 6e 64 20 76 65 72 69 66 79 20 74  nux and verify t
4430: 68 61 74 20 69 74 20 64 65 74 65 63 74 73 20 6e  hat it detects n
4440: 6f 20 70 72 6f 62 6c 65 6d 73 2e 3c 2f 70 3e 0a  o problems.</p>.
4450: 0a 20 20 3c 70 3e 53 6f 6d 65 20 70 65 6f 70 6c  .  <p>Some peopl
4460: 65 20 73 61 79 20 74 68 61 74 20 77 65 20 73 68  e say that we sh
4470: 6f 75 6c 64 20 65 6c 69 6d 69 6e 61 74 65 20 61  ould eliminate a
4480: 6c 6c 20 77 61 72 6e 69 6e 67 73 20 62 65 63 61  ll warnings beca
4490: 75 73 65 0a 20 20 62 65 6e 69 67 6e 20 77 61 72  use.  benign war
44a0: 6e 69 6e 67 73 20 6d 61 73 6b 20 72 65 61 6c 20  nings mask real 
44b0: 77 61 72 6e 69 6e 67 73 20 74 68 61 74 20 6d 69  warnings that mi
44c0: 67 68 74 20 61 72 69 73 65 20 69 6e 20 66 75 74  ght arise in fut
44d0: 75 72 65 20 63 68 61 6e 67 65 73 2e 0a 20 20 54  ure changes..  T
44e0: 68 69 73 20 69 73 20 74 72 75 65 20 65 6e 6f 75  his is true enou
44f0: 67 68 2e 20 20 42 75 74 20 69 6e 20 72 65 70 6c  gh.  But in repl
4500: 79 2c 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72  y, the developer
4510: 73 20 6f 62 73 65 72 76 65 20 74 68 61 74 20 61  s observe that a
4520: 6c 6c 0a 20 20 77 61 72 6e 69 6e 67 73 20 68 61  ll.  warnings ha
4530: 76 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20  ve already been 
4540: 66 69 78 65 64 20 69 6e 20 74 68 65 20 62 75 69  fixed in the bui
4550: 6c 64 73 0a 20 20 75 73 65 64 20 66 6f 72 20 53  lds.  used for S
4560: 51 4c 69 74 65 20 64 65 76 65 6c 6f 70 6d 65 6e  QLite developmen
4570: 74 20 28 76 61 72 69 6f 75 73 20 76 65 72 73 69  t (various versi
4580: 6f 6e 73 20 6f 66 20 47 43 43 2c 20 4d 53 56 43  ons of GCC, MSVC
4590: 2c 0a 20 20 61 6e 64 20 63 6c 61 6e 67 29 2e 0a  ,.  and clang)..
45a0: 20 20 43 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69    Compiler warni
45b0: 6e 67 73 20 75 73 75 61 6c 6c 79 20 6f 6e 6c 79  ngs usually only
45c0: 20 61 72 69 73 65 20 66 72 6f 6d 20 63 6f 6d 70   arise from comp
45d0: 69 6c 65 72 73 20 6f 72 20 63 6f 6d 70 69 6c 65  ilers or compile
45e0: 2d 74 69 6d 65 20 0a 20 20 6f 70 74 69 6f 6e 73  -time .  options
45f0: 20 74 68 61 74 20 74 68 65 20 53 51 4c 69 74 65   that the SQLite
4600: 20 64 65 76 65 6c 6f 70 65 72 73 20 64 6f 20 6e   developers do n
4610: 6f 74 20 75 73 65 20 74 68 65 6d 73 65 6c 76 65  ot use themselve
4620: 73 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a  s.</p>.}..faq {.
4630: 20 20 43 61 73 65 2d 69 6e 73 65 6e 73 69 74 69    Case-insensiti
4640: 76 65 20 6d 61 74 63 68 69 6e 67 20 6f 66 20 55  ve matching of U
4650: 6e 69 63 6f 64 65 20 63 68 61 72 61 63 74 65 72  nicode character
4660: 73 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 2e  s does not work.
4670: 0a 7d 20 7b 0a 20 20 54 68 65 20 64 65 66 61 75  .} {.  The defau
4680: 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  lt configuration
4690: 20 6f 66 20 53 51 4c 69 74 65 20 6f 6e 6c 79 20   of SQLite only 
46a0: 73 75 70 70 6f 72 74 73 20 63 61 73 65 2d 69 6e  supports case-in
46b0: 73 65 6e 73 69 74 69 76 65 0a 20 20 63 6f 6d 70  sensitive.  comp
46c0: 61 72 69 73 6f 6e 73 20 6f 66 20 41 53 43 49 49  arisons of ASCII
46d0: 20 63 68 61 72 61 63 74 65 72 73 2e 20 20 54 68   characters.  Th
46e0: 65 20 72 65 61 73 6f 6e 20 66 6f 72 20 74 68 69  e reason for thi
46f0: 73 20 69 73 20 74 68 61 74 20 64 6f 69 6e 67 0a  s is that doing.
4700: 20 20 66 75 6c 6c 20 55 6e 69 63 6f 64 65 20 63    full Unicode c
4710: 61 73 65 2d 69 6e 73 65 6e 73 69 74 69 76 65 20  ase-insensitive 
4720: 63 6f 6d 70 61 72 69 73 6f 6e 73 20 61 6e 64 20  comparisons and 
4730: 63 61 73 65 20 63 6f 6e 76 65 72 73 69 6f 6e 73  case conversions
4740: 20 0a 20 20 72 65 71 75 69 72 65 73 20 74 61 62   .  requires tab
4750: 6c 65 73 20 61 6e 64 20 6c 6f 67 69 63 20 74 68  les and logic th
4760: 61 74 20 77 6f 75 6c 64 20 6e 65 61 72 6c 79 20  at would nearly 
4770: 64 6f 75 62 6c 65 20 74 68 65 20 73 69 7a 65 20  double the size 
4780: 6f 66 0a 20 20 74 68 65 20 53 51 4c 69 74 65 20  of.  the SQLite 
4790: 6c 69 62 72 61 72 79 2e 20 20 54 68 65 0a 20 20  library.  The.  
47a0: 53 51 4c 69 74 65 20 64 65 76 65 6c 6f 70 65 72  SQLite developer
47b0: 73 20 72 65 61 73 6f 6e 20 74 68 61 74 20 61 6e  s reason that an
47c0: 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 68  y application th
47d0: 61 74 20 6e 65 65 64 73 20 66 75 6c 6c 0a 20 20  at needs full.  
47e0: 55 6e 69 63 6f 64 65 20 63 61 73 65 20 73 75 70  Unicode case sup
47f0: 70 6f 72 74 20 70 72 6f 62 61 62 6c 79 20 61 6c  port probably al
4800: 72 65 61 64 79 20 68 61 73 20 74 68 65 20 6e 65  ready has the ne
4810: 63 65 73 73 61 72 79 20 74 61 62 6c 65 73 20 61  cessary tables a
4820: 6e 64 0a 20 20 66 75 6e 63 74 69 6f 6e 73 20 61  nd.  functions a
4830: 6e 64 20 73 6f 20 53 51 4c 69 74 65 20 73 68 6f  nd so SQLite sho
4840: 75 6c 64 20 6e 6f 74 20 74 61 6b 65 20 75 70 20  uld not take up 
4850: 73 70 61 63 65 20 74 6f 20 0a 20 20 64 75 70 6c  space to .  dupl
4860: 69 63 61 74 65 20 74 68 69 73 20 61 62 69 6c 69  icate this abili
4870: 74 79 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 49 6e  ty.</p>..  <p>In
4880: 73 74 65 61 64 20 6f 66 20 70 72 6f 76 69 64 69  stead of providi
4890: 6e 67 20 66 75 6c 6c 20 55 6e 69 63 6f 64 65 20  ng full Unicode 
48a0: 63 61 73 65 20 73 75 70 70 6f 72 74 20 62 79 20  case support by 
48b0: 64 65 66 61 75 6c 74 2c 20 0a 20 20 53 51 4c 69  default, .  SQLi
48c0: 74 65 20 70 72 6f 76 69 64 65 73 20 74 68 65 20  te provides the 
48d0: 61 62 69 6c 69 74 79 20 74 6f 20 6c 69 6e 6b 20  ability to link 
48e0: 61 67 61 69 6e 73 74 20 65 78 74 65 72 6e 61 6c  against external
48f0: 0a 20 20 55 6e 69 63 6f 64 65 20 63 6f 6d 70 61  .  Unicode compa
4900: 72 69 73 6f 6e 20 61 6e 64 20 63 6f 6e 76 65 72  rison and conver
4910: 73 69 6f 6e 20 72 6f 75 74 69 6e 65 73 2e 0a 20  sion routines.. 
4920: 20 54 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e   The application
4930: 20 63 61 6e 20 6f 76 65 72 6c 6f 61 64 20 74 68   can overload th
4940: 65 20 62 75 69 6c 74 2d 69 6e 20 5b 4e 4f 43 41  e built-in [NOCA
4950: 53 45 5d 20 63 6f 6c 6c 61 74 69 6e 67 0a 20 20  SE] collating.  
4960: 73 65 71 75 65 6e 63 65 20 28 75 73 69 6e 67 20  sequence (using 
4970: 5b 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f  [sqlite3_create_
4980: 63 6f 6c 6c 61 74 69 6f 6e 28 29 5d 29 20 61 6e  collation()]) an
4990: 64 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 0a 20  d the built-in. 
49a0: 20 5b 6c 69 6b 65 28 29 5d 2c 20 5b 75 70 70 65   [like()], [uppe
49b0: 72 28 29 5d 2c 20 61 6e 64 20 5b 6c 6f 77 65 72  r()], and [lower
49c0: 28 29 5d 20 66 75 6e 63 74 69 6f 6e 73 0a 20 20  ()] functions.  
49d0: 28 75 73 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f  (using [sqlite3_
49e0: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 28  create_function(
49f0: 29 5d 29 2e 20 20 0a 20 20 54 68 65 20 53 51 4c  )]).  .  The SQL
4a00: 69 74 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20  ite source code 
4a10: 69 6e 63 6c 75 64 65 73 20 61 6e 20 22 49 43 55  includes an "ICU
4a20: 22 20 65 78 74 65 6e 73 69 6f 6e 20 74 68 61 74  " extension that
4a30: 20 64 6f 65 73 20 0a 20 20 74 68 65 73 65 20 6f   does .  these o
4a40: 76 65 72 6c 6f 61 64 73 2e 20 20 4f 72 2c 20 64  verloads.  Or, d
4a50: 65 76 65 6c 6f 70 65 72 73 20 63 61 6e 20 77 72  evelopers can wr
4a60: 69 74 65 20 74 68 65 69 72 20 6f 77 6e 20 6f 76  ite their own ov
4a70: 65 72 6c 6f 61 64 73 0a 20 20 62 61 73 65 64 20  erloads.  based 
4a80: 6f 6e 20 74 68 65 69 72 20 6f 77 6e 20 55 6e 69  on their own Uni
4a90: 63 6f 64 65 2d 61 77 61 72 65 20 63 6f 6d 70 61  code-aware compa
4aa0: 72 69 73 6f 6e 20 72 6f 75 74 69 6e 65 73 20 61  rison routines a
4ab0: 6c 72 65 61 64 79 0a 20 20 63 6f 6e 74 61 69 6e  lready.  contain
4ac0: 65 64 20 77 69 74 68 69 6e 20 74 68 65 69 72 20  ed within their 
4ad0: 70 72 6f 6a 65 63 74 2e 0a 7d 0a 0a 66 61 71 20  project..}..faq 
4ae0: 7b 0a 20 20 49 4e 53 45 52 54 20 69 73 20 72 65  {.  INSERT is re
4af0: 61 6c 6c 79 20 73 6c 6f 77 20 2d 20 49 20 63 61  ally slow - I ca
4b00: 6e 20 6f 6e 6c 79 20 64 6f 20 66 65 77 20 64 6f  n only do few do
4b10: 7a 65 6e 20 49 4e 53 45 52 54 73 20 70 65 72 20  zen INSERTs per 
4b20: 73 65 63 6f 6e 64 0a 7d 20 7b 0a 20 20 41 63 74  second.} {.  Act
4b30: 75 61 6c 6c 79 2c 20 53 51 4c 69 74 65 20 77 69  ually, SQLite wi
4b40: 6c 6c 20 65 61 73 69 6c 79 20 64 6f 20 35 30 2c  ll easily do 50,
4b50: 30 30 30 20 6f 72 20 6d 6f 72 65 20 5b 49 4e 53  000 or more [INS
4b60: 45 52 54 5d 20 73 74 61 74 65 6d 65 6e 74 73 20  ERT] statements 
4b70: 70 65 72 20 73 65 63 6f 6e 64 0a 20 20 6f 6e 20  per second.  on 
4b80: 61 6e 20 61 76 65 72 61 67 65 20 64 65 73 6b 74  an average deskt
4b90: 6f 70 20 63 6f 6d 70 75 74 65 72 2e 20 20 42 75  op computer.  Bu
4ba0: 74 20 69 74 20 77 69 6c 6c 20 6f 6e 6c 79 20 64  t it will only d
4bb0: 6f 20 61 20 66 65 77 20 64 6f 7a 65 6e 20 74 72  o a few dozen tr
4bc0: 61 6e 73 61 63 74 69 6f 6e 73 0a 20 20 70 65 72  ansactions.  per
4bd0: 20 73 65 63 6f 6e 64 2e 20 20 54 72 61 6e 73 61   second.  Transa
4be0: 63 74 69 6f 6e 20 73 70 65 65 64 20 69 73 20 6c  ction speed is l
4bf0: 69 6d 69 74 65 64 20 62 79 20 74 68 65 20 72 6f  imited by the ro
4c00: 74 61 74 69 6f 6e 61 6c 20 73 70 65 65 64 20 6f  tational speed o
4c10: 66 0a 20 20 79 6f 75 72 20 64 69 73 6b 20 64 72  f.  your disk dr
4c20: 69 76 65 2e 20 20 41 20 74 72 61 6e 73 61 63 74  ive.  A transact
4c30: 69 6f 6e 20 6e 6f 72 6d 61 6c 6c 79 20 72 65 71  ion normally req
4c40: 75 69 72 65 73 20 74 77 6f 20 63 6f 6d 70 6c 65  uires two comple
4c50: 74 65 20 72 6f 74 61 74 69 6f 6e 73 0a 20 20 6f  te rotations.  o
4c60: 66 20 74 68 65 20 64 69 73 6b 20 70 6c 61 74 74  f the disk platt
4c70: 65 72 2c 20 77 68 69 63 68 20 6f 6e 20 61 20 37  er, which on a 7
4c80: 32 30 30 52 50 4d 20 64 69 73 6b 20 64 72 69 76  200RPM disk driv
4c90: 65 20 6c 69 6d 69 74 73 20 79 6f 75 20 74 6f 20  e limits you to 
4ca0: 61 62 6f 75 74 0a 20 20 36 30 20 74 72 61 6e 73  about.  60 trans
4cb0: 61 63 74 69 6f 6e 73 20 70 65 72 20 73 65 63 6f  actions per seco
4cc0: 6e 64 2e 0a 0a 20 20 3c 70 3e 54 72 61 6e 73 61  nd...  <p>Transa
4cd0: 63 74 69 6f 6e 20 73 70 65 65 64 20 69 73 20 6c  ction speed is l
4ce0: 69 6d 69 74 65 64 20 62 79 20 64 69 73 6b 20 64  imited by disk d
4cf0: 72 69 76 65 20 73 70 65 65 64 20 62 65 63 61 75  rive speed becau
4d00: 73 65 20 28 62 79 20 64 65 66 61 75 6c 74 29 0a  se (by default).
4d10: 20 20 53 51 4c 69 74 65 20 61 63 74 75 61 6c 6c    SQLite actuall
4d20: 79 20 77 61 69 74 73 20 75 6e 74 69 6c 20 74 68  y waits until th
4d30: 65 20 64 61 74 61 20 72 65 61 6c 6c 79 20 69 73  e data really is
4d40: 20 73 61 66 65 6c 79 20 73 74 6f 72 65 64 20 6f   safely stored o
4d50: 6e 20 74 68 65 20 64 69 73 6b 0a 20 20 73 75 72  n the disk.  sur
4d60: 66 61 63 65 20 62 65 66 6f 72 65 20 74 68 65 20  face before the 
4d70: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63  transaction is c
4d80: 6f 6d 70 6c 65 74 65 2e 20 20 54 68 61 74 20 77  omplete.  That w
4d90: 61 79 2c 20 69 66 20 79 6f 75 20 73 75 64 64 65  ay, if you sudde
4da0: 6e 6c 79 20 6c 6f 73 65 0a 20 20 70 6f 77 65 72  nly lose.  power
4db0: 20 6f 72 20 69 66 20 79 6f 75 72 20 4f 53 20 63   or if your OS c
4dc0: 72 61 73 68 65 73 2c 20 79 6f 75 72 20 64 61 74  rashes, your dat
4dd0: 61 20 69 73 20 73 74 69 6c 6c 20 73 61 66 65 2e  a is still safe.
4de0: 20 20 46 6f 72 20 64 65 74 61 69 6c 73 2c 20 0a    For details, .
4df0: 20 20 72 65 61 64 20 61 62 6f 75 74 20 3c 61 20    read about <a 
4e00: 68 72 65 66 3d 22 61 74 6f 6d 69 63 63 6f 6d 6d  href="atomiccomm
4e10: 69 74 2e 68 74 6d 6c 22 3e 61 74 6f 6d 69 63 20  it.html">atomic 
4e20: 63 6f 6d 6d 69 74 20 69 6e 20 53 51 4c 69 74 65  commit in SQLite
4e30: 2e 3c 2f 61 3e 2e 0a 0a 20 20 3c 70 3e 42 79 20  .</a>...  <p>By 
4e40: 64 65 66 61 75 6c 74 2c 20 65 61 63 68 20 49 4e  default, each IN
4e50: 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74 20 69  SERT statement i
4e60: 73 20 69 74 73 20 6f 77 6e 20 74 72 61 6e 73 61  s its own transa
4e70: 63 74 69 6f 6e 2e 20 20 42 75 74 20 69 66 20 79  ction.  But if y
4e80: 6f 75 0a 20 20 73 75 72 72 6f 75 6e 64 20 6d 75  ou.  surround mu
4e90: 6c 74 69 70 6c 65 20 49 4e 53 45 52 54 20 73 74  ltiple INSERT st
4ea0: 61 74 65 6d 65 6e 74 73 20 77 69 74 68 20 5b 42  atements with [B
4eb0: 45 47 49 4e 5d 2e 2e 2e 5b 43 4f 4d 4d 49 54 5d  EGIN]...[COMMIT]
4ec0: 20 74 68 65 6e 20 61 6c 6c 20 74 68 65 0a 20 20   then all the.  
4ed0: 69 6e 73 65 72 74 73 20 61 72 65 20 67 72 6f 75  inserts are grou
4ee0: 70 65 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c  ped into a singl
4ef0: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20  e transaction.  
4f00: 54 68 65 20 74 69 6d 65 20 6e 65 65 64 65 64 20  The time needed 
4f10: 74 6f 20 63 6f 6d 6d 69 74 0a 20 20 74 68 65 20  to commit.  the 
4f20: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61  transaction is a
4f30: 6d 6f 72 74 69 7a 65 64 20 6f 76 65 72 20 61 6c  mortized over al
4f40: 6c 20 74 68 65 20 65 6e 63 6c 6f 73 65 64 20 69  l the enclosed i
4f50: 6e 73 65 72 74 20 73 74 61 74 65 6d 65 6e 74 73  nsert statements
4f60: 20 61 6e 64 0a 20 20 73 6f 20 74 68 65 20 74 69   and.  so the ti
4f70: 6d 65 20 70 65 72 20 69 6e 73 65 72 74 20 73 74  me per insert st
4f80: 61 74 65 6d 65 6e 74 20 69 73 20 67 72 65 61 74  atement is great
4f90: 6c 79 20 72 65 64 75 63 65 64 2e 0a 0a 20 20 3c  ly reduced...  <
4fa0: 70 3e 41 6e 6f 74 68 65 72 20 6f 70 74 69 6f 6e  p>Another option
4fb0: 20 69 73 20 74 6f 20 72 75 6e 20 5b 50 52 41 47   is to run [PRAG
4fc0: 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 4f  MA synchronous=O
4fd0: 46 46 5d 2e 20 20 54 68 69 73 20 63 6f 6d 6d 61  FF].  This comma
4fe0: 6e 64 20 77 69 6c 6c 0a 20 20 63 61 75 73 65 20  nd will.  cause 
4ff0: 53 51 4c 69 74 65 20 74 6f 20 6e 6f 74 20 77 61  SQLite to not wa
5000: 69 74 20 6f 6e 20 64 61 74 61 20 74 6f 20 72 65  it on data to re
5010: 61 63 68 20 74 68 65 20 64 69 73 6b 20 73 75 72  ach the disk sur
5020: 66 61 63 65 2c 20 77 68 69 63 68 20 77 69 6c 6c  face, which will
5030: 20 6d 61 6b 65 0a 20 20 77 72 69 74 65 20 6f 70   make.  write op
5040: 65 72 61 74 69 6f 6e 73 20 61 70 70 65 61 72 20  erations appear 
5050: 74 6f 20 62 65 20 6d 75 63 68 20 66 61 73 74 65  to be much faste
5060: 72 2e 20 20 42 75 74 20 69 66 20 79 6f 75 20 6c  r.  But if you l
5070: 6f 73 65 20 70 6f 77 65 72 20 69 6e 20 74 68 65  ose power in the
5080: 0a 20 20 6d 69 64 64 6c 65 20 6f 66 20 61 20 74  .  middle of a t
5090: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 79 6f 75 72  ransaction, your
50a0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 6d   database file m
50b0: 69 67 68 74 20 67 6f 20 63 6f 72 72 75 70 74 2e  ight go corrupt.
50c0: 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 49 20 61 63  .}..faq {.  I ac
50d0: 63 69 64 65 6e 74 61 6c 6c 79 20 64 65 6c 65 74  cidentally delet
50e0: 65 64 20 73 6f 6d 65 20 69 6d 70 6f 72 74 61 6e  ed some importan
50f0: 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72  t information fr
5100: 6f 6d 20 6d 79 20 53 51 4c 69 74 65 20 64 61 74  om my SQLite dat
5110: 61 62 61 73 65 2e 0a 20 20 48 6f 77 20 63 61 6e  abase..  How can
5120: 20 49 20 72 65 63 6f 76 65 72 20 69 74 3f 0a 7d   I recover it?.}
5130: 20 7b 0a 20 20 49 66 20 79 6f 75 20 68 61 76 65   {.  If you have
5140: 20 61 20 62 61 63 6b 75 70 20 63 6f 70 79 20 6f   a backup copy o
5150: 66 20 79 6f 75 72 20 64 61 74 61 62 61 73 65 20  f your database 
5160: 66 69 6c 65 2c 20 72 65 63 6f 76 65 72 20 74 68  file, recover th
5170: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 20 20  e information.  
5180: 66 72 6f 6d 20 79 6f 75 72 20 62 61 63 6b 75 70  from your backup
5190: 2e 0a 0a 20 20 3c 70 3e 49 66 20 79 6f 75 20 64  ...  <p>If you d
51a0: 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 62 61 63  o not have a bac
51b0: 6b 75 70 2c 20 72 65 63 6f 76 65 72 79 20 69 73  kup, recovery is
51c0: 20 76 65 72 79 20 64 69 66 66 69 63 75 6c 74 2e   very difficult.
51d0: 20 20 59 6f 75 20 6d 69 67 68 74 0a 20 20 62 65    You might.  be
51e0: 20 61 62 6c 65 20 74 6f 20 66 69 6e 64 20 70 61   able to find pa
51f0: 72 74 69 61 6c 20 73 74 72 69 6e 67 20 64 61 74  rtial string dat
5200: 61 20 69 6e 20 61 20 62 69 6e 61 72 79 20 64 75  a in a binary du
5210: 6d 70 20 6f 66 20 74 68 65 20 72 61 77 20 64 61  mp of the raw da
5220: 74 61 62 61 73 65 0a 20 20 66 69 6c 65 2e 20 20  tabase.  file.  
5230: 52 65 63 6f 76 65 72 69 6e 67 20 6e 75 6d 65 72  Recovering numer
5240: 69 63 20 64 61 74 61 20 6d 69 67 68 74 20 61 6c  ic data might al
5250: 73 6f 20 62 65 20 70 6f 73 73 69 62 6c 65 20 67  so be possible g
5260: 69 76 65 6e 20 73 70 65 63 69 61 6c 20 74 6f 6f  iven special too
5270: 6c 73 2c 0a 20 20 74 68 6f 75 67 68 20 74 6f 20  ls,.  though to 
5280: 6f 75 72 20 6b 6e 6f 77 6c 65 64 67 65 20 6e 6f  our knowledge no
5290: 20 73 75 63 68 20 74 6f 6f 6c 73 20 65 78 69 73   such tools exis
52a0: 74 2e 20 20 53 51 4c 69 74 65 20 69 73 20 73 6f  t.  SQLite is so
52b0: 6d 65 74 69 6d 65 73 20 63 6f 6d 70 69 6c 65 64  metimes compiled
52c0: 0a 20 20 77 69 74 68 20 74 68 65 20 5b 53 51 4c  .  with the [SQL
52d0: 49 54 45 5f 53 45 43 55 52 45 5f 44 45 4c 45 54  ITE_SECURE_DELET
52e0: 45 5d 20 6f 70 74 69 6f 6e 20 77 68 69 63 68 20  E] option which 
52f0: 6f 76 65 72 77 72 69 74 65 73 20 61 6c 6c 20 64  overwrites all d
5300: 65 6c 65 74 65 64 20 63 6f 6e 74 65 6e 74 0a 20  eleted content. 
5310: 20 77 69 74 68 20 7a 65 72 6f 73 2e 20 20 49 66   with zeros.  If
5320: 20 74 68 61 74 20 69 73 20 74 68 65 20 63 61 73   that is the cas
5330: 65 20 74 68 65 6e 20 72 65 63 6f 76 65 72 79 20  e then recovery 
5340: 69 73 20 63 6c 65 61 72 6c 79 20 69 6d 70 6f 73  is clearly impos
5350: 73 69 62 6c 65 2e 0a 20 20 52 65 63 6f 76 65 72  sible..  Recover
5360: 79 20 69 73 20 61 6c 73 6f 20 69 6d 70 6f 73 73  y is also imposs
5370: 69 62 6c 65 20 69 66 20 79 6f 75 20 68 61 76 65  ible if you have
5380: 20 72 75 6e 20 5b 56 41 43 55 55 4d 5d 20 73 69   run [VACUUM] si
5390: 6e 63 65 20 74 68 65 20 64 61 74 61 20 77 61 73  nce the data was
53a0: 0a 20 20 64 65 6c 65 74 65 64 2e 20 20 49 66 20  .  deleted.  If 
53b0: 53 51 4c 49 54 45 5f 53 45 43 55 52 45 5f 44 45  SQLITE_SECURE_DE
53c0: 4c 45 54 45 20 69 73 20 6e 6f 74 20 75 73 65 64  LETE is not used
53d0: 20 61 6e 64 20 56 41 43 55 55 4d 20 68 61 73 20   and VACUUM has 
53e0: 6e 6f 74 20 62 65 65 6e 20 72 75 6e 2c 0a 20 20  not been run,.  
53f0: 74 68 65 6e 20 73 6f 6d 65 20 6f 66 20 74 68 65  then some of the
5400: 20 64 65 6c 65 74 65 64 20 63 6f 6e 74 65 6e 74   deleted content
5410: 20 6d 69 67 68 74 20 73 74 69 6c 6c 20 62 65 20   might still be 
5420: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  in the database 
5430: 66 69 6c 65 2c 20 69 6e 0a 20 20 61 72 65 61 73  file, in.  areas
5440: 20 6d 61 72 6b 65 64 20 66 6f 72 20 72 65 75 73   marked for reus
5450: 65 2e 20 20 42 75 74 2c 20 61 67 61 69 6e 2c 20  e.  But, again, 
5460: 74 68 65 72 65 20 65 78 69 73 74 20 6e 6f 20 70  there exist no p
5470: 72 6f 63 65 64 75 72 65 73 20 6f 72 20 74 6f 6f  rocedures or too
5480: 6c 73 0a 20 20 74 68 61 74 20 77 65 20 6b 6e 6f  ls.  that we kno
5490: 77 20 6f 66 20 74 6f 20 68 65 6c 70 20 79 6f 75  w of to help you
54a0: 20 72 65 63 6f 76 65 72 20 74 68 61 74 20 64 61   recover that da
54b0: 74 61 2e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 57  ta..}..faq {.  W
54c0: 68 61 74 20 69 73 20 61 6e 20 53 51 4c 49 54 45  hat is an SQLITE
54d0: 5f 43 4f 52 52 55 50 54 20 65 72 72 6f 72 3f 20  _CORRUPT error? 
54e0: 20 57 68 61 74 20 64 6f 65 73 20 69 74 20 6d 65   What does it me
54f0: 61 6e 20 66 6f 72 20 74 68 65 20 64 61 74 61 62  an for the datab
5500: 61 73 65 0a 20 20 74 6f 20 62 65 20 22 6d 61 6c  ase.  to be "mal
5510: 66 6f 72 6d 65 64 22 3f 20 57 68 79 20 61 6d 20  formed"? Why am 
5520: 49 20 67 65 74 74 69 6e 67 20 74 68 69 73 20 65  I getting this e
5530: 72 72 6f 72 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 41  rror?.} {.  <p>A
5540: 6e 20 5b 53 51 4c 49 54 45 5f 43 4f 52 52 55 50  n [SQLITE_CORRUP
5550: 54 5d 20 65 72 72 6f 72 20 69 73 20 72 65 74 75  T] error is retu
5560: 72 6e 65 64 20 77 68 65 6e 20 53 51 4c 69 74 65  rned when SQLite
5570: 20 64 65 74 65 63 74 73 20 61 6e 20 65 72 72 6f   detects an erro
5580: 72 0a 20 20 69 6e 20 74 68 65 20 73 74 72 75 63  r.  in the struc
5590: 74 75 72 65 2c 20 66 6f 72 6d 61 74 2c 20 6f 72  ture, format, or
55a0: 20 6f 74 68 65 72 20 63 6f 6e 74 72 6f 6c 20 65   other control e
55b0: 6c 65 6d 65 6e 74 73 20 6f 66 20 74 68 65 0a 20  lements of the. 
55c0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 3c   database file.<
55d0: 2f 70 3e 0a 0a 20 20 3c 70 3e 53 51 4c 69 74 65  /p>..  <p>SQLite
55e0: 20 64 6f 65 73 20 6e 6f 74 20 63 6f 72 72 75 70   does not corrup
55f0: 74 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73  t database files
5600: 20 77 69 74 68 6f 75 74 20 65 78 74 65 72 6e 61   without externa
5610: 6c 20 68 65 6c 70 2e 0a 20 20 49 66 20 79 6f 75  l help..  If you
5620: 72 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 63 72  r application cr
5630: 61 73 68 65 73 20 69 6e 20 74 68 65 20 6d 69 64  ashes in the mid
5640: 64 6c 65 20 6f 66 20 61 6e 0a 20 20 75 70 64 61  dle of an.  upda
5650: 74 65 2c 20 79 6f 75 72 20 64 61 74 61 20 69 73  te, your data is
5660: 20 73 61 66 65 2e 20 20 54 68 65 20 64 61 74 61   safe.  The data
5670: 62 61 73 65 20 69 73 20 73 61 66 65 20 65 76 65  base is safe eve
5680: 6e 20 69 66 20 79 6f 75 72 20 4f 53 0a 20 20 63  n if your OS.  c
5690: 72 61 73 68 65 73 20 6f 72 20 74 61 6b 65 73 20  rashes or takes 
56a0: 61 20 70 6f 77 65 72 20 6c 6f 73 73 2e 20 20 54  a power loss.  T
56b0: 68 65 20 63 72 61 73 68 2d 72 65 73 69 73 74 61  he crash-resista
56c0: 6e 63 65 20 6f 66 20 53 51 4c 69 74 65 20 68 61  nce of SQLite ha
56d0: 73 0a 20 20 62 65 65 6e 20 65 78 74 65 6e 73 69  s.  been extensi
56e0: 76 65 6c 79 20 73 74 75 64 69 65 64 20 61 6e 64  vely studied and
56f0: 20 74 65 73 74 65 64 20 61 6e 64 20 69 73 20 61   tested and is a
5700: 74 74 65 73 74 65 64 20 62 79 20 79 65 61 72 73  ttested by years
5710: 20 6f 66 20 72 65 61 6c 2d 77 6f 72 6c 64 20 0a   of real-world .
5720: 20 20 65 78 70 65 72 69 65 6e 63 65 20 62 79 20    experience by 
5730: 62 69 6c 6c 69 6f 6e 73 20 6f 66 20 75 73 65 72  billions of user
5740: 73 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 54 68 61  s.</p>..  <p>Tha
5750: 74 20 73 61 69 64 2c 20 74 68 65 72 65 20 61 72  t said, there ar
5760: 65 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 74 68  e a number of th
5770: 69 6e 67 73 20 74 68 61 74 20 65 78 74 65 72 6e  ings that extern
5780: 61 6c 20 70 72 6f 67 72 61 6d 73 20 6f 72 20 62  al programs or b
5790: 75 67 73 0a 20 20 69 6e 20 79 6f 75 72 20 68 61  ugs.  in your ha
57a0: 72 64 77 61 72 65 20 6f 72 20 4f 53 20 63 61 6e  rdware or OS can
57b0: 20 64 6f 20 74 6f 20 63 6f 72 72 75 70 74 20 61   do to corrupt a
57c0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20   database file. 
57d0: 20 53 65 65 0a 20 20 3c 61 20 68 72 65 66 3d 22   See.  <a href="
57e0: 68 6f 77 74 6f 63 6f 72 72 75 70 74 2e 68 74 6d  howtocorrupt.htm
57f0: 6c 22 3e 48 6f 77 20 54 6f 20 43 6f 72 72 75 70  l">How To Corrup
5800: 74 20 41 6e 20 53 51 4c 69 74 65 20 44 61 74 61  t An SQLite Data
5810: 62 61 73 65 20 46 69 6c 65 3c 2f 61 3e 20 66 6f  base File</a> fo
5820: 72 0a 20 20 66 75 72 74 68 65 72 20 69 6e 66 6f  r.  further info
5830: 72 6d 61 74 69 6f 6e 2e 0a 0a 20 20 3c 70 3e 59  rmation...  <p>Y
5840: 6f 75 20 63 61 6e 20 75 73 65 20 3c 61 20 68 72  ou can use <a hr
5850: 65 66 3d 22 70 72 61 67 6d 61 2e 68 74 6d 6c 23  ef="pragma.html#
5860: 70 72 61 67 6d 61 5f 69 6e 74 65 67 72 69 74 79  pragma_integrity
5870: 5f 63 68 65 63 6b 22 3e 50 52 41 47 4d 41 20 69  _check">PRAGMA i
5880: 6e 74 65 67 72 69 74 79 5f 63 68 65 63 6b 3c 2f  ntegrity_check</
5890: 61 3e 20 0a 20 20 74 6f 20 64 6f 20 61 20 74 68  a> .  to do a th
58a0: 6f 72 6f 75 67 68 20 62 75 74 20 74 69 6d 65 20  orough but time 
58b0: 69 6e 74 65 6e 73 69 76 65 20 74 65 73 74 20 6f  intensive test o
58c0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69  f the database i
58d0: 6e 74 65 67 72 69 74 79 2e 3c 2f 70 3e 0a 0a 20  ntegrity.</p>.. 
58e0: 20 3c 70 3e 59 6f 75 20 63 61 6e 20 75 73 65 20   <p>You can use 
58f0: 3c 61 20 68 72 65 66 3d 22 70 72 61 67 6d 61 2e  <a href="pragma.
5900: 68 74 6d 6c 23 70 72 61 67 6d 61 5f 71 75 69 63  html#pragma_quic
5910: 6b 5f 63 68 65 63 6b 22 3e 50 52 41 47 4d 41 20  k_check">PRAGMA 
5920: 71 75 69 63 6b 5f 63 68 65 63 6b 3c 2f 61 3e 20  quick_check</a> 
5930: 74 6f 20 64 6f 20 61 20 66 61 73 74 65 72 20 0a  to do a faster .
5940: 20 20 62 75 74 20 6c 65 73 73 20 74 68 6f 72 6f    but less thoro
5950: 75 67 68 20 74 65 73 74 20 6f 66 20 74 68 65 20  ugh test of the 
5960: 64 61 74 61 62 61 73 65 20 69 6e 74 65 67 72 69  database integri
5970: 74 79 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 44 65  ty.</p>..  <p>De
5980: 70 65 6e 64 69 6e 67 20 68 6f 77 20 62 61 64 6c  pending how badl
5990: 79 20 79 6f 75 72 20 64 61 74 61 62 61 73 65 20  y your database 
59a0: 69 73 20 63 6f 72 72 75 70 74 65 64 2c 20 79 6f  is corrupted, yo
59b0: 75 20 6d 61 79 20 62 65 20 61 62 6c 65 20 74 6f  u may be able to
59c0: 20 0a 20 20 72 65 63 6f 76 65 72 20 73 6f 6d 65   .  recover some
59d0: 20 6f 66 20 74 68 65 20 64 61 74 61 20 62 79 20   of the data by 
59e0: 75 73 69 6e 67 20 74 68 65 20 43 4c 49 20 74 6f  using the CLI to
59f0: 20 64 75 6d 70 20 74 68 65 20 73 63 68 65 6d 61   dump the schema
5a00: 20 61 6e 64 20 63 6f 6e 74 65 6e 74 73 0a 20 20   and contents.  
5a10: 74 6f 20 61 20 66 69 6c 65 20 61 6e 64 20 74 68  to a file and th
5a20: 65 6e 20 72 65 63 72 65 61 74 65 2e 20 20 55 6e  en recreate.  Un
5a30: 66 6f 72 74 75 6e 61 74 65 6c 79 2c 20 6f 6e 63  fortunately, onc
5a40: 65 20 68 75 6d 70 74 79 2d 64 75 6d 70 74 79 20  e humpty-dumpty 
5a50: 66 61 6c 6c 73 20 6f 66 66 20 0a 20 20 74 68 65  falls off .  the
5a60: 20 77 61 6c 6c 2c 20 69 74 20 69 73 20 67 65 6e   wall, it is gen
5a70: 65 72 61 6c 6c 79 20 6e 6f 74 20 70 6f 73 73 69  erally not possi
5a80: 62 6c 65 20 74 6f 20 70 75 74 20 68 69 6d 20 62  ble to put him b
5a90: 61 63 6b 20 74 6f 67 65 74 68 65 72 20 61 67 61  ack together aga
5aa0: 69 6e 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b  in.</p>.}..faq {
5ab0: 0a 20 20 44 6f 65 73 20 53 51 4c 69 74 65 20 73  .  Does SQLite s
5ac0: 75 70 70 6f 72 74 20 66 6f 72 65 69 67 6e 20 6b  upport foreign k
5ad0: 65 79 73 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 0a 20  eys?.} {.  <p>. 
5ae0: 20 41 73 20 6f 66 20 5b 76 65 72 73 69 6f 6e 20   As of [version 
5af0: 33 2e 36 2e 31 39 5d 20 28 5b 64 61 74 65 6f 66  3.6.19] ([dateof
5b00: 3a 33 2e 36 2e 31 39 5d 29 2c 20 0a 20 20 53 51  :3.6.19]), .  SQ
5b10: 4c 69 74 65 20 73 75 70 70 6f 72 74 73 20 5b 66  Lite supports [f
5b20: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
5b30: 72 61 69 6e 74 73 5d 2e 20 20 42 75 74 20 65 6e  raints].  But en
5b40: 66 6f 72 63 65 6d 65 6e 74 0a 20 20 6f 66 20 66  forcement.  of f
5b50: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
5b60: 72 61 69 6e 74 73 20 69 73 20 74 75 72 6e 65 64  raints is turned
5b70: 20 6f 66 66 20 62 79 20 64 65 66 61 75 6c 74 20   off by default 
5b80: 28 66 6f 72 20 62 61 63 6b 77 61 72 64 73 20 63  (for backwards c
5b90: 6f 6d 70 61 74 69 62 69 6c 69 74 79 29 2e 0a 20  ompatibility).. 
5ba0: 20 54 6f 20 65 6e 61 62 6c 65 20 66 6f 72 65 69   To enable forei
5bb0: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e  gn key constrain
5bc0: 74 20 65 6e 66 6f 72 63 65 6d 65 6e 74 2c 20 72  t enforcement, r
5bd0: 75 6e 20 0a 20 20 5b 50 52 41 47 4d 41 20 66 6f  un .  [PRAGMA fo
5be0: 72 65 69 67 6e 5f 6b 65 79 73 7c 50 52 41 47 4d  reign_keys|PRAGM
5bf0: 41 20 66 6f 72 65 69 67 6e 5f 6b 65 79 73 3d 4f  A foreign_keys=O
5c00: 4e 5d 20 6f 72 20 63 6f 6d 70 69 6c 65 20 77 69  N] or compile wi
5c10: 74 68 0a 20 20 5b 53 51 4c 49 54 45 5f 44 45 46  th.  [SQLITE_DEF
5c20: 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59  AULT_FOREIGN_KEY
5c30: 53 20 7c 20 2d 44 53 51 4c 49 54 45 5f 44 45 46  S | -DSQLITE_DEF
5c40: 41 55 4c 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59  AULT_FOREIGN_KEY
5c50: 53 3d 31 5d 2e 0a 7d 0a 0a 66 61 71 20 7b 0a 20  S=1]..}..faq {. 
5c60: 20 49 20 67 65 74 20 61 20 63 6f 6d 70 69 6c 65   I get a compile
5c70: 72 20 65 72 72 6f 72 20 69 66 20 49 20 75 73 65  r error if I use
5c80: 20 74 68 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54   the SQLITE_OMIT
5c90: 5f 2e 2e 2e 20 0a 20 20 63 6f 6d 70 69 6c 65 2d  _... .  compile-
5ca0: 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20 77 68 65  time options whe
5cb0: 6e 20 62 75 69 6c 64 69 6e 67 20 53 51 4c 69 74  n building SQLit
5cc0: 65 2e 0a 7d 20 7b 0a 20 20 54 68 65 20 5b 6f 6d  e..} {.  The [om
5cd0: 69 74 66 65 61 74 75 72 65 73 20 7c 20 53 51 4c  itfeatures | SQL
5ce0: 49 54 45 5f 4f 4d 49 54 5f 2e 2e 2e 5d 20 63 6f  ITE_OMIT_...] co
5cf0: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f  mpile-time optio
5d00: 6e 73 20 6f 6e 6c 79 20 77 6f 72 6b 0a 20 20 77  ns only work.  w
5d10: 68 65 6e 20 62 75 69 6c 64 69 6e 67 20 66 72 6f  hen building fro
5d20: 6d 20 63 61 6e 6f 6e 69 63 61 6c 20 73 6f 75 72  m canonical sour
5d30: 63 65 20 66 69 6c 65 73 2e 20 20 54 68 65 79 20  ce files.  They 
5d40: 64 6f 20 3c 75 3e 6e 6f 74 3c 2f 75 3e 20 77 6f  do <u>not</u> wo
5d50: 72 6b 0a 20 20 77 68 65 6e 20 79 6f 75 20 62 75  rk.  when you bu
5d60: 69 6c 64 20 66 72 6f 6d 20 74 68 65 20 53 51 4c  ild from the SQL
5d70: 69 74 65 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f  ite [amalgamatio
5d80: 6e 5d 20 6f 72 20 66 72 6f 6d 20 74 68 65 20 70  n] or from the p
5d90: 72 65 2d 70 72 6f 63 65 73 73 65 64 0a 20 20 73  re-processed.  s
5da0: 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 0a 20 20  ource files...  
5db0: 3c 70 3e 49 74 20 69 73 20 70 6f 73 73 69 62 6c  <p>It is possibl
5dc0: 65 20 74 6f 20 62 75 69 6c 64 20 61 20 73 70 65  e to build a spe
5dd0: 63 69 61 6c 20 5b 61 6d 61 6c 67 61 6d 61 74 69  cial [amalgamati
5de0: 6f 6e 5d 20 74 68 61 74 20 77 69 6c 6c 20 77 6f  on] that will wo
5df0: 72 6b 20 77 69 74 68 0a 20 20 61 20 70 72 65 64  rk with.  a pred
5e00: 65 74 65 72 6d 69 6e 65 64 20 73 65 74 20 6f 66  etermined set of
5e10: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2e 2e 2e   SQLITE_OMIT_...
5e20: 20 6f 70 74 69 6f 6e 73 2e 20 20 49 6e 73 74 72   options.  Instr
5e30: 75 63 74 69 6f 6e 73 20 66 6f 72 20 64 6f 69 6e  uctions for doin
5e40: 67 0a 20 20 73 6f 20 63 61 6e 20 62 65 20 66 6f  g.  so can be fo
5e50: 75 6e 64 20 77 69 74 68 20 74 68 65 20 5b 6f 6d  und with the [om
5e60: 69 74 66 65 61 74 75 72 65 73 20 7c 20 53 51 4c  itfeatures | SQL
5e70: 49 54 45 5f 4f 4d 49 54 5f 2e 2e 2e 20 64 6f 63  ITE_OMIT_... doc
5e80: 75 6d 65 6e 74 61 74 69 6f 6e 5d 2e 0a 7d 0a 0a  umentation]..}..
5e90: 66 61 71 20 7b 0a 20 20 4d 79 20 57 48 45 52 45  faq {.  My WHERE
5ea0: 20 63 6c 61 75 73 65 20 65 78 70 72 65 73 73 69   clause expressi
5eb0: 6f 6e 20 3c 74 74 3e 63 6f 6c 75 6d 6e 31 3d 22  on <tt>column1="
5ec0: 63 6f 6c 75 6d 6e 31 22 3c 2f 74 74 3e 20 64 6f  column1"</tt> do
5ed0: 65 73 20 6e 6f 74 20 77 6f 72 6b 2e 0a 20 20 49  es not work..  I
5ee0: 74 20 63 61 75 73 65 73 20 65 76 65 72 79 20 72  t causes every r
5ef0: 6f 77 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  ow of the table 
5f00: 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 2c 20  to be returned, 
5f10: 6e 6f 74 20 6a 75 73 74 20 74 68 65 20 72 6f 77  not just the row
5f20: 73 0a 20 20 77 68 65 72 65 20 63 6f 6c 75 6d 6e  s.  where column
5f30: 31 20 68 61 73 20 74 68 65 20 76 61 6c 75 65 20  1 has the value 
5f40: 22 63 6f 6c 75 6d 6e 31 22 2e 0a 7d 20 7b 0a 20  "column1"..} {. 
5f50: 20 55 73 65 20 73 69 6e 67 6c 65 2d 71 75 6f 74   Use single-quot
5f60: 65 73 2c 20 6e 6f 74 20 64 6f 75 62 6c 65 2d 71  es, not double-q
5f70: 75 6f 74 65 73 2c 20 61 72 6f 75 6e 64 20 73 74  uotes, around st
5f80: 72 69 6e 67 20 6c 69 74 65 72 61 6c 73 20 69 6e  ring literals in
5f90: 20 53 51 4c 2e 0a 20 20 54 68 69 73 20 69 73 20   SQL..  This is 
5fa0: 77 68 61 74 20 74 68 65 20 53 51 4c 20 73 74 61  what the SQL sta
5fb0: 6e 64 61 72 64 20 72 65 71 75 69 72 65 73 2e 20  ndard requires. 
5fc0: 20 59 6f 75 72 20 57 48 45 52 45 20 63 6c 61 75   Your WHERE clau
5fd0: 73 65 20 65 78 70 72 65 73 73 69 6f 6e 0a 20 20  se expression.  
5fe0: 73 68 6f 75 6c 64 20 72 65 61 64 3a 20 3c 74 74  should read: <tt
5ff0: 3e 63 6f 6c 75 6d 6e 31 3d 27 63 6f 6c 75 6d 6e  >column1='column
6000: 31 27 3c 2f 74 74 3e 0a 0a 20 20 3c 70 3e 53 51  1'</tt>..  <p>SQ
6010: 4c 20 75 73 65 73 20 64 6f 75 62 6c 65 2d 71 75  L uses double-qu
6020: 6f 74 65 73 20 61 72 6f 75 6e 64 20 69 64 65 6e  otes around iden
6030: 74 69 66 69 65 72 73 20 28 63 6f 6c 75 6d 6e 20  tifiers (column 
6040: 6f 72 20 74 61 62 6c 65 20 6e 61 6d 65 73 29 20  or table names) 
6050: 74 68 61 74 0a 20 20 63 6f 6e 74 61 69 6e 73 20  that.  contains 
6060: 73 70 65 63 69 61 6c 20 63 68 61 72 61 63 74 65  special characte
6070: 72 73 20 6f 72 20 77 68 69 63 68 20 61 72 65 20  rs or which are 
6080: 6b 65 79 77 6f 72 64 73 2e 20 20 53 6f 20 64 6f  keywords.  So do
6090: 75 62 6c 65 2d 71 75 6f 74 65 73 20 61 72 65 0a  uble-quotes are.
60a0: 20 20 61 20 77 61 79 20 6f 66 20 65 73 63 61 70    a way of escap
60b0: 69 6e 67 20 69 64 65 6e 74 69 66 69 65 72 20 6e  ing identifier n
60c0: 61 6d 65 73 2e 20 20 48 65 6e 63 65 2c 20 77 68  ames.  Hence, wh
60d0: 65 6e 20 79 6f 75 20 73 61 79 0a 20 20 3c 74 74  en you say.  <tt
60e0: 3e 63 6f 6c 75 6d 6e 31 3d 22 63 6f 6c 75 6d 6e  >column1="column
60f0: 31 22 3c 2f 74 74 3e 20 74 68 61 74 20 69 73 20  1"</tt> that is 
6100: 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 0a 20  equivalent to . 
6110: 20 3c 74 74 3e 63 6f 6c 75 6d 6e 31 3d 63 6f 6c   <tt>column1=col
6120: 75 6d 6e 31 3c 2f 74 74 3e 20 77 68 69 63 68 20  umn1</tt> which 
6130: 69 73 20 6f 62 76 69 6f 75 73 6c 79 20 61 6c 77  is obviously alw
6140: 61 79 73 20 74 72 75 65 2e 0a 7d 0a 0a 66 61 71  ays true..}..faq
6150: 20 7b 0a 20 20 48 6f 77 20 61 72 65 20 74 68 65   {.  How are the
6160: 20 73 79 6e 74 61 78 20 64 69 61 67 72 61 6d 73   syntax diagrams
6170: 20 28 61 2e 6b 2e 61 2e 20 22 72 61 69 6c 72 6f   (a.k.a. "railro
6180: 61 64 22 20 64 69 61 67 72 61 6d 73 29 20 66 6f  ad" diagrams) fo
6190: 72 0a 20 20 53 51 4c 69 74 65 20 67 65 6e 65 72  r.  SQLite gener
61a0: 61 74 65 64 3f 0a 7d 20 7b 0a 20 20 54 68 65 20  ated?.} {.  The 
61b0: 70 72 6f 63 65 73 73 20 69 73 20 65 78 70 6c 61  process is expla
61c0: 69 6e 65 64 20 61 74 20 5b 68 74 74 70 3a 2f 2f  ined at [http://
61d0: 77 69 6b 69 2e 74 63 6c 2d 6c 61 6e 67 2e 6f 72  wiki.tcl-lang.or
61e0: 67 2f 32 31 37 30 38 5d 2e 0a 7d 0a 0a 66 61 71  g/21708]..}..faq
61f0: 20 7b 0a 20 20 54 68 65 20 53 51 4c 20 73 74 61   {.  The SQL sta
6200: 6e 64 61 72 64 20 72 65 71 75 69 72 65 73 20 74  ndard requires t
6210: 68 61 74 20 61 20 55 4e 49 51 55 45 20 63 6f 6e  hat a UNIQUE con
6220: 73 74 72 61 69 6e 74 20 62 65 20 65 6e 66 6f 72  straint be enfor
6230: 63 65 64 20 65 76 65 6e 20 69 66 0a 20 20 6f 6e  ced even if.  on
6240: 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65  e or more of the
6250: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20   columns in the 
6260: 63 6f 6e 73 74 72 61 69 6e 74 20 61 72 65 20 4e  constraint are N
6270: 55 4c 4c 2c 20 62 75 74 20 53 51 4c 69 74 65 20  ULL, but SQLite 
6280: 64 6f 65 73 0a 20 20 6e 6f 74 20 64 6f 20 74 68  does.  not do th
6290: 69 73 2e 20 20 49 73 6e 27 74 20 74 68 61 74 20  is.  Isn't that 
62a0: 61 20 62 75 67 3f 0a 7d 20 7b 0a 20 20 50 65 72  a bug?.} {.  Per
62b0: 68 61 70 73 20 79 6f 75 20 61 72 65 20 72 65 66  haps you are ref
62c0: 65 72 72 69 6e 67 20 74 6f 20 74 68 65 20 66 6f  erring to the fo
62d0: 6c 6c 6f 77 69 6e 67 20 73 74 61 74 65 6d 65 6e  llowing statemen
62e0: 74 20 66 72 6f 6d 20 53 51 4c 39 32 3a 0a 0a 20  t from SQL92:.. 
62f0: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20   <blockquote>.  
6300: 41 20 75 6e 69 71 75 65 20 63 6f 6e 73 74 72 61  A unique constra
6310: 69 6e 74 20 69 73 20 73 61 74 69 73 66 69 65 64  int is satisfied
6320: 20 69 66 20 61 6e 64 20 6f 6e 6c 79 20 69 66 20   if and only if 
6330: 6e 6f 20 74 77 6f 20 72 6f 77 73 20 69 6e 20 61  no two rows in a
6340: 0a 20 20 74 61 62 6c 65 20 68 61 76 65 20 74 68  .  table have th
6350: 65 20 73 61 6d 65 20 6e 6f 6e 2d 6e 75 6c 6c 20  e same non-null 
6360: 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 75 6e  values in the un
6370: 69 71 75 65 20 63 6f 6c 75 6d 6e 73 2e 20 0a 20  ique columns. . 
6380: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a   </blockquote>..
6390: 20 20 54 68 61 74 20 73 74 61 74 65 6d 65 6e 74    That statement
63a0: 20 69 73 20 61 6d 62 69 67 75 6f 75 73 2c 20 68   is ambiguous, h
63b0: 61 76 69 6e 67 20 61 74 20 6c 65 61 73 74 20 74  aving at least t
63c0: 77 6f 20 70 6f 73 73 69 62 6c 65 20 69 6e 74 65  wo possible inte
63d0: 72 70 72 65 74 61 74 69 6f 6e 73 3a 0a 0a 20 20  rpretations:..  
63e0: 3c 6f 6c 3e 0a 20 20 3c 6c 69 3e 41 20 75 6e 69  <ol>.  <li>A uni
63f0: 71 75 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 69  que constraint i
6400: 73 20 73 61 74 69 73 66 69 65 64 20 69 66 20 61  s satisfied if a
6410: 6e 64 20 6f 6e 6c 79 20 69 66 20 6e 6f 20 74 77  nd only if no tw
6420: 6f 20 72 6f 77 73 20 69 6e 20 61 0a 20 20 74 61  o rows in a.  ta
6430: 62 6c 65 20 68 61 76 65 20 74 68 65 20 73 61 6d  ble have the sam
6440: 65 20 76 61 6c 75 65 73 20 61 6e 64 20 68 61 76  e values and hav
6450: 65 20 6e 6f 6e 2d 6e 75 6c 6c 20 76 61 6c 75 65  e non-null value
6460: 73 20 69 6e 20 74 68 65 20 75 6e 69 71 75 65 20  s in the unique 
6470: 63 6f 6c 75 6d 6e 73 2e 0a 20 20 3c 6c 69 3e 41  columns..  <li>A
6480: 20 75 6e 69 71 75 65 20 63 6f 6e 73 74 72 61 69   unique constrai
6490: 6e 74 20 69 73 20 73 61 74 69 73 66 69 65 64 20  nt is satisfied 
64a0: 69 66 20 61 6e 64 20 6f 6e 6c 79 20 69 66 20 6e  if and only if n
64b0: 6f 20 74 77 6f 20 72 6f 77 73 20 69 6e 20 61 20  o two rows in a 
64c0: 0a 20 20 74 61 62 6c 65 20 68 61 76 65 20 74 68  .  table have th
64d0: 65 20 73 61 6d 65 20 76 61 6c 75 65 73 20 69 6e  e same values in
64e0: 20 74 68 65 20 73 75 62 73 65 74 20 6f 66 20 75   the subset of u
64f0: 6e 69 71 75 65 20 63 6f 6c 75 6d 6e 73 20 74 68  nique columns th
6500: 61 74 20 61 72 65 20 6e 6f 74 20 6e 75 6c 6c 2e  at are not null.
6510: 0a 20 20 3c 2f 6f 6c 3e 0a 0a 20 20 53 51 4c 69  .  </ol>..  SQLi
6520: 74 65 20 66 6f 6c 6c 6f 77 73 20 69 6e 74 65 72  te follows inter
6530: 70 72 65 74 61 74 69 6f 6e 20 28 31 29 2c 20 61  pretation (1), a
6540: 73 20 64 6f 65 73 20 50 6f 73 74 67 72 65 53 51  s does PostgreSQ
6550: 4c 2c 20 4d 79 53 51 4c 2c 20 4f 72 61 63 6c 65  L, MySQL, Oracle
6560: 2c 0a 20 20 61 6e 64 20 46 69 72 65 62 69 72 64  ,.  and Firebird
6570: 2e 20 20 49 74 20 69 73 20 74 72 75 65 20 74 68  .  It is true th
6580: 61 74 20 49 6e 66 6f 72 6d 69 78 20 61 6e 64 20  at Informix and 
6590: 4d 69 63 72 6f 73 6f 66 74 20 53 51 4c 20 53 65  Microsoft SQL Se
65a0: 72 76 65 72 20 75 73 65 0a 20 20 69 6e 74 65 72  rver use.  inter
65b0: 70 72 65 74 61 74 69 6f 6e 20 28 32 29 2c 20 68  pretation (2), h
65c0: 6f 77 65 76 65 72 20 77 65 20 74 68 65 20 53 51  owever we the SQ
65d0: 4c 69 74 65 20 64 65 76 65 6c 6f 70 65 72 73 20  Lite developers 
65e0: 68 6f 6c 64 20 74 68 61 74 20 0a 20 20 69 6e 74  hold that .  int
65f0: 65 72 70 72 65 74 61 74 69 6f 6e 20 28 31 29 20  erpretation (1) 
6600: 69 73 20 74 68 65 20 6d 6f 73 74 20 6e 61 74 75  is the most natu
6610: 72 61 6c 20 72 65 61 64 69 6e 67 20 0a 20 20 6f  ral reading .  o
6620: 66 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e  f the requiremen
6630: 74 20 61 6e 64 20 77 65 20 61 6c 73 6f 20 77 61  t and we also wa
6640: 6e 74 20 74 6f 20 6d 61 78 69 6d 69 7a 65 20 63  nt to maximize c
6650: 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74  ompatibility wit
6660: 68 20 6f 74 68 65 72 0a 20 20 53 51 4c 20 64 61  h other.  SQL da
6670: 74 61 62 61 73 65 20 65 6e 67 69 6e 65 73 2c 20  tabase engines, 
6680: 61 6e 64 20 6d 6f 73 74 20 6f 74 68 65 72 20 64  and most other d
6690: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 73 20  atabase engines 
66a0: 61 6c 73 6f 20 67 6f 20 77 69 74 68 20 28 31 29  also go with (1)
66b0: 2c 0a 20 20 73 6f 20 74 68 61 74 20 69 73 20 77  ,.  so that is w
66c0: 68 61 74 20 53 51 4c 69 74 65 20 64 6f 65 73 2e  hat SQLite does.
66d0: 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 57 68 61 74  .}..faq {.  What
66e0: 20 69 73 20 74 68 65 20 45 78 70 6f 72 74 20 43   is the Export C
66f0: 6f 6e 74 72 6f 6c 20 43 6c 61 73 73 69 66 69 63  ontrol Classific
6700: 61 74 69 6f 6e 20 4e 75 6d 62 65 72 20 28 45 43  ation Number (EC
6710: 43 4e 29 20 66 6f 72 20 53 51 4c 69 74 65 3f 0a  CN) for SQLite?.
6720: 7d 20 7b 0a 20 20 41 66 74 65 72 20 63 61 72 65  } {.  After care
6730: 66 75 6c 20 72 65 76 69 65 77 20 6f 66 20 74 68  ful review of th
6740: 65 20 43 6f 6d 6d 65 72 63 65 20 43 6f 6e 74 72  e Commerce Contr
6750: 6f 6c 20 4c 69 73 74 20 28 43 43 4c 29 2c 20 77  ol List (CCL), w
6760: 65 20 61 72 65 20 63 6f 6e 76 69 6e 63 65 64 0a  e are convinced.
6770: 20 20 74 68 61 74 20 74 68 65 20 63 6f 72 65 20    that the core 
6780: 70 75 62 6c 69 63 2d 64 6f 6d 61 69 6e 20 53 51  public-domain SQ
6790: 4c 69 74 65 20 73 6f 75 72 63 65 20 63 6f 64 65  Lite source code
67a0: 20 69 73 20 6e 6f 74 20 64 65 73 63 72 69 62 65   is not describe
67b0: 64 20 62 79 20 61 6e 79 20 45 43 43 4e 2c 0a 20  d by any ECCN,. 
67c0: 20 68 65 6e 63 65 20 74 68 65 20 45 43 43 4e 20   hence the ECCN 
67d0: 73 68 6f 75 6c 64 20 62 65 20 72 65 70 6f 72 74  should be report
67e0: 65 64 20 61 73 20 3c 62 3e 45 41 52 39 39 3c 2f  ed as <b>EAR99</
67f0: 62 3e 2e 0a 0a 20 20 3c 70 3e 54 68 65 20 61 62  b>...  <p>The ab
6800: 6f 76 65 20 69 73 20 74 72 75 65 20 66 6f 72 20  ove is true for 
6810: 74 68 65 20 63 6f 72 65 20 70 75 62 6c 69 63 2d  the core public-
6820: 64 6f 6d 61 69 6e 20 53 51 4c 69 74 65 2e 20 20  domain SQLite.  
6830: 49 66 20 79 6f 75 20 65 78 74 65 6e 64 0a 20 20  If you extend.  
6840: 53 51 4c 69 74 65 20 62 79 20 61 64 64 69 6e 67  SQLite by adding
6850: 20 6e 65 77 20 63 6f 64 65 2c 20 6f 72 20 69 66   new code, or if
6860: 20 79 6f 75 20 73 74 61 74 69 63 61 6c 6c 79 20   you statically 
6870: 6c 69 6e 6b 20 53 51 4c 69 74 65 20 77 69 74 68  link SQLite with
6880: 20 79 6f 75 72 0a 20 20 61 70 70 6c 69 63 61 74   your.  applicat
6890: 69 6f 6e 2c 20 74 68 61 74 20 6d 69 67 68 74 20  ion, that might 
68a0: 63 68 61 6e 67 65 20 74 68 65 20 45 43 43 4e 20  change the ECCN 
68b0: 69 6e 20 79 6f 75 72 20 70 61 72 74 69 63 75 6c  in your particul
68c0: 61 72 20 63 61 73 65 2e 0a 7d 0a 0a 66 61 71 20  ar case..}..faq 
68d0: 7b 0a 20 20 4d 79 20 71 75 65 72 79 20 64 6f 65  {.  My query doe
68e0: 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 74 68 65  s not return the
68f0: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 74 68 61   column name tha
6900: 74 20 49 20 65 78 70 65 63 74 2e 20 20 49 73 20  t I expect.  Is 
6910: 74 68 69 73 20 61 20 62 75 67 3f 0a 7d 20 7b 0a  this a bug?.} {.
6920: 20 20 49 66 20 74 68 65 20 63 6f 6c 75 6d 6e 73    If the columns
6930: 20 6f 66 20 79 6f 75 72 20 72 65 73 75 6c 74 20   of your result 
6940: 73 65 74 20 61 72 65 20 6e 61 6d 65 64 20 62 79  set are named by
6950: 20 41 53 20 63 6c 61 75 73 65 73 2c 20 74 68 65   AS clauses, the
6960: 6e 20 53 51 4c 69 74 65 0a 20 20 69 73 20 67 75  n SQLite.  is gu
6970: 61 72 61 6e 74 65 65 64 20 74 6f 20 75 73 65 20  aranteed to use 
6980: 74 68 65 20 69 64 65 6e 74 69 66 69 65 72 20 74  the identifier t
6990: 6f 20 74 68 65 20 72 69 67 68 74 20 6f 66 20 74  o the right of t
69a0: 68 65 20 41 53 20 6b 65 79 77 6f 72 64 20 61 73  he AS keyword as
69b0: 20 74 68 65 0a 20 20 63 6f 6c 75 6d 6e 20 6e 61   the.  column na
69c0: 6d 65 2e 20 20 49 66 20 74 68 65 20 72 65 73 75  me.  If the resu
69d0: 6c 74 20 73 65 74 20 64 6f 65 73 20 6e 6f 74 20  lt set does not 
69e0: 75 73 65 20 61 6e 20 41 53 20 63 6c 61 75 73 65  use an AS clause
69f0: 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 0a 20 20  , then SQLite.  
6a00: 69 73 20 66 72 65 65 20 74 6f 20 6e 61 6d 65 20  is free to name 
6a10: 74 68 65 20 63 6f 6c 75 6d 6e 20 61 6e 79 74 68  the column anyth
6a20: 69 6e 67 20 69 74 20 77 61 6e 74 73 2e 0a 20 20  ing it wants..  
6a30: 53 65 65 20 74 68 65 20 5b 73 71 6c 69 74 65 33  See the [sqlite3
6a40: 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 29 5d 20  _column_name()] 
6a50: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f  documentation fo
6a60: 72 20 66 75 72 74 68 65 72 20 69 6e 66 6f 72 6d  r further inform
6a70: 61 74 69 6f 6e 2e 0a 7d 0a 0a 23 20 45 6e 64 20  ation..}..# End 
6a80: 6f 66 20 71 75 65 73 74 69 6f 6e 73 20 61 6e 64  of questions and
6a90: 20 61 6e 73 77 65 72 73 2e 0a 23 23 23 23 23 23   answers..######
6aa0: 23 23 23 23 23 23 23 0a 0a 68 64 5f 70 75 74 73  #######..hd_puts
6ab0: 20 7b 3c 68 32 3e 46 72 65 71 75 65 6e 74 6c 79   {<h2>Frequently
6ac0: 20 41 73 6b 65 64 20 51 75 65 73 74 69 6f 6e 73   Asked Questions
6ad0: 3c 2f 68 32 3e 7d 0a 0a 68 64 5f 70 75 74 73 20  </h2>}..hd_puts 
6ae0: 7b 3c 6f 6c 20 63 6c 61 73 73 3d 6e 6f 75 6e 64  {<ol class=nound
6af0: 65 72 6c 69 6e 65 3e 7d 0a 66 6f 72 20 7b 73 65  erline>}.for {se
6b00: 74 20 69 20 31 7d 20 7b 24 69 3c 24 63 6e 74 7d  t i 1} {$i<$cnt}
6b10: 20 7b 69 6e 63 72 20 69 7d 20 7b 0a 20 20 68 64   {incr i} {.  hd
6b20: 5f 70 75 74 73 20 22 3c 6c 69 3e 3c 61 20 68 72  _puts "<li><a hr
6b30: 65 66 3d 5c 22 23 71 24 69 5c 22 3e 5b 6c 69 6e  ef=\"#q$i\">[lin
6b40: 64 65 78 20 24 66 61 71 28 24 69 29 20 30 5d 3c  dex $faq($i) 0]<
6b50: 2f 61 3e 3c 2f 6c 69 3e 22 0a 7d 0a 68 64 5f 70  /a></li>".}.hd_p
6b60: 75 74 73 20 7b 3c 2f 6f 6c 3e 7d 0a 0a 66 6f 72  uts {</ol>}..for
6b70: 20 7b 73 65 74 20 69 20 31 7d 20 7b 24 69 3c 24   {set i 1} {$i<$
6b80: 63 6e 74 7d 20 7b 69 6e 63 72 20 69 7d 20 7b 0a  cnt} {incr i} {.
6b90: 20 20 68 64 5f 66 72 61 67 6d 65 6e 74 20 71 24    hd_fragment q$
6ba0: 69 0a 20 20 68 64 5f 70 75 74 73 20 22 3c 70 3e  i.  hd_puts "<p>
6bb0: 3c 62 3e 28 24 69 29 20 5b 6c 69 6e 64 65 78 20  <b>($i) [lindex 
6bc0: 24 66 61 71 28 24 69 29 20 30 5d 3c 2f 62 3e 3c  $faq($i) 0]</b><
6bd0: 2f 70 3e 5c 6e 22 0a 20 20 68 64 5f 72 65 73 6f  /p>\n".  hd_reso
6be0: 6c 76 65 20 22 3c 62 6c 6f 63 6b 71 75 6f 74 65  lve "<blockquote
6bf0: 3e 5b 6c 69 6e 64 65 78 20 24 66 61 71 28 24 69  >[lindex $faq($i
6c00: 29 20 31 5d 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  ) 1]</blockquote
6c10: 3e 3c 2f 6c 69 3e 5c 6e 22 0a 7d 0a 68 64 5f 70  ></li>\n".}.hd_p
6c20: 75 74 73 20 7b 3c 2f 6f 6c 3e 7d 0a 3c 2f 74 63  uts {</ol>}.</tc
6c30: 6c 3e 0a                                         l>.