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