/ Hex Artifact Content
Login

Artifact 705c986e40775cc3d92a1676dcbb55f00f0459c5:


0000: 23 0a 23 20 52 75 6e 20 74 68 69 73 20 73 63 72  #.# Run this scr
0010: 69 70 74 20 74 6f 20 67 65 6e 65 72 61 74 65 64  ipt to generated
0020: 20 61 20 66 61 71 2e 68 74 6d 6c 20 6f 75 74 70   a faq.html outp
0030: 75 74 20 66 69 6c 65 0a 23 0a 73 65 74 20 72 63  ut file.#.set rc
0040: 73 69 64 20 7b 24 49 64 3a 20 66 61 71 2e 74 63  sid {$Id: faq.tc
0050: 6c 2c 76 20 31 2e 33 36 20 32 30 30 36 2f 30 34  l,v 1.36 2006/04
0060: 2f 30 35 20 30 31 3a 30 32 3a 30 38 20 64 72 68  /05 01:02:08 drh
0070: 20 45 78 70 20 24 7d 0a 73 6f 75 72 63 65 20 63   Exp $}.source c
0080: 6f 6d 6d 6f 6e 2e 74 63 6c 0a 68 65 61 64 65 72  ommon.tcl.header
0090: 20 7b 53 51 4c 69 74 65 20 46 72 65 71 75 65 6e   {SQLite Frequen
00a0: 74 6c 79 20 41 73 6b 65 64 20 51 75 65 73 74 69  tly Asked Questi
00b0: 6f 6e 73 3c 2f 74 69 74 6c 65 3e 7d 0a 0a 73 65  ons</title>}..se
00c0: 74 20 63 6e 74 20 31 0a 70 72 6f 63 20 66 61 71  t cnt 1.proc faq
00d0: 20 7b 71 75 65 73 74 69 6f 6e 20 61 6e 73 77 65   {question answe
00e0: 72 7d 20 7b 0a 20 20 73 65 74 20 3a 3a 66 61 71  r} {.  set ::faq
00f0: 28 24 3a 3a 63 6e 74 29 20 5b 6c 69 73 74 20 5b  ($::cnt) [list [
0100: 73 74 72 69 6e 67 20 74 72 69 6d 20 24 71 75 65  string trim $que
0110: 73 74 69 6f 6e 5d 20 5b 73 74 72 69 6e 67 20 74  stion] [string t
0120: 72 69 6d 20 24 61 6e 73 77 65 72 5d 5d 0a 20 20  rim $answer]].  
0130: 69 6e 63 72 20 3a 3a 63 6e 74 0a 7d 0a 0a 23 23  incr ::cnt.}..##
0140: 23 23 23 23 23 23 23 23 23 23 23 0a 23 20 45 6e  ###########.# En
0150: 74 65 72 20 71 75 65 73 74 69 6f 6e 73 20 61 6e  ter questions an
0160: 64 20 61 6e 73 77 65 72 73 20 68 65 72 65 2e 0a  d answers here..
0170: 0a 66 61 71 20 7b 0a 20 20 48 6f 77 20 64 6f 20  .faq {.  How do 
0180: 49 20 63 72 65 61 74 65 20 61 6e 20 41 55 54 4f  I create an AUTO
0190: 49 4e 43 52 45 4d 45 4e 54 20 66 69 65 6c 64 2e  INCREMENT field.
01a0: 0a 7d 20 7b 0a 20 20 3c 70 3e 53 68 6f 72 74 20  .} {.  <p>Short 
01b0: 61 6e 73 77 65 72 3a 20 41 20 63 6f 6c 75 6d 6e  answer: A column
01c0: 20 64 65 63 6c 61 72 65 64 20 49 4e 54 45 47 45   declared INTEGE
01d0: 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 77 69  R PRIMARY KEY wi
01e0: 6c 6c 0a 20 20 61 75 74 6f 69 6e 63 72 65 6d 65  ll.  autoincreme
01f0: 6e 74 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 48 65  nt.</p>..  <p>He
0200: 72 65 20 69 73 20 74 68 65 20 6c 6f 6e 67 20 61  re is the long a
0210: 6e 73 77 65 72 3a 0a 20 20 49 66 20 79 6f 75 20  nswer:.  If you 
0220: 64 65 63 6c 61 72 65 20 61 20 63 6f 6c 75 6d 6e  declare a column
0230: 20 6f 66 20 61 20 74 61 62 6c 65 20 74 6f 20 62   of a table to b
0240: 65 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52  e INTEGER PRIMAR
0250: 59 20 4b 45 59 2c 20 74 68 65 6e 0a 20 20 77 68  Y KEY, then.  wh
0260: 65 6e 65 76 65 72 20 79 6f 75 20 69 6e 73 65 72  enever you inser
0270: 74 20 61 20 4e 55 4c 4c 0a 20 20 69 6e 74 6f 20  t a NULL.  into 
0280: 74 68 61 74 20 63 6f 6c 75 6d 6e 20 6f 66 20 74  that column of t
0290: 68 65 20 74 61 62 6c 65 2c 20 74 68 65 20 4e 55  he table, the NU
02a0: 4c 4c 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61  LL is automatica
02b0: 6c 6c 79 20 63 6f 6e 76 65 72 74 65 64 0a 20 20  lly converted.  
02c0: 69 6e 74 6f 20 61 6e 20 69 6e 74 65 67 65 72 20  into an integer 
02d0: 77 68 69 63 68 20 69 73 20 6f 6e 65 20 67 72 65  which is one gre
02e0: 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 6c 61  ater than the la
02f0: 72 67 65 73 74 20 76 61 6c 75 65 20 6f 66 20 74  rgest value of t
0300: 68 61 74 0a 20 20 63 6f 6c 75 6d 6e 20 6f 76 65  hat.  column ove
0310: 72 20 61 6c 6c 20 6f 74 68 65 72 20 72 6f 77 73  r all other rows
0320: 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2c 20 6f   in the table, o
0330: 72 20 31 20 69 66 20 74 68 65 20 74 61 62 6c 65  r 1 if the table
0340: 20 69 73 20 65 6d 70 74 79 2e 0a 20 20 28 49 66   is empty..  (If
0350: 20 74 68 65 20 6c 61 72 67 65 73 74 20 70 6f 73   the largest pos
0360: 73 69 62 6c 65 20 69 6e 74 65 67 65 72 20 6b 65  sible integer ke
0370: 79 2c 20 39 32 32 33 33 37 32 30 33 36 38 35 34  y, 9223372036854
0380: 37 37 35 38 30 37 2c 20 74 68 65 6e 20 61 6e 0a  775807, then an.
0390: 20 20 75 6e 75 73 65 64 20 6b 65 79 20 76 61 6c    unused key val
03a0: 75 65 20 69 73 20 63 68 6f 73 65 6e 20 61 74 20  ue is chosen at 
03b0: 72 61 6e 64 6f 6d 2e 29 0a 20 20 46 6f 72 20 65  random.).  For e
03c0: 78 61 6d 70 6c 65 2c 20 73 75 70 70 6f 73 65 20  xample, suppose 
03d0: 79 6f 75 20 68 61 76 65 20 61 20 74 61 62 6c 65  you have a table
03e0: 20 6c 69 6b 65 20 74 68 69 73 3a 0a 3c 62 6c 6f   like this:.<blo
03f0: 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 43 52  ckquote><pre>.CR
0400: 45 41 54 45 20 54 41 42 4c 45 20 74 31 28 0a 20  EATE TABLE t1(. 
0410: 20 61 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41   a INTEGER PRIMA
0420: 52 59 20 4b 45 59 2c 0a 20 20 62 20 49 4e 54 45  RY KEY,.  b INTE
0430: 47 45 52 0a 29 3b 0a 3c 2f 70 72 65 3e 3c 2f 62  GER.);.</pre></b
0440: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 3c 70 3e  lockquote>.  <p>
0450: 57 69 74 68 20 74 68 69 73 20 74 61 62 6c 65 2c  With this table,
0460: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 3c 2f   the statement</
0470: 70 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c  p>.<blockquote><
0480: 70 72 65 3e 0a 49 4e 53 45 52 54 20 49 4e 54 4f  pre>.INSERT INTO
0490: 20 74 31 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c   t1 VALUES(NULL,
04a0: 31 32 33 29 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c  123);.</pre></bl
04b0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 3c 70 3e 69  ockquote>.  <p>i
04c0: 73 20 6c 6f 67 69 63 61 6c 6c 79 20 65 71 75 69  s logically equi
04d0: 76 61 6c 65 6e 74 20 74 6f 20 73 61 79 69 6e 67  valent to saying
04e0: 3a 3c 2f 70 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74  :</p>.<blockquot
04f0: 65 3e 3c 70 72 65 3e 0a 49 4e 53 45 52 54 20 49  e><pre>.INSERT I
0500: 4e 54 4f 20 74 31 20 56 41 4c 55 45 53 28 28 53  NTO t1 VALUES((S
0510: 45 4c 45 43 54 20 6d 61 78 28 61 29 20 46 52 4f  ELECT max(a) FRO
0520: 4d 20 74 31 29 2b 31 2c 31 32 33 29 3b 0a 3c 2f  M t1)+1,123);.</
0530: 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  pre></blockquote
0540: 3e 0a 0a 20 20 3c 70 3e 54 68 65 72 65 20 69 73  >..  <p>There is
0550: 20 61 20 6e 65 77 20 41 50 49 20 66 75 6e 63 74   a new API funct
0560: 69 6f 6e 20 6e 61 6d 65 64 0a 20 20 3c 61 20 68  ion named.  <a h
0570: 72 65 66 3d 22 63 61 70 69 33 72 65 66 2e 68 74  ref="capi3ref.ht
0580: 6d 6c 23 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f  ml#sqlite3_last_
0590: 69 6e 73 65 72 74 5f 72 6f 77 69 64 22 3e 0a 20  insert_rowid">. 
05a0: 20 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e   sqlite3_last_in
05b0: 73 65 72 74 5f 72 6f 77 69 64 28 29 3c 2f 61 3e  sert_rowid()</a>
05c0: 20 77 68 69 63 68 20 77 69 6c 6c 20 72 65 74 75   which will retu
05d0: 72 6e 20 74 68 65 20 69 6e 74 65 67 65 72 20 6b  rn the integer k
05e0: 65 79 0a 20 20 66 6f 72 20 74 68 65 20 6d 6f 73  ey.  for the mos
05f0: 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 20  t recent insert 
0600: 6f 70 65 72 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  operation.</p>..
0610: 20 20 3c 70 3e 4e 6f 74 65 20 74 68 61 74 20 74    <p>Note that t
0620: 68 65 20 69 6e 74 65 67 65 72 20 6b 65 79 20 69  he integer key i
0630: 73 20 6f 6e 65 20 67 72 65 61 74 65 72 20 74 68  s one greater th
0640: 61 6e 20 74 68 65 20 6c 61 72 67 65 73 74 0a 20  an the largest. 
0650: 20 6b 65 79 20 74 68 61 74 20 77 61 73 20 69 6e   key that was in
0660: 20 74 68 65 20 74 61 62 6c 65 20 6a 75 73 74 20   the table just 
0670: 70 72 69 6f 72 20 74 6f 20 74 68 65 20 69 6e 73  prior to the ins
0680: 65 72 74 2e 20 20 54 68 65 20 6e 65 77 20 6b 65  ert.  The new ke
0690: 79 0a 20 20 77 69 6c 6c 20 62 65 20 75 6e 69 71  y.  will be uniq
06a0: 75 65 20 6f 76 65 72 20 61 6c 6c 20 6b 65 79 73  ue over all keys
06b0: 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 68   currently in th
06c0: 65 20 74 61 62 6c 65 2c 20 62 75 74 20 69 74 20  e table, but it 
06d0: 6d 69 67 68 74 0a 20 20 6f 76 65 72 6c 61 70 20  might.  overlap 
06e0: 77 69 74 68 20 6b 65 79 73 20 74 68 61 74 20 68  with keys that h
06f0: 61 76 65 20 62 65 65 6e 20 70 72 65 76 69 6f 75  ave been previou
0700: 73 6c 79 20 64 65 6c 65 74 65 64 20 66 72 6f 6d  sly deleted from
0710: 20 74 68 65 0a 20 20 74 61 62 6c 65 2e 20 20 54   the.  table.  T
0720: 6f 20 63 72 65 61 74 65 20 6b 65 79 73 20 74 68  o create keys th
0730: 61 74 20 61 72 65 20 75 6e 69 71 75 65 20 6f 76  at are unique ov
0740: 65 72 20 74 68 65 20 6c 69 66 65 74 69 6d 65 20  er the lifetime 
0750: 6f 66 20 74 68 65 0a 20 20 74 61 62 6c 65 2c 20  of the.  table, 
0760: 61 64 64 20 74 68 65 20 41 55 54 4f 49 4e 43 52  add the AUTOINCR
0770: 45 4d 45 4e 54 20 6b 65 79 77 6f 72 64 20 74 6f  EMENT keyword to
0780: 20 74 68 65 20 49 4e 54 45 47 45 52 20 50 52 49   the INTEGER PRI
0790: 4d 41 52 59 20 4b 45 59 0a 20 20 64 65 63 6c 61  MARY KEY.  decla
07a0: 72 61 74 69 6f 6e 2e 20 20 54 68 65 6e 20 74 68  ration.  Then th
07b0: 65 20 6b 65 79 20 63 68 6f 73 65 6e 20 77 69 6c  e key chosen wil
07c0: 6c 20 62 65 20 6f 6e 65 20 6d 6f 72 65 20 74 68  l be one more th
07d0: 61 6e 20 74 68 61 6e 20 74 68 65 0a 20 20 6c 61  an than the.  la
07e0: 72 67 65 73 74 20 6b 65 79 20 74 68 61 74 20 68  rgest key that h
07f0: 61 73 20 65 76 65 72 20 65 78 69 73 74 65 64 20  as ever existed 
0800: 69 6e 20 74 68 61 74 20 74 61 62 6c 65 2e 20 20  in that table.  
0810: 49 66 20 74 68 65 20 6c 61 72 67 65 73 74 0a 20  If the largest. 
0820: 20 70 6f 73 73 69 62 6c 65 20 6b 65 79 20 68 61   possible key ha
0830: 73 20 70 72 65 76 69 6f 75 73 6c 79 20 65 78 69  s previously exi
0840: 73 74 65 64 20 69 6e 20 74 68 61 74 20 74 61 62  sted in that tab
0850: 6c 65 2c 20 74 68 65 6e 20 74 68 65 20 49 4e 53  le, then the INS
0860: 45 52 54 0a 20 20 77 69 6c 6c 20 66 61 69 6c 20  ERT.  will fail 
0870: 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f 46  with an SQLITE_F
0880: 55 4c 4c 20 65 72 72 6f 72 20 63 6f 64 65 2e 3c  ULL error code.<
0890: 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 57  /p>.}..faq {.  W
08a0: 68 61 74 20 64 61 74 61 74 79 70 65 73 20 64 6f  hat datatypes do
08b0: 65 73 20 53 51 4c 69 74 65 20 73 75 70 70 6f 72  es SQLite suppor
08c0: 74 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 53 65 65 20  t?.} {.  <p>See 
08d0: 3c 61 20 68 72 65 66 3d 22 64 61 74 61 74 79 70  <a href="datatyp
08e0: 65 33 2e 68 74 6d 6c 22 3e 68 74 74 70 3a 2f 2f  e3.html">http://
08f0: 77 77 77 2e 73 71 6c 69 74 65 2e 6f 72 67 2f 64  www.sqlite.org/d
0900: 61 74 61 74 79 70 65 33 2e 68 74 6d 6c 3c 2f 61  atatype3.html</a
0910: 3e 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a  >.</p>.}..faq {.
0920: 20 20 53 51 4c 69 74 65 20 6c 65 74 73 20 6d 65    SQLite lets me
0930: 20 69 6e 73 65 72 74 20 61 20 73 74 72 69 6e 67   insert a string
0940: 20 69 6e 74 6f 20 61 20 64 61 74 61 62 61 73 65   into a database
0950: 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 79 70 65 20   column of type 
0960: 69 6e 74 65 67 65 72 21 0a 7d 20 7b 0a 20 20 3c  integer!.} {.  <
0970: 70 3e 54 68 69 73 20 69 73 20 61 20 66 65 61 74  p>This is a feat
0980: 75 72 65 2c 20 6e 6f 74 20 61 20 62 75 67 2e 20  ure, not a bug. 
0990: 20 53 51 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74   SQLite does not
09a0: 20 65 6e 66 6f 72 63 65 20 64 61 74 61 20 74 79   enforce data ty
09b0: 70 65 0a 20 20 63 6f 6e 73 74 72 61 69 6e 74 73  pe.  constraints
09c0: 2e 20 20 41 6e 79 20 64 61 74 61 20 63 61 6e 20  .  Any data can 
09d0: 62 65 0a 20 20 69 6e 73 65 72 74 65 64 20 69 6e  be.  inserted in
09e0: 74 6f 20 61 6e 79 20 63 6f 6c 75 6d 6e 2e 20 20  to any column.  
09f0: 59 6f 75 20 63 61 6e 20 70 75 74 20 61 72 62 69  You can put arbi
0a00: 74 72 61 72 79 20 6c 65 6e 67 74 68 20 73 74 72  trary length str
0a10: 69 6e 67 73 20 69 6e 74 6f 0a 20 20 69 6e 74 65  ings into.  inte
0a20: 67 65 72 20 63 6f 6c 75 6d 6e 73 2c 20 66 6c 6f  ger columns, flo
0a30: 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e 75 6d 62  ating point numb
0a40: 65 72 73 20 69 6e 20 62 6f 6f 6c 65 61 6e 20 63  ers in boolean c
0a50: 6f 6c 75 6d 6e 73 2c 20 6f 72 20 64 61 74 65 73  olumns, or dates
0a60: 0a 20 20 69 6e 20 63 68 61 72 61 63 74 65 72 20  .  in character 
0a70: 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65 20 64 61  columns.  The da
0a80: 74 61 74 79 70 65 20 79 6f 75 20 61 73 73 69 67  tatype you assig
0a90: 6e 20 74 6f 20 61 20 63 6f 6c 75 6d 6e 20 69 6e  n to a column in
0aa0: 20 74 68 65 0a 20 20 43 52 45 41 54 45 20 54 41   the.  CREATE TA
0ab0: 42 4c 45 20 63 6f 6d 6d 61 6e 64 20 64 6f 65 73  BLE command does
0ac0: 20 6e 6f 74 20 72 65 73 74 72 69 63 74 20 77 68   not restrict wh
0ad0: 61 74 20 64 61 74 61 20 63 61 6e 20 62 65 20 70  at data can be p
0ae0: 75 74 20 69 6e 74 6f 0a 20 20 74 68 61 74 20 63  ut into.  that c
0af0: 6f 6c 75 6d 6e 2e 20 20 45 76 65 72 79 20 63 6f  olumn.  Every co
0b00: 6c 75 6d 6e 20 69 73 20 61 62 6c 65 20 74 6f 20  lumn is able to 
0b10: 68 6f 6c 64 0a 20 20 61 6e 20 61 72 62 69 74 72  hold.  an arbitr
0b20: 61 72 79 20 6c 65 6e 67 74 68 20 73 74 72 69 6e  ary length strin
0b30: 67 2e 20 20 28 54 68 65 72 65 20 69 73 20 6f 6e  g.  (There is on
0b40: 65 20 65 78 63 65 70 74 69 6f 6e 3a 20 43 6f 6c  e exception: Col
0b50: 75 6d 6e 73 20 6f 66 0a 20 20 74 79 70 65 20 49  umns of.  type I
0b60: 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b  NTEGER PRIMARY K
0b70: 45 59 20 6d 61 79 20 6f 6e 6c 79 20 68 6f 6c 64  EY may only hold
0b80: 20 61 20 36 34 2d 62 69 74 20 73 69 67 6e 65 64   a 64-bit signed
0b90: 20 69 6e 74 65 67 65 72 2e 0a 20 20 41 6e 20 65   integer..  An e
0ba0: 72 72 6f 72 20 77 69 6c 6c 20 72 65 73 75 6c 74  rror will result
0bb0: 0a 20 20 69 66 20 79 6f 75 20 74 72 79 20 74 6f  .  if you try to
0bc0: 20 70 75 74 20 61 6e 79 74 68 69 6e 67 20 6f 74   put anything ot
0bd0: 68 65 72 20 74 68 61 6e 20 61 6e 20 69 6e 74 65  her than an inte
0be0: 67 65 72 20 69 6e 74 6f 20 61 6e 0a 20 20 49 4e  ger into an.  IN
0bf0: 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45  TEGER PRIMARY KE
0c00: 59 20 63 6f 6c 75 6d 6e 2e 29 3c 2f 70 3e 0a 0a  Y column.)</p>..
0c10: 20 20 3c 70 3e 42 75 74 20 53 51 4c 69 74 65 20    <p>But SQLite 
0c20: 64 6f 65 73 20 75 73 65 20 74 68 65 20 64 65 63  does use the dec
0c30: 6c 61 72 65 64 20 74 79 70 65 20 6f 66 20 61 20  lared type of a 
0c40: 63 6f 6c 75 6d 6e 20 61 73 20 61 20 68 69 6e 74  column as a hint
0c50: 0a 20 20 74 68 61 74 20 79 6f 75 20 70 72 65 66  .  that you pref
0c60: 65 72 20 76 61 6c 75 65 73 20 69 6e 20 74 68 61  er values in tha
0c70: 74 20 66 6f 72 6d 61 74 2e 20 20 53 6f 2c 20 66  t format.  So, f
0c80: 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61  or example, if a
0c90: 0a 20 20 63 6f 6c 75 6d 6e 20 69 73 20 6f 66 20  .  column is of 
0ca0: 74 79 70 65 20 49 4e 54 45 47 45 52 20 61 6e 64  type INTEGER and
0cb0: 20 79 6f 75 20 74 72 79 20 74 6f 20 69 6e 73 65   you try to inse
0cc0: 72 74 20 61 20 73 74 72 69 6e 67 20 69 6e 74 6f  rt a string into
0cd0: 0a 20 20 74 68 61 74 20 63 6f 6c 75 6d 6e 2c 20  .  that column, 
0ce0: 53 51 4c 69 74 65 20 77 69 6c 6c 20 61 74 74 65  SQLite will atte
0cf0: 6d 70 74 20 74 6f 20 63 6f 6e 76 65 72 74 20 74  mpt to convert t
0d00: 68 65 20 73 74 72 69 6e 67 20 69 6e 74 6f 20 61  he string into a
0d10: 6e 0a 20 20 69 6e 74 65 67 65 72 2e 20 20 49 66  n.  integer.  If
0d20: 20 69 74 20 63 61 6e 2c 20 69 74 20 69 6e 73 65   it can, it inse
0d30: 72 74 73 20 74 68 65 20 69 6e 74 65 67 65 72 20  rts the integer 
0d40: 69 6e 73 74 65 61 64 2e 20 20 49 66 20 6e 6f 74  instead.  If not
0d50: 2c 0a 20 20 69 74 20 69 6e 73 65 72 74 73 20 74  ,.  it inserts t
0d60: 68 65 20 73 74 72 69 6e 67 2e 20 20 54 68 69 73  he string.  This
0d70: 20 66 65 61 74 75 72 65 20 69 73 20 73 6f 6d 65   feature is some
0d80: 74 69 6d 65 73 0a 20 20 63 61 6c 6c 20 3c 61 20  times.  call <a 
0d90: 68 72 65 66 3d 22 64 61 74 61 74 79 70 65 33 2e  href="datatype3.
0da0: 68 74 6d 6c 23 61 66 66 69 6e 69 74 79 22 3e 74  html#affinity">t
0db0: 79 70 65 20 6f 72 20 63 6f 6c 75 6d 6e 20 61 66  ype or column af
0dc0: 66 69 6e 69 74 79 3c 2f 61 3e 2e 0a 20 20 3c 2f  finity</a>..  </
0dd0: 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 57 68  p>.}..faq {.  Wh
0de0: 79 20 64 6f 65 73 20 53 51 4c 69 74 65 20 74 68  y does SQLite th
0df0: 69 6e 6b 20 74 68 61 74 20 74 68 65 20 65 78 70  ink that the exp
0e00: 72 65 73 73 69 6f 6e 20 27 30 27 3d 3d 27 30 30  ression '0'=='00
0e10: 27 20 69 73 20 54 52 55 45 3f 0a 7d 20 7b 0a 20  ' is TRUE?.} {. 
0e20: 20 3c 70 3e 41 73 20 6f 66 20 76 65 72 73 69 6f   <p>As of versio
0e30: 6e 20 32 2e 37 2e 30 2c 20 69 74 20 64 6f 65 73  n 2.7.0, it does
0e40: 6e 27 74 2e 20 20 53 65 65 20 74 68 65 20 64 6f  n't.  See the do
0e50: 63 75 6d 65 6e 74 20 6f 6e 0a 20 20 3c 61 20 68  cument on.  <a h
0e60: 72 65 66 3d 22 64 61 74 61 74 79 70 65 33 2e 68  ref="datatype3.h
0e70: 74 6d 6c 22 3e 64 61 74 61 74 79 70 65 73 20 69  tml">datatypes i
0e80: 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  n SQLite version
0e90: 20 33 3c 2f 61 3e 0a 20 20 66 6f 72 20 64 65 74   3</a>.  for det
0ea0: 61 69 6c 73 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71  ails.</p>.}..faq
0eb0: 20 7b 0a 20 20 57 68 79 20 64 6f 65 73 6e 27 74   {.  Why doesn't
0ec0: 20 53 51 4c 69 74 65 20 61 6c 6c 6f 77 20 6d 65   SQLite allow me
0ed0: 20 74 6f 20 75 73 65 20 27 30 27 20 61 6e 64 20   to use '0' and 
0ee0: 27 30 2e 30 27 20 61 73 20 74 68 65 20 70 72 69  '0.0' as the pri
0ef0: 6d 61 72 79 0a 20 20 6b 65 79 20 6f 6e 20 74 77  mary.  key on tw
0f00: 6f 20 64 69 66 66 65 72 65 6e 74 20 72 6f 77 73  o different rows
0f10: 20 6f 66 20 74 68 65 20 73 61 6d 65 20 74 61 62   of the same tab
0f20: 6c 65 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 59 6f 75  le?.} {.  <p>You
0f30: 72 20 70 72 69 6d 61 72 79 20 6b 65 79 20 6d 75  r primary key mu
0f40: 73 74 20 68 61 76 65 20 61 20 6e 75 6d 65 72 69  st have a numeri
0f50: 63 20 74 79 70 65 2e 20 20 43 68 61 6e 67 65 20  c type.  Change 
0f60: 74 68 65 20 64 61 74 61 74 79 70 65 20 6f 66 0a  the datatype of.
0f70: 20 20 79 6f 75 72 20 70 72 69 6d 61 72 79 20 6b    your primary k
0f80: 65 79 20 74 6f 20 54 45 58 54 20 61 6e 64 20 69  ey to TEXT and i
0f90: 74 20 73 68 6f 75 6c 64 20 77 6f 72 6b 2e 3c 2f  t should work.</
0fa0: 70 3e 0a 0a 20 20 3c 70 3e 45 76 65 72 79 20 72  p>..  <p>Every r
0fb0: 6f 77 20 6d 75 73 74 20 68 61 76 65 20 61 20 75  ow must have a u
0fc0: 6e 69 71 75 65 20 70 72 69 6d 61 72 79 20 6b 65  nique primary ke
0fd0: 79 2e 20 20 46 6f 72 20 61 20 63 6f 6c 75 6d 6e  y.  For a column
0fe0: 20 77 69 74 68 20 61 0a 20 20 6e 75 6d 65 72 69   with a.  numeri
0ff0: 63 20 74 79 70 65 2c 20 53 51 4c 69 74 65 20 74  c type, SQLite t
1000: 68 69 6e 6b 73 20 74 68 61 74 20 3c 62 3e 27 30  hinks that <b>'0
1010: 27 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 27 30 2e  '</b> and <b>'0.
1020: 30 27 3c 2f 62 3e 20 61 72 65 20 74 68 65 0a 20  0'</b> are the. 
1030: 20 73 61 6d 65 20 76 61 6c 75 65 20 62 65 63 61   same value beca
1040: 75 73 65 20 74 68 65 79 20 63 6f 6d 70 61 72 65  use they compare
1050: 20 65 71 75 61 6c 20 74 6f 20 6f 6e 65 20 61 6e   equal to one an
1060: 6f 74 68 65 72 20 6e 75 6d 65 72 69 63 61 6c 6c  other numericall
1070: 79 2e 0a 20 20 28 53 65 65 20 74 68 65 20 70 72  y..  (See the pr
1080: 65 76 69 6f 75 73 20 71 75 65 73 74 69 6f 6e 2e  evious question.
1090: 29 20 20 48 65 6e 63 65 20 74 68 65 20 76 61 6c  )  Hence the val
10a0: 75 65 73 20 61 72 65 20 6e 6f 74 20 75 6e 69 71  ues are not uniq
10b0: 75 65 2e 3c 2f 70 3e 0a 7d 0a 20 20 20 20 20 20  ue.</p>.}.      
10c0: 20 20 0a 66 61 71 20 7b 0a 20 20 4d 79 20 6c 69    .faq {.  My li
10d0: 6e 75 78 20 62 6f 78 20 69 73 20 6e 6f 74 20 61  nux box is not a
10e0: 62 6c 65 20 74 6f 20 72 65 61 64 20 61 6e 20 53  ble to read an S
10f0: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 74  QLite database t
1100: 68 61 74 20 77 61 73 20 63 72 65 61 74 65 64 0a  hat was created.
1110: 20 20 6f 6e 20 6d 79 20 53 70 61 72 63 53 74 61    on my SparcSta
1120: 74 69 6f 6e 2e 0a 7d 20 7b 0a 20 20 3c 70 3e 59  tion..} {.  <p>Y
1130: 6f 75 20 6e 65 65 64 20 74 6f 20 75 70 67 72 61  ou need to upgra
1140: 64 65 20 79 6f 75 72 20 53 51 4c 69 74 65 20 6c  de your SQLite l
1150: 69 62 72 61 72 79 20 74 6f 20 76 65 72 73 69 6f  ibrary to versio
1160: 6e 20 32 2e 36 2e 33 20 6f 72 20 6c 61 74 65 72  n 2.6.3 or later
1170: 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 54 68 65 20  .</p>..  <p>The 
1180: 78 38 36 20 70 72 6f 63 65 73 73 6f 72 20 6f 6e  x86 processor on
1190: 20 79 6f 75 72 20 6c 69 6e 75 78 20 62 6f 78 20   your linux box 
11a0: 69 73 20 6c 69 74 74 6c 65 2d 65 6e 64 69 61 6e  is little-endian
11b0: 20 28 6d 65 61 6e 69 6e 67 20 74 68 61 74 0a 20   (meaning that. 
11c0: 20 74 68 65 20 6c 65 61 73 74 20 73 69 67 6e 69   the least signi
11d0: 66 69 63 61 6e 74 20 62 79 74 65 20 6f 66 20 69  ficant byte of i
11e0: 6e 74 65 67 65 72 73 20 63 6f 6d 65 73 20 66 69  ntegers comes fi
11f0: 72 73 74 29 20 62 75 74 20 74 68 65 20 53 70 61  rst) but the Spa
1200: 72 63 20 69 73 0a 20 20 62 69 67 2d 65 6e 64 69  rc is.  big-endi
1210: 61 6e 20 28 74 68 65 20 6d 6f 73 74 20 73 69 67  an (the most sig
1220: 6e 69 66 69 63 61 6e 74 20 62 79 74 65 73 20 63  nificant bytes c
1230: 6f 6d 65 73 20 66 69 72 73 74 29 2e 20 20 53 51  omes first).  SQ
1240: 4c 69 74 65 20 64 61 74 61 62 61 73 65 73 0a 20  Lite databases. 
1250: 20 63 72 65 61 74 65 64 20 6f 6e 20 61 20 6c 69   created on a li
1260: 74 74 6c 65 2d 65 6e 64 69 61 6e 20 61 72 63 68  ttle-endian arch
1270: 69 74 65 63 74 75 72 65 20 63 61 6e 6e 6f 74 20  itecture cannot 
1280: 62 65 20 6f 6e 20 61 20 62 69 67 2d 65 6e 64 69  be on a big-endi
1290: 61 6e 0a 20 20 6d 61 63 68 69 6e 65 20 62 79 20  an.  machine by 
12a0: 76 65 72 73 69 6f 6e 20 32 2e 36 2e 32 20 6f 72  version 2.6.2 or
12b0: 20 65 61 72 6c 69 65 72 20 6f 66 20 53 51 4c 69   earlier of SQLi
12c0: 74 65 2e 20 20 42 65 67 69 6e 6e 69 6e 67 20 77  te.  Beginning w
12d0: 69 74 68 0a 20 20 76 65 72 73 69 6f 6e 20 32 2e  ith.  version 2.
12e0: 36 2e 33 2c 20 53 51 4c 69 74 65 20 73 68 6f 75  6.3, SQLite shou
12f0: 6c 64 20 62 65 20 61 62 6c 65 20 74 6f 20 72 65  ld be able to re
1300: 61 64 20 61 6e 64 20 77 72 69 74 65 20 64 61 74  ad and write dat
1310: 61 62 61 73 65 20 66 69 6c 65 73 0a 20 20 72 65  abase files.  re
1320: 67 61 72 64 6c 65 73 73 20 6f 66 20 62 79 74 65  gardless of byte
1330: 20 6f 72 64 65 72 20 6f 66 20 74 68 65 20 6d 61   order of the ma
1340: 63 68 69 6e 65 20 6f 6e 20 77 68 69 63 68 20 74  chine on which t
1350: 68 65 20 66 69 6c 65 20 77 61 73 20 63 72 65 61  he file was crea
1360: 74 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20  ted.</p>.}..faq 
1370: 7b 0a 20 20 43 61 6e 20 6d 75 6c 74 69 70 6c 65  {.  Can multiple
1380: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 6f 72   applications or
1390: 20 6d 75 6c 74 69 70 6c 65 20 69 6e 73 74 61 6e   multiple instan
13a0: 63 65 73 20 6f 66 20 74 68 65 20 73 61 6d 65 0a  ces of the same.
13b0: 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 61 63    application ac
13c0: 63 65 73 73 20 61 20 73 69 6e 67 6c 65 20 64 61  cess a single da
13d0: 74 61 62 61 73 65 20 66 69 6c 65 20 61 74 20 74  tabase file at t
13e0: 68 65 20 73 61 6d 65 20 74 69 6d 65 3f 0a 7d 20  he same time?.} 
13f0: 7b 0a 20 20 3c 70 3e 4d 75 6c 74 69 70 6c 65 20  {.  <p>Multiple 
1400: 70 72 6f 63 65 73 73 65 73 20 63 61 6e 20 68 61  processes can ha
1410: 76 65 20 74 68 65 20 73 61 6d 65 20 64 61 74 61  ve the same data
1420: 62 61 73 65 20 6f 70 65 6e 20 61 74 20 74 68 65  base open at the
1430: 20 73 61 6d 65 0a 20 20 74 69 6d 65 2e 20 20 4d   same.  time.  M
1440: 75 6c 74 69 70 6c 65 20 70 72 6f 63 65 73 73 65  ultiple processe
1450: 73 20 63 61 6e 20 62 65 20 64 6f 69 6e 67 20 61  s can be doing a
1460: 20 53 45 4c 45 43 54 0a 20 20 61 74 20 74 68 65   SELECT.  at the
1470: 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 42 75 74   same time.  But
1480: 20 6f 6e 6c 79 20 6f 6e 65 20 70 72 6f 63 65 73   only one proces
1490: 73 20 63 61 6e 20 62 65 20 6d 61 6b 69 6e 67 20  s can be making 
14a0: 63 68 61 6e 67 65 73 20 74 6f 0a 20 20 74 68 65  changes to.  the
14b0: 20 64 61 74 61 62 61 73 65 20 61 74 20 61 6e 79   database at any
14c0: 20 6d 6f 6d 65 6e 74 20 69 6e 20 74 69 6d 65 2c   moment in time,
14d0: 20 68 6f 77 65 76 65 72 2e 3c 2f 70 3e 0a 0a 20   however.</p>.. 
14e0: 20 3c 70 3e 53 51 4c 69 74 65 20 75 73 65 73 20   <p>SQLite uses 
14f0: 72 65 61 64 65 72 2f 77 72 69 74 65 72 20 6c 6f  reader/writer lo
1500: 63 6b 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 61  cks to control a
1510: 63 63 65 73 73 20 74 6f 20 74 68 65 20 64 61 74  ccess to the dat
1520: 61 62 61 73 65 2e 0a 20 20 28 55 6e 64 65 72 20  abase..  (Under 
1530: 57 69 6e 39 35 2f 39 38 2f 4d 45 20 77 68 69 63  Win95/98/ME whic
1540: 68 20 6c 61 63 6b 73 20 73 75 70 70 6f 72 74 20  h lacks support 
1550: 66 6f 72 20 72 65 61 64 65 72 2f 77 72 69 74 65  for reader/write
1560: 72 20 6c 6f 63 6b 73 2c 20 61 0a 20 20 70 72 6f  r locks, a.  pro
1570: 62 61 62 69 6c 69 73 74 69 63 20 73 69 6d 75 6c  babilistic simul
1580: 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69 6e  ation is used in
1590: 73 74 65 61 64 2e 29 0a 20 20 42 75 74 20 75 73  stead.).  But us
15a0: 65 20 63 61 75 74 69 6f 6e 3a 20 74 68 69 73 20  e caution: this 
15b0: 6c 6f 63 6b 69 6e 67 20 6d 65 63 68 61 6e 69 73  locking mechanis
15c0: 6d 20 6d 69 67 68 74 0a 20 20 6e 6f 74 20 77 6f  m might.  not wo
15d0: 72 6b 20 63 6f 72 72 65 63 74 6c 79 20 69 66 20  rk correctly if 
15e0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
15f0: 65 20 69 73 20 6b 65 70 74 20 6f 6e 20 61 6e 20  e is kept on an 
1600: 4e 46 53 20 66 69 6c 65 73 79 73 74 65 6d 2e 0a  NFS filesystem..
1610: 20 20 54 68 69 73 20 69 73 20 62 65 63 61 75 73    This is becaus
1620: 65 20 66 63 6e 74 6c 28 29 20 66 69 6c 65 20 6c  e fcntl() file l
1630: 6f 63 6b 69 6e 67 20 69 73 20 62 72 6f 6b 65 6e  ocking is broken
1640: 20 6f 6e 20 6d 61 6e 79 20 4e 46 53 20 69 6d 70   on many NFS imp
1650: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 2e 0a 20 20  lementations..  
1660: 59 6f 75 20 73 68 6f 75 6c 64 20 61 76 6f 69 64  You should avoid
1670: 20 70 75 74 74 69 6e 67 20 53 51 4c 69 74 65 20   putting SQLite 
1680: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 6f  database files o
1690: 6e 20 4e 46 53 20 69 66 20 6d 75 6c 74 69 70 6c  n NFS if multipl
16a0: 65 0a 20 20 70 72 6f 63 65 73 73 65 73 20 6d 69  e.  processes mi
16b0: 67 68 74 20 74 72 79 20 74 6f 20 61 63 63 65 73  ght try to acces
16c0: 73 20 74 68 65 20 66 69 6c 65 20 61 74 20 74 68  s the file at th
16d0: 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 4f 6e  e same time.  On
16e0: 20 57 69 6e 64 6f 77 73 2c 0a 20 20 4d 69 63 72   Windows,.  Micr
16f0: 6f 73 6f 66 74 27 73 20 64 6f 63 75 6d 65 6e 74  osoft's document
1700: 61 74 69 6f 6e 20 73 61 79 73 20 74 68 61 74 20  ation says that 
1710: 6c 6f 63 6b 69 6e 67 20 6d 61 79 20 6e 6f 74 20  locking may not 
1720: 77 6f 72 6b 20 75 6e 64 65 72 20 46 41 54 0a 20  work under FAT. 
1730: 20 66 69 6c 65 73 79 73 74 65 6d 73 20 69 66 20   filesystems if 
1740: 79 6f 75 20 61 72 65 20 6e 6f 74 20 72 75 6e 6e  you are not runn
1750: 69 6e 67 20 74 68 65 20 53 68 61 72 65 2e 65 78  ing the Share.ex
1760: 65 20 64 61 65 6d 6f 6e 2e 20 20 50 65 6f 70 6c  e daemon.  Peopl
1770: 65 20 77 68 6f 0a 20 20 68 61 76 65 20 61 20 6c  e who.  have a l
1780: 6f 74 20 6f 66 20 65 78 70 65 72 69 65 6e 63 65  ot of experience
1790: 20 77 69 74 68 20 57 69 6e 64 6f 77 73 20 74 65   with Windows te
17a0: 6c 6c 20 6d 65 20 74 68 61 74 20 66 69 6c 65 20  ll me that file 
17b0: 6c 6f 63 6b 69 6e 67 20 6f 66 0a 20 20 6e 65 74  locking of.  net
17c0: 77 6f 72 6b 20 66 69 6c 65 73 20 69 73 20 76 65  work files is ve
17d0: 72 79 20 62 75 67 67 79 20 61 6e 64 20 69 73 20  ry buggy and is 
17e0: 6e 6f 74 20 64 65 70 65 6e 64 61 62 6c 65 2e 20  not dependable. 
17f0: 20 49 66 20 77 68 61 74 20 74 68 65 79 0a 20 20   If what they.  
1800: 73 61 79 20 69 73 20 74 72 75 65 2c 20 73 68 61  say is true, sha
1810: 72 69 6e 67 20 61 6e 20 53 51 4c 69 74 65 20 64  ring an SQLite d
1820: 61 74 61 62 61 73 65 20 62 65 74 77 65 65 6e 20  atabase between 
1830: 74 77 6f 20 6f 72 20 6d 6f 72 65 20 57 69 6e 64  two or more Wind
1840: 6f 77 73 0a 20 20 6d 61 63 68 69 6e 65 73 20 6d  ows.  machines m
1850: 69 67 68 74 20 63 61 75 73 65 20 75 6e 65 78 70  ight cause unexp
1860: 65 63 74 65 64 20 70 72 6f 62 6c 65 6d 73 2e 3c  ected problems.<
1870: 2f 70 3e 0a 0a 20 20 3c 70 3e 57 65 20 61 72 65  /p>..  <p>We are
1880: 20 61 77 61 72 65 20 6f 66 20 6e 6f 20 6f 74 68   aware of no oth
1890: 65 72 20 3c 69 3e 65 6d 62 65 64 64 65 64 3c 2f  er <i>embedded</
18a0: 69 3e 20 53 51 4c 20 64 61 74 61 62 61 73 65 20  i> SQL database 
18b0: 65 6e 67 69 6e 65 20 74 68 61 74 0a 20 20 73 75  engine that.  su
18c0: 70 70 6f 72 74 73 20 61 73 20 6d 75 63 68 20 63  pports as much c
18d0: 6f 6e 63 75 72 72 61 6e 63 79 20 61 73 20 53 51  oncurrancy as SQ
18e0: 4c 69 74 65 2e 20 20 53 51 4c 69 74 65 20 61 6c  Lite.  SQLite al
18f0: 6c 6f 77 73 20 6d 75 6c 74 69 70 6c 65 20 70 72  lows multiple pr
1900: 6f 63 65 73 73 65 73 0a 20 20 74 6f 20 68 61 76  ocesses.  to hav
1910: 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  e the database f
1920: 69 6c 65 20 6f 70 65 6e 20 61 74 20 6f 6e 63 65  ile open at once
1930: 2c 20 61 6e 64 20 66 6f 72 20 6d 75 6c 74 69 70  , and for multip
1940: 6c 65 20 70 72 6f 63 65 73 73 65 73 20 74 6f 0a  le processes to.
1950: 20 20 72 65 61 64 20 74 68 65 20 64 61 74 61 62    read the datab
1960: 61 73 65 20 61 74 20 6f 6e 63 65 2e 20 20 57 68  ase at once.  Wh
1970: 65 6e 20 61 6e 79 20 70 72 6f 63 65 73 73 20 77  en any process w
1980: 61 6e 74 73 20 74 6f 20 77 72 69 74 65 2c 20 69  ants to write, i
1990: 74 20 6d 75 73 74 0a 20 20 6c 6f 63 6b 20 74 68  t must.  lock th
19a0: 65 20 65 6e 74 69 72 65 20 64 61 74 61 62 61 73  e entire databas
19b0: 65 20 66 69 6c 65 20 66 6f 72 20 74 68 65 20 64  e file for the d
19c0: 75 72 61 74 69 6f 6e 20 6f 66 20 69 74 73 20 75  uration of its u
19d0: 70 64 61 74 65 2e 20 20 42 75 74 20 74 68 61 74  pdate.  But that
19e0: 0a 20 20 6e 6f 72 6d 61 6c 6c 79 20 6f 6e 6c 79  .  normally only
19f0: 20 74 61 6b 65 73 20 61 20 66 65 77 20 6d 69 6c   takes a few mil
1a00: 6c 69 73 65 63 6f 6e 64 73 2e 20 20 4f 74 68 65  liseconds.  Othe
1a10: 72 20 70 72 6f 63 65 73 73 65 73 20 6a 75 73 74  r processes just
1a20: 20 77 61 69 74 20 6f 6e 0a 20 20 74 68 65 20 77   wait on.  the w
1a30: 72 69 74 65 72 20 74 6f 20 66 69 6e 69 73 68 20  riter to finish 
1a40: 74 68 65 6e 20 63 6f 6e 74 69 6e 75 65 20 61 62  then continue ab
1a50: 6f 75 74 20 74 68 65 69 72 20 62 75 73 69 6e 65  out their busine
1a60: 73 73 2e 20 20 4f 74 68 65 72 20 65 6d 62 65 64  ss.  Other embed
1a70: 64 65 64 0a 20 20 53 51 4c 20 64 61 74 61 62 61  ded.  SQL databa
1a80: 73 65 20 65 6e 67 69 6e 65 73 20 74 79 70 69 63  se engines typic
1a90: 61 6c 6c 79 20 6f 6e 6c 79 20 61 6c 6c 6f 77 20  ally only allow 
1aa0: 61 20 73 69 6e 67 6c 65 20 70 72 6f 63 65 73 73  a single process
1ab0: 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f 0a 20   to connect to. 
1ac0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61 74   the database at
1ad0: 20 6f 6e 63 65 2e 3c 2f 70 3e 0a 0a 20 20 3c 70   once.</p>..  <p
1ae0: 3e 48 6f 77 65 76 65 72 2c 20 63 6c 69 65 6e 74  >However, client
1af0: 2f 73 65 72 76 65 72 20 64 61 74 61 62 61 73 65  /server database
1b00: 20 65 6e 67 69 6e 65 73 20 28 73 75 63 68 20 61   engines (such a
1b10: 73 20 50 6f 73 74 67 72 65 53 51 4c 2c 20 4d 79  s PostgreSQL, My
1b20: 53 51 4c 2c 0a 20 20 6f 72 20 4f 72 61 63 6c 65  SQL,.  or Oracle
1b30: 29 20 75 73 75 61 6c 6c 79 20 73 75 70 70 6f 72  ) usually suppor
1b40: 74 20 61 20 68 69 67 68 65 72 20 6c 65 76 65 6c  t a higher level
1b50: 20 6f 66 20 63 6f 6e 63 75 72 72 65 6e 63 79 20   of concurrency 
1b60: 61 6e 64 20 61 6c 6c 6f 77 0a 20 20 6d 75 6c 74  and allow.  mult
1b70: 69 70 6c 65 20 70 72 6f 63 65 73 73 65 73 20 74  iple processes t
1b80: 6f 20 62 65 20 77 72 69 74 69 6e 67 20 74 6f 20  o be writing to 
1b90: 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73  the same databas
1ba0: 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69  e at the same ti
1bb0: 6d 65 2e 0a 20 20 54 68 69 73 20 69 73 20 70 6f  me..  This is po
1bc0: 73 73 69 62 6c 65 20 69 6e 20 61 20 63 6c 69 65  ssible in a clie
1bd0: 6e 74 2f 73 65 72 76 65 72 20 64 61 74 61 62 61  nt/server databa
1be0: 73 65 20 62 65 63 61 75 73 65 20 74 68 65 72 65  se because there
1bf0: 20 69 73 20 61 6c 77 61 79 73 20 61 0a 20 20 73   is always a.  s
1c00: 69 6e 67 6c 65 20 77 65 6c 6c 2d 63 6f 6e 74 72  ingle well-contr
1c10: 6f 6c 6c 65 64 20 73 65 72 76 65 72 20 70 72 6f  olled server pro
1c20: 63 65 73 73 20 61 76 61 69 6c 61 62 6c 65 20 74  cess available t
1c30: 6f 20 63 6f 6f 72 64 69 6e 61 74 65 20 61 63 63  o coordinate acc
1c40: 65 73 73 2e 0a 20 20 49 66 20 79 6f 75 72 20 61  ess..  If your a
1c50: 70 70 6c 69 63 61 74 69 6f 6e 20 68 61 73 20 61  pplication has a
1c60: 20 6e 65 65 64 20 66 6f 72 20 61 20 6c 6f 74 20   need for a lot 
1c70: 6f 66 20 63 6f 6e 63 75 72 72 65 6e 63 79 2c 20  of concurrency, 
1c80: 74 68 65 6e 20 79 6f 75 20 73 68 6f 75 6c 64 0a  then you should.
1c90: 20 20 63 6f 6e 73 69 64 65 72 20 75 73 69 6e 67    consider using
1ca0: 20 61 20 63 6c 69 65 6e 74 2f 73 65 72 76 65 72   a client/server
1cb0: 20 64 61 74 61 62 61 73 65 2e 20 20 42 75 74 20   database.  But 
1cc0: 65 78 70 65 72 69 65 6e 63 65 20 73 75 67 67 65  experience sugge
1cd0: 73 74 73 20 74 68 61 74 0a 20 20 6d 6f 73 74 20  sts that.  most 
1ce0: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 6e 65 65  applications nee
1cf0: 64 20 6d 75 63 68 20 6c 65 73 73 20 63 6f 6e 63  d much less conc
1d00: 75 72 72 65 6e 63 79 20 74 68 61 6e 20 74 68 65  urrency than the
1d10: 69 72 20 64 65 73 69 67 6e 65 72 73 20 69 6d 61  ir designers ima
1d20: 67 69 6e 65 2e 0a 20 20 3c 2f 70 3e 0a 0a 20 20  gine..  </p>..  
1d30: 3c 70 3e 57 68 65 6e 20 53 51 4c 69 74 65 20 74  <p>When SQLite t
1d40: 72 69 65 73 20 74 6f 20 61 63 63 65 73 73 20 61  ries to access a
1d50: 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 6c 6f   file that is lo
1d60: 63 6b 65 64 20 62 79 20 61 6e 6f 74 68 65 72 0a  cked by another.
1d70: 20 20 70 72 6f 63 65 73 73 2c 20 74 68 65 20 64    process, the d
1d80: 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20  efault behavior 
1d90: 69 73 20 74 6f 20 72 65 74 75 72 6e 20 53 51 4c  is to return SQL
1da0: 49 54 45 5f 42 55 53 59 2e 20 20 59 6f 75 20 63  ITE_BUSY.  You c
1db0: 61 6e 0a 20 20 61 64 6a 75 73 74 20 74 68 69 73  an.  adjust this
1dc0: 20 62 65 68 61 76 69 6f 72 20 66 72 6f 6d 20 43   behavior from C
1dd0: 20 63 6f 64 65 20 75 73 69 6e 67 20 74 68 65 20   code using the 
1de0: 0a 20 20 3c 61 20 68 72 65 66 3d 22 63 61 70 69  .  <a href="capi
1df0: 33 72 65 66 23 73 71 6c 69 74 65 33 5f 62 75 73  3ref#sqlite3_bus
1e00: 79 5f 68 61 6e 64 6c 65 72 22 3e 73 71 6c 69 74  y_handler">sqlit
1e10: 65 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 28  e3_busy_handler(
1e20: 29 3c 2f 61 3e 20 6f 72 0a 20 20 3c 61 20 68 72  )</a> or.  <a hr
1e30: 65 66 3d 22 63 61 70 69 33 72 65 66 23 73 71 6c  ef="capi3ref#sql
1e40: 69 74 65 33 5f 62 75 73 79 5f 74 69 6d 65 6f 75  ite3_busy_timeou
1e50: 74 22 3e 73 71 6c 69 74 65 33 5f 62 75 73 79 5f  t">sqlite3_busy_
1e60: 74 69 6d 65 6f 75 74 28 29 3c 2f 61 3e 0a 20 20  timeout()</a>.  
1e70: 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 2e 3c 2f  API functions.</
1e80: 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 49 73  p>.}..faq {.  Is
1e90: 20 53 51 4c 69 74 65 20 74 68 72 65 61 64 73 61   SQLite threadsa
1ea0: 66 65 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 59 65 73  fe?.} {.  <p>Yes
1eb0: 2e 20 20 53 6f 6d 65 74 69 6d 65 73 2e 20 20 49  .  Sometimes.  I
1ec0: 6e 20 6f 72 64 65 72 20 74 6f 20 62 65 20 74 68  n order to be th
1ed0: 72 65 61 64 2d 73 61 66 65 2c 20 53 51 4c 69 74  read-safe, SQLit
1ee0: 65 20 6d 75 73 74 20 62 65 20 63 6f 6d 70 69 6c  e must be compil
1ef0: 65 64 0a 20 20 77 69 74 68 20 74 68 65 20 54 48  ed.  with the TH
1f00: 52 45 41 44 53 41 46 45 20 70 72 65 70 72 6f 63  READSAFE preproc
1f10: 65 73 73 6f 72 20 6d 61 63 72 6f 20 73 65 74 20  essor macro set 
1f20: 74 6f 20 31 2e 20 20 49 6e 20 74 68 65 20 64 65  to 1.  In the de
1f30: 66 61 75 6c 74 0a 20 20 64 69 73 74 72 69 62 75  fault.  distribu
1f40: 74 69 6f 6e 2c 20 74 68 65 20 77 69 6e 64 6f 77  tion, the window
1f50: 73 20 62 69 6e 61 72 69 65 73 20 61 72 65 20 63  s binaries are c
1f60: 6f 6d 70 69 6c 65 64 20 74 6f 20 62 65 20 74 68  ompiled to be th
1f70: 72 65 61 64 73 61 66 65 20 62 75 74 0a 20 20 74  readsafe but.  t
1f80: 68 65 20 6c 69 6e 75 78 20 62 69 6e 61 72 69 65  he linux binarie
1f90: 73 20 61 72 65 20 6e 6f 74 2e 20 20 49 66 20 79  s are not.  If y
1fa0: 6f 75 20 77 61 6e 74 20 74 6f 20 63 68 61 6e 67  ou want to chang
1fb0: 65 20 74 68 69 73 2c 20 79 6f 75 27 6c 6c 20 68  e this, you'll h
1fc0: 61 76 65 20 74 6f 0a 20 20 72 65 63 6f 6d 70 69  ave to.  recompi
1fd0: 6c 65 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 22 54  le.</p>..  <p>"T
1fe0: 68 72 65 61 64 73 61 66 65 22 20 69 6e 20 74 68  hreadsafe" in th
1ff0: 65 20 70 72 65 76 69 6f 75 73 20 70 61 72 61 67  e previous parag
2000: 72 61 70 68 20 6d 65 61 6e 73 20 74 68 61 74 20  raph means that 
2010: 74 77 6f 20 6f 72 20 6d 6f 72 65 20 74 68 72 65  two or more thre
2020: 61 64 73 0a 20 20 63 61 6e 20 72 75 6e 20 53 51  ads.  can run SQ
2030: 4c 69 74 65 20 61 74 20 74 68 65 20 73 61 6d 65  Lite at the same
2040: 20 74 69 6d 65 20 6f 6e 20 64 69 66 66 65 72 65   time on differe
2050: 6e 74 20 22 3c 62 3e 73 71 6c 69 74 65 33 3c 2f  nt "<b>sqlite3</
2060: 62 3e 22 20 73 74 72 75 63 74 75 72 65 73 0a 20  b>" structures. 
2070: 20 72 65 74 75 72 6e 65 64 20 66 72 6f 6d 20 73   returned from s
2080: 65 70 61 72 61 74 65 20 63 61 6c 6c 73 20 74 6f  eparate calls to
2090: 20 0a 20 20 3c 61 20 68 72 65 66 3d 22 63 61 70   .  <a href="cap
20a0: 69 33 72 65 66 23 73 71 6c 69 74 65 33 5f 6f 70  i3ref#sqlite3_op
20b0: 65 6e 22 3e 73 71 6c 69 74 65 33 5f 6f 70 65 6e  en">sqlite3_open
20c0: 28 29 3c 2f 61 3e 2e 20 20 49 74 20 69 73 20 6e  ()</a>.  It is n
20d0: 65 76 65 72 20 73 61 66 65 0a 20 20 74 6f 20 75  ever safe.  to u
20e0: 73 65 20 74 68 65 20 73 61 6d 65 20 3c 62 3e 73  se the same <b>s
20f0: 71 6c 69 74 65 33 3c 2f 62 3e 20 73 74 72 75 63  qlite3</b> struc
2100: 74 75 72 65 20 70 6f 69 6e 74 65 72 20 69 6e 20  ture pointer in 
2110: 74 77 6f 0a 20 20 6f 72 20 6d 6f 72 65 20 74 68  two.  or more th
2120: 72 65 61 64 73 2e 3c 2f 70 3e 0a 0a 20 20 3c 70  reads.</p>..  <p
2130: 3e 50 72 69 6f 72 20 74 6f 20 76 65 72 73 69 6f  >Prior to versio
2140: 6e 20 33 2e 33 2e 31 2c 0a 20 20 61 6e 20 3c 62  n 3.3.1,.  an <b
2150: 3e 73 71 6c 69 74 65 33 3c 2f 62 3e 20 73 74 72  >sqlite3</b> str
2160: 75 63 74 75 72 65 20 63 6f 75 6c 64 20 6f 6e 6c  ucture could onl
2170: 79 20 62 65 20 75 73 65 64 20 69 6e 20 74 68 65  y be used in the
2180: 20 73 61 6d 65 20 74 68 72 65 61 64 0a 20 20 74   same thread.  t
2190: 68 61 74 20 63 61 6c 6c 65 64 20 3c 61 20 68 72  hat called <a hr
21a0: 65 66 3d 22 63 61 70 69 33 72 65 66 23 73 71 6c  ef="capi3ref#sql
21b0: 69 74 65 33 5f 6f 70 65 6e 22 3e 73 71 6c 69 74  ite3_open">sqlit
21c0: 65 33 5f 6f 70 65 6e 3c 2f 61 3e 20 74 6f 20 63  e3_open</a> to c
21d0: 72 65 61 74 65 20 69 74 2e 0a 20 20 59 6f 75 20  reate it..  You 
21e0: 63 6f 75 6c 64 20 6e 6f 74 20 6f 70 65 6e 20 61  could not open a
21f0: 0a 20 20 64 61 74 61 62 61 73 65 20 69 6e 20 6f  .  database in o
2200: 6e 65 20 74 68 72 65 61 64 20 74 68 65 6e 20 70  ne thread then p
2210: 61 73 73 20 74 68 65 20 68 61 6e 64 6c 65 20 6f  ass the handle o
2220: 66 66 20 74 6f 20 61 6e 6f 74 68 65 72 20 74 68  ff to another th
2230: 72 65 61 64 20 66 6f 72 0a 20 20 69 74 20 74 6f  read for.  it to
2240: 20 75 73 65 2e 20 20 54 68 69 73 20 77 61 73 20   use.  This was 
2250: 64 75 65 20 74 6f 20 6c 69 6d 69 74 61 74 69 6f  due to limitatio
2260: 6e 73 20 28 62 75 67 73 3f 29 20 69 6e 20 6d 61  ns (bugs?) in ma
2270: 6e 79 20 63 6f 6d 6d 6f 6e 20 74 68 72 65 61 64  ny common thread
2280: 69 6e 67 0a 20 20 69 6d 70 6c 65 6d 65 6e 74 61  ing.  implementa
2290: 74 69 6f 6e 73 20 73 75 63 68 20 61 73 20 6f 6e  tions such as on
22a0: 20 52 65 64 48 61 74 39 2e 20 20 53 70 65 63 69   RedHat9.  Speci
22b0: 66 69 63 61 6c 6c 79 2c 20 61 6e 20 66 63 6e 74  fically, an fcnt
22c0: 6c 28 29 20 6c 6f 63 6b 0a 20 20 63 72 65 61 74  l() lock.  creat
22d0: 65 64 20 62 79 20 6f 6e 65 20 74 68 72 65 61 64  ed by one thread
22e0: 20 63 61 6e 6e 6f 74 20 62 65 20 72 65 6d 6f 76   cannot be remov
22f0: 65 64 20 6f 72 20 6d 6f 64 69 66 69 65 64 20 62  ed or modified b
2300: 79 20 61 20 64 69 66 66 65 72 65 6e 74 0a 20 20  y a different.  
2310: 74 68 72 65 61 64 20 6f 6e 20 74 68 65 20 74 72  thread on the tr
2320: 6f 75 62 6c 65 73 6f 6d 65 20 73 79 73 74 65 6d  oublesome system
2330: 73 2e 20 20 41 6e 64 20 73 69 6e 63 65 20 53 51  s.  And since SQ
2340: 4c 69 74 65 20 75 73 65 73 20 66 63 6e 74 6c 28  Lite uses fcntl(
2350: 29 0a 20 20 6c 6f 63 6b 73 20 68 65 61 76 69 6c  ).  locks heavil
2360: 79 20 66 6f 72 20 63 6f 6e 63 75 72 72 65 6e 63  y for concurrenc
2370: 79 20 63 6f 6e 74 72 6f 6c 2c 20 73 65 72 69 6f  y control, serio
2380: 75 73 20 70 72 6f 62 6c 65 6d 73 20 61 72 6f 73  us problems aros
2390: 65 20 69 66 20 79 6f 75 20 0a 20 20 73 74 61 72  e if you .  star
23a0: 74 20 6d 6f 76 69 6e 67 20 64 61 74 61 62 61 73  t moving databas
23b0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 63  e connections ac
23c0: 72 6f 73 73 20 74 68 72 65 61 64 73 2e 3c 2f 70  ross threads.</p
23d0: 3e 0a 0a 20 20 3c 70 3e 54 68 65 20 72 65 73 74  >..  <p>The rest
23e0: 72 69 63 74 69 6f 6e 20 6f 6e 20 6d 6f 76 69 6e  riction on movin
23f0: 67 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  g database conne
2400: 63 74 69 6f 6e 73 20 61 63 72 6f 73 73 20 74 68  ctions across th
2410: 72 65 61 64 73 0a 20 20 77 61 73 20 72 65 6c 61  reads.  was rela
2420: 78 65 64 20 73 6f 6d 65 77 68 61 74 20 69 6e 20  xed somewhat in 
2430: 76 65 72 73 69 6f 6e 20 33 2e 33 2e 31 2e 20 20  version 3.3.1.  
2440: 57 69 74 68 20 74 68 61 74 20 61 6e 64 20 73 75  With that and su
2450: 62 73 65 71 75 65 6e 74 0a 20 20 76 65 72 73 69  bsequent.  versi
2460: 6f 6e 73 2c 20 69 74 20 69 73 20 73 61 66 65 20  ons, it is safe 
2470: 74 6f 20 6d 6f 76 65 20 61 20 63 6f 6e 6e 65 63  to move a connec
2480: 74 69 6f 6e 20 68 61 6e 64 6c 65 20 61 63 72 6f  tion handle acro
2490: 73 73 20 74 68 72 65 61 64 73 0a 20 20 61 73 20  ss threads.  as 
24a0: 6c 6f 6e 67 20 61 73 20 74 68 65 20 63 6f 6e 6e  long as the conn
24b0: 65 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 68 6f  ection is not ho
24c0: 6c 64 69 6e 67 20 61 6e 79 20 66 63 6e 74 6c 28  lding any fcntl(
24d0: 29 20 6c 6f 63 6b 73 2e 20 20 59 6f 75 0a 20 20  ) locks.  You.  
24e0: 63 61 6e 20 73 61 66 65 6c 79 20 61 73 73 75 6d  can safely assum
24f0: 65 20 74 68 61 74 20 6e 6f 20 6c 6f 63 6b 73 20  e that no locks 
2500: 61 72 65 20 62 65 69 6e 67 20 68 65 6c 64 20 69  are being held i
2510: 66 20 6e 6f 0a 20 20 74 72 61 6e 73 61 63 74 69  f no.  transacti
2520: 6f 6e 20 69 73 20 70 65 6e 64 69 6e 67 20 61 6e  on is pending an
2530: 64 20 61 6c 6c 20 73 74 61 74 65 6d 65 6e 74 73  d all statements
2540: 20 68 61 76 65 20 62 65 65 6e 20 66 69 6e 61 6c   have been final
2550: 69 7a 65 64 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e  ized.</p>..  <p>
2560: 55 6e 64 65 72 20 55 4e 49 58 2c 20 79 6f 75 20  Under UNIX, you 
2570: 73 68 6f 75 6c 64 20 6e 6f 74 20 63 61 72 72 79  should not carry
2580: 20 61 6e 20 6f 70 65 6e 20 53 51 4c 69 74 65 20   an open SQLite 
2590: 64 61 74 61 62 61 73 65 20 61 63 72 6f 73 73 0a  database across.
25a0: 20 20 61 20 66 6f 72 6b 28 29 20 73 79 73 74 65    a fork() syste
25b0: 6d 20 63 61 6c 6c 20 69 6e 74 6f 20 74 68 65 20  m call into the 
25c0: 63 68 69 6c 64 20 70 72 6f 63 65 73 73 2e 20 20  child process.  
25d0: 50 72 6f 62 6c 65 6d 73 20 77 69 6c 6c 20 72 65  Problems will re
25e0: 73 75 6c 74 0a 20 20 69 66 20 79 6f 75 20 64 6f  sult.  if you do
25f0: 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20  .</p>.}..faq {. 
2600: 20 48 6f 77 20 64 6f 20 49 20 6c 69 73 74 20 61   How do I list a
2610: 6c 6c 20 74 61 62 6c 65 73 2f 69 6e 64 69 63 65  ll tables/indice
2620: 73 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 61  s contained in a
2630: 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  n SQLite databas
2640: 65 0a 7d 20 7b 0a 20 20 3c 70 3e 49 66 20 79 6f  e.} {.  <p>If yo
2650: 75 20 61 72 65 20 72 75 6e 6e 69 6e 67 20 74 68  u are running th
2660: 65 20 3c 62 3e 73 71 6c 69 74 65 33 3c 2f 62 3e  e <b>sqlite3</b>
2670: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 61 63   command-line ac
2680: 63 65 73 73 20 70 72 6f 67 72 61 6d 0a 20 20 79  cess program.  y
2690: 6f 75 20 63 61 6e 20 74 79 70 65 20 22 3c 62 3e  ou can type "<b>
26a0: 2e 74 61 62 6c 65 73 3c 2f 62 3e 22 20 74 6f 20  .tables</b>" to 
26b0: 67 65 74 20 61 20 6c 69 73 74 20 6f 66 20 61 6c  get a list of al
26c0: 6c 20 74 61 62 6c 65 73 2e 20 20 4f 72 20 79 6f  l tables.  Or yo
26d0: 75 0a 20 20 63 61 6e 20 74 79 70 65 20 22 3c 62  u.  can type "<b
26e0: 3e 2e 73 63 68 65 6d 61 3c 2f 62 3e 22 20 74 6f  >.schema</b>" to
26f0: 20 73 65 65 20 74 68 65 20 63 6f 6d 70 6c 65 74   see the complet
2700: 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d  e database schem
2710: 61 20 69 6e 63 6c 75 64 69 6e 67 0a 20 20 61 6c  a including.  al
2720: 6c 20 74 61 62 6c 65 73 20 61 6e 64 20 69 6e 64  l tables and ind
2730: 69 63 65 73 2e 20 20 45 69 74 68 65 72 20 6f 66  ices.  Either of
2740: 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20   these commands 
2750: 63 61 6e 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20  can be followed 
2760: 62 79 0a 20 20 61 20 4c 49 4b 45 20 70 61 74 74  by.  a LIKE patt
2770: 65 72 6e 20 74 68 61 74 20 77 69 6c 6c 20 72 65  ern that will re
2780: 73 74 72 69 63 74 20 74 68 65 20 74 61 62 6c 65  strict the table
2790: 73 20 74 68 61 74 20 61 72 65 20 64 69 73 70 6c  s that are displ
27a0: 61 79 65 64 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e  ayed.</p>..  <p>
27b0: 46 72 6f 6d 20 77 69 74 68 69 6e 20 61 20 43 2f  From within a C/
27c0: 43 2b 2b 20 70 72 6f 67 72 61 6d 20 28 6f 72 20  C++ program (or 
27d0: 61 20 73 63 72 69 70 74 20 75 73 69 6e 67 20 54  a script using T
27e0: 63 6c 2f 52 75 62 79 2f 50 65 72 6c 2f 50 79 74  cl/Ruby/Perl/Pyt
27f0: 68 6f 6e 0a 20 20 62 69 6e 64 69 6e 67 73 29 20  hon.  bindings) 
2800: 79 6f 75 20 63 61 6e 20 67 65 74 20 61 63 63 65  you can get acce
2810: 73 73 20 74 6f 20 74 61 62 6c 65 20 61 6e 64 20  ss to table and 
2820: 69 6e 64 65 78 20 6e 61 6d 65 73 20 62 79 20 64  index names by d
2830: 6f 69 6e 67 20 61 20 53 45 4c 45 43 54 0a 20 20  oing a SELECT.  
2840: 6f 6e 20 61 20 73 70 65 63 69 61 6c 20 74 61 62  on a special tab
2850: 6c 65 20 6e 61 6d 65 64 20 22 3c 62 3e 53 51 4c  le named "<b>SQL
2860: 49 54 45 5f 4d 41 53 54 45 52 3c 2f 62 3e 22 2e  ITE_MASTER</b>".
2870: 20 20 45 76 65 72 79 20 53 51 4c 69 74 65 20 64    Every SQLite d
2880: 61 74 61 62 61 73 65 0a 20 20 68 61 73 20 61 6e  atabase.  has an
2890: 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74   SQLITE_MASTER t
28a0: 61 62 6c 65 20 74 68 61 74 20 64 65 66 69 6e 65  able that define
28b0: 73 20 74 68 65 20 73 63 68 65 6d 61 20 66 6f 72  s the schema for
28c0: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 20   the database.. 
28d0: 20 54 68 65 20 53 51 4c 49 54 45 5f 4d 41 53 54   The SQLITE_MAST
28e0: 45 52 20 74 61 62 6c 65 20 6c 6f 6f 6b 73 20 6c  ER table looks l
28f0: 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 3c 62  ike this:</p>.<b
2900: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a  lockquote><pre>.
2910: 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 71 6c  CREATE TABLE sql
2920: 69 74 65 5f 6d 61 73 74 65 72 20 28 0a 20 20 74  ite_master (.  t
2930: 79 70 65 20 54 45 58 54 2c 0a 20 20 6e 61 6d 65  ype TEXT,.  name
2940: 20 54 45 58 54 2c 0a 20 20 74 62 6c 5f 6e 61 6d   TEXT,.  tbl_nam
2950: 65 20 54 45 58 54 2c 0a 20 20 72 6f 6f 74 70 61  e TEXT,.  rootpa
2960: 67 65 20 49 4e 54 45 47 45 52 2c 0a 20 20 73 71  ge INTEGER,.  sq
2970: 6c 20 54 45 58 54 0a 29 3b 0a 3c 2f 70 72 65 3e  l TEXT.);.</pre>
2980: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20  </blockquote>.  
2990: 3c 70 3e 46 6f 72 20 74 61 62 6c 65 73 2c 20 74  <p>For tables, t
29a0: 68 65 20 3c 62 3e 74 79 70 65 3c 2f 62 3e 20 66  he <b>type</b> f
29b0: 69 65 6c 64 20 77 69 6c 6c 20 61 6c 77 61 79 73  ield will always
29c0: 20 62 65 20 3c 62 3e 27 74 61 62 6c 65 27 3c 2f   be <b>'table'</
29d0: 62 3e 20 61 6e 64 20 74 68 65 0a 20 20 3c 62 3e  b> and the.  <b>
29e0: 6e 61 6d 65 3c 2f 62 3e 20 66 69 65 6c 64 20 77  name</b> field w
29f0: 69 6c 6c 20 62 65 20 74 68 65 20 6e 61 6d 65 20  ill be the name 
2a00: 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 20 20 53  of the table.  S
2a10: 6f 20 74 6f 20 67 65 74 20 61 20 6c 69 73 74 20  o to get a list 
2a20: 6f 66 0a 20 20 61 6c 6c 20 74 61 62 6c 65 73 20  of.  all tables 
2a30: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2c  in the database,
2a40: 20 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69   use the followi
2a50: 6e 67 20 53 45 4c 45 43 54 20 63 6f 6d 6d 61 6e  ng SELECT comman
2a60: 64 3a 3c 2f 70 3e 0a 3c 62 6c 6f 63 6b 71 75 6f  d:</p>.<blockquo
2a70: 74 65 3e 3c 70 72 65 3e 0a 53 45 4c 45 43 54 20  te><pre>.SELECT 
2a80: 6e 61 6d 65 20 46 52 4f 4d 20 73 71 6c 69 74 65  name FROM sqlite
2a90: 5f 6d 61 73 74 65 72 0a 57 48 45 52 45 20 74 79  _master.WHERE ty
2aa0: 70 65 3d 27 74 61 62 6c 65 27 0a 4f 52 44 45 52  pe='table'.ORDER
2ab0: 20 42 59 20 6e 61 6d 65 3b 0a 3c 2f 70 72 65 3e   BY name;.</pre>
2ac0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20  </blockquote>.  
2ad0: 3c 70 3e 46 6f 72 20 69 6e 64 69 63 65 73 2c 20  <p>For indices, 
2ae0: 3c 62 3e 74 79 70 65 3c 2f 62 3e 20 69 73 20 65  <b>type</b> is e
2af0: 71 75 61 6c 20 74 6f 20 3c 62 3e 27 69 6e 64 65  qual to <b>'inde
2b00: 78 27 3c 2f 62 3e 2c 20 3c 62 3e 6e 61 6d 65 3c  x'</b>, <b>name<
2b10: 2f 62 3e 20 69 73 20 74 68 65 0a 20 20 6e 61 6d  /b> is the.  nam
2b20: 65 20 6f 66 20 74 68 65 20 69 6e 64 65 78 20 61  e of the index a
2b30: 6e 64 20 3c 62 3e 74 62 6c 5f 6e 61 6d 65 3c 2f  nd <b>tbl_name</
2b40: 62 3e 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f  b> is the name o
2b50: 66 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 77  f the table to w
2b60: 68 69 63 68 0a 20 20 74 68 65 20 69 6e 64 65 78  hich.  the index
2b70: 20 62 65 6c 6f 6e 67 73 2e 20 20 46 6f 72 20 62   belongs.  For b
2b80: 6f 74 68 20 74 61 62 6c 65 73 20 61 6e 64 20 69  oth tables and i
2b90: 6e 64 69 63 65 73 2c 20 74 68 65 20 3c 62 3e 73  ndices, the <b>s
2ba0: 71 6c 3c 2f 62 3e 20 66 69 65 6c 64 20 69 73 0a  ql</b> field is.
2bb0: 20 20 74 68 65 20 74 65 78 74 20 6f 66 20 74 68    the text of th
2bc0: 65 20 6f 72 69 67 69 6e 61 6c 20 43 52 45 41 54  e original CREAT
2bd0: 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54  E TABLE or CREAT
2be0: 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e  E INDEX statemen
2bf0: 74 20 74 68 61 74 0a 20 20 63 72 65 61 74 65 64  t that.  created
2c00: 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e   the table or in
2c10: 64 65 78 2e 20 20 46 6f 72 20 61 75 74 6f 6d 61  dex.  For automa
2c20: 74 69 63 61 6c 6c 79 20 63 72 65 61 74 65 64 20  tically created 
2c30: 69 6e 64 69 63 65 73 20 28 75 73 65 64 0a 20 20  indices (used.  
2c40: 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65  to implement the
2c50: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20   PRIMARY KEY or 
2c60: 55 4e 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e  UNIQUE constrain
2c70: 74 73 29 20 74 68 65 20 3c 62 3e 73 71 6c 3c 2f  ts) the <b>sql</
2c80: 62 3e 20 66 69 65 6c 64 0a 20 20 69 73 20 4e 55  b> field.  is NU
2c90: 4c 4c 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 54 68  LL.</p>..  <p>Th
2ca0: 65 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20  e SQLITE_MASTER 
2cb0: 74 61 62 6c 65 20 69 73 20 72 65 61 64 2d 6f 6e  table is read-on
2cc0: 6c 79 2e 20 20 59 6f 75 20 63 61 6e 6e 6f 74 20  ly.  You cannot 
2cd0: 63 68 61 6e 67 65 20 74 68 69 73 20 74 61 62 6c  change this tabl
2ce0: 65 0a 20 20 75 73 69 6e 67 20 55 50 44 41 54 45  e.  using UPDATE
2cf0: 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 44 45 4c  , INSERT, or DEL
2d00: 45 54 45 2e 20 20 54 68 65 20 74 61 62 6c 65 20  ETE.  The table 
2d10: 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  is automatically
2d20: 20 75 70 64 61 74 65 64 20 62 79 0a 20 20 43 52   updated by.  CR
2d30: 45 41 54 45 20 54 41 42 4c 45 2c 20 43 52 45 41  EATE TABLE, CREA
2d40: 54 45 20 49 4e 44 45 58 2c 20 44 52 4f 50 20 54  TE INDEX, DROP T
2d50: 41 42 4c 45 2c 20 61 6e 64 20 44 52 4f 50 20 49  ABLE, and DROP I
2d60: 4e 44 45 58 20 63 6f 6d 6d 61 6e 64 73 2e 3c 2f  NDEX commands.</
2d70: 70 3e 0a 0a 20 20 3c 70 3e 54 65 6d 70 6f 72 61  p>..  <p>Tempora
2d80: 72 79 20 74 61 62 6c 65 73 20 64 6f 20 6e 6f 74  ry tables do not
2d90: 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 20 53   appear in the S
2da0: 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74 61 62  QLITE_MASTER tab
2db0: 6c 65 2e 20 20 54 65 6d 70 6f 72 61 72 79 0a 20  le.  Temporary. 
2dc0: 20 74 61 62 6c 65 73 20 61 6e 64 20 74 68 65 69   tables and thei
2dd0: 72 20 69 6e 64 69 63 65 73 20 61 6e 64 20 74 72  r indices and tr
2de0: 69 67 67 65 72 73 20 6f 63 63 75 72 20 69 6e 20  iggers occur in 
2df0: 61 6e 6f 74 68 65 72 20 73 70 65 63 69 61 6c 20  another special 
2e00: 74 61 62 6c 65 0a 20 20 6e 61 6d 65 64 20 53 51  table.  named SQ
2e10: 4c 49 54 45 5f 54 45 4d 50 5f 4d 41 53 54 45 52  LITE_TEMP_MASTER
2e20: 2e 20 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 4d  .  SQLITE_TEMP_M
2e30: 41 53 54 45 52 20 77 6f 72 6b 73 20 6a 75 73 74  ASTER works just
2e40: 20 6c 69 6b 65 20 53 51 4c 49 54 45 5f 4d 41 53   like SQLITE_MAS
2e50: 54 45 52 0a 20 20 65 78 63 65 70 74 20 74 68 61  TER.  except tha
2e60: 74 20 69 74 20 69 73 20 6f 6e 6c 79 20 76 69 73  t it is only vis
2e70: 69 62 6c 65 20 74 6f 20 74 68 65 20 61 70 70 6c  ible to the appl
2e80: 69 63 61 74 69 6f 6e 20 74 68 61 74 20 63 72 65  ication that cre
2e90: 61 74 65 64 20 74 68 65 20 0a 20 20 74 65 6d 70  ated the .  temp
2ea0: 6f 72 61 72 79 20 74 61 62 6c 65 73 2e 20 20 54  orary tables.  T
2eb0: 6f 20 67 65 74 20 61 20 6c 69 73 74 20 6f 66 20  o get a list of 
2ec0: 61 6c 6c 20 74 61 62 6c 65 73 2c 20 62 6f 74 68  all tables, both
2ed0: 20 70 65 72 6d 61 6e 65 6e 74 20 61 6e 64 0a 20   permanent and. 
2ee0: 20 74 65 6d 70 6f 72 61 72 79 2c 20 6f 6e 65 20   temporary, one 
2ef0: 63 61 6e 20 75 73 65 20 61 20 63 6f 6d 6d 61 6e  can use a comman
2f00: 64 20 73 69 6d 69 6c 61 72 20 74 6f 20 74 68 65  d similar to the
2f10: 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 3c 62 6c 6f   following:.<blo
2f20: 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 53 45  ckquote><pre>.SE
2f30: 4c 45 43 54 20 6e 61 6d 65 20 46 52 4f 4d 20 0a  LECT name FROM .
2f40: 20 20 20 28 53 45 4c 45 43 54 20 2a 20 46 52 4f     (SELECT * FRO
2f50: 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  M sqlite_master 
2f60: 55 4e 49 4f 4e 20 41 4c 4c 0a 20 20 20 20 53 45  UNION ALL.    SE
2f70: 4c 45 43 54 20 2a 20 46 52 4f 4d 20 73 71 6c 69  LECT * FROM sqli
2f80: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 29 0a  te_temp_master).
2f90: 57 48 45 52 45 20 74 79 70 65 3d 27 74 61 62 6c  WHERE type='tabl
2fa0: 65 27 0a 4f 52 44 45 52 20 42 59 20 6e 61 6d 65  e'.ORDER BY name
2fb0: 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75  .</pre></blockqu
2fc0: 6f 74 65 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20  ote>.}..faq {.  
2fd0: 41 72 65 20 74 68 65 72 65 20 61 6e 79 20 6b 6e  Are there any kn
2fe0: 6f 77 6e 20 73 69 7a 65 20 6c 69 6d 69 74 73 20  own size limits 
2ff0: 74 6f 20 53 51 4c 69 74 65 20 64 61 74 61 62 61  to SQLite databa
3000: 73 65 73 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 41 20  ses?.} {.  <p>A 
3010: 64 61 74 61 62 61 73 65 20 69 73 20 6c 69 6d 69  database is limi
3020: 74 65 64 20 69 6e 20 73 69 7a 65 20 74 6f 20 32  ted in size to 2
3030: 20 74 69 62 69 62 79 74 65 73 20 28 32 3c 73 75   tibibytes (2<su
3040: 70 3e 34 31 3c 2f 73 75 70 3e 20 62 79 74 65 73  p>41</sup> bytes
3050: 29 2e 0a 20 20 54 68 61 74 20 69 73 20 61 20 74  )..  That is a t
3060: 68 65 6f 72 65 74 69 63 61 6c 20 6c 69 6d 69 74  heoretical limit
3070: 61 74 69 6f 6e 2e 20 20 49 6e 20 70 72 61 63 74  ation.  In pract
3080: 69 63 65 2c 20 79 6f 75 20 73 68 6f 75 6c 64 20  ice, you should 
3090: 74 72 79 20 74 6f 20 6b 65 65 70 0a 20 20 79 6f  try to keep.  yo
30a0: 75 72 20 53 51 4c 69 74 65 20 64 61 74 61 62 61  ur SQLite databa
30b0: 73 65 73 20 62 65 6c 6f 77 20 31 30 30 20 67 69  ses below 100 gi
30c0: 67 61 62 79 74 65 73 20 74 6f 20 61 76 6f 69 64  gabytes to avoid
30d0: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 70 72 6f   performance pro
30e0: 62 6c 65 6d 73 2e 0a 20 20 49 66 20 79 6f 75 20  blems..  If you 
30f0: 6e 65 65 64 20 74 6f 20 73 74 6f 72 65 20 31 30  need to store 10
3100: 30 20 67 69 67 61 62 79 74 65 73 20 6f 72 20 6d  0 gigabytes or m
3110: 6f 72 65 20 69 6e 20 61 20 64 61 74 61 62 61 73  ore in a databas
3120: 65 2c 20 63 6f 6e 73 69 64 65 72 20 75 73 69 6e  e, consider usin
3130: 67 0a 20 20 61 6e 20 65 6e 74 65 72 70 72 69 73  g.  an enterpris
3140: 65 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e  e database engin
3150: 65 20 77 68 69 63 68 20 69 73 20 64 65 73 69 67  e which is desig
3160: 6e 65 64 20 66 6f 72 20 74 68 61 74 20 70 75 72  ned for that pur
3170: 70 6f 73 65 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e  pose.</p>..  <p>
3180: 54 68 65 20 74 68 65 6f 72 65 74 69 63 61 6c 20  The theoretical 
3190: 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 6e 75 6d  limit on the num
31a0: 62 65 72 20 6f 66 20 72 6f 77 73 20 69 6e 20 61  ber of rows in a
31b0: 20 74 61 62 6c 65 20 69 73 0a 20 20 32 3c 73 75   table is.  2<su
31c0: 70 3e 36 34 3c 2f 73 75 70 3e 2d 31 2c 20 74 68  p>64</sup>-1, th
31d0: 6f 75 67 68 20 6f 62 76 69 6f 75 73 6c 79 20 79  ough obviously y
31e0: 6f 75 20 77 69 6c 6c 20 72 75 6e 20 69 6e 74 6f  ou will run into
31f0: 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 0a 20   the file size. 
3200: 20 6c 69 6d 69 74 61 74 69 6f 6e 20 70 72 69 6f   limitation prio
3210: 72 20 74 6f 20 72 65 61 63 68 69 6e 67 20 74 68  r to reaching th
3220: 65 20 72 6f 77 20 6c 69 6d 69 74 2e 20 20 41 20  e row limit.  A 
3230: 73 69 6e 67 6c 65 20 72 6f 77 20 63 61 6e 20 68  single row can h
3240: 6f 6c 64 0a 20 20 75 70 20 74 6f 20 32 3c 73 75  old.  up to 2<su
3250: 70 3e 33 30 3c 2f 73 75 70 3e 20 62 79 74 65 73  p>30</sup> bytes
3260: 20 6f 66 20 64 61 74 61 20 69 6e 20 74 68 65 20   of data in the 
3270: 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e  current implemen
3280: 74 61 74 69 6f 6e 2e 20 20 54 68 65 0a 20 20 75  tation.  The.  u
3290: 6e 64 65 72 6c 79 69 6e 67 20 66 69 6c 65 20 66  nderlying file f
32a0: 6f 72 6d 61 74 20 73 75 70 70 6f 72 74 73 20 72  ormat supports r
32b0: 6f 77 20 73 69 7a 65 73 20 75 70 20 74 6f 20 61  ow sizes up to a
32c0: 62 6f 75 74 20 32 3c 73 75 70 3e 36 32 3c 2f 73  bout 2<sup>62</s
32d0: 75 70 3e 20 62 79 74 65 73 2e 0a 20 20 3c 2f 70  up> bytes..  </p
32e0: 3e 0a 0a 20 20 3c 70 3e 54 68 65 72 65 20 61 72  >..  <p>There ar
32f0: 65 20 70 72 6f 62 61 62 6c 79 20 6c 69 6d 69 74  e probably limit
3300: 73 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 20  s on the number 
3310: 6f 66 20 74 61 62 6c 65 73 20 6f 72 20 69 6e 64  of tables or ind
3320: 69 63 65 73 20 6f 72 0a 20 20 74 68 65 20 6e 75  ices or.  the nu
3330: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
3340: 69 6e 20 61 20 74 61 62 6c 65 20 6f 72 20 69 6e  in a table or in
3350: 64 65 78 2c 20 62 75 74 20 6e 6f 62 6f 64 79 20  dex, but nobody 
3360: 69 73 20 73 75 72 65 20 77 68 61 74 0a 20 20 74  is sure what.  t
3370: 68 6f 73 65 20 6c 69 6d 69 74 73 20 61 72 65 2e  hose limits are.
3380: 20 20 49 6e 20 70 72 61 63 74 69 63 65 2c 20 53    In practice, S
3390: 51 4c 69 74 65 20 6d 75 73 74 20 72 65 61 64 20  QLite must read 
33a0: 61 6e 64 20 70 61 72 73 65 20 74 68 65 20 6f 72  and parse the or
33b0: 69 67 69 6e 61 6c 0a 20 20 53 51 4c 20 6f 66 20  iginal.  SQL of 
33c0: 61 6c 6c 20 74 61 62 6c 65 20 61 6e 64 20 69 6e  all table and in
33d0: 64 65 78 20 64 65 63 6c 61 72 61 74 69 6f 6e 73  dex declarations
33e0: 20 65 76 65 72 79 74 69 6d 65 20 61 20 6e 65 77   everytime a new
33f0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 0a 20   database file. 
3400: 20 69 73 20 6f 70 65 6e 65 64 2c 20 73 6f 20 66   is opened, so f
3410: 6f 72 20 74 68 65 20 62 65 73 74 20 70 65 72 66  or the best perf
3420: 6f 72 6d 61 6e 63 65 20 6f 66 0a 20 20 3c 61 20  ormance of.  <a 
3430: 68 72 65 66 3d 22 63 61 70 69 33 72 65 66 2e 68  href="capi3ref.h
3440: 74 6d 6c 23 73 71 6c 69 74 65 33 5f 6f 70 65 6e  tml#sqlite3_open
3450: 22 3e 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29  ">sqlite3_open()
3460: 3c 2f 61 3e 20 69 74 20 69 73 20 62 65 73 74 0a  </a> it is best.
3470: 20 20 74 6f 20 6b 65 65 70 20 64 6f 77 6e 20 74    to keep down t
3480: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 64 65 63  he number of dec
3490: 6c 61 72 65 64 20 74 61 62 6c 65 73 2e 20 20 20  lared tables.   
34a0: 4c 69 6b 65 77 69 73 65 2c 20 74 68 6f 75 67 68  Likewise, though
34b0: 20 74 68 65 72 65 0a 20 20 69 73 20 6e 6f 20 6c   there.  is no l
34c0: 69 6d 69 74 20 6f 6e 20 74 68 65 20 6e 75 6d 62  imit on the numb
34d0: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e  er of columns in
34e0: 20 61 20 74 61 62 6c 65 2c 20 6d 6f 72 65 20 74   a table, more t
34f0: 68 61 6e 20 61 20 66 65 77 20 68 75 6e 64 72 65  han a few hundre
3500: 64 0a 20 20 73 65 65 6d 73 20 65 78 74 72 65 6d  d.  seems extrem
3510: 65 2e 20 20 4f 6e 6c 79 20 74 68 65 20 66 69 72  e.  Only the fir
3520: 73 74 20 33 31 20 63 6f 6c 75 6d 6e 73 20 6f 66  st 31 columns of
3530: 20 61 20 74 61 62 6c 65 20 61 72 65 20 63 61 6e   a table are can
3540: 64 69 64 61 74 65 73 20 66 6f 72 0a 20 20 63 65  didates for.  ce
3550: 72 74 61 69 6e 20 6f 70 74 69 6d 69 7a 61 74 69  rtain optimizati
3560: 6f 6e 73 2e 20 20 59 6f 75 20 63 61 6e 20 70 75  ons.  You can pu
3570: 74 20 61 73 20 6d 61 6e 79 20 63 6f 6c 75 6d 6e  t as many column
3580: 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 20 61 73  s in an index as
3590: 20 79 6f 75 20 6c 69 6b 65 0a 20 20 62 75 74 20   you like.  but 
35a0: 69 6e 64 65 78 65 73 20 77 69 74 68 20 6d 6f 72  indexes with mor
35b0: 65 20 74 68 61 6e 20 33 30 20 63 6f 6c 75 6d 6e  e than 30 column
35c0: 73 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 75 73  s will not be us
35d0: 65 64 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 71  ed to optimize q
35e0: 75 65 72 69 65 73 2e 0a 20 20 3c 2f 70 3e 0a 0a  ueries..  </p>..
35f0: 20 20 3c 70 3e 54 68 65 20 6e 61 6d 65 73 20 6f    <p>The names o
3600: 66 20 74 61 62 6c 65 73 2c 20 69 6e 64 69 63 65  f tables, indice
3610: 73 2c 20 76 69 65 77 2c 20 74 72 69 67 67 65 72  s, view, trigger
3620: 73 2c 20 61 6e 64 20 63 6f 6c 75 6d 6e 73 20 63  s, and columns c
3630: 61 6e 20 62 65 0a 20 20 61 73 20 6c 6f 6e 67 20  an be.  as long 
3640: 61 73 20 64 65 73 69 72 65 64 2e 20 20 48 6f 77  as desired.  How
3650: 65 76 65 72 2c 20 74 68 65 20 6e 61 6d 65 73 20  ever, the names 
3660: 6f 66 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73  of SQL functions
3670: 20 28 61 73 20 63 72 65 61 74 65 64 0a 20 20 62   (as created.  b
3680: 79 20 74 68 65 20 0a 20 20 3c 61 20 68 72 65 66  y the .  <a href
3690: 3d 22 63 61 70 69 33 72 65 66 2e 68 74 6d 6c 23  ="capi3ref.html#
36a0: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66  sqlite3_create_f
36b0: 75 6e 63 74 69 6f 6e 22 3e 73 71 6c 69 74 65 33  unction">sqlite3
36c0: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e  _create_function
36d0: 28 29 3c 2f 61 3e 0a 20 20 41 50 49 29 20 6d 61  ()</a>.  API) ma
36e0: 79 20 6e 6f 74 20 65 78 63 65 65 64 20 32 35 35  y not exceed 255
36f0: 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 20 6c   characters in l
3700: 65 6e 67 74 68 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61  ength.</p>.}..fa
3710: 71 20 7b 0a 20 20 57 68 61 74 20 69 73 20 74 68  q {.  What is th
3720: 65 20 6d 61 78 69 6d 75 6d 20 73 69 7a 65 20 6f  e maximum size o
3730: 66 20 61 20 56 41 52 43 48 41 52 20 69 6e 20 53  f a VARCHAR in S
3740: 51 4c 69 74 65 3f 0a 7d 20 7b 0a 20 20 3c 70 3e  QLite?.} {.  <p>
3750: 53 51 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74 20  SQLite does not 
3760: 65 6e 66 6f 72 63 65 20 74 68 65 20 6c 65 6e 67  enforce the leng
3770: 74 68 20 6f 66 20 61 20 56 41 52 43 48 41 52 2e  th of a VARCHAR.
3780: 20 20 59 6f 75 20 63 61 6e 20 64 65 63 6c 61 72    You can declar
3790: 65 0a 20 20 61 20 56 41 52 43 48 41 52 28 31 30  e.  a VARCHAR(10
37a0: 29 20 61 6e 64 20 53 51 4c 69 74 65 20 77 69 6c  ) and SQLite wil
37b0: 6c 20 62 65 20 68 61 70 70 79 20 74 6f 20 6c 65  l be happy to le
37c0: 74 20 79 6f 75 20 70 75 74 20 35 30 30 20 63 68  t you put 500 ch
37d0: 61 72 61 63 74 65 72 73 0a 20 20 69 6e 20 69 74  aracters.  in it
37e0: 2e 20 20 41 6e 64 20 69 74 20 77 69 6c 6c 20 6b  .  And it will k
37f0: 65 65 70 20 61 6c 6c 20 35 30 30 20 63 68 61 72  eep all 500 char
3800: 61 63 74 65 72 73 20 69 6e 74 61 63 74 20 2d 20  acters intact - 
3810: 69 74 20 6e 65 76 65 72 20 74 72 75 6e 63 61 74  it never truncat
3820: 65 73 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a 66 61  es..  </p>.}..fa
3830: 71 20 7b 0a 20 20 44 6f 65 73 20 53 51 4c 69 74  q {.  Does SQLit
3840: 65 20 73 75 70 70 6f 72 74 20 61 20 42 4c 4f 42  e support a BLOB
3850: 20 74 79 70 65 3f 0a 7d 20 7b 0a 20 20 3c 70 3e   type?.} {.  <p>
3860: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 73 20  SQLite versions 
3870: 33 2e 30 20 61 6e 64 20 6c 61 74 65 72 20 61 6c  3.0 and later al
3880: 6c 6f 77 20 79 6f 75 20 74 6f 20 73 74 6f 72 65  low you to store
3890: 20 42 4c 4f 42 20 64 61 74 61 20 69 6e 20 61 6e   BLOB data in an
38a0: 79 20 0a 20 20 63 6f 6c 75 6d 6e 2c 20 65 76 65  y .  column, eve
38b0: 6e 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 61  n columns that a
38c0: 72 65 20 64 65 63 6c 61 72 65 64 20 74 6f 20 68  re declared to h
38d0: 6f 6c 64 20 73 6f 6d 65 20 6f 74 68 65 72 20 74  old some other t
38e0: 79 70 65 2e 3c 2f 70 3e 0a 7d 0a 0a 66 61 71 20  ype.</p>.}..faq 
38f0: 7b 0a 20 20 48 6f 77 20 64 6f 20 49 20 61 64 64  {.  How do I add
3900: 20 6f 72 20 64 65 6c 65 74 65 20 63 6f 6c 75 6d   or delete colum
3910: 6e 73 20 66 72 6f 6d 20 61 6e 20 65 78 69 73 74  ns from an exist
3920: 69 6e 67 20 74 61 62 6c 65 20 69 6e 20 53 51 4c  ing table in SQL
3930: 69 74 65 2e 0a 7d 20 7b 0a 20 20 3c 70 3e 53 51  ite..} {.  <p>SQ
3940: 4c 69 74 65 20 68 61 73 20 6c 69 6d 69 74 65 64  Lite has limited
3950: 20 0a 20 20 3c 61 20 68 72 65 66 3d 22 6c 61 6e   .  <a href="lan
3960: 67 5f 61 6c 74 65 72 74 61 62 6c 65 2e 68 74 6d  g_altertable.htm
3970: 6c 22 3e 41 4c 54 45 52 20 54 41 42 4c 45 3c 2f  l">ALTER TABLE</
3980: 61 3e 20 73 75 70 70 6f 72 74 20 74 68 61 74 20  a> support that 
3990: 79 6f 75 20 63 61 6e 0a 20 20 75 73 65 20 74 6f  you can.  use to
39a0: 20 61 64 64 20 61 20 63 6f 6c 75 6d 6e 20 74 6f   add a column to
39b0: 20 74 68 65 20 65 6e 64 20 6f 66 20 61 20 74 61   the end of a ta
39c0: 62 6c 65 20 6f 72 20 74 6f 20 63 68 61 6e 67 65  ble or to change
39d0: 20 74 68 65 20 6e 61 6d 65 20 6f 66 0a 20 20 61   the name of.  a
39e0: 20 74 61 62 6c 65 2e 20 20 0a 20 20 49 66 20 79   table.  .  If y
39f0: 6f 75 20 77 68 61 74 20 6d 61 6b 65 20 6d 6f 72  ou what make mor
3a00: 65 20 63 6f 6d 70 6c 65 78 20 63 68 61 6e 67 65  e complex change
3a10: 73 20 74 68 65 20 73 74 72 75 63 74 75 72 65 20  s the structure 
3a20: 6f 66 20 61 20 74 61 62 6c 65 2c 0a 20 20 79 6f  of a table,.  yo
3a30: 75 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 72  u will have to r
3a40: 65 63 72 65 61 74 65 20 74 68 65 0a 20 20 74 61  ecreate the.  ta
3a50: 62 6c 65 2e 20 20 59 6f 75 20 63 61 6e 20 73 61  ble.  You can sa
3a60: 76 65 20 65 78 69 73 74 69 6e 67 20 64 61 74 61  ve existing data
3a70: 20 74 6f 20 61 20 74 65 6d 70 6f 72 61 72 79 20   to a temporary 
3a80: 74 61 62 6c 65 2c 20 64 72 6f 70 20 74 68 65 0a  table, drop the.
3a90: 20 20 6f 6c 64 20 74 61 62 6c 65 2c 20 63 72 65    old table, cre
3aa0: 61 74 65 20 74 68 65 20 6e 65 77 20 74 61 62 6c  ate the new tabl
3ab0: 65 2c 20 74 68 65 6e 20 63 6f 70 79 20 74 68 65  e, then copy the
3ac0: 20 64 61 74 61 20 62 61 63 6b 20 69 6e 20 66 72   data back in fr
3ad0: 6f 6d 0a 20 20 74 68 65 20 74 65 6d 70 6f 72 61  om.  the tempora
3ae0: 72 79 20 74 61 62 6c 65 2e 3c 2f 70 3e 0a 0a 20  ry table.</p>.. 
3af0: 20 3c 70 3e 46 6f 72 20 65 78 61 6d 70 6c 65 2c   <p>For example,
3b00: 20 73 75 70 70 6f 73 65 20 79 6f 75 20 68 61 76   suppose you hav
3b10: 65 20 61 20 74 61 62 6c 65 20 6e 61 6d 65 64 20  e a table named 
3b20: 22 74 31 22 20 77 69 74 68 20 63 6f 6c 75 6d 6e  "t1" with column
3b30: 73 0a 20 20 6e 61 6d 65 73 20 22 61 22 2c 20 22  s.  names "a", "
3b40: 62 22 2c 20 61 6e 64 20 22 63 22 20 61 6e 64 20  b", and "c" and 
3b50: 74 68 61 74 20 79 6f 75 20 77 61 6e 74 20 74 6f  that you want to
3b60: 20 64 65 6c 65 74 65 20 63 6f 6c 75 6d 6e 20 22   delete column "
3b70: 63 22 20 66 72 6f 6d 0a 20 20 74 68 69 73 20 74  c" from.  this t
3b80: 61 62 6c 65 2e 20 20 54 68 65 20 66 6f 6c 6c 6f  able.  The follo
3b90: 77 69 6e 67 20 73 74 65 70 73 20 69 6c 6c 75 73  wing steps illus
3ba0: 74 72 61 74 65 20 68 6f 77 20 74 68 69 73 20 63  trate how this c
3bb0: 6f 75 6c 64 20 62 65 20 64 6f 6e 65 3a 0a 20 20  ould be done:.  
3bc0: 3c 2f 70 3e 0a 0a 20 20 3c 62 6c 6f 63 6b 71 75  </p>..  <blockqu
3bd0: 6f 74 65 3e 3c 70 72 65 3e 0a 42 45 47 49 4e 20  ote><pre>.BEGIN 
3be0: 54 52 41 4e 53 41 43 54 49 4f 4e 3b 0a 43 52 45  TRANSACTION;.CRE
3bf0: 41 54 45 20 54 45 4d 50 4f 52 41 52 59 20 54 41  ATE TEMPORARY TA
3c00: 42 4c 45 20 74 31 5f 62 61 63 6b 75 70 28 61 2c  BLE t1_backup(a,
3c10: 62 29 3b 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20  b);.INSERT INTO 
3c20: 74 31 5f 62 61 63 6b 75 70 20 53 45 4c 45 43 54  t1_backup SELECT
3c30: 20 61 2c 62 20 46 52 4f 4d 20 74 31 3b 0a 44 52   a,b FROM t1;.DR
3c40: 4f 50 20 54 41 42 4c 45 20 74 31 3b 0a 43 52 45  OP TABLE t1;.CRE
3c50: 41 54 45 20 54 41 42 4c 45 20 74 31 28 61 2c 62  ATE TABLE t1(a,b
3c60: 29 3b 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74  );.INSERT INTO t
3c70: 31 20 53 45 4c 45 43 54 20 61 2c 62 20 46 52 4f  1 SELECT a,b FRO
3c80: 4d 20 74 31 5f 62 61 63 6b 75 70 3b 0a 44 52 4f  M t1_backup;.DRO
3c90: 50 20 54 41 42 4c 45 20 74 31 5f 62 61 63 6b 75  P TABLE t1_backu
3ca0: 70 3b 0a 43 4f 4d 4d 49 54 3b 0a 3c 2f 70 72 65  p;.COMMIT;.</pre
3cb0: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 7d  ></blockquote>.}
3cc0: 0a 0a 66 61 71 20 7b 0a 20 20 49 20 64 65 6c 65  ..faq {.  I dele
3cd0: 74 65 64 20 61 20 6c 6f 74 20 6f 66 20 64 61 74  ted a lot of dat
3ce0: 61 20 62 75 74 20 74 68 65 20 64 61 74 61 62 61  a but the databa
3cf0: 73 65 20 66 69 6c 65 20 64 69 64 20 6e 6f 74 20  se file did not 
3d00: 67 65 74 20 61 6e 79 0a 20 20 73 6d 61 6c 6c 65  get any.  smalle
3d10: 72 2e 20 20 49 73 20 74 68 69 73 20 61 20 62 75  r.  Is this a bu
3d20: 67 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 4e 6f 2e 20  g?.} {.  <p>No. 
3d30: 20 57 68 65 6e 20 79 6f 75 20 64 65 6c 65 74 65   When you delete
3d40: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f   information fro
3d50: 6d 20 61 6e 20 53 51 4c 69 74 65 20 64 61 74 61  m an SQLite data
3d60: 62 61 73 65 2c 20 74 68 65 0a 20 20 75 6e 75 73  base, the.  unus
3d70: 65 64 20 64 69 73 6b 20 73 70 61 63 65 20 69 73  ed disk space is
3d80: 20 61 64 64 65 64 20 74 6f 20 61 6e 20 69 6e 74   added to an int
3d90: 65 72 6e 61 6c 20 22 66 72 65 65 2d 6c 69 73 74  ernal "free-list
3da0: 22 20 61 6e 64 20 69 73 20 72 65 75 73 65 64 0a  " and is reused.
3db0: 20 20 74 68 65 20 6e 65 78 74 20 74 69 6d 65 20    the next time 
3dc0: 79 6f 75 20 69 6e 73 65 72 74 20 64 61 74 61 2e  you insert data.
3dd0: 20 20 54 68 65 20 64 69 73 6b 20 73 70 61 63 65    The disk space
3de0: 20 69 73 20 6e 6f 74 20 6c 6f 73 74 2e 20 20 42   is not lost.  B
3df0: 75 74 0a 20 20 6e 65 69 74 68 65 72 20 69 73 20  ut.  neither is 
3e00: 69 74 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74  it returned to t
3e10: 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73  he operating sys
3e20: 74 65 6d 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 49  tem.</p>..  <p>I
3e30: 66 20 79 6f 75 20 64 65 6c 65 74 65 20 61 20 6c  f you delete a l
3e40: 6f 74 20 6f 66 20 64 61 74 61 20 61 6e 64 20 77  ot of data and w
3e50: 61 6e 74 20 74 6f 20 73 68 72 69 6e 6b 20 74 68  ant to shrink th
3e60: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
3e70: 0a 20 20 72 75 6e 20 74 68 65 20 3c 61 20 68 72  .  run the <a hr
3e80: 65 66 3d 22 6c 61 6e 67 5f 76 61 63 75 75 6d 2e  ef="lang_vacuum.
3e90: 68 74 6d 6c 22 3e 56 41 43 55 55 4d 3c 2f 61 3e  html">VACUUM</a>
3ea0: 20 63 6f 6d 6d 61 6e 64 2e 0a 20 20 56 41 43 55   command..  VACU
3eb0: 55 4d 20 77 69 6c 6c 20 72 65 63 6f 6e 73 74 72  UM will reconstr
3ec0: 75 63 74 0a 20 20 74 68 65 20 64 61 74 61 62 61  uct.  the databa
3ed0: 73 65 20 66 72 6f 6d 20 73 63 72 61 74 63 68 2e  se from scratch.
3ee0: 20 20 54 68 69 73 20 77 69 6c 6c 20 6c 65 61 76    This will leav
3ef0: 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77  e the database w
3f00: 69 74 68 20 61 6e 20 65 6d 70 74 79 0a 20 20 66  ith an empty.  f
3f10: 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 61 20 66  ree-list and a f
3f20: 69 6c 65 20 74 68 61 74 20 69 73 20 6d 69 6e 69  ile that is mini
3f30: 6d 61 6c 20 69 6e 20 73 69 7a 65 2e 20 20 4e 6f  mal in size.  No
3f40: 74 65 2c 20 68 6f 77 65 76 65 72 2c 20 74 68 61  te, however, tha
3f50: 74 20 74 68 65 0a 20 20 56 41 43 55 55 4d 20 63  t the.  VACUUM c
3f60: 61 6e 20 74 61 6b 65 20 73 6f 6d 65 20 74 69 6d  an take some tim
3f70: 65 20 74 6f 20 72 75 6e 20 28 61 72 6f 75 6e 64  e to run (around
3f80: 20 61 20 68 61 6c 66 20 73 65 63 6f 6e 64 20 70   a half second p
3f90: 65 72 20 6d 65 67 61 62 79 74 65 0a 20 20 6f 6e  er megabyte.  on
3fa0: 20 74 68 65 20 4c 69 6e 75 78 20 62 6f 78 20 77   the Linux box w
3fb0: 68 65 72 65 20 53 51 4c 69 74 65 20 69 73 20 64  here SQLite is d
3fc0: 65 76 65 6c 6f 70 65 64 29 20 61 6e 64 20 69 74  eveloped) and it
3fd0: 20 63 61 6e 20 75 73 65 20 75 70 20 74 6f 20 74   can use up to t
3fe0: 77 69 63 65 0a 20 20 61 73 20 6d 75 63 68 20 74  wice.  as much t
3ff0: 65 6d 70 6f 72 61 72 79 20 64 69 73 6b 20 73 70  emporary disk sp
4000: 61 63 65 20 61 73 20 74 68 65 20 6f 72 69 67 69  ace as the origi
4010: 6e 61 6c 20 66 69 6c 65 20 77 68 69 6c 65 20 69  nal file while i
4020: 74 20 69 73 20 72 75 6e 6e 69 6e 67 2e 0a 20 20  t is running..  
4030: 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 41 73 20 6f 66  </p>..  <p>As of
4040: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20   SQLite version 
4050: 33 2e 31 2c 20 61 6e 20 61 6c 74 65 72 6e 61 74  3.1, an alternat
4060: 69 76 65 20 74 6f 20 75 73 69 6e 67 20 74 68 65  ive to using the
4070: 20 56 41 43 55 55 4d 20 63 6f 6d 6d 61 6e 64 0a   VACUUM command.
4080: 20 20 69 73 20 61 75 74 6f 2d 76 61 63 75 75 6d    is auto-vacuum
4090: 20 6d 6f 64 65 2c 20 65 6e 61 62 6c 65 64 20 75   mode, enabled u
40a0: 73 69 6e 67 20 74 68 65 20 0a 20 20 3c 61 20 68  sing the .  <a h
40b0: 72 65 66 3d 22 70 72 61 67 6d 61 2e 68 74 6d 6c  ref="pragma.html
40c0: 23 70 72 61 67 6d 61 5f 61 75 74 6f 5f 76 61 63  #pragma_auto_vac
40d0: 75 75 6d 22 3e 61 75 74 6f 5f 76 61 63 75 75 6d  uum">auto_vacuum
40e0: 20 70 72 61 67 6d 61 3c 2f 61 3e 2e 3c 2f 70 3e   pragma</a>.</p>
40f0: 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 43 61 6e 20  .}..faq {.  Can 
4100: 49 20 75 73 65 20 53 51 4c 69 74 65 20 69 6e 20  I use SQLite in 
4110: 6d 79 20 63 6f 6d 6d 65 72 63 69 61 6c 20 70 72  my commercial pr
4120: 6f 64 75 63 74 20 77 69 74 68 6f 75 74 20 70 61  oduct without pa
4130: 79 69 6e 67 20 72 6f 79 61 6c 74 69 65 73 3f 0a  ying royalties?.
4140: 7d 20 7b 0a 20 20 3c 70 3e 59 65 73 2e 20 20 53  } {.  <p>Yes.  S
4150: 51 4c 69 74 65 20 69 73 20 69 6e 20 74 68 65 20  QLite is in the 
4160: 0a 20 20 3c 61 20 68 72 65 66 3d 22 63 6f 70 79  .  <a href="copy
4170: 72 69 67 68 74 2e 68 74 6d 6c 22 3e 70 75 62 6c  right.html">publ
4180: 69 63 20 64 6f 6d 61 69 6e 3c 2f 61 3e 2e 20 20  ic domain</a>.  
4190: 4e 6f 20 63 6c 61 69 6d 20 6f 66 20 6f 77 6e 65  No claim of owne
41a0: 72 73 68 69 70 20 69 73 20 6d 61 64 65 0a 20 20  rship is made.  
41b0: 74 6f 20 61 6e 79 20 70 61 72 74 20 6f 66 20 74  to any part of t
41c0: 68 65 20 63 6f 64 65 2e 20 20 59 6f 75 20 63 61  he code.  You ca
41d0: 6e 20 64 6f 20 61 6e 79 74 68 69 6e 67 20 79 6f  n do anything yo
41e0: 75 20 77 61 6e 74 20 77 69 74 68 20 69 74 2e 3c  u want with it.<
41f0: 2f 70 3e 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 48  /p>.}..faq {.  H
4200: 6f 77 20 64 6f 20 49 20 75 73 65 20 61 20 73 74  ow do I use a st
4210: 72 69 6e 67 20 6c 69 74 65 72 61 6c 20 74 68 61  ring literal tha
4220: 74 20 63 6f 6e 74 61 69 6e 73 20 61 6e 20 65 6d  t contains an em
4230: 62 65 64 64 65 64 20 73 69 6e 67 6c 65 2d 71 75  bedded single-qu
4240: 6f 74 65 20 28 27 29 0a 20 20 63 68 61 72 61 63  ote (').  charac
4250: 74 65 72 3f 0a 7d 20 7b 0a 20 20 3c 70 3e 54 68  ter?.} {.  <p>Th
4260: 65 20 53 51 4c 20 73 74 61 6e 64 61 72 64 20 73  e SQL standard s
4270: 70 65 63 69 66 69 65 73 20 74 68 61 74 20 73 69  pecifies that si
4280: 6e 67 6c 65 2d 71 75 6f 74 65 73 20 69 6e 20 73  ngle-quotes in s
4290: 74 72 69 6e 67 73 20 61 72 65 20 65 73 63 61 70  trings are escap
42a0: 65 64 0a 20 20 62 79 20 70 75 74 74 69 6e 67 20  ed.  by putting 
42b0: 74 77 6f 20 73 69 6e 67 6c 65 20 71 75 6f 74 65  two single quote
42c0: 73 20 69 6e 20 61 20 72 6f 77 2e 20 20 53 51 4c  s in a row.  SQL
42d0: 20 77 6f 72 6b 73 20 6c 69 6b 65 20 74 68 65 20   works like the 
42e0: 50 61 73 63 61 6c 20 70 72 6f 67 72 61 6d 6d 69  Pascal programmi
42f0: 6e 67 0a 20 20 6c 61 6e 67 75 61 67 65 20 69 6e  ng.  language in
4300: 20 74 68 65 20 72 65 67 61 72 64 2e 20 20 53 51   the regard.  SQ
4310: 4c 69 74 65 20 66 6f 6c 6c 6f 77 73 20 74 68 69  Lite follows thi
4320: 73 20 73 74 61 6e 64 61 72 64 2e 20 20 45 78 61  s standard.  Exa
4330: 6d 70 6c 65 3a 0a 20 20 3c 2f 70 3e 0a 0a 20 20  mple:.  </p>..  
4340: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65  <blockquote><pre
4350: 3e 0a 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54  >.    INSERT INT
4360: 4f 20 78 79 7a 20 56 41 4c 55 45 53 28 27 35 20  O xyz VALUES('5 
4370: 4f 27 27 63 6c 6f 63 6b 27 29 3b 0a 20 20 3c 2f  O''clock');.  </
4380: 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  pre></blockquote
4390: 3e 0a 7d 0a 0a 66 61 71 20 7b 57 68 61 74 20 69  >.}..faq {What i
43a0: 73 20 61 6e 20 53 51 4c 49 54 45 5f 53 43 48 45  s an SQLITE_SCHE
43b0: 4d 41 20 65 72 72 6f 72 2c 20 61 6e 64 20 77 68  MA error, and wh
43c0: 79 20 61 6d 20 49 20 67 65 74 74 69 6e 67 20 6f  y am I getting o
43d0: 6e 65 3f 7d 20 7b 0a 20 20 3c 70 3e 41 6e 20 53  ne?} {.  <p>An S
43e0: 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 65 72 72  QLITE_SCHEMA err
43f0: 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 20 77  or is returned w
4400: 68 65 6e 20 61 20 0a 20 20 70 72 65 70 61 72 65  hen a .  prepare
4410: 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  d SQL statement 
4420: 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 76 61 6c  is no longer val
4430: 69 64 20 61 6e 64 20 63 61 6e 6e 6f 74 20 62 65  id and cannot be
4440: 20 65 78 65 63 75 74 65 64 2e 0a 20 20 57 68 65   executed..  Whe
4450: 6e 20 74 68 69 73 20 6f 63 63 75 72 73 2c 20 74  n this occurs, t
4460: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6d 75 73  he statement mus
4470: 74 20 62 65 20 72 65 63 6f 6d 70 69 6c 65 64 20  t be recompiled 
4480: 66 72 6f 6d 20 53 51 4c 20 75 73 69 6e 67 20 0a  from SQL using .
4490: 20 20 74 68 65 20 0a 20 20 3c 61 20 68 72 65 66    the .  <a href
44a0: 3d 22 63 61 70 69 33 72 65 66 2e 68 74 6d 6c 23  ="capi3ref.html#
44b0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 22  sqlite3_prepare"
44c0: 3e 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65  >sqlite3_prepare
44d0: 28 29 3c 2f 61 3e 20 41 50 49 2e 0a 20 20 49 6e  ()</a> API..  In
44e0: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20   SQLite version 
44f0: 33 2c 20 61 6e 20 53 51 4c 49 54 45 5f 53 43 48  3, an SQLITE_SCH
4500: 45 4d 41 20 65 72 72 6f 72 20 63 61 6e 0a 20 20  EMA error can.  
4510: 6f 6e 6c 79 20 6f 63 63 75 72 20 77 68 65 6e 20  only occur when 
4520: 75 73 69 6e 67 20 74 68 65 20 0a 20 20 3c 61 20  using the .  <a 
4530: 68 72 65 66 3d 22 63 61 70 69 33 72 65 66 2e 68  href="capi3ref.h
4540: 74 6d 6c 23 73 71 6c 69 74 65 33 5f 70 72 65 70  tml#sqlite3_prep
4550: 61 72 65 22 3e 73 71 6c 69 74 65 33 5f 70 72 65  are">sqlite3_pre
4560: 70 61 72 65 28 29 3c 2f 61 3e 2f 3c 61 0a 20 20  pare()</a>/<a.  
4570: 68 72 65 66 3d 22 63 61 70 69 33 72 65 66 2e 68  href="capi3ref.h
4580: 74 6d 6c 23 73 71 6c 69 74 65 33 5f 73 74 65 70  tml#sqlite3_step
4590: 22 3e 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  ">sqlite3_step()
45a0: 3c 2f 61 3e 2f 3c 61 0a 20 20 68 72 65 66 3d 22  </a>/<a.  href="
45b0: 63 61 70 69 33 72 65 66 2e 68 74 6d 6c 23 73 71  capi3ref.html#sq
45c0: 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 22 3e  lite3_finalize">
45d0: 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65  sqlite3_finalize
45e0: 28 29 3c 2f 61 3e 0a 20 20 41 50 49 20 74 6f 20  ()</a>.  API to 
45f0: 65 78 65 63 75 74 65 20 53 51 4c 2c 20 6e 6f 74  execute SQL, not
4600: 20 77 68 65 6e 20 75 73 69 6e 67 20 74 68 65 0a   when using the.
4610: 20 20 3c 61 20 68 72 65 66 3d 22 63 61 70 69 33    <a href="capi3
4620: 72 65 66 2e 68 74 6d 6c 23 73 71 6c 69 74 65 33  ref.html#sqlite3
4630: 5f 65 78 65 63 22 3e 73 71 6c 69 74 65 33 5f 65  _exec">sqlite3_e
4640: 78 65 63 28 29 3c 2f 61 3e 2e 20 54 68 69 73 20  xec()</a>. This 
4650: 77 61 73 20 6e 6f 74 0a 20 20 74 68 65 20 63 61  was not.  the ca
4660: 73 65 20 69 6e 20 76 65 72 73 69 6f 6e 20 32 2e  se in version 2.
4670: 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 54 68 65 20 6d  </p>..  <p>The m
4680: 6f 73 74 20 63 6f 6d 6d 6f 6e 20 72 65 61 73 6f  ost common reaso
4690: 6e 20 66 6f 72 20 61 20 70 72 65 70 61 72 65 64  n for a prepared
46a0: 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 62 65   statement to be
46b0: 63 6f 6d 65 20 69 6e 76 61 6c 69 64 0a 20 20 69  come invalid.  i
46c0: 73 20 74 68 61 74 20 74 68 65 20 73 63 68 65 6d  s that the schem
46d0: 61 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  a of the databas
46e0: 65 20 77 61 73 20 6d 6f 64 69 66 69 65 64 20 61  e was modified a
46f0: 66 74 65 72 20 74 68 65 20 53 51 4c 20 77 61 73  fter the SQL was
4700: 20 0a 20 20 70 72 65 70 61 72 65 64 20 28 70 6f   .  prepared (po
4710: 73 73 69 62 6c 79 20 62 79 20 61 6e 6f 74 68 65  ssibly by anothe
4720: 72 20 70 72 6f 63 65 73 73 29 2e 20 20 54 68 65  r process).  The
4730: 20 6f 74 68 65 72 20 72 65 61 73 6f 6e 73 20 74   other reasons t
4740: 68 69 73 20 63 61 6e 20 0a 20 20 68 61 70 70 65  his can .  happe
4750: 6e 20 61 72 65 3a 3c 2f 70 3e 20 0a 20 20 3c 75  n are:</p> .  <u
4760: 6c 3e 0a 20 20 3c 6c 69 3e 41 20 64 61 74 61 62  l>.  <li>A datab
4770: 61 73 65 20 77 61 73 20 3c 61 20 68 72 65 66 3d  ase was <a href=
4780: 22 6c 61 6e 67 5f 64 65 74 61 63 68 2e 68 74 6d  "lang_detach.htm
4790: 6c 22 3e 44 45 54 41 43 48 3c 2f 61 3e 65 64 2e  l">DETACH</a>ed.
47a0: 0a 20 20 3c 6c 69 3e 54 68 65 20 64 61 74 61 62  .  <li>The datab
47b0: 61 73 65 20 77 61 73 20 3c 61 20 68 72 65 66 3d  ase was <a href=
47c0: 22 6c 61 6e 67 5f 76 61 63 75 75 6d 2e 68 74 6d  "lang_vacuum.htm
47d0: 6c 22 3e 56 41 43 55 55 4d 3c 2f 61 3e 65 64 0a  l">VACUUM</a>ed.
47e0: 20 20 3c 6c 69 3e 41 20 75 73 65 72 2d 66 75 6e    <li>A user-fun
47f0: 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e  ction definition
4800: 20 77 61 73 20 64 65 6c 65 74 65 64 20 6f 72 20   was deleted or 
4810: 63 68 61 6e 67 65 64 2e 0a 20 20 3c 6c 69 3e 41  changed..  <li>A
4820: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65   collation seque
4830: 6e 63 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 77  nce definition w
4840: 61 73 20 64 65 6c 65 74 65 64 20 6f 72 20 63 68  as deleted or ch
4850: 61 6e 67 65 64 2e 0a 20 20 3c 6c 69 3e 54 68 65  anged..  <li>The
4860: 20 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 66   authorization f
4870: 75 6e 63 74 69 6f 6e 20 77 61 73 20 63 68 61 6e  unction was chan
4880: 67 65 64 2e 0a 20 20 3c 2f 75 6c 3e 0a 0a 20 20  ged..  </ul>..  
4890: 3c 70 3e 49 6e 20 61 6c 6c 20 63 61 73 65 73 2c  <p>In all cases,
48a0: 20 74 68 65 20 73 6f 6c 75 74 69 6f 6e 20 69 73   the solution is
48b0: 20 74 6f 20 72 65 63 6f 6d 70 69 6c 65 20 74 68   to recompile th
48c0: 65 20 73 74 61 74 65 6d 65 6e 74 20 66 72 6f 6d  e statement from
48d0: 20 53 51 4c 0a 20 20 61 6e 64 20 61 74 74 65 6d   SQL.  and attem
48e0: 70 74 20 74 6f 20 65 78 65 63 75 74 65 20 69 74  pt to execute it
48f0: 20 61 67 61 69 6e 2e 20 42 65 63 61 75 73 65 20   again. Because 
4900: 61 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  a prepared state
4910: 6d 65 6e 74 20 63 61 6e 20 62 65 0a 20 20 69 6e  ment can be.  in
4920: 76 61 6c 69 64 61 74 65 64 20 62 79 20 61 6e 6f  validated by ano
4930: 74 68 65 72 20 70 72 6f 63 65 73 73 20 63 68 61  ther process cha
4940: 6e 67 69 6e 67 20 74 68 65 20 64 61 74 61 62 61  nging the databa
4950: 73 65 20 73 63 68 65 6d 61 2c 20 61 6c 6c 20 63  se schema, all c
4960: 6f 64 65 0a 20 20 74 68 61 74 20 75 73 65 73 20  ode.  that uses 
4970: 74 68 65 0a 20 20 3c 61 20 68 72 65 66 3d 22 63  the.  <a href="c
4980: 61 70 69 33 72 65 66 2e 68 74 6d 6c 23 73 71 6c  api3ref.html#sql
4990: 69 74 65 33 5f 70 72 65 70 61 72 65 22 3e 73 71  ite3_prepare">sq
49a0: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 3c  lite3_prepare()<
49b0: 2f 61 3e 2f 3c 61 0a 20 20 68 72 65 66 3d 22 63  /a>/<a.  href="c
49c0: 61 70 69 33 72 65 66 2e 68 74 6d 6c 23 73 71 6c  api3ref.html#sql
49d0: 69 74 65 33 5f 73 74 65 70 22 3e 73 71 6c 69 74  ite3_step">sqlit
49e0: 65 33 5f 73 74 65 70 28 29 3c 2f 61 3e 2f 3c 61  e3_step()</a>/<a
49f0: 0a 20 20 68 72 65 66 3d 22 63 61 70 69 33 72 65  .  href="capi3re
4a00: 66 2e 68 74 6d 6c 23 73 71 6c 69 74 65 33 5f 66  f.html#sqlite3_f
4a10: 69 6e 61 6c 69 7a 65 22 3e 73 71 6c 69 74 65 33  inalize">sqlite3
4a20: 5f 66 69 6e 61 6c 69 7a 65 28 29 3c 2f 61 3e 0a  _finalize()</a>.
4a30: 20 20 41 50 49 20 73 68 6f 75 6c 64 20 62 65 20    API should be 
4a40: 70 72 65 70 61 72 65 64 20 74 6f 20 68 61 6e 64  prepared to hand
4a50: 6c 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41  le SQLITE_SCHEMA
4a60: 20 65 72 72 6f 72 73 2e 20 41 6e 20 65 78 61 6d   errors. An exam
4a70: 70 6c 65 0a 20 20 6f 66 20 6f 6e 65 20 61 70 70  ple.  of one app
4a80: 72 6f 61 63 68 20 74 6f 20 74 68 69 73 20 66 6f  roach to this fo
4a90: 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a 0a 20 20 3c 62  llows:</p>..  <b
4aa0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a  lockquote><pre>.
4ab0: 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20  .    int rc;.   
4ac0: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70   sqlite3_stmt *p
4ad0: 53 74 6d 74 3b 0a 20 20 20 20 63 68 61 72 20 7a  Stmt;.    char z
4ae0: 53 71 6c 5b 5d 20 3d 20 22 53 45 4c 45 43 54 20  Sql[] = "SELECT 
4af0: 2e 2e 2e 2e 2e 22 3b 0a 0a 20 20 20 20 64 6f 20  .....";..    do 
4b00: 7b 0a 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 69  {.      /* Compi
4b10: 6c 65 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  le the statement
4b20: 20 66 72 6f 6d 20 53 51 4c 2e 20 41 73 73 75 6d   from SQL. Assum
4b30: 65 20 73 75 63 63 65 73 73 2e 20 2a 2f 0a 20 20  e success. */.  
4b40: 20 20 20 20 73 71 6c 69 74 65 33 5f 70 72 65 70      sqlite3_prep
4b50: 61 72 65 28 70 44 62 2c 20 7a 53 71 6c 2c 20 2d  are(pDb, zSql, -
4b60: 31 2c 20 26 70 53 74 6d 74 2c 20 30 29 3b 0a 0a  1, &pStmt, 0);..
4b70: 20 20 20 20 20 20 77 68 69 6c 65 28 20 53 51 4c        while( SQL
4b80: 49 54 45 5f 52 4f 57 3d 3d 73 71 6c 69 74 65 33  ITE_ROW==sqlite3
4b90: 5f 73 74 65 70 28 70 53 74 6d 74 29 20 29 7b 0a  _step(pStmt) ){.
4ba0: 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 73 6f          /* Do so
4bb0: 6d 65 74 68 69 6e 67 20 77 69 74 68 20 74 68 65  mething with the
4bc0: 20 72 6f 77 20 6f 66 20 61 76 61 69 6c 61 62 6c   row of availabl
4bd0: 65 20 64 61 74 61 20 2a 2f 0a 20 20 20 20 20 20  e data */.      
4be0: 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 46 69 6e 61  }..      /* Fina
4bf0: 6c 69 7a 65 20 74 68 65 20 73 74 61 74 65 6d 65  lize the stateme
4c00: 6e 74 2e 20 49 66 20 61 6e 20 53 51 4c 49 54 45  nt. If an SQLITE
4c10: 5f 53 43 48 45 4d 41 20 65 72 72 6f 72 20 68 61  _SCHEMA error ha
4c20: 73 0a 20 20 20 20 20 20 2a 2a 20 6f 63 63 75 72  s.      ** occur
4c30: 65 64 2c 20 74 68 65 6e 20 74 68 65 20 61 62 6f  ed, then the abo
4c40: 76 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74  ve call to sqlit
4c50: 65 33 5f 73 74 65 70 28 29 20 77 69 6c 6c 20 68  e3_step() will h
4c60: 61 76 65 0a 20 20 20 20 20 20 2a 2a 20 72 65 74  ave.      ** ret
4c70: 75 72 6e 65 64 20 53 51 4c 49 54 45 5f 45 52 52  urned SQLITE_ERR
4c80: 4f 52 2e 20 73 71 6c 69 74 65 33 5f 66 69 6e 61  OR. sqlite3_fina
4c90: 6c 69 7a 65 28 29 20 77 69 6c 6c 20 72 65 74 75  lize() will retu
4ca0: 72 6e 0a 20 20 20 20 20 20 2a 2a 20 53 51 4c 49  rn.      ** SQLI
4cb0: 54 45 5f 53 43 48 45 4d 41 2e 20 49 6e 20 74 68  TE_SCHEMA. In th
4cc0: 69 73 20 63 61 73 65 20 74 68 65 20 6c 6f 6f 70  is case the loop
4cd0: 20 77 69 6c 6c 20 65 78 65 63 75 74 65 20 61 67   will execute ag
4ce0: 61 69 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  ain..      */.  
4cf0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
4d00: 5f 66 69 6e 61 6c 69 7a 65 28 70 53 74 6d 74 29  _finalize(pStmt)
4d10: 3b 0a 20 20 20 20 7d 20 77 68 69 6c 65 28 20 72  ;.    } while( r
4d20: 63 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41  c==SQLITE_SCHEMA
4d30: 20 29 3b 0a 20 20 20 20 0a 20 20 3c 2f 70 72 65   );.    .  </pre
4d40: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 7d  ></blockquote>.}
4d50: 0a 0a 66 61 71 20 7b 57 68 79 20 64 6f 65 73 20  ..faq {Why does 
4d60: 52 4f 55 4e 44 28 39 2e 39 35 2c 31 29 20 20 72  ROUND(9.95,1)  r
4d70: 65 74 75 72 6e 20 39 2e 39 20 69 6e 73 74 65 61  eturn 9.9 instea
4d80: 64 20 6f 66 20 31 30 2e 30 3f 0a 20 20 20 20 20  d of 10.0?.     
4d90: 53 68 6f 75 6c 64 6e 27 74 20 39 2e 39 35 20 72  Shouldn't 9.95 r
4da0: 6f 75 6e 64 20 75 70 3f 7d 20 7b 0a 20 20 3c 70  ound up?} {.  <p
4db0: 3e 53 51 4c 69 74 65 20 75 73 65 73 20 62 69 6e  >SQLite uses bin
4dc0: 61 72 79 20 61 72 69 74 68 6d 65 74 69 63 20 61  ary arithmetic a
4dd0: 6e 64 20 69 6e 20 62 69 6e 61 72 79 2c 20 74 68  nd in binary, th
4de0: 65 72 65 20 69 73 20 6e 6f 0a 20 20 77 61 79 20  ere is no.  way 
4df0: 74 6f 20 77 72 69 74 65 20 39 2e 39 35 20 69 6e  to write 9.95 in
4e00: 20 61 20 66 69 6e 69 74 65 20 6e 75 6d 62 65 72   a finite number
4e10: 20 6f 66 20 62 69 74 73 2e 20 20 54 68 65 20 63   of bits.  The c
4e20: 6c 6f 73 65 73 74 20 74 6f 0a 20 20 79 6f 75 20  losest to.  you 
4e30: 63 61 6e 20 67 65 74 20 74 6f 20 39 2e 39 35 20  can get to 9.95 
4e40: 69 6e 20 61 20 36 34 2d 62 69 74 20 49 45 45 45  in a 64-bit IEEE
4e50: 20 66 6c 6f 61 74 20 28 77 68 69 63 68 20 69 73   float (which is
4e60: 20 77 68 61 74 0a 20 20 53 51 4c 69 74 65 20 75   what.  SQLite u
4e70: 73 65 73 29 20 69 73 20 39 2e 39 34 39 39 39 39  ses) is 9.949999
4e80: 39 39 39 39 39 39 39 39 39 32 38 39 34 35 37 32  9999999992894572
4e90: 36 34 32 33 39 38 39 39 38 31 34 31 32 38 38 37  6423989981412887
4ea0: 35 37 33 32 34 32 31 38 37 35 2e 0a 20 20 53 6f  5732421875..  So
4eb0: 20 77 68 65 6e 20 79 6f 75 20 74 79 70 65 20 22   when you type "
4ec0: 39 2e 39 35 22 2c 20 53 51 4c 69 74 65 20 72 65  9.95", SQLite re
4ed0: 61 6c 6c 79 20 75 6e 64 65 72 73 74 61 6e 64 73  ally understands
4ee0: 20 74 68 65 20 6e 75 6d 62 65 72 20 74 6f 20 62   the number to b
4ef0: 65 0a 20 20 74 68 65 20 6d 75 63 68 20 6c 6f 6e  e.  the much lon
4f00: 67 65 72 20 76 61 6c 75 65 20 73 68 6f 77 6e 20  ger value shown 
4f10: 61 62 6f 76 65 2e 20 20 41 6e 64 20 74 68 61 74  above.  And that
4f20: 20 76 61 6c 75 65 20 72 6f 75 6e 64 73 20 64 6f   value rounds do
4f30: 77 6e 2e 3c 2f 70 3e 0a 0a 20 20 3c 70 3e 54 68  wn.</p>..  <p>Th
4f40: 69 73 20 6b 69 6e 64 20 6f 66 20 70 72 6f 62 6c  is kind of probl
4f50: 65 6d 20 63 6f 6d 65 73 20 75 70 20 61 6c 6c 20  em comes up all 
4f60: 74 68 65 20 74 69 6d 65 20 77 68 65 6e 20 64 65  the time when de
4f70: 61 6c 69 6e 67 20 77 69 74 68 0a 20 20 66 6c 6f  aling with.  flo
4f80: 61 74 69 6e 67 20 70 6f 69 6e 74 20 62 69 6e 61  ating point bina
4f90: 72 79 20 6e 75 6d 62 65 72 73 2e 20 20 54 68 65  ry numbers.  The
4fa0: 20 67 65 6e 65 72 61 6c 20 72 75 6c 65 20 74 6f   general rule to
4fb0: 20 72 65 6d 65 6d 62 65 72 20 69 73 0a 20 20 74   remember is.  t
4fc0: 68 61 74 20 6d 6f 73 74 20 66 72 61 63 74 69 6f  hat most fractio
4fd0: 6e 61 6c 20 6e 75 6d 62 65 72 73 20 74 68 61 74  nal numbers that
4fe0: 20 68 61 76 65 20 61 20 66 69 6e 69 74 65 20 72   have a finite r
4ff0: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 69 6e  epresentation in
5000: 20 64 65 63 69 6d 61 6c 0a 20 20 28 61 2e 6b 2e   decimal.  (a.k.
5010: 61 20 22 62 61 73 65 2d 31 30 22 29 0a 20 20 64  a "base-10").  d
5020: 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 66 69 6e  o not have a fin
5030: 69 74 65 20 72 65 70 72 65 73 65 6e 74 61 74 69  ite representati
5040: 6f 6e 20 69 6e 20 62 69 6e 61 72 79 20 28 61 2e  on in binary (a.
5050: 6b 2e 61 20 22 62 61 73 65 2d 32 22 29 2e 0a 20  k.a "base-2").. 
5060: 20 41 6e 64 20 73 6f 20 74 68 65 79 20 61 72 65   And so they are
5070: 0a 20 20 61 70 70 72 6f 78 69 6d 61 74 65 64 20  .  approximated 
5080: 75 73 69 6e 67 20 74 68 65 20 63 6c 6f 73 65 73  using the closes
5090: 74 20 62 69 6e 61 72 79 20 6e 75 6d 62 65 72 20  t binary number 
50a0: 61 76 61 69 6c 61 62 6c 65 2e 20 20 54 68 61 74  available.  That
50b0: 0a 20 20 61 70 70 72 6f 78 69 6d 61 74 69 6f 6e  .  approximation
50c0: 20 69 73 20 75 73 75 61 6c 6c 79 20 76 65 72 79   is usually very
50d0: 20 63 6c 6f 73 65 2c 20 62 75 74 20 69 74 20 77   close, but it w
50e0: 69 6c 6c 20 62 65 20 73 6c 69 67 68 74 6c 79 20  ill be slightly 
50f0: 6f 66 66 0a 20 20 61 6e 64 20 69 6e 20 73 6f 6d  off.  and in som
5100: 65 20 63 61 73 65 73 20 63 61 6e 20 63 61 75 73  e cases can caus
5110: 65 20 79 6f 75 72 20 72 65 73 75 6c 74 73 20 74  e your results t
5120: 6f 20 62 65 20 61 20 6c 69 74 74 6c 65 20 64 69  o be a little di
5130: 66 66 65 72 65 6e 74 0a 20 20 66 72 6f 6d 20 77  fferent.  from w
5140: 68 61 74 20 79 6f 75 20 6d 69 67 68 74 20 65 78  hat you might ex
5150: 70 65 63 74 2e 3c 2f 70 3e 0a 7d 0a 0a 23 20 45  pect.</p>.}..# E
5160: 6e 64 20 6f 66 20 71 75 65 73 74 69 6f 6e 73 20  nd of questions 
5170: 61 6e 64 20 61 6e 73 77 65 72 73 2e 0a 23 23 23  and answers..###
5180: 23 23 23 23 23 23 23 23 23 23 0a 0a 70 75 74 73  ##########..puts
5190: 20 7b 3c 68 32 3e 46 72 65 71 75 65 6e 74 6c 79   {<h2>Frequently
51a0: 20 41 73 6b 65 64 20 51 75 65 73 74 69 6f 6e 73   Asked Questions
51b0: 3c 2f 68 32 3e 7d 0a 0a 23 20 70 75 74 73 20 7b  </h2>}..# puts {
51c0: 3c 44 4c 20 43 4f 4d 50 41 43 54 3e 7d 0a 23 20  <DL COMPACT>}.# 
51d0: 66 6f 72 20 7b 73 65 74 20 69 20 31 7d 20 7b 24  for {set i 1} {$
51e0: 69 3c 24 63 6e 74 7d 20 7b 69 6e 63 72 20 69 7d  i<$cnt} {incr i}
51f0: 20 7b 0a 23 20 20 20 70 75 74 73 20 22 20 20 3c   {.#   puts "  <
5200: 44 54 3e 3c 41 20 48 52 45 46 3d 5c 22 23 71 24  DT><A HREF=\"#q$
5210: 69 5c 22 3e 28 24 69 29 3c 2f 41 3e 3c 2f 44 54  i\">($i)</A></DT
5220: 3e 22 0a 23 20 20 20 70 75 74 73 20 22 20 20 3c  >".#   puts "  <
5230: 44 44 3e 5b 6c 69 6e 64 65 78 20 24 66 61 71 28  DD>[lindex $faq(
5240: 24 69 29 20 30 5d 3c 2f 44 44 3e 22 0a 23 20 7d  $i) 0]</DD>".# }
5250: 0a 23 20 70 75 74 73 20 7b 3c 2f 44 4c 3e 7d 0a  .# puts {</DL>}.
5260: 70 75 74 73 20 7b 3c 4f 4c 3e 7d 0a 66 6f 72 20  puts {<OL>}.for 
5270: 7b 73 65 74 20 69 20 31 7d 20 7b 24 69 3c 24 63  {set i 1} {$i<$c
5280: 6e 74 7d 20 7b 69 6e 63 72 20 69 7d 20 7b 0a 20  nt} {incr i} {. 
5290: 20 70 75 74 73 20 22 3c 6c 69 3e 3c 61 20 68 72   puts "<li><a hr
52a0: 65 66 3d 5c 22 23 71 24 69 5c 22 3e 5b 6c 69 6e  ef=\"#q$i\">[lin
52b0: 64 65 78 20 24 66 61 71 28 24 69 29 20 30 5d 3c  dex $faq($i) 0]<
52c0: 2f 61 3e 3c 2f 6c 69 3e 22 0a 7d 0a 70 75 74 73  /a></li>".}.puts
52d0: 20 7b 3c 2f 4f 4c 3e 7d 0a 0a 66 6f 72 20 7b 73   {</OL>}..for {s
52e0: 65 74 20 69 20 31 7d 20 7b 24 69 3c 24 63 6e 74  et i 1} {$i<$cnt
52f0: 7d 20 7b 69 6e 63 72 20 69 7d 20 7b 0a 20 20 70  } {incr i} {.  p
5300: 75 74 73 20 22 3c 41 20 4e 41 4d 45 3d 5c 22 71  uts "<A NAME=\"q
5310: 24 69 5c 22 3e 3c 48 52 20 2f 3e 22 0a 20 20 70  $i\"><HR />".  p
5320: 75 74 73 20 22 3c 50 3e 3c 42 3e 28 24 69 29 20  uts "<P><B>($i) 
5330: 5b 6c 69 6e 64 65 78 20 24 66 61 71 28 24 69 29  [lindex $faq($i)
5340: 20 30 5d 3c 2f 42 3e 3c 2f 50 3e 5c 6e 22 0a 20   0]</B></P>\n". 
5350: 20 70 75 74 73 20 22 3c 42 4c 4f 43 4b 51 55 4f   puts "<BLOCKQUO
5360: 54 45 3e 5b 6c 69 6e 64 65 78 20 24 66 61 71 28  TE>[lindex $faq(
5370: 24 69 29 20 31 5d 3c 2f 42 4c 4f 43 4b 51 55 4f  $i) 1]</BLOCKQUO
5380: 54 45 3e 3c 2f 4c 49 3e 5c 6e 22 0a 7d 0a 0a 70  TE></LI>\n".}..p
5390: 75 74 73 20 7b 3c 2f 4f 4c 3e 7d 0a 66 6f 6f 74  uts {</OL>}.foot
53a0: 65 72 20 24 72 63 73 69 64 0a                    er $rcsid.