0000: 3c 74 69 74 6c 65 3e 43 6f 6d 70 69 6c 61 74 69 <title>Compilati
0010: 6f 6e 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53 on Options For S
0020: 51 4c 69 74 65 3c 2f 74 69 74 6c 65 3e 0a 3c 74 QLite</title>.<t
0030: 63 6c 3e 68 64 5f 6b 65 79 77 6f 72 64 73 20 7b cl>hd_keywords {
0040: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 compile-time opt
0050: 69 6f 6e 73 7d 3c 2f 74 63 6c 3e 0a 0a 3c 68 31 ions}</tcl>..<h1
0060: 3e 31 2e 30 20 43 6f 6d 70 69 6c 61 74 69 6f 6e >1.0 Compilation
0070: 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53 51 4c Options For SQL
0080: 69 74 65 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a 46 6f ite</h1>..<p>.Fo
0090: 72 20 6d 6f 73 74 20 70 75 72 70 6f 73 65 73 2c r most purposes,
00a0: 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65 20 62 SQLite can be b
00b0: 75 69 6c 74 20 6a 75 73 74 20 66 69 6e 65 20 75 uilt just fine u
00c0: 73 69 6e 67 20 74 68 65 20 64 65 66 61 75 6c 74 sing the default
00d0: 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 74 .compilation opt
00e0: 69 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c 20 69 ions. However, i
00f0: 66 20 72 65 71 75 69 72 65 64 2c 20 74 68 65 20 f required, the
0100: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 compile-time opt
0110: 69 6f 6e 73 0a 64 6f 63 75 6d 65 6e 74 65 64 20 ions.documented
0120: 62 65 6c 6f 77 20 63 61 6e 20 62 65 20 75 73 65 below can be use
0130: 64 20 74 6f 20 0a 3c 61 20 68 72 65 66 3d 22 23 d to .<a href="#
0140: 6f 6d 69 74 66 65 61 74 75 72 65 73 22 3e 6f 6d omitfeatures">om
0150: 69 74 20 53 51 4c 69 74 65 20 66 65 61 74 75 72 it SQLite featur
0160: 65 73 3c 2f 61 3e 20 28 72 65 73 75 6c 74 69 6e es</a> (resultin
0170: 67 20 69 6e 0a 61 20 73 6d 61 6c 6c 65 72 20 63 g in.a smaller c
0180: 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72 79 20 ompiled library
0190: 73 69 7a 65 29 20 6f 72 20 74 6f 20 63 68 61 6e size) or to chan
01a0: 67 65 20 74 68 65 0a 3c 61 20 68 72 65 66 3d 22 ge the.<a href="
01b0: 23 64 65 66 61 75 6c 74 73 22 3e 64 65 66 61 75 #defaults">defau
01c0: 6c 74 20 76 61 6c 75 65 73 3c 2f 61 3e 20 6f 66 lt values</a> of
01d0: 20 73 6f 6d 65 20 70 61 72 61 6d 65 74 65 72 73 some parameters
01e0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 76 65 72 ..</p>..<p>.Ever
01f0: 79 20 65 66 66 6f 72 74 20 68 61 73 20 62 65 65 y effort has bee
0200: 6e 20 6d 61 64 65 20 74 6f 20 65 6e 73 75 72 65 n made to ensure
0210: 20 74 68 61 74 20 74 68 65 20 76 61 72 69 6f 75 that the variou
0220: 73 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 0a 6f s combinations.o
0230: 66 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 f compilation op
0240: 74 69 6f 6e 73 20 77 6f 72 6b 20 68 61 72 6d 6f tions work harmo
0250: 6e 69 6f 75 73 6c 79 20 61 6e 64 20 70 72 6f 64 niously and prod
0260: 75 63 65 20 61 20 77 6f 72 6b 69 6e 67 20 6c 69 uce a working li
0270: 62 72 61 72 79 2e 0a 4e 65 76 65 72 74 68 65 6c brary..Neverthel
0280: 65 73 73 2c 20 69 74 20 69 73 20 73 74 72 6f 6e ess, it is stron
0290: 67 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65 64 20 gly recommended
02a0: 74 68 61 74 20 74 68 65 20 53 51 4c 69 74 65 20 that the SQLite
02b0: 74 65 73 74 2d 73 75 69 74 65 0a 62 65 20 65 78 test-suite.be ex
02c0: 65 63 75 74 65 64 20 74 6f 20 63 68 65 63 6b 20 ecuted to check
02d0: 66 6f 72 20 65 72 72 6f 72 73 20 62 65 66 6f 72 for errors befor
02e0: 65 20 75 73 69 6e 67 20 61 6e 20 53 51 4c 69 74 e using an SQLit
02f0: 65 20 6c 69 62 72 61 72 79 20 62 75 69 6c 74 0a e library built.
0300: 77 69 74 68 20 6e 6f 6e 2d 73 74 61 6e 64 61 72 with non-standar
0310: 64 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 d compilation op
0320: 74 69 6f 6e 73 2e 0a 3c 2f 70 3e 0a 3c 61 20 6e tions..</p>.<a n
0330: 61 6d 65 3d 22 64 65 66 61 75 6c 74 73 22 3e 3c ame="defaults"><
0340: 2f 61 3e 0a 3c 68 32 3e 31 2e 31 20 4f 70 74 69 /a>.<h2>1.1 Opti
0350: 6f 6e 73 20 54 6f 20 53 65 74 20 44 65 66 61 75 ons To Set Defau
0360: 6c 74 20 50 61 72 61 6d 65 74 65 72 20 56 61 6c lt Parameter Val
0370: 75 65 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a ues</h2>..<tcl>.
0380: 70 72 6f 63 20 43 4f 4d 50 49 4c 45 5f 4f 50 54 proc COMPILE_OPT
0390: 49 4f 4e 20 7b 6e 61 6d 65 20 74 65 78 74 7d 20 ION {name text}
03a0: 7b 0a 20 20 69 66 20 7b 5b 72 65 67 65 78 70 20 {. if {[regexp
03b0: 7b 53 51 4c 49 54 45 5f 28 5b 41 2d 5a 30 2d 39 {SQLITE_([A-Z0-9
03c0: 5f 5d 2b 29 7d 20 24 6e 61 6d 65 20 61 6c 6c 20 _]+)} $name all
03d0: 6c 61 62 65 6c 5d 7d 20 7b 0a 20 20 20 20 68 64 label]} {. hd
03e0: 5f 66 72 61 67 6d 65 6e 74 20 5b 73 74 72 69 6e _fragment [strin
03f0: 67 20 74 6f 6c 6f 77 65 72 20 24 6c 61 62 65 6c g tolower $label
0400: 5d 0a 20 20 20 20 68 64 5f 6b 65 79 77 6f 72 64 ]. hd_keyword
0410: 73 20 24 61 6c 6c 0a 20 20 7d 0a 20 20 69 66 20 s $all. }. if
0420: 7b 5b 72 65 67 65 78 70 20 7b 5e 59 59 28 5b 41 {[regexp {^YY([A
0430: 2d 5a 30 2d 39 5f 5d 2b 29 7d 20 24 6e 61 6d 65 -Z0-9_]+)} $name
0440: 20 61 6c 6c 20 6c 61 62 65 6c 5d 7d 20 7b 0a 20 all label]} {.
0450: 20 20 20 68 64 5f 66 72 61 67 6d 65 6e 74 20 5b hd_fragment [
0460: 73 74 72 69 6e 67 20 74 6f 6c 6f 77 65 72 20 24 string tolower $
0470: 61 6c 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79 77 all]. hd_keyw
0480: 6f 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20 20 ords $all. }.
0490: 68 64 5f 70 75 74 73 20 3c 70 3e 3c 62 3e 24 6e hd_puts <p><b>$n
04a0: 61 6d 65 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 72 65 ame</b></p>. re
04b0: 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 5c 5c 73 gsub -all "\n\\s
04c0: 2a 5c 6e 22 20 24 74 65 78 74 20 22 3c 2f 70 3e *\n" $text "</p>
04d0: 5c 6e 5c 6e 3c 70 3e 22 20 74 65 78 74 0a 20 20 \n\n<p>" text.
04e0: 68 64 5f 72 65 73 6f 6c 76 65 20 3c 62 6c 6f 63 hd_resolve <bloc
04f0: 6b 71 75 6f 74 65 3e 3c 70 3e 24 74 65 78 74 3c kquote><p>$text<
0500: 2f 70 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e /p></blockquote>
0510: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
0520: 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 ON {SQLITE_DEFAU
0530: 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 3d 3c 69 LT_AUTOVACUUM=<i
0540: 3e 26 6c 74 3b 31 20 6f 72 20 30 26 67 74 3b 3c ><1 or 0><
0550: 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 /i>} {. This ma
0560: 63 72 6f 20 64 65 74 65 72 6d 69 6e 65 73 20 69 cro determines i
0570: 66 20 53 51 4c 69 74 65 20 63 72 65 61 74 65 73 f SQLite creates
0580: 20 64 61 74 61 62 61 73 65 73 20 77 69 74 68 20 databases with
0590: 74 68 65 20 0a 20 20 5b 61 75 74 6f 5f 76 61 63 the . [auto_vac
05a0: 75 75 6d 5d 20 66 6c 61 67 20 73 65 74 20 62 79 uum] flag set by
05b0: 20 64 65 66 61 75 6c 74 2e 20 54 68 65 20 64 65 default. The de
05c0: 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 30 fault value is 0
05d0: 20 0a 20 20 28 64 6f 20 6e 6f 74 20 63 72 65 61 . (do not crea
05e0: 74 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 te auto-vacuum d
05f0: 61 74 61 62 61 73 65 73 29 2e 20 49 6e 20 61 6e atabases). In an
0600: 79 20 63 61 73 65 20 74 68 65 0a 20 20 63 6f 6d y case the. com
0610: 70 69 6c 65 2d 74 69 6d 65 20 64 65 66 61 75 6c pile-time defaul
0620: 74 20 6d 61 79 20 62 65 20 6f 76 65 72 72 69 64 t may be overrid
0630: 64 65 6e 20 62 79 20 74 68 65 20 0a 20 20 5b 50 den by the . [P
0640: 52 41 47 4d 41 20 61 75 74 6f 5f 76 61 63 75 75 RAGMA auto_vacuu
0650: 6d 5d 20 63 6f 6d 6d 61 6e 64 2e 0a 7d 0a 0a 43 m] command..}..C
0660: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 OMPILE_OPTION {S
0670: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 QLITE_DEFAULT_CA
0680: 43 48 45 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b CHE_SIZE=<i><
0690: 70 61 67 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b pages></i>} {
06a0: 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 . This macro se
06b0: 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 ts the default s
06c0: 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67 65 2d ize of the page-
06d0: 63 61 63 68 65 20 66 6f 72 20 65 61 63 68 20 61 cache for each a
06e0: 74 74 61 63 68 65 64 0a 20 20 64 61 74 61 62 61 ttached. databa
06f0: 73 65 2c 20 69 6e 20 70 61 67 65 73 2e 20 54 68 se, in pages. Th
0700: 69 73 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 is can be overri
0710: 64 64 65 6e 20 62 79 20 74 68 65 20 0a 20 20 5b dden by the . [
0720: 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69 7a PRAGMA cache_siz
0730: 65 5d 20 63 6f 6d 6d 61 6e 64 2e 20 54 68 65 20 e] command. The
0740: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 default value is
0750: 20 32 30 30 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 2000..}..COMPIL
0760: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 E_OPTION {SQLITE
0770: 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f _DEFAULT_FILE_FO
0780: 52 4d 41 54 3d 3c 69 3e 26 6c 74 3b 31 20 6f 72 RMAT=<i><1 or
0790: 20 34 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 4></i>} {.
07a0: 54 68 65 20 64 65 66 61 75 6c 74 20 73 63 68 65 The default sche
07b0: 6d 61 2d 6c 65 76 65 6c 20 66 69 6c 65 20 66 6f ma-level file fo
07c0: 72 6d 61 74 20 75 73 65 64 20 62 79 20 53 51 4c rmat used by SQL
07d0: 69 74 65 20 77 68 65 6e 20 63 72 65 61 74 69 6e ite when creatin
07e0: 67 0a 20 20 6e 65 77 20 64 61 74 61 62 61 73 65 g. new database
07f0: 20 66 69 6c 65 73 20 69 73 20 73 65 74 20 62 79 files is set by
0800: 20 74 68 69 73 20 6d 61 63 72 6f 2e 20 20 54 68 this macro. Th
0810: 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 73 20 61 e file formats a
0820: 72 65 20 61 6c 6c 0a 20 20 76 65 72 79 20 73 69 re all. very si
0830: 6d 69 6c 61 72 2e 20 20 54 68 65 20 64 69 66 66 milar. The diff
0840: 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 66 erence between f
0850: 6f 72 6d 61 74 73 20 31 20 61 6e 64 20 34 20 69 ormats 1 and 4 i
0860: 73 20 74 68 61 74 20 66 6f 72 6d 61 74 0a 20 20 s that format.
0870: 34 20 75 6e 64 65 72 73 74 61 6e 64 73 20 64 65 4 understands de
0880: 73 63 65 6e 64 69 6e 67 20 69 6e 64 69 63 65 73 scending indices
0890: 20 61 6e 64 20 68 61 73 20 61 20 74 69 67 68 74 and has a tight
08a0: 65 72 20 65 6e 63 6f 64 69 6e 67 20 66 6f 72 0a er encoding for.
08b0: 20 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 73 boolean values
08c0: 2e 0a 0a 20 20 53 51 4c 69 74 65 20 28 61 73 20 ... SQLite (as
08d0: 6f 66 20 5b 76 65 72 73 69 6f 6e 20 33 2e 36 2e of [version 3.6.
08e0: 30 5d 29 20 63 61 6e 20 72 65 61 64 20 61 6e 64 0]) can read and
08f0: 20 77 72 69 74 65 20 61 6e 79 20 66 69 6c 65 20 write any file
0900: 66 6f 72 6d 61 74 0a 20 20 62 65 74 77 65 65 6e format. between
0910: 20 31 20 61 6e 64 20 34 2e 20 20 42 75 74 20 6f 1 and 4. But o
0920: 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 lder versions of
0930: 20 53 51 4c 69 74 65 20 6d 69 67 68 74 20 6e 6f SQLite might no
0940: 74 20 62 65 20 61 62 6c 65 20 74 6f 0a 20 20 72 t be able to. r
0950: 65 61 64 20 66 6f 72 6d 61 74 73 20 67 72 65 61 ead formats grea
0960: 74 65 72 20 74 68 61 6e 20 31 2e 20 20 53 6f 20 ter than 1. So
0970: 74 68 61 74 20 6f 6c 64 65 72 20 76 65 72 73 69 that older versi
0980: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 77 69 ons of SQLite wi
0990: 6c 6c 0a 20 20 62 65 20 61 62 6c 65 20 74 6f 20 ll. be able to
09a0: 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 64 read and write d
09b0: 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 63 72 atabase files cr
09c0: 65 61 74 65 64 20 62 79 20 6e 65 77 65 72 20 76 eated by newer v
09d0: 65 72 73 69 6f 6e 73 0a 20 20 6f 66 20 53 51 4c ersions. of SQL
09e0: 69 74 65 2c 20 74 68 65 20 64 65 66 61 75 6c 74 ite, the default
09f0: 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 69 73 20 file format is
0a00: 73 65 74 20 74 6f 20 31 20 66 6f 72 20 6d 61 78 set to 1 for max
0a10: 69 6d 75 6d 0a 20 20 63 6f 6d 70 61 74 69 62 69 imum. compatibi
0a20: 6c 69 74 79 2e 0a 0a 20 20 54 68 65 20 66 69 6c lity... The fil
0a30: 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 61 20 6e e format for a n
0a40: 65 77 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 ew database can
0a50: 62 65 20 73 65 74 20 61 74 20 72 75 6e 74 69 6d be set at runtim
0a60: 65 20 75 73 69 6e 67 0a 20 20 74 68 65 20 5b 50 e using. the [P
0a70: 52 41 47 4d 41 20 6c 65 67 61 63 79 5f 66 69 6c RAGMA legacy_fil
0a80: 65 5f 66 6f 72 6d 61 74 5d 20 63 6f 6d 6d 61 6e e_format] comman
0a90: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 d..}..COMPILE_OP
0aa0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 TION {SQLITE_DEF
0ab0: 41 55 4c 54 5f 4a 4f 55 52 4e 41 4c 5f 53 49 5a AULT_JOURNAL_SIZ
0ac0: 45 5f 4c 49 4d 49 54 3d 3c 69 3e 26 6c 74 3b 62 E_LIMIT=<i><b
0ad0: 79 74 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a ytes></i>} {.
0ae0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 73 65 This option se
0af0: 74 73 20 74 68 65 20 73 69 7a 65 20 6c 69 6d 69 ts the size limi
0b00: 74 20 6f 6e 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f t on rollback jo
0b10: 75 72 6e 61 6c 20 66 69 6c 65 73 20 69 6e 0a 20 urnal files in.
0b20: 20 5b 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 70 [journal_mode p
0b30: 72 61 67 6d 61 20 7c 20 70 65 72 73 69 73 74 65 ragma | persiste
0b40: 6e 74 20 6a 6f 75 72 6e 61 6c 20 6d 6f 64 65 5d nt journal mode]
0b50: 2e 20 20 57 68 65 6e 20 74 68 69 73 20 0a 20 20 . When this .
0b60: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 compile-time opt
0b70: 69 6f 6e 20 69 73 20 6f 6d 69 74 74 65 64 20 74 ion is omitted t
0b80: 68 65 72 65 20 69 73 20 6e 6f 20 75 70 70 65 72 here is no upper
0b90: 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65 0a 20 20 bound on the.
0ba0: 73 69 7a 65 20 6f 66 20 74 68 65 20 72 6f 6c 6c size of the roll
0bb0: 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 66 69 6c back journal fil
0bc0: 65 2e 20 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 e. The journal
0bd0: 66 69 6c 65 20 73 69 7a 65 20 6c 69 6d 69 74 0a file size limit.
0be0: 20 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 can be changed
0bf0: 20 61 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 at run-time usi
0c00: 6e 67 20 74 68 65 20 5b 6a 6f 75 72 6e 61 6c 5f ng the [journal_
0c10: 73 69 7a 65 5f 6c 69 6d 69 74 20 70 72 61 67 6d size_limit pragm
0c20: 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f a]..}..COMPILE_O
0c30: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 PTION {SQLITE_DE
0c40: 46 41 55 4c 54 5f 4d 45 4d 53 54 41 54 55 53 3d FAULT_MEMSTATUS=
0c50: 3c 69 3e 26 6c 74 3b 31 20 6f 72 20 30 26 67 74 <i><1 or 0>
0c60: 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 ;</i>} {. This
0c70: 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f macro is used to
0c80: 20 64 65 74 65 72 6d 69 6e 65 20 77 68 65 74 68 determine wheth
0c90: 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 66 65 er or not the fe
0ca0: 61 74 75 72 65 73 20 65 6e 61 62 6c 65 64 20 61 atures enabled a
0cb0: 6e 64 0a 20 20 64 69 73 61 62 6c 65 64 20 75 73 nd. disabled us
0cc0: 69 6e 67 20 74 68 65 20 53 51 4c 49 54 45 5f 43 ing the SQLITE_C
0cd0: 4f 4e 46 49 47 5f 4d 45 4d 53 54 41 54 55 53 20 ONFIG_MEMSTATUS
0ce0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 5b 73 71 6c argument to [sql
0cf0: 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 5d 0a 20 ite3_config()].
0d00: 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 62 are available b
0d10: 79 20 64 65 66 61 75 6c 74 2e 20 54 68 65 20 64 y default. The d
0d20: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 efault value is
0d30: 31 20 28 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 1 ([SQLITE_CONFI
0d40: 47 5f 4d 45 4d 53 54 41 54 55 53 5d 0a 20 20 72 G_MEMSTATUS]. r
0d50: 65 6c 61 74 65 64 20 66 65 61 74 75 72 65 73 20 elated features
0d60: 65 6e 61 62 6c 65 64 29 2e 0a 7d 0a 0a 43 4f 4d enabled)..}..COM
0d70: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c PILE_OPTION {SQL
0d80: 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 ITE_DEFAULT_PAGE
0d90: 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b 62 79 74 _SIZE=<i><byt
0da0: 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 es></i>} {.
0db0: 54 68 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 This macro is us
0dc0: 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 64 65 ed to set the de
0dd0: 66 61 75 6c 74 20 70 61 67 65 2d 73 69 7a 65 20 fault page-size
0de0: 75 73 65 64 20 77 68 65 6e 20 61 0a 20 20 64 61 used when a. da
0df0: 74 61 62 61 73 65 20 69 73 20 63 72 65 61 74 65 tabase is create
0e00: 64 2e 20 54 68 65 20 76 61 6c 75 65 20 61 73 73 d. The value ass
0e10: 69 67 6e 65 64 20 6d 75 73 74 20 62 65 20 61 20 igned must be a
0e20: 70 6f 77 65 72 20 6f 66 20 32 2e 20 54 68 65 0a power of 2. The.
0e30: 20 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 default value
0e40: 69 73 20 31 30 32 34 2e 20 54 68 65 20 63 6f 6d is 1024. The com
0e50: 70 69 6c 65 2d 74 69 6d 65 20 64 65 66 61 75 6c pile-time defaul
0e60: 74 20 6d 61 79 20 62 65 20 6f 76 65 72 72 69 64 t may be overrid
0e70: 64 65 6e 20 61 74 20 0a 20 20 72 75 6e 74 69 6d den at . runtim
0e80: 65 20 62 79 20 74 68 65 20 5b 50 52 41 47 4d 41 e by the [PRAGMA
0e90: 20 70 61 67 65 5f 73 69 7a 65 5d 20 63 6f 6d 6d page_size] comm
0ea0: 61 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f and..}..COMPILE_
0eb0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 OPTION {SQLITE_D
0ec0: 45 46 41 55 4c 54 5f 54 45 4d 50 5f 43 41 43 48 EFAULT_TEMP_CACH
0ed0: 45 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b 70 61 E_SIZE=<i><pa
0ee0: 67 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 ges></i>} {.
0ef0: 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74 73 This macro sets
0f00: 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 69 7a the default siz
0f10: 65 20 6f 66 20 74 68 65 20 70 61 67 65 2d 63 61 e of the page-ca
0f20: 63 68 65 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 che for temporar
0f30: 79 20 66 69 6c 65 73 0a 20 20 63 72 65 61 74 65 y files. create
0f40: 64 20 62 79 20 53 51 4c 69 74 65 20 74 6f 20 73 d by SQLite to s
0f50: 74 6f 72 65 20 69 6e 74 65 72 6d 65 64 69 61 74 tore intermediat
0f60: 65 20 72 65 73 75 6c 74 73 2c 20 69 6e 20 70 61 e results, in pa
0f70: 67 65 73 2e 20 49 74 20 64 6f 65 73 0a 20 20 6e ges. It does. n
0f80: 6f 74 20 61 66 66 65 63 74 20 74 68 65 20 70 61 ot affect the pa
0f90: 67 65 2d 63 61 63 68 65 20 66 6f 72 20 74 68 65 ge-cache for the
0fa0: 20 74 65 6d 70 20 64 61 74 61 62 61 73 65 2c 20 temp database,
0fb0: 77 68 65 72 65 20 74 61 62 6c 65 73 20 63 72 65 where tables cre
0fc0: 61 74 65 64 0a 20 20 75 73 69 6e 67 20 5b 43 52 ated. using [CR
0fd0: 45 41 54 45 20 54 41 42 4c 45 20 7c 20 43 52 45 EATE TABLE | CRE
0fe0: 41 54 45 20 54 45 4d 50 20 54 41 42 4c 45 5d 20 ATE TEMP TABLE]
0ff0: 61 72 65 20 73 74 6f 72 65 64 2e 20 54 68 65 20 are stored. The
1000: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 0a 20 20 default value.
1010: 69 73 20 35 30 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 is 500..}..COMPI
1020: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 59 59 53 54 41 LE_OPTION {YYSTA
1030: 43 4b 44 45 50 54 48 3d 3c 69 3e 26 6c 74 3b 6d CKDEPTH=<i><m
1040: 61 78 5f 64 65 70 74 68 26 67 74 3b 3c 2f 69 3e ax_depth></i>
1050: 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f } {. This macro
1060: 20 73 65 74 73 20 74 68 65 20 6d 61 78 69 6d 75 sets the maximu
1070: 6d 20 64 65 70 74 68 20 6f 66 20 74 68 65 20 4c m depth of the L
1080: 41 4c 52 28 31 29 20 73 74 61 63 6b 20 75 73 65 ALR(1) stack use
1090: 64 20 62 79 0a 20 20 74 68 65 20 53 51 4c 20 70 d by. the SQL p
10a0: 61 72 73 65 72 20 77 69 74 68 69 6e 20 53 51 4c arser within SQL
10b0: 69 74 65 2e 20 20 54 68 65 20 64 65 66 61 75 6c ite. The defaul
10c0: 74 20 76 61 6c 75 65 20 69 73 20 31 30 30 2e 20 t value is 100.
10d0: 20 41 20 74 79 70 69 63 61 6c 0a 20 20 61 70 70 A typical. app
10e0: 6c 69 63 61 74 69 6f 6e 20 77 69 6c 6c 20 75 73 lication will us
10f0: 65 20 6c 65 73 73 20 74 68 61 6e 20 61 62 6f 75 e less than abou
1100: 74 20 32 30 20 6c 65 76 65 6c 73 20 6f 66 20 74 t 20 levels of t
1110: 68 65 20 73 74 61 63 6b 2e 0a 20 20 44 65 76 65 he stack.. Deve
1120: 6c 6f 70 65 72 73 20 77 68 6f 73 65 20 61 70 70 lopers whose app
1130: 6c 69 63 61 74 69 6f 6e 73 20 63 6f 6e 74 61 69 lications contai
1140: 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 n SQL statements
1150: 20 74 68 61 74 20 0a 20 20 6e 65 65 64 20 6d 6f that . need mo
1160: 72 65 20 74 68 61 6e 20 31 30 30 20 4c 41 4c 52 re than 100 LALR
1170: 28 31 29 20 73 74 61 63 6b 20 65 6e 74 72 69 65 (1) stack entrie
1180: 73 20 73 68 6f 75 6c 64 20 73 65 72 69 6f 75 73 s should serious
1190: 6c 79 0a 20 20 63 6f 6e 73 69 64 65 72 20 72 65 ly. consider re
11a0: 66 61 63 74 6f 72 69 6e 67 20 74 68 65 69 72 20 factoring their
11b0: 53 51 4c 20 61 73 20 69 74 20 69 73 20 6c 69 6b SQL as it is lik
11c0: 65 6c 79 20 74 6f 20 62 65 20 77 65 6c 6c 20 62 ely to be well b
11d0: 65 79 6f 6e 64 0a 20 20 74 68 65 20 61 62 69 6c eyond. the abil
11e0: 69 74 79 20 6f 66 20 61 6e 79 20 68 75 6d 61 6e ity of any human
11f0: 20 74 6f 20 63 6f 6d 70 72 65 68 65 6e 64 2e 0a to comprehend..
1200: 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 68 32 3e 31 2e }.</tcl>..<h2>1.
1210: 32 20 4f 70 74 69 6f 6e 73 20 54 6f 20 53 65 74 2 Options To Set
1220: 20 53 69 7a 65 20 4c 69 6d 69 74 73 3c 2f 68 32 Size Limits</h2
1230: 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72 65 20 >..<p>There are
1240: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 compile-time opt
1250: 69 6f 6e 73 20 74 68 61 74 20 77 69 6c 6c 20 73 ions that will s
1260: 65 74 20 75 70 70 65 72 20 62 6f 75 6e 64 73 0a et upper bounds.
1270: 6f 6e 20 74 68 65 20 73 69 7a 65 73 20 6f 66 20 on the sizes of
1280: 76 61 72 69 6f 75 73 20 73 74 72 75 63 74 75 72 various structur
1290: 65 73 20 69 6e 20 53 51 4c 69 74 65 2e 20 20 54 es in SQLite. T
12a0: 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a he compile-time.
12b0: 6f 70 74 69 6f 6e 73 20 6e 6f 72 6d 61 6c 6c 79 options normally
12c0: 20 73 65 74 20 61 20 68 61 72 64 20 75 70 70 65 set a hard uppe
12d0: 72 20 62 6f 75 6e 64 20 74 68 61 74 20 63 61 6e r bound that can
12e0: 20 62 65 20 63 68 61 6e 67 65 64 0a 61 74 20 72 be changed.at r
12f0: 75 6e 2d 74 69 6d 65 20 6f 6e 20 69 6e 64 69 76 un-time on indiv
1300: 69 64 75 61 6c 20 5b 64 61 74 61 62 61 73 65 20 idual [database
1310: 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 20 75 73 69 connections] usi
1320: 6e 67 20 74 68 65 0a 5b 73 71 6c 69 74 65 33 5f ng the.[sqlite3_
1330: 6c 69 6d 69 74 28 29 5d 20 69 6e 74 65 72 66 61 limit()] interfa
1340: 63 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 ce.</p>..<p>The
1350: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 compile-time opt
1360: 69 6f 6e 73 20 66 6f 72 20 73 65 74 74 69 6e 67 ions for setting
1370: 20 75 70 70 65 72 20 62 6f 75 6e 64 73 20 61 72 upper bounds ar
1380: 65 0a 5b 6c 69 6d 69 74 73 20 7c 20 64 6f 63 75 e.[limits | docu
1390: 6d 65 6e 74 65 64 20 73 65 70 61 72 61 74 65 6c mented separatel
13a0: 79 5d 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 y]. The followi
13b0: 6e 67 20 69 73 20 61 20 6c 69 73 74 20 6f 66 0a ng is a list of.
13c0: 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 73 65 the available se
13d0: 74 74 69 6e 67 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c ttings:</p>..<ul
13e0: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d >.<li> [SQLITE_M
13f0: 41 58 5f 41 54 54 41 43 48 45 44 5d 20 20 3c 2f AX_ATTACHED] </
1400: 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 li>.<li> [SQLITE
1410: 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 5d 20 20 3c 2f _MAX_COLUMN] </
1420: 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 li>.<li> [SQLITE
1430: 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 _MAX_COMPOUND_SE
1440: 4c 45 43 54 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 LECT] </li>.<li
1450: 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 > [SQLITE_MAX_EX
1460: 50 52 5f 44 45 50 54 48 5d 20 20 3c 2f 6c 69 3e PR_DEPTH] </li>
1470: 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 .<li> [SQLITE_MA
1480: 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 5d 20 X_FUNCTION_ARG]
1490: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c </li>.<li> [SQL
14a0: 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 5d 20 ITE_MAX_LENGTH]
14b0: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c </li>.<li> [SQL
14c0: 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 ITE_MAX_LIKE_PAT
14d0: 54 45 52 4e 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f TERN_LENGTH] </
14e0: 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 li>.<li> [SQLITE
14f0: 5f 4d 41 58 5f 50 41 47 45 5f 43 4f 55 4e 54 5d _MAX_PAGE_COUNT]
1500: 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 </li>.<li> [SQ
1510: 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 LITE_MAX_PAGE_SI
1520: 5a 45 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 ZE] </li>.<li>
1530: 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c 5f [SQLITE_MAX_SQL_
1540: 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c LENGTH] </li>.<
1550: 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f li> [SQLITE_MAX_
1560: 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 5d VARIABLE_NUMBER]
1570: 20 20 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c </li>.</ul>..<
1580: 61 20 6e 61 6d 65 3d 22 63 6f 6e 74 72 6f 6c 66 a name="controlf
1590: 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 eatures"></a>.<h
15a0: 32 3e 31 2e 33 20 4f 70 74 69 6f 6e 73 20 54 6f 2>1.3 Options To
15b0: 20 43 6f 6e 74 72 6f 6c 20 4f 70 65 72 61 74 69 Control Operati
15c0: 6e 67 20 43 68 61 72 61 63 74 65 72 69 73 74 69 ng Characteristi
15d0: 63 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 cs</h2>..<tcl>.C
15e0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 OMPILE_OPTION {S
15f0: 51 4c 49 54 45 5f 43 41 53 45 5f 53 45 4e 53 49 QLITE_CASE_SENSI
1600: 54 49 56 45 5f 4c 49 4b 45 7d 20 7b 0a 20 20 49 TIVE_LIKE} {. I
1610: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 f this option is
1620: 20 70 72 65 73 65 6e 74 2c 20 74 68 65 6e 20 74 present, then t
1630: 68 65 20 62 75 69 6c 74 2d 69 6e 20 5b 4c 49 4b he built-in [LIK
1640: 45 5d 20 6f 70 65 72 61 74 6f 72 20 77 69 6c 6c E] operator will
1650: 20 62 65 0a 20 20 63 61 73 65 20 73 65 6e 73 69 be. case sensi
1660: 74 69 76 65 2e 20 20 54 68 69 73 20 73 61 6d 65 tive. This same
1670: 20 65 66 66 65 63 74 20 63 61 6e 20 62 65 20 61 effect can be a
1680: 63 68 69 65 76 65 64 20 61 74 20 72 75 6e 2d 74 chieved at run-t
1690: 69 6d 65 20 75 73 69 6e 67 0a 20 20 74 68 65 20 ime using. the
16a0: 5b 63 61 73 65 5f 73 65 6e 73 69 74 69 76 65 5f [case_sensitive_
16b0: 6c 69 6b 65 20 70 72 61 67 6d 61 5d 2e 0a 7d 0a like pragma]..}.
16c0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
16d0: 7b 53 51 4c 49 54 45 5f 48 41 56 45 5f 49 53 4e {SQLITE_HAVE_ISN
16e0: 41 4e 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 AN} {. If this
16f0: 6f 70 74 69 6f 6e 20 69 73 20 70 72 65 73 65 6e option is presen
1700: 74 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 77 t, then SQLite w
1710: 69 6c 6c 20 75 73 65 20 74 68 65 20 69 73 6e 61 ill use the isna
1720: 6e 28 29 20 66 75 6e 63 74 69 6f 6e 20 66 72 6f n() function fro
1730: 6d 0a 20 20 74 68 65 20 73 79 73 74 65 6d 20 6d m. the system m
1740: 61 74 68 20 6c 69 62 72 61 72 79 2e 20 20 57 69 ath library. Wi
1750: 74 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 6f thout this optio
1760: 6e 20 28 74 68 65 20 64 65 66 61 75 6c 74 20 62 n (the default b
1770: 65 68 61 76 69 6f 72 29 0a 20 20 53 51 4c 69 74 ehavior). SQLit
1780: 65 20 75 73 65 73 20 69 74 73 20 6f 77 6e 20 69 e uses its own i
1790: 6e 74 65 72 6e 61 6c 20 69 6d 70 6c 65 6d 65 6e nternal implemen
17a0: 74 61 74 69 6f 6e 20 6f 66 20 69 73 6e 61 6e 28 tation of isnan(
17b0: 29 2e 20 20 53 51 4c 69 74 65 20 75 73 65 73 0a ). SQLite uses.
17c0: 20 20 69 74 73 20 6f 77 6e 20 69 6e 74 65 72 6e its own intern
17d0: 61 6c 20 69 73 6e 61 6e 28 29 20 69 6d 70 6c 65 al isnan() imple
17e0: 6d 65 6e 74 61 74 69 6f 6e 20 62 79 20 64 65 66 mentation by def
17f0: 61 75 6c 74 20 62 65 63 61 75 73 65 20 6f 66 20 ault because of
1800: 70 61 73 74 0a 20 20 70 72 6f 62 6c 65 6d 73 20 past. problems
1810: 77 69 74 68 20 73 79 73 74 65 6d 20 69 73 6e 61 with system isna
1820: 6e 28 29 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 7d n() functions..}
1830: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e ..COMPILE_OPTION
1840: 20 7b 53 51 4c 49 54 45 5f 4f 53 5f 4f 54 48 45 {SQLITE_OS_OTHE
1850: 52 3d 3c 69 3e 26 6c 74 3b 30 20 6f 72 20 31 26 R=<i><0 or 1&
1860: 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 65 gt;</i>} {. The
1870: 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 option causes S
1880: 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 69 74 QLite to omit it
1890: 73 20 62 75 69 6c 74 2d 69 6e 20 6f 70 65 72 61 s built-in opera
18a0: 74 69 6e 67 20 73 79 73 74 65 6d 20 69 6e 74 65 ting system inte
18b0: 72 66 61 63 65 73 0a 20 20 66 6f 72 20 55 6e 69 rfaces. for Uni
18c0: 78 2c 20 57 69 6e 64 6f 77 73 2c 20 61 6e 64 20 x, Windows, and
18d0: 4f 53 2f 32 2e 20 20 54 68 65 20 72 65 73 75 6c OS/2. The resul
18e0: 74 69 6e 67 20 6c 69 62 72 61 72 79 20 77 69 6c ting library wil
18f0: 6c 20 68 61 76 65 20 6e 6f 20 64 65 66 61 75 6c l have no defaul
1900: 74 0a 20 20 5b 73 71 6c 69 74 65 33 5f 76 66 73 t. [sqlite3_vfs
1910: 20 7c 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 | operating sys
1920: 74 65 6d 20 69 6e 74 65 72 66 61 63 65 5d 2e 20 tem interface].
1930: 20 41 70 70 6c 69 63 61 74 69 6f 6e 73 20 6d 75 Applications mu
1940: 73 74 20 75 73 65 0a 20 20 5b 73 71 6c 69 74 65 st use. [sqlite
1950: 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 29 3_vfs_register()
1960: 5d 20 74 6f 20 72 65 67 69 73 74 65 72 20 61 6e ] to register an
1970: 20 61 70 70 72 6f 70 72 69 61 74 65 20 69 6e 74 appropriate int
1980: 65 72 66 61 63 65 20 62 65 66 6f 72 65 0a 20 20 erface before.
1990: 75 73 69 6e 67 20 53 51 4c 69 74 65 2e 20 20 41 using SQLite. A
19a0: 70 70 6c 69 63 61 74 69 6f 6e 73 20 6d 75 73 74 pplications must
19b0: 20 61 6c 73 6f 20 73 75 70 70 6c 79 20 69 6d 70 also supply imp
19c0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 66 6f 72 lementations for
19d0: 20 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f the. [sqlite3_
19e0: 6f 73 5f 69 6e 69 74 28 29 5d 20 61 6e 64 20 5b os_init()] and [
19f0: 73 71 6c 69 74 65 33 5f 6f 73 5f 65 6e 64 28 29 sqlite3_os_end()
1a00: 5d 20 69 6e 74 65 72 66 61 63 65 73 2e 20 20 54 ] interfaces. T
1a10: 68 65 20 75 73 75 61 6c 20 70 72 61 63 74 69 63 he usual practic
1a20: 65 0a 20 20 69 73 20 66 6f 72 20 74 68 65 20 73 e. is for the s
1a30: 75 70 70 6c 69 65 64 20 5b 73 71 6c 69 74 65 33 upplied [sqlite3
1a40: 5f 6f 73 5f 69 6e 69 74 28 29 5d 20 74 6f 20 69 _os_init()] to i
1a50: 6e 76 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f 76 nvoke [sqlite3_v
1a60: 66 73 5f 72 65 67 69 73 74 65 72 28 29 5d 2e 0a fs_register()]..
1a70: 20 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 61 75 SQLite will au
1a80: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 76 6f tomatically invo
1a90: 6b 65 20 5b 73 71 6c 69 74 65 33 5f 6f 73 5f 69 ke [sqlite3_os_i
1aa0: 6e 69 74 28 29 5d 20 77 68 65 6e 20 69 74 20 69 nit()] when it i
1ab0: 6e 69 74 69 61 6c 69 7a 65 73 2e 0a 0a 20 20 54 nitializes... T
1ac0: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 74 79 his option is ty
1ad0: 70 69 63 61 6c 6c 79 20 75 73 65 64 20 77 68 65 pically used whe
1ae0: 6e 20 62 75 69 6c 64 69 6e 67 20 53 51 4c 69 74 n building SQLit
1af0: 65 20 66 6f 72 20 61 6e 20 65 6d 62 65 64 64 65 e for an embedde
1b00: 64 0a 20 20 70 6c 61 74 66 6f 72 6d 20 77 69 74 d. platform wit
1b10: 68 20 61 20 63 75 73 74 6f 6d 20 6f 70 65 72 61 h a custom opera
1b20: 74 69 6e 67 20 73 79 73 74 65 6d 2e 0a 7d 0a 0a ting system..}..
1b30: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b COMPILE_OPTION {
1b40: 53 51 4c 49 54 45 5f 53 45 43 55 52 45 5f 44 45 SQLITE_SECURE_DE
1b50: 4c 45 54 45 7d 20 7b 0a 20 20 54 68 69 73 20 63 LETE} {. This c
1b60: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 ompile-time opti
1b70: 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 on causes SQLite
1b80: 20 74 6f 20 6f 76 65 72 77 72 69 74 65 20 64 65 to overwrite de
1b90: 6c 65 74 65 64 0a 20 20 69 6e 66 6f 72 6d 61 74 leted. informat
1ba0: 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f 73 20 69 ion with zeros i
1bb0: 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 6d 61 n addition to ma
1bc0: 72 6b 69 6e 67 20 74 68 65 20 73 70 61 63 65 0a rking the space.
1bd0: 20 20 61 73 20 61 76 61 69 6c 61 62 6c 65 20 66 as available f
1be0: 6f 72 20 72 65 75 73 65 2e 20 20 57 69 74 68 6f or reuse. Witho
1bf0: 75 74 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 ut this option,
1c00: 64 65 6c 65 74 65 64 20 64 61 74 61 0a 20 20 6d deleted data. m
1c10: 69 67 68 74 20 62 65 20 72 65 63 6f 76 65 72 61 ight be recovera
1c20: 62 6c 65 20 66 72 6f 6d 20 61 20 64 61 74 61 62 ble from a datab
1c30: 61 73 65 20 75 73 69 6e 67 20 61 20 62 69 6e 61 ase using a bina
1c40: 72 79 20 65 64 69 74 6f 72 2e 0a 20 20 48 6f 77 ry editor.. How
1c50: 65 76 65 72 2c 20 74 68 65 72 65 20 69 73 20 61 ever, there is a
1c60: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 70 65 6e performance pen
1c70: 61 6c 74 79 20 66 6f 72 20 75 73 69 6e 67 20 74 alty for using t
1c80: 68 69 73 20 6f 70 74 69 6f 6e 2e 0a 0a 20 20 54 his option... T
1c90: 68 69 73 20 6f 70 74 69 6f 6e 20 64 6f 65 73 20 his option does
1ca0: 3c 75 3e 6e 6f 74 3c 2f 75 3e 20 63 61 75 73 65 <u>not</u> cause
1cb0: 20 64 65 6c 65 74 65 64 20 64 61 74 61 20 69 73 deleted data is
1cc0: 20 73 65 63 75 72 65 6c 79 0a 20 20 72 65 6d 6f securely. remo
1cd0: 76 65 64 20 66 72 6f 6d 20 74 68 65 20 75 6e 64 ved from the und
1ce0: 65 72 6c 79 69 6e 67 20 73 74 6f 72 61 67 65 20 erlying storage
1cf0: 6d 65 64 69 61 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c media..}..COMPIL
1d00: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 E_OPTION {SQLITE
1d10: 5f 54 48 52 45 41 44 53 41 46 45 3d 3c 69 3e 26 _THREADSAFE=<i>&
1d20: 6c 74 3b 30 20 6f 72 20 31 20 6f 72 20 32 26 67 lt;0 or 1 or 2&g
1d30: 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 t;</i>} {. This
1d40: 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 option controls
1d50: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
1d60: 63 6f 64 65 20 69 73 20 69 6e 63 6c 75 64 65 64 code is included
1d70: 20 69 6e 20 53 51 4c 69 74 65 20 74 6f 0a 20 20 in SQLite to.
1d80: 65 6e 61 62 6c 65 20 69 74 20 74 6f 20 6f 70 65 enable it to ope
1d90: 72 61 74 65 20 73 61 66 65 6c 79 20 69 6e 20 61 rate safely in a
1da0: 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 65 multithreaded e
1db0: 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 20 54 68 65 nvironment. The
1dc0: 0a 20 20 64 65 66 61 75 6c 74 20 69 73 20 53 51 . default is SQ
1dd0: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d LITE_THREADSAFE=
1de0: 31 20 77 68 69 63 68 20 69 73 20 73 61 66 65 20 1 which is safe
1df0: 66 6f 72 20 75 73 65 20 69 6e 20 61 20 6d 75 6c for use in a mul
1e00: 74 69 74 68 72 65 61 64 65 64 0a 20 20 65 6e 76 tithreaded. env
1e10: 69 72 6f 6e 6d 65 6e 74 2e 20 20 57 68 65 6e 20 ironment. When
1e20: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51 compiled with SQ
1e30: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d LITE_THREADSAFE=
1e40: 30 20 61 6c 6c 20 6d 75 74 65 78 69 6e 67 20 63 0 all mutexing c
1e50: 6f 64 65 0a 20 20 69 73 20 6f 6d 69 74 74 65 64 ode. is omitted
1e60: 20 61 6e 64 20 69 74 20 69 73 20 75 6e 73 61 66 and it is unsaf
1e70: 65 20 74 6f 20 75 73 65 20 53 51 4c 69 74 65 20 e to use SQLite
1e80: 69 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 in a multithread
1e90: 65 64 20 70 72 6f 67 72 61 6d 2e 0a 20 20 57 68 ed program.. Wh
1ea0: 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 en compiled with
1eb0: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
1ec0: 46 45 3d 32 2c 20 53 51 4c 69 74 65 20 63 61 6e FE=2, SQLite can
1ed0: 20 62 65 20 75 73 65 64 20 69 6e 20 61 20 6d 75 be used in a mu
1ee0: 6c 74 69 74 68 72 65 61 64 65 64 0a 20 20 70 72 ltithreaded. pr
1ef0: 6f 67 72 61 6d 20 73 6f 20 6c 6f 6e 67 20 61 73 ogram so long as
1f00: 20 6e 6f 20 74 77 6f 20 74 68 72 65 61 64 73 20 no two threads
1f10: 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 74 attempt to use t
1f20: 68 65 20 73 61 6d 65 0a 20 20 5b 64 61 74 61 62 he same. [datab
1f30: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 5d 20 ase connection]
1f40: 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 at the same time
1f50: 2e 0a 0a 20 20 54 6f 20 70 75 74 20 69 74 20 61 ... To put it a
1f60: 6e 6f 74 68 65 72 20 77 61 79 2c 20 53 51 4c 49 nother way, SQLI
1f70: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 31 20 TE_THREADSAFE=1
1f80: 73 65 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 sets the default
1f90: 0a 20 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f . [threading mo
1fa0: 64 65 5d 20 74 6f 20 53 65 72 69 61 6c 69 7a 65 de] to Serialize
1fb0: 64 2e 20 20 53 51 4c 49 54 45 5f 54 48 52 45 41 d. SQLITE_THREA
1fc0: 44 53 41 46 45 3d 32 20 73 65 74 73 20 74 68 65 DSAFE=2 sets the
1fd0: 20 64 65 66 61 75 6c 74 0a 20 20 5b 74 68 72 65 default. [thre
1fe0: 61 64 69 6e 67 20 6d 6f 64 65 5d 20 74 6f 20 4d ading mode] to M
1ff0: 75 6c 74 69 2d 74 68 72 65 61 64 65 64 2e 20 20 ulti-threaded.
2000: 41 6e 64 20 53 51 4c 49 54 45 5f 54 48 52 45 41 And SQLITE_THREA
2010: 44 53 41 46 45 3d 30 20 73 65 74 73 20 74 68 65 DSAFE=0 sets the
2020: 0a 20 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f . [threading mo
2030: 64 65 5d 20 74 6f 20 53 69 6e 67 6c 65 2d 74 68 de] to Single-th
2040: 72 65 61 64 65 64 2e 0a 0a 20 20 54 68 65 20 76 readed... The v
2050: 61 6c 75 65 20 6f 66 20 53 51 4c 49 54 45 5f 54 alue of SQLITE_T
2060: 48 52 45 41 44 53 41 46 45 20 63 61 6e 20 62 65 HREADSAFE can be
2070: 20 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20 72 determined at r
2080: 75 6e 2d 74 69 6d 65 0a 20 20 75 73 69 6e 67 20 un-time. using
2090: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 74 68 72 the [sqlite3_thr
20a0: 65 61 64 73 61 66 65 28 29 5d 20 69 6e 74 65 72 eadsafe()] inter
20b0: 66 61 63 65 2e 0a 0a 20 20 57 68 65 6e 20 53 51 face... When SQ
20c0: 4c 69 74 65 20 68 61 73 20 62 65 65 6e 20 63 6f Lite has been co
20d0: 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51 4c 49 mpiled with SQLI
20e0: 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 31 20 TE_THREADSAFE=1
20f0: 6f 72 0a 20 20 53 51 4c 49 54 45 5f 54 48 52 45 or. SQLITE_THRE
2100: 41 44 53 41 46 45 3d 32 20 74 68 65 6e 20 74 68 ADSAFE=2 then th
2110: 65 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 e [threading mod
2120: 65 5d 0a 20 20 63 61 6e 20 62 65 20 61 6c 74 65 e]. can be alte
2130: 72 65 64 20 61 74 20 72 75 6e 2d 74 69 6d 65 20 red at run-time
2140: 75 73 69 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 using the [sqlit
2150: 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20 69 6e 74 e3_config()] int
2160: 65 72 66 61 63 65 20 74 6f 67 65 74 68 65 72 0a erface together.
2170: 20 20 77 69 74 68 20 6f 6e 65 20 6f 66 20 74 68 with one of th
2180: 65 73 65 20 76 65 72 62 73 3a 0a 0a 20 20 3c 75 ese verbs:.. <u
2190: 6c 3e 0a 20 20 3c 6c 69 3e 5b 53 51 4c 49 54 45 l>. <li>[SQLITE
21a0: 5f 43 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 _CONFIG_SINGLETH
21b0: 52 45 41 44 5d 0a 20 20 3c 6c 69 3e 5b 53 51 4c READ]. <li>[SQL
21c0: 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 ITE_CONFIG_MULTI
21d0: 54 48 52 45 41 44 5d 0a 20 20 3c 6c 69 3e 5b 53 THREAD]. <li>[S
21e0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 45 52 QLITE_CONFIG_SER
21f0: 49 41 4c 49 5a 45 44 5d 0a 20 20 3c 2f 75 6c 3e IALIZED]. </ul>
2200: 0a 0a 20 20 54 68 65 20 5b 53 51 4c 49 54 45 5f .. The [SQLITE_
2210: 4f 50 45 4e 5f 4e 4f 4d 55 54 45 58 5d 20 61 6e OPEN_NOMUTEX] an
2220: 64 0a 20 20 5b 53 51 4c 49 54 45 5f 4f 50 45 4e d. [SQLITE_OPEN
2230: 5f 46 55 4c 4c 4d 55 54 45 58 5d 20 66 6c 61 67 _FULLMUTEX] flag
2240: 73 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70 s to [sqlite3_op
2250: 65 6e 5f 76 32 28 29 5d 20 63 61 6e 20 61 6c 73 en_v2()] can als
2260: 6f 20 62 65 20 75 73 65 64 0a 20 20 74 6f 20 61 o be used. to a
2270: 64 6a 75 73 74 20 74 68 65 20 5b 74 68 72 65 61 djust the [threa
2280: 64 69 6e 67 20 6d 6f 64 65 5d 20 6f 66 20 69 6e ding mode] of in
2290: 64 69 76 69 64 75 61 6c 20 5b 64 61 74 61 62 61 dividual [databa
22a0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 0a se connections].
22b0: 20 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e 0a 0a at run-time...
22c0: 20 20 4e 6f 74 65 20 74 68 61 74 20 77 68 65 6e Note that when
22d0: 20 53 51 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 SQLite is compi
22e0: 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f led with SQLITE_
22f0: 54 48 52 45 41 44 53 41 46 45 3d 30 2c 20 74 68 THREADSAFE=0, th
2300: 65 20 63 6f 64 65 0a 20 20 74 6f 20 6d 61 6b 65 e code. to make
2310: 20 53 51 4c 69 74 65 20 74 68 72 65 61 64 73 61 SQLite threadsa
2320: 66 65 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72 fe is omitted fr
2330: 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e 20 20 57 om the build. W
2340: 68 65 6e 20 74 68 69 73 20 6f 63 63 75 72 73 2c hen this occurs,
2350: 0a 20 20 69 74 20 69 73 20 69 6d 70 6f 73 73 69 . it is impossi
2360: 62 6c 65 20 74 6f 20 63 68 61 6e 67 65 20 74 68 ble to change th
2370: 65 20 5b 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 e [threading mod
2380: 65 5d 20 61 74 20 73 74 61 72 74 2d 74 69 6d 65 e] at start-time
2390: 20 6f 72 20 72 75 6e 2d 74 69 6d 65 2e 0a 0a 20 or run-time...
23a0: 20 53 65 65 20 74 68 65 20 5b 74 68 72 65 61 64 See the [thread
23b0: 69 6e 67 20 6d 6f 64 65 5d 20 64 6f 63 75 6d 65 ing mode] docume
23c0: 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61 64 64 69 ntation for addi
23d0: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 tional informati
23e0: 6f 6e 0a 20 20 6f 6e 20 61 73 70 65 63 74 73 20 on. on aspects
23f0: 6f 66 20 75 73 69 6e 67 20 53 51 4c 69 74 65 20 of using SQLite
2400: 69 6e 20 61 20 6d 75 6c 74 69 74 68 72 65 61 64 in a multithread
2410: 65 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 0a ed environment..
2420: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f }..COMPILE_OPTIO
2430: 4e 20 7b 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 N {SQLITE_TEMP_S
2440: 54 4f 52 45 3d 3c 69 3e 26 6c 74 3b 30 20 74 68 TORE=<i><0 th
2450: 72 6f 75 67 68 20 33 26 67 74 3b 3c 2f 69 3e 7d rough 3></i>}
2460: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e {. This option
2470: 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74 68 65 controls whethe
2480: 72 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 r temporary file
2490: 73 20 61 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 s are stored on
24a0: 64 69 73 6b 20 6f 72 0a 20 20 69 6e 20 6d 65 6d disk or. in mem
24b0: 6f 72 79 2e 20 20 54 68 65 20 6d 65 61 6e 69 6e ory. The meanin
24c0: 67 73 20 66 6f 72 20 76 61 72 69 6f 75 73 20 73 gs for various s
24d0: 65 74 74 69 6e 67 73 20 6f 66 20 74 68 69 73 20 ettings of this
24e0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a 20 20 6f compile-time. o
24f0: 70 74 69 6f 6e 20 61 72 65 20 61 73 20 66 6f 6c ption are as fol
2500: 6c 6f 77 73 3a 0a 0a 20 20 3c 74 61 62 6c 65 20 lows:.. <table
2510: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 32 22 20 cellpadding="2"
2520: 62 6f 72 64 65 72 3d 22 31 22 3e 0a 20 20 3c 74 border="1">. <t
2530: 72 3e 3c 74 68 3e 53 51 4c 49 54 45 5f 54 45 4d r><th>SQLITE_TEM
2540: 50 5f 53 54 4f 52 45 3c 2f 74 68 3e 3c 74 68 3e P_STORE</th><th>
2550: 4d 65 61 6e 69 6e 67 3c 2f 74 68 3e 3c 2f 74 72 Meaning</th></tr
2560: 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 >. <tr><td alig
2570: 6e 3d 22 63 65 6e 74 65 72 22 3e 30 3c 2f 74 64 n="center">0</td
2580: 3e 3c 74 64 3e 41 6c 77 61 79 73 20 75 73 65 20 ><td>Always use
2590: 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 3c temporary files<
25a0: 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e /td></tr>. <tr>
25b0: 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 <td align="cente
25c0: 72 22 3e 31 3c 2f 74 64 3e 3c 74 64 3e 55 73 65 r">1</td><td>Use
25d0: 20 66 69 6c 65 73 20 62 79 20 64 65 66 61 75 6c files by defaul
25e0: 74 20 62 75 74 20 61 6c 6c 6f 77 20 74 68 65 0a t but allow the.
25f0: 20 20 5b 50 52 41 47 4d 41 20 74 65 6d 70 5f 73 [PRAGMA temp_s
2600: 74 6f 72 65 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f tore] command to
2610: 20 6f 76 65 72 72 69 64 65 3c 2f 74 64 3e 3c 2f override</td></
2620: 74 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c tr>. <tr><td al
2630: 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 32 3c 2f ign="center">2</
2640: 74 64 3e 3c 74 64 3e 55 73 65 20 6d 65 6d 6f 72 td><td>Use memor
2650: 79 20 62 79 20 64 65 66 61 75 6c 74 20 62 75 74 y by default but
2660: 20 61 6c 6c 6f 77 20 74 68 65 0a 20 20 5b 50 52 allow the. [PR
2670: 41 47 4d 41 20 74 65 6d 70 5f 73 74 6f 72 65 5d AGMA temp_store]
2680: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 6f 76 65 72 command to over
2690: 72 69 64 65 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 ride</td></tr>.
26a0: 20 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 <tr><td align="
26b0: 63 65 6e 74 65 72 22 3e 33 3c 2f 74 64 3e 3c 74 center">3</td><t
26c0: 64 3e 41 6c 77 61 79 73 20 75 73 65 20 6d 65 6d d>Always use mem
26d0: 6f 72 79 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 ory</td></tr>.
26e0: 3c 2f 74 61 62 6c 65 3e 0a 0a 20 20 54 68 65 20 </table>.. The
26f0: 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 default setting
2700: 69 73 20 31 2e 20 20 0a 20 20 41 64 64 69 74 69 is 1. . Additi
2710: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e onal information
2720: 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e can be found in
2730: 20 5b 74 65 6d 70 73 74 6f 72 65 20 7c 20 74 65 [tempstore | te
2740: 6d 70 66 69 6c 65 73 2e 68 74 6d 6c 5d 2e 0a 7d mpfiles.html]..}
2750: 0a 3c 2f 74 63 6c 3e 0a 0a 3c 61 20 6e 61 6d 65 .</tcl>..<a name
2760: 3d 22 65 6e 61 62 6c 65 66 65 61 74 75 72 65 73 ="enablefeatures
2770: 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 34 20 4f "></a>.<h2>1.4 O
2780: 70 74 69 6f 6e 73 20 54 6f 20 45 6e 61 62 6c 65 ptions To Enable
2790: 20 46 65 61 74 75 72 65 73 20 4e 6f 72 6d 61 6c Features Normal
27a0: 6c 79 20 54 75 72 6e 65 64 20 4f 66 66 3c 2f 68 ly Turned Off</h
27b0: 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 2>..<tcl>.COMPIL
27c0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 E_OPTION {SQLITE
27d0: 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 _ENABLE_ATOMIC_W
27e0: 52 49 54 45 7d 20 7b 0a 20 20 49 66 20 74 68 69 RITE} {. If thi
27f0: 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 s C-preprocessor
2800: 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 macro is define
2810: 64 20 61 6e 64 20 69 66 20 74 68 65 0a 20 20 78 d and if the. x
2820: 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 DeviceCharacteri
2830: 73 74 69 63 73 20 6d 65 74 68 6f 64 20 6f 66 20 stics method of
2840: 5b 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 [sqlite3_io_meth
2850: 6f 64 73 5d 20 6f 62 6a 65 63 74 20 66 6f 72 0a ods] object for.
2860: 20 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c a database fil
2870: 65 20 72 65 70 6f 72 74 73 20 28 76 69 61 20 6f e reports (via o
2880: 6e 65 20 6f 66 20 74 68 65 20 5b 53 51 4c 49 54 ne of the [SQLIT
2890: 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 5d 20 E_IOCAP_ATOMIC]
28a0: 62 69 74 73 29 0a 20 20 74 68 61 74 20 74 68 65 bits). that the
28b0: 20 66 69 6c 65 73 79 73 74 65 6d 20 73 75 70 70 filesystem supp
28c0: 6f 72 74 73 20 61 74 6f 6d 69 63 20 77 72 69 74 orts atomic writ
28d0: 65 73 20 61 6e 64 20 69 66 20 61 20 74 72 61 6e es and if a tran
28e0: 73 61 63 74 69 6f 6e 0a 20 20 69 6e 76 6f 6c 76 saction. involv
28f0: 65 73 20 61 20 63 68 61 6e 67 65 20 74 6f 20 6f es a change to o
2900: 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 70 61 67 nly a single pag
2910: 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
2920: 65 20 66 69 6c 65 2c 0a 20 20 74 68 65 6e 20 74 e file,. then t
2930: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 he transaction c
2940: 6f 6d 6d 69 74 73 20 77 69 74 68 20 6a 75 73 74 ommits with just
2950: 20 61 20 73 69 6e 67 6c 65 20 77 72 69 74 65 20 a single write
2960: 72 65 71 75 65 73 74 20 6f 66 0a 20 20 61 20 73 request of. a s
2970: 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74 68 ingle page of th
2980: 65 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 6e e database and n
2990: 6f 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e o rollback journ
29a0: 61 6c 20 69 73 20 63 72 65 61 74 65 64 0a 20 20 al is created.
29b0: 6f 72 20 77 72 69 74 74 65 6e 2e 20 20 4f 6e 20 or written. On
29c0: 66 69 6c 65 73 79 73 74 65 6d 73 20 74 68 61 74 filesystems that
29d0: 20 73 75 70 70 6f 72 74 20 61 74 6f 6d 69 63 20 support atomic
29e0: 77 72 69 74 65 73 2c 20 74 68 69 73 0a 20 20 6f writes, this. o
29f0: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 20 ptimization can
2a00: 72 65 73 75 6c 74 20 69 6e 20 73 69 67 6e 69 66 result in signif
2a10: 69 63 61 6e 74 20 73 70 65 65 64 20 69 6d 70 72 icant speed impr
2a20: 6f 76 65 6d 65 6e 74 73 20 66 6f 72 0a 20 20 73 ovements for. s
2a30: 6d 61 6c 6c 20 75 70 64 61 74 65 73 2e 20 20 48 mall updates. H
2a40: 6f 77 65 76 65 72 2c 20 66 65 77 20 66 69 6c 65 owever, few file
2a50: 73 79 73 74 65 6d 73 20 73 75 70 70 6f 72 74 20 systems support
2a60: 74 68 69 73 20 63 61 70 61 62 69 6c 69 74 79 0a this capability.
2a70: 20 20 61 6e 64 20 74 68 65 20 63 6f 64 65 20 70 and the code p
2a80: 61 74 68 73 20 74 68 61 74 20 63 68 65 63 6b 20 aths that check
2a90: 66 6f 72 20 74 68 69 73 20 63 61 70 61 62 69 6c for this capabil
2aa0: 69 74 79 20 73 6c 6f 77 20 64 6f 77 6e 20 77 72 ity slow down wr
2ab0: 69 74 65 0a 20 20 70 65 72 66 6f 72 6d 61 6e 63 ite. performanc
2ac0: 65 20 6f 6e 20 73 79 73 74 65 6d 73 20 74 68 61 e on systems tha
2ad0: 74 20 6c 61 63 6b 20 61 74 6f 6d 69 63 20 77 72 t lack atomic wr
2ae0: 69 74 65 20 63 61 70 61 62 69 6c 69 74 79 2c 20 ite capability,
2af0: 73 6f 20 74 68 69 73 0a 20 20 66 65 61 74 75 72 so this. featur
2b00: 65 20 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 e is disabled by
2b10: 20 64 65 66 61 75 6c 74 2e 0a 7d 0a 0a 43 4f 4d default..}..COM
2b20: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c PILE_OPTION {SQL
2b30: 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d ITE_ENABLE_COLUM
2b40: 4e 5f 4d 45 54 41 44 41 54 41 7d 20 7b 0a 20 20 N_METADATA} {.
2b50: 57 68 65 6e 20 74 68 69 73 20 43 2d 70 72 65 70 When this C-prep
2b60: 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 69 rocessor macro i
2b70: 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c 69 74 s defined, SQLit
2b80: 65 20 69 6e 63 6c 75 64 65 73 20 73 6f 6d 65 0a e includes some.
2b90: 20 20 61 64 64 69 74 69 6f 6e 61 6c 20 41 50 49 additional API
2ba0: 73 20 74 68 61 74 20 70 72 6f 76 69 64 65 20 63 s that provide c
2bb0: 6f 6e 76 65 6e 69 65 6e 74 20 61 63 63 65 73 73 onvenient access
2bc0: 20 74 6f 20 6d 65 74 61 2d 64 61 74 61 20 61 62 to meta-data ab
2bd0: 6f 75 74 0a 20 20 74 61 62 6c 65 73 20 61 6e 64 out. tables and
2be0: 20 71 75 65 72 69 65 73 2e 20 20 54 68 65 20 41 queries. The A
2bf0: 50 49 73 20 74 68 61 74 20 61 72 65 20 65 6e 61 PIs that are ena
2c00: 62 6c 65 64 20 62 79 20 74 68 69 73 20 6f 70 74 bled by this opt
2c10: 69 6f 6e 20 61 72 65 3a 0a 0a 20 20 3c 75 6c 3e ion are:.. <ul>
2c20: 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 . <li> [sqlite3
2c30: 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 _column_database
2c40: 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 _name()] </li>.
2c50: 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 <li> [sqlite3_c
2c60: 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e olumn_database_n
2c70: 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e 0a 20 ame16()] </li>.
2c80: 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 <li> [sqlite3_c
2c90: 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 olumn_table_name
2ca0: 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e ()] </li>. <li>
2cb0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e [sqlite3_column
2cc0: 5f 74 61 62 6c 65 5f 6e 61 6d 65 31 36 28 29 5d _table_name16()]
2cd0: 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 </li>. <li> [s
2ce0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 qlite3_column_or
2cf0: 69 67 69 6e 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c igin_name()] </l
2d00: 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 i>. <li> [sqlit
2d10: 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e e3_column_origin
2d20: 5f 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e _name16()] </li>
2d30: 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 . <li> [sqlite3
2d40: 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 _table_column_me
2d50: 74 61 64 61 74 61 28 29 5d 20 3c 2f 6c 69 3e 0a tadata()] </li>.
2d60: 20 20 3c 2f 75 6c 3e 0a 7d 0a 0a 43 4f 4d 50 49 </ul>.}..COMPI
2d70: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 LE_OPTION {SQLIT
2d80: 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 7d 20 7b E_ENABLE_FTS3} {
2d90: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 . When this opt
2da0: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 20 69 ion is defined i
2db0: 6e 20 74 68 65 20 5b 61 6d 61 6c 67 61 6d 61 74 n the [amalgamat
2dc0: 69 6f 6e 5d 2c 20 76 65 72 73 69 6f 6e 20 33 0a ion], version 3.
2dd0: 20 20 6f 66 20 74 68 65 20 66 75 6c 6c 2d 74 65 of the full-te
2de0: 78 74 20 73 65 61 72 63 68 20 65 6e 67 69 6e 65 xt search engine
2df0: 20 69 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 is added to the
2e00: 20 62 75 69 6c 64 20 61 75 74 6f 6d 61 74 69 63 build automatic
2e10: 61 6c 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 ally..}..COMPILE
2e20: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f _OPTION {SQLITE_
2e30: 45 4e 41 42 4c 45 5f 46 54 53 33 5f 50 41 52 45 ENABLE_FTS3_PARE
2e40: 4e 54 48 45 53 49 53 7d 20 7b 0a 20 20 54 68 69 NTHESIS} {. Thi
2e50: 73 20 6f 70 74 69 6f 6e 20 6d 6f 64 69 66 69 65 s option modifie
2e60: 73 20 74 68 65 20 71 75 65 72 79 20 70 61 74 74 s the query patt
2e70: 65 72 6e 20 70 61 72 73 65 72 20 69 6e 20 46 54 ern parser in FT
2e80: 53 33 20 73 75 63 68 20 74 68 61 74 20 69 74 0a S3 such that it.
2e90: 20 20 73 75 70 70 6f 72 74 73 20 6f 70 65 72 61 supports opera
2ea0: 74 6f 72 73 20 41 4e 44 20 61 6e 64 20 4e 4f 54 tors AND and NOT
2eb0: 20 28 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f (in addition to
2ec0: 20 74 68 65 20 75 73 75 61 6c 20 4f 52 20 61 6e the usual OR an
2ed0: 64 20 4e 45 41 52 29 0a 20 20 61 6e 64 20 61 6c d NEAR). and al
2ee0: 73 6f 20 61 6c 6c 6f 77 73 20 71 75 65 72 79 20 so allows query
2ef0: 65 78 70 72 65 73 73 69 6f 6e 73 20 74 6f 20 63 expressions to c
2f00: 6f 6e 74 61 69 6e 20 6e 65 73 74 65 64 20 70 61 ontain nested pa
2f10: 72 65 6e 74 68 65 73 65 73 69 73 2e 0a 7d 0a 0a renthesesis..}..
2f20: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b COMPILE_OPTION {
2f30: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 43 SQLITE_ENABLE_IC
2f40: 55 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 U} {. This opti
2f50: 6f 6e 20 63 61 75 73 65 73 20 74 68 65 20 0a 20 on causes the .
2f60: 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f <a href="http:/
2f70: 2f 77 77 77 2e 69 63 75 2d 70 72 6f 6a 65 63 74 /www.icu-project
2f80: 2e 6f 72 67 2f 22 3e 49 6e 74 65 72 6e 61 74 69 .org/">Internati
2f90: 6f 6e 61 6c 20 43 6f 6d 70 6f 6e 65 6e 74 73 20 onal Components
2fa0: 66 6f 72 20 55 6e 69 63 6f 64 65 3c 2f 61 3e 0a for Unicode</a>.
2fb0: 20 20 6f 72 20 22 49 43 55 22 20 65 78 74 65 6e or "ICU" exten
2fc0: 73 69 6f 6e 20 74 6f 20 53 51 4c 69 74 65 20 74 sion to SQLite t
2fd0: 6f 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 o be added to th
2fe0: 65 20 62 75 69 6c 64 2e 20 20 0a 7d 0a 0a 43 4f e build. .}..CO
2ff0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 MPILE_OPTION {SQ
3000: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 LITE_ENABLE_IOTR
3010: 41 43 45 7d 20 7b 0a 20 20 57 68 65 6e 20 62 6f ACE} {. When bo
3020: 74 68 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f th the SQLite co
3030: 72 65 20 61 6e 64 20 74 68 65 20 5b 43 6f 6d 6d re and the [Comm
3040: 61 6e 64 20 4c 69 6e 65 20 49 6e 74 65 72 66 61 and Line Interfa
3050: 63 65 5d 20 28 43 4c 49 29 20 61 72 65 20 62 6f ce] (CLI) are bo
3060: 74 68 20 0a 20 20 63 6f 6d 70 69 6c 65 64 20 77 th . compiled w
3070: 69 74 68 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c ith this option,
3080: 20 74 68 65 6e 20 74 68 65 20 43 4c 49 20 70 72 then the CLI pr
3090: 6f 76 69 64 65 73 20 61 6e 20 65 78 74 72 61 20 ovides an extra
30a0: 63 6f 6d 6d 61 6e 64 0a 20 20 6e 61 6d 65 64 20 command. named
30b0: 22 2e 69 6f 74 72 61 63 65 22 20 74 68 61 74 20 ".iotrace" that
30c0: 70 72 6f 76 69 64 65 73 20 61 20 6c 6f 77 2d 6c provides a low-l
30d0: 65 76 65 6c 20 6c 6f 67 20 6f 66 20 49 2f 4f 20 evel log of I/O
30e0: 61 63 74 69 76 69 74 79 2e 0a 20 20 54 68 69 73 activity.. This
30f0: 20 6f 70 74 69 6f 6e 20 69 73 20 65 78 70 65 72 option is exper
3100: 69 6d 65 6e 74 61 6c 20 61 6e 64 20 6d 61 79 20 imental and may
3110: 62 65 20 64 69 73 63 6f 6e 74 69 6e 75 65 64 20 be discontinued
3120: 69 6e 20 61 20 66 75 74 75 72 65 20 72 65 6c 65 in a future rele
3130: 61 73 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f ase..}..COMPILE_
3140: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 OPTION {SQLITE_E
3150: 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f 53 54 NABLE_LOCKING_ST
3160: 59 4c 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 YLE} {. This op
3170: 74 69 6f 6e 20 65 6e 61 62 6c 65 73 20 61 64 64 tion enables add
3180: 69 74 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 69 6e itional logic in
3190: 20 74 68 65 20 4f 53 20 69 6e 74 65 72 66 61 63 the OS interfac
31a0: 65 20 6c 61 79 65 72 20 66 6f 72 0a 20 20 4d 61 e layer for. Ma
31b0: 63 20 4f 53 20 58 2e 20 54 68 65 20 61 64 64 69 c OS X. The addi
31c0: 74 69 6f 6e 61 6c 20 6c 6f 67 69 63 20 61 74 74 tional logic att
31d0: 65 6d 70 74 73 20 74 6f 20 64 65 74 65 72 6d 69 empts to determi
31e0: 6e 65 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 ne the type of t
31f0: 68 65 0a 20 20 75 6e 64 65 72 6c 79 69 6e 67 20 he. underlying
3200: 66 69 6c 65 73 79 73 74 65 6d 20 61 6e 64 20 63 filesystem and c
3210: 68 6f 6f 73 65 20 61 6e 64 20 61 6c 74 65 72 6e hoose and altern
3220: 61 74 69 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 ative locking st
3230: 72 61 74 65 67 79 0a 20 20 74 68 61 74 20 77 6f rategy. that wo
3240: 72 6b 73 20 63 6f 72 72 65 63 74 6c 79 20 66 6f rks correctly fo
3250: 72 20 74 68 61 74 20 66 69 6c 65 73 79 73 74 65 r that filesyste
3260: 6d 20 74 79 70 65 2e 20 46 69 76 65 20 6c 6f 63 m type. Five loc
3270: 6b 69 6e 67 20 73 74 72 61 74 65 67 69 65 73 20 king strategies
3280: 0a 20 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 . are available
3290: 3a 0a 0a 20 20 3c 75 6c 3e 0a 20 20 20 20 3c 6c :.. <ul>. <l
32a0: 69 3e 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e 67 i> POSIX locking
32b0: 20 73 74 79 6c 65 2e 20 54 68 69 73 20 69 73 20 style. This is
32c0: 74 68 65 20 64 65 66 61 75 6c 74 20 6c 6f 63 6b the default lock
32d0: 69 6e 67 20 73 74 79 6c 65 20 61 6e 64 20 74 68 ing style and th
32e0: 65 0a 20 20 20 20 20 20 20 20 20 73 74 79 6c 65 e. style
32f0: 20 75 73 65 64 20 62 79 20 6f 74 68 65 72 20 28 used by other (
3300: 6e 6f 6e 20 4d 61 63 20 4f 53 20 58 29 20 55 6e non Mac OS X) Un
3310: 69 78 65 73 2e 20 4c 6f 63 6b 73 20 61 72 65 20 ixes. Locks are
3320: 6f 62 74 61 69 6e 65 64 20 61 6e 64 20 0a 20 20 obtained and .
3330: 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 64 20 released
3340: 75 73 69 6e 67 20 74 68 65 20 66 63 6e 74 6c 28 using the fcntl(
3350: 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a ) system call...
3360: 20 20 20 20 3c 6c 69 3e 20 41 46 50 20 6c 6f 63 <li> AFP loc
3370: 6b 69 6e 67 20 73 74 79 6c 65 2e 20 54 68 69 73 king style. This
3380: 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c 65 20 69 locking style i
3390: 73 20 75 73 65 64 20 66 6f 72 20 6e 65 74 77 6f s used for netwo
33a0: 72 6b 20 66 69 6c 65 20 0a 20 20 20 20 20 20 20 rk file .
33b0: 20 20 73 79 73 74 65 6d 73 20 74 68 61 74 20 75 systems that u
33c0: 73 65 20 74 68 65 20 41 46 50 20 28 41 70 70 6c se the AFP (Appl
33d0: 65 20 46 69 6c 69 6e 67 20 50 72 6f 74 6f 63 6f e Filing Protoco
33e0: 6c 29 20 70 72 6f 74 6f 63 6f 6c 2e 20 4c 6f 63 l) protocol. Loc
33f0: 6b 73 0a 20 20 20 20 20 20 20 20 20 61 72 65 20 ks. are
3400: 6f 62 74 61 69 6e 65 64 20 62 79 20 63 61 6c 6c obtained by call
3410: 69 6e 67 20 74 68 65 20 6c 69 62 72 61 72 79 20 ing the library
3420: 66 75 6e 63 74 69 6f 6e 20 5f 41 46 50 46 53 53 function _AFPFSS
3430: 65 74 4c 6f 63 6b 28 29 2e 0a 0a 20 20 20 20 3c etLock()... <
3440: 6c 69 3e 20 46 6c 6f 63 6b 20 6c 6f 63 6b 69 6e li> Flock lockin
3450: 67 20 73 74 79 6c 65 2e 20 54 68 69 73 20 69 73 g style. This is
3460: 20 75 73 65 64 20 66 6f 72 20 66 69 6c 65 2d 73 used for file-s
3470: 79 73 74 65 6d 73 20 74 68 61 74 20 64 6f 20 6e ystems that do n
3480: 6f 74 0a 20 20 20 20 20 20 20 20 20 73 75 70 70 ot. supp
3490: 6f 72 74 20 50 4f 53 49 58 20 6c 6f 63 6b 69 6e ort POSIX lockin
34a0: 67 20 73 74 79 6c 65 2e 20 4c 6f 63 6b 73 20 61 g style. Locks a
34b0: 72 65 20 6f 62 74 61 69 6e 65 64 20 61 6e 64 20 re obtained and
34c0: 72 65 6c 65 61 73 65 64 20 75 73 69 6e 67 0a 20 released using.
34d0: 20 20 20 20 20 20 20 20 74 68 65 20 66 6c 6f 63 the floc
34e0: 6b 28 29 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e k() system call.
34f0: 0a 0a 20 20 20 20 3c 6c 69 3e 20 44 6f 74 2d 66 .. <li> Dot-f
3500: 69 6c 65 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c ile locking styl
3510: 65 2e 20 54 68 69 73 20 6c 6f 63 6b 69 6e 67 20 e. This locking
3520: 73 74 79 6c 65 20 69 73 20 75 73 65 64 20 77 68 style is used wh
3530: 65 6e 20 6e 65 69 74 68 65 72 0a 20 20 20 20 20 en neither.
3540: 20 20 20 20 66 6c 6f 63 6b 20 6e 6f 72 20 50 4f flock nor PO
3550: 53 49 58 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c SIX locking styl
3560: 65 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 es are supported
3570: 20 62 79 20 74 68 65 20 66 69 6c 65 20 73 79 73 by the file sys
3580: 74 65 6d 2e 0a 20 20 20 20 20 20 20 20 20 44 61 tem.. Da
3590: 74 61 62 61 73 65 20 6c 6f 63 6b 73 20 61 72 65 tabase locks are
35a0: 20 6f 62 74 61 69 6e 65 64 20 62 79 20 63 72 65 obtained by cre
35b0: 61 74 69 6e 67 20 61 6e 64 20 65 6e 74 72 79 20 ating and entry
35c0: 69 6e 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 in the file-syst
35d0: 65 6d 0a 20 20 20 20 20 20 20 20 20 61 74 20 61 em. at a
35e0: 20 77 65 6c 6c 2d 6b 6e 6f 77 6e 20 6c 6f 63 61 well-known loca
35f0: 74 69 6f 6e 20 72 65 6c 61 74 69 76 65 20 74 6f tion relative to
3600: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
3610: 6c 65 20 28 61 20 22 64 6f 74 2d 66 69 6c 65 22 le (a "dot-file"
3620: 29 0a 20 20 20 20 20 20 20 20 20 61 6e 64 20 72 ). and r
3630: 65 6c 69 6e 71 75 69 73 68 65 64 20 62 79 20 64 elinquished by d
3640: 65 6c 65 74 69 6e 67 20 74 68 65 20 73 61 6d 65 eleting the same
3650: 20 66 69 6c 65 2e 0a 0a 20 20 20 20 3c 6c 69 3e file... <li>
3660: 20 4e 6f 20 6c 6f 63 6b 69 6e 67 20 73 74 79 6c No locking styl
3670: 65 2e 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 e. If none of th
3680: 65 20 61 62 6f 76 65 20 63 61 6e 20 62 65 20 73 e above can be s
3690: 75 70 70 6f 72 74 65 64 2c 20 74 68 69 73 20 0a upported, this .
36a0: 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 69 6e 67 locking
36b0: 20 73 74 79 6c 65 20 69 73 20 75 73 65 64 2e 20 style is used.
36c0: 4e 6f 20 64 61 74 61 62 61 73 65 20 6c 6f 63 6b No database lock
36d0: 69 6e 67 20 6d 65 63 68 61 6e 69 73 6d 20 69 73 ing mechanism is
36e0: 20 75 73 65 64 2e 20 57 68 65 6e 0a 20 20 20 20 used. When.
36f0: 20 20 20 20 20 74 68 69 73 20 73 79 73 74 65 6d this system
3700: 20 69 73 20 75 73 65 64 20 69 74 20 69 73 20 6e is used it is n
3710: 6f 74 20 73 61 66 65 20 66 6f 72 20 61 20 73 69 ot safe for a si
3720: 6e 67 6c 65 20 64 61 74 61 62 61 73 65 20 74 6f ngle database to
3730: 20 62 65 0a 20 20 20 20 20 20 20 20 20 61 63 63 be. acc
3740: 65 73 73 65 64 20 62 79 20 6d 75 6c 74 69 70 6c essed by multipl
3750: 65 20 63 6c 69 65 6e 74 73 2e 0a 20 20 3c 2f 75 e clients.. </u
3760: 6c 3e 0a 0a 20 20 41 64 64 69 74 69 6f 6e 61 6c l>.. Additional
3770: 6c 79 2c 20 66 69 76 65 20 65 78 74 72 61 20 56 ly, five extra V
3780: 46 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f FS implementatio
3790: 6e 73 20 61 72 65 20 70 72 6f 76 69 64 65 64 20 ns are provided
37a0: 61 73 20 77 65 6c 6c 20 61 73 20 74 68 65 0a 20 as well as the.
37b0: 20 64 65 66 61 75 6c 74 2e 20 42 79 20 73 70 65 default. By spe
37c0: 63 69 66 79 69 6e 67 20 6f 6e 65 20 6f 66 20 74 cifying one of t
37d0: 68 65 20 65 78 74 72 61 20 56 46 53 20 69 6d 70 he extra VFS imp
37e0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 0a 20 20 lementations .
37f0: 77 68 65 6e 20 63 61 6c 6c 69 6e 67 20 5b 73 71 when calling [sq
3800: 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d lite3_open_v2()]
3810: 2c 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e , an application
3820: 20 6d 61 79 20 62 79 70 61 73 73 20 74 68 65 20 may bypass the
3830: 66 69 6c 65 2d 73 79 73 74 65 6d 0a 20 20 64 65 file-system. de
3840: 74 65 63 74 69 6f 6e 20 6c 6f 67 69 63 20 61 6e tection logic an
3850: 64 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65 6c d explicitly sel
3860: 65 63 74 20 6f 6e 65 20 6f 66 20 74 68 65 20 61 ect one of the a
3870: 62 6f 76 65 20 6c 6f 63 6b 69 6e 67 20 73 74 79 bove locking sty
3880: 6c 65 73 2e 20 54 68 65 0a 20 20 66 69 76 65 20 les. The. five
3890: 65 78 74 72 61 20 56 46 53 20 69 6d 70 6c 65 6d extra VFS implem
38a0: 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20 63 61 entations are ca
38b0: 6c 6c 65 64 20 22 75 6e 69 78 2d 70 6f 73 69 78 lled "unix-posix
38c0: 22 2c 20 22 75 6e 69 78 2d 61 66 70 22 2c 0a 20 ", "unix-afp",.
38d0: 20 22 75 6e 69 78 2d 66 6c 6f 63 6b 22 2c 20 22 "unix-flock", "
38e0: 75 6e 69 78 2d 64 6f 74 66 69 6c 65 22 20 61 6e unix-dotfile" an
38f0: 64 20 22 75 6e 69 78 2d 6e 6f 6e 65 22 2e 0a 7d d "unix-none"..}
3900: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e ..COMPILE_OPTION
3910: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f {SQLITE_ENABLE_
3920: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e MEMORY_MANAGEMEN
3930: 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 T} {. This opti
3940: 6f 6e 20 61 64 64 73 20 65 78 74 72 61 20 6c 6f on adds extra lo
3950: 67 69 63 20 74 6f 20 53 51 4c 69 74 65 20 74 68 gic to SQLite th
3960: 61 74 20 61 6c 6c 6f 77 73 20 69 74 20 74 6f 20 at allows it to
3970: 72 65 6c 65 61 73 65 20 75 6e 75 73 65 64 0a 20 release unused.
3980: 20 6d 65 6d 6f 72 79 20 75 70 6f 6e 20 72 65 71 memory upon req
3990: 75 65 73 74 2e 20 20 54 68 69 73 20 6f 70 74 69 uest. This opti
39a0: 6f 6e 20 6d 75 73 74 20 62 65 20 65 6e 61 62 6c on must be enabl
39b0: 65 64 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 20 ed in order for
39c0: 74 68 65 0a 20 20 5b 73 71 6c 69 74 65 33 5f 72 the. [sqlite3_r
39d0: 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 5d elease_memory()]
39e0: 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 77 6f interface to wo
39f0: 72 6b 2e 20 20 49 66 20 74 68 69 73 20 63 6f 6d rk. If this com
3a00: 70 69 6c 65 2d 74 69 6d 65 0a 20 20 6f 70 74 69 pile-time. opti
3a10: 6f 6e 20 69 73 20 6e 6f 74 20 75 73 65 64 2c 20 on is not used,
3a20: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 72 65 6c the [sqlite3_rel
3a30: 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 5d 20 69 ease_memory()] i
3a40: 6e 74 65 72 66 61 63 65 20 69 73 20 61 20 0a 20 nterface is a .
3a50: 20 6e 6f 2d 6f 70 2e 20 20 53 69 6e 63 65 20 5b no-op. Since [
3a60: 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 sqlite3_soft_hea
3a70: 70 5f 6c 69 6d 69 74 28 29 5d 20 64 65 70 65 6e p_limit()] depen
3a80: 64 73 20 6f 6e 0a 20 20 5b 73 71 6c 69 74 65 33 ds on. [sqlite3
3a90: 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 _release_memory(
3aa0: 29 5d 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 )], this option
3ab0: 69 73 20 61 6c 73 6f 20 6e 65 63 65 73 73 61 72 is also necessar
3ac0: 79 20 66 6f 72 0a 20 20 74 68 65 20 63 6f 72 72 y for. the corr
3ad0: 65 63 74 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 ect operation of
3ae0: 20 5b 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 [sqlite3_soft_h
3af0: 65 61 70 5f 6c 69 6d 69 74 28 29 5d 2e 0a 7d 0a eap_limit()]..}.
3b00: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
3b10: 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d {SQLITE_ENABLE_M
3b20: 45 4d 53 59 53 33 7d 20 7b 0a 20 20 54 68 69 73 EMSYS3} {. This
3b30: 20 6f 70 74 69 6f 6e 20 69 6e 63 6c 75 64 65 73 option includes
3b40: 20 63 6f 64 65 20 69 6e 20 53 51 4c 69 74 65 20 code in SQLite
3b50: 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 that implements
3b60: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 20 an alternative.
3b70: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f memory allocato
3b80: 72 2e 20 20 54 68 69 73 20 61 6c 74 65 72 6e 61 r. This alterna
3b90: 74 69 76 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f tive memory allo
3ba0: 63 61 74 6f 72 20 69 73 20 6f 6e 6c 79 20 65 6e cator is only en
3bb0: 67 61 67 65 64 0a 20 20 77 68 65 6e 20 74 68 65 gaged. when the
3bc0: 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f [SQLITE_CONFIG_
3bd0: 48 45 41 50 5d 20 6f 70 74 69 6f 6e 20 74 6f 20 HEAP] option to
3be0: 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 [sqlite3_config(
3bf0: 29 5d 20 69 73 20 75 73 65 64 20 74 6f 0a 20 20 )] is used to.
3c00: 73 75 70 70 6c 79 20 61 20 6c 61 72 67 65 20 63 supply a large c
3c10: 68 75 6e 6b 20 6f 66 20 6d 65 6d 6f 72 79 20 66 hunk of memory f
3c20: 72 6f 6d 20 77 68 69 63 68 20 61 6c 6c 20 6d 65 rom which all me
3c30: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 mory allocations
3c40: 20 61 72 65 0a 20 20 74 61 6b 65 6e 2e 0a 20 20 are. taken..
3c50: 54 68 65 20 4d 45 4d 53 59 53 33 20 6d 65 6d 6f The MEMSYS3 memo
3c60: 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 75 73 65 ry allocator use
3c70: 73 20 61 20 68 79 62 72 69 64 20 61 6c 6c 6f 63 s a hybrid alloc
3c80: 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 ation algorithm
3c90: 0a 20 20 70 61 74 74 65 72 6e 65 64 20 61 66 74 . patterned aft
3ca0: 65 72 20 64 6c 6d 61 6c 6c 6f 63 28 29 2e 20 20 er dlmalloc().
3cb0: 20 4f 6e 6c 79 20 6f 6e 65 20 6f 66 20 53 51 4c Only one of SQL
3cc0: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
3cd0: 53 33 20 61 6e 64 20 0a 20 20 53 51 4c 49 54 45 S3 and . SQLITE
3ce0: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 20 _ENABLE_MEMSYS5
3cf0: 6d 61 79 20 62 65 20 65 6e 61 62 6c 65 64 20 61 may be enabled a
3d00: 74 20 6f 6e 63 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 t once..}..COMPI
3d10: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 LE_OPTION {SQLIT
3d20: 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 E_ENABLE_MEMSYS5
3d30: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f } {. This optio
3d40: 6e 20 69 6e 63 6c 75 64 65 73 20 63 6f 64 65 20 n includes code
3d50: 69 6e 20 53 51 4c 69 74 65 20 74 68 61 74 20 69 in SQLite that i
3d60: 6d 70 6c 65 6d 65 6e 74 73 20 61 6e 20 61 6c 74 mplements an alt
3d70: 65 72 6e 61 74 69 76 65 0a 20 20 6d 65 6d 6f 72 ernative. memor
3d80: 79 20 61 6c 6c 6f 63 61 74 6f 72 2e 20 20 54 68 y allocator. Th
3d90: 69 73 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6d is alternative m
3da0: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 emory allocator
3db0: 69 73 20 6f 6e 6c 79 20 65 6e 67 61 67 65 64 0a is only engaged.
3dc0: 20 20 77 68 65 6e 20 74 68 65 20 5b 53 51 4c 49 when the [SQLI
3dd0: 54 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 5d 20 TE_CONFIG_HEAP]
3de0: 6f 70 74 69 6f 6e 20 74 6f 20 5b 73 71 6c 69 74 option to [sqlit
3df0: 65 33 5f 63 6f 6e 66 69 67 28 29 5d 20 69 73 20 e3_config()] is
3e00: 75 73 65 64 20 74 6f 0a 20 20 73 75 70 70 6c 79 used to. supply
3e10: 20 61 20 6c 61 72 67 65 20 63 68 75 6e 6b 20 6f a large chunk o
3e20: 66 20 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 77 68 f memory from wh
3e30: 69 63 68 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 61 ich all memory a
3e40: 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 0a 20 llocations are.
3e50: 20 74 61 6b 65 6e 2e 0a 20 20 54 68 65 20 4d 45 taken.. The ME
3e60: 4d 53 59 53 35 20 6d 6f 64 75 6c 65 20 72 6f 75 MSYS5 module rou
3e70: 6e 64 73 20 61 6c 6c 20 61 6c 6c 6f 63 61 74 69 nds all allocati
3e80: 6f 6e 73 20 75 70 20 74 6f 20 74 68 65 20 6e 65 ons up to the ne
3e90: 78 74 20 70 6f 77 65 72 0a 20 20 6f 66 20 74 77 xt power. of tw
3ea0: 6f 20 61 6e 64 20 75 73 65 73 20 61 20 66 69 72 o and uses a fir
3eb0: 73 74 2d 66 69 74 2c 20 62 75 64 64 79 2d 61 6c st-fit, buddy-al
3ec0: 6c 6f 63 61 74 6f 72 20 61 6c 67 6f 72 69 74 68 locator algorith
3ed0: 6d 0a 20 20 74 68 61 74 20 70 72 6f 76 69 64 65 m. that provide
3ee0: 73 20 73 74 72 6f 6e 67 20 67 75 61 72 61 6e 74 s strong guarant
3ef0: 65 65 73 20 61 67 61 69 6e 73 74 20 66 72 61 67 ees against frag
3f00: 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 64 20 62 72 mentation and br
3f10: 65 61 6b 64 6f 77 6e 0a 20 20 73 75 62 6a 65 63 eakdown. subjec
3f20: 74 20 74 6f 20 63 65 72 74 61 69 6e 20 6f 70 65 t to certain ope
3f30: 72 61 74 69 6e 67 20 63 6f 6e 73 74 72 61 69 6e rating constrain
3f40: 74 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f ts..}..COMPILE_O
3f50: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e PTION {SQLITE_EN
3f60: 41 42 4c 45 5f 52 54 52 45 45 7d 20 7b 0a 20 20 ABLE_RTREE} {.
3f70: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 This option caus
3f80: 65 73 20 53 51 4c 69 74 65 20 74 6f 20 69 6e 63 es SQLite to inc
3f90: 6c 75 64 65 20 73 75 70 70 6f 72 74 20 66 6f 72 lude support for
3fa0: 20 74 68 65 0a 20 20 5b 72 74 72 65 65 20 7c 20 the. [rtree |
3fb0: 52 2a 54 72 65 65 20 69 6e 64 65 78 20 65 78 74 R*Tree index ext
3fc0: 65 6e 73 69 6f 6e 5d 2e 0a 7d 0a 0a 43 4f 4d 50 ension]..}..COMP
3fd0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 ILE_OPTION {SQLI
3fe0: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 32 7d TE_ENABLE_STAT2}
3ff0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e {. This option
4000: 20 61 64 64 73 20 61 64 64 69 74 69 6f 6e 61 6c adds additional
4010: 20 6c 6f 67 69 63 20 74 6f 20 74 68 65 20 5b 41 logic to the [A
4020: 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e 64 20 NALYZE] command
4030: 61 6e 64 20 74 6f 0a 20 20 74 68 65 20 5b 71 75 and to. the [qu
4040: 65 72 79 20 70 6c 61 6e 6e 65 72 5d 20 74 68 61 ery planner] tha
4050: 74 20 63 61 6e 20 68 65 6c 70 20 53 51 4c 69 74 t can help SQLit
4060: 65 20 74 6f 20 63 68 6f 73 65 20 61 20 62 65 74 e to chose a bet
4070: 74 65 72 20 71 75 65 72 79 20 70 6c 61 6e 0a 20 ter query plan.
4080: 20 75 6e 64 65 72 20 63 65 72 74 61 69 6e 20 73 under certain s
4090: 69 74 75 61 74 69 6f 6e 73 2e 20 20 54 68 65 20 ituations. The
40a0: 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61 6e [ANALYZE] comman
40b0: 64 20 69 73 20 65 6e 68 61 6e 63 65 64 20 74 6f d is enhanced to
40c0: 20 63 6f 6c 6c 65 63 74 0a 20 20 61 20 31 30 2d collect. a 10-
40d0: 73 61 6d 70 6c 65 20 68 69 73 74 6f 67 72 61 6d sample histogram
40e0: 20 6f 66 20 74 68 65 20 64 61 74 61 20 69 6e 20 of the data in
40f0: 65 61 63 68 20 69 6e 64 65 78 20 61 6e 64 20 73 each index and s
4100: 74 6f 72 65 20 74 68 61 74 20 68 69 73 74 6f 67 tore that histog
4110: 72 61 6d 0a 20 20 69 6e 20 74 68 65 20 3c 62 3e ram. in the <b>
4120: 73 71 6c 69 74 65 5f 73 74 61 74 32 3c 2f 62 3e sqlite_stat2</b>
4130: 20 74 61 62 6c 65 2e 20 20 54 68 65 20 71 75 65 table. The que
4140: 72 79 20 70 6c 61 6e 6e 65 72 20 77 69 6c 6c 20 ry planner will
4150: 74 68 65 6e 20 75 73 65 20 74 68 65 0a 20 20 68 then use the. h
4160: 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20 74 6f istogram data to
4170: 20 68 65 6c 70 20 69 74 20 65 73 74 69 6d 61 74 help it estimat
4180: 65 20 68 6f 77 20 6d 61 6e 79 20 72 6f 77 73 20 e how many rows
4190: 77 69 6c 6c 20 62 65 20 73 65 6c 65 63 74 65 64 will be selected
41a0: 20 62 79 20 61 0a 20 20 3c 61 20 68 72 65 66 3d by a. <a href=
41b0: 22 6f 70 74 6f 76 65 72 76 69 65 77 2e 68 74 6d "optoverview.htm
41c0: 6c 23 72 61 6e 67 65 71 75 65 72 79 22 3e 72 61 l#rangequery">ra
41d0: 6e 67 65 20 63 6f 6e 73 74 72 61 69 6e 74 3c 2f nge constraint</
41e0: 61 3e 20 69 6e 20 61 20 57 48 45 52 45 20 63 6c a> in a WHERE cl
41f0: 61 75 73 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 ause..}..COMPILE
4200: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f _OPTION {SQLITE_
4210: 45 4e 41 42 4c 45 5f 55 50 44 41 54 45 5f 44 45 ENABLE_UPDATE_DE
4220: 4c 45 54 45 5f 4c 49 4d 49 54 7d 20 7b 0a 20 20 LETE_LIMIT} {.
4230: 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 62 This option enab
4240: 6c 65 73 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 les an optional
4250: 4f 52 44 45 52 20 42 59 20 61 6e 64 20 4c 49 4d ORDER BY and LIM
4260: 49 54 20 63 6c 61 75 73 65 20 6f 6e 20 0a 20 20 IT clause on .
4270: 5b 55 50 44 41 54 45 5d 20 61 6e 64 20 5b 44 45 [UPDATE] and [DE
4280: 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 6e 74 73 LETE] statements
4290: 2e 0a 0a 20 20 3c 70 3e 49 66 20 74 68 69 73 20 ... <p>If this
42a0: 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 option is define
42b0: 64 2c 20 74 68 65 6e 20 69 74 20 6d 75 73 74 20 d, then it must
42c0: 61 6c 73 6f 20 62 65 20 0a 20 20 64 65 66 69 6e also be . defin
42d0: 65 64 20 77 68 65 6e 20 75 73 69 6e 67 20 74 68 ed when using th
42e0: 65 20 27 6c 65 6d 6f 6e 27 20 74 6f 6f 6c 20 74 e 'lemon' tool t
42f0: 6f 20 67 65 6e 65 72 61 74 65 20 61 20 70 61 72 o generate a par
4300: 73 65 2e 63 0a 20 20 66 69 6c 65 2e 20 42 65 63 se.c. file. Bec
4310: 61 75 73 65 20 6f 66 20 74 68 69 73 2c 20 74 68 ause of this, th
4320: 69 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 6f 6e is option may on
4330: 6c 79 20 62 65 20 75 73 65 64 20 77 68 65 6e 20 ly be used when
4340: 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 62 the library is b
4350: 75 69 6c 74 0a 20 20 66 72 6f 6d 20 73 6f 75 72 uilt. from sour
4360: 63 65 2c 20 6e 6f 74 20 66 72 6f 6d 20 74 68 65 ce, not from the
4370: 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20 [amalgamation]
4380: 6f 72 20 66 72 6f 6d 20 74 68 65 20 63 6f 6c 6c or from the coll
4390: 65 63 74 69 6f 6e 20 6f 66 0a 20 20 70 72 65 2d ection of. pre-
43a0: 70 61 63 6b 61 67 65 64 20 43 20 66 69 6c 65 73 packaged C files
43b0: 20 70 72 6f 76 69 64 65 64 20 66 6f 72 20 6e 6f provided for no
43c0: 6e 2d 55 6e 69 78 20 6c 69 6b 65 20 70 6c 61 74 n-Unix like plat
43d0: 66 6f 72 6d 73 20 6f 6e 20 74 68 65 20 77 65 62 forms on the web
43e0: 73 69 74 65 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a site.. </p>.}..
43f0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b COMPILE_OPTION {
4400: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 4e SQLITE_ENABLE_UN
4410: 4c 4f 43 4b 5f 4e 4f 54 49 46 59 7d 20 7b 0a 20 LOCK_NOTIFY} {.
4420: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 65 6e 61 This option ena
4430: 62 6c 65 73 20 74 68 65 20 5b 73 71 6c 69 74 65 bles the [sqlite
4440: 33 5f 75 6e 6c 6f 63 6b 5f 6e 6f 74 69 66 79 28 3_unlock_notify(
4450: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 61 6e 64 )] interface and
4460: 0a 20 20 69 74 73 20 61 73 73 6f 63 69 61 74 65 . its associate
4470: 64 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e d functionality.
4480: 20 20 53 65 65 20 74 68 65 20 64 6f 63 75 6d 65 See the docume
4490: 6e 74 61 74 69 6f 6e 20 74 69 74 6c 65 64 0a 20 ntation titled.
44a0: 20 5b 55 73 69 6e 67 20 74 68 65 20 53 51 4c 69 [Using the SQLi
44b0: 74 65 20 55 6e 6c 6f 63 6b 20 4e 6f 74 69 66 69 te Unlock Notifi
44c0: 63 61 74 69 6f 6e 20 46 65 61 74 75 72 65 5d 20 cation Feature]
44d0: 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 0a 20 for additional.
44e0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 7d 0a information..}.
44f0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
4500: 7b 59 59 54 52 41 43 4b 4d 41 58 53 54 41 43 4b {YYTRACKMAXSTACK
4510: 44 45 50 54 48 7d 20 7b 0a 20 20 54 68 69 73 20 DEPTH} {. This
4520: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68 option causes th
4530: 65 20 4c 41 4c 52 28 31 29 20 70 61 72 73 65 72 e LALR(1) parser
4540: 20 73 74 61 63 6b 20 64 65 70 74 68 20 74 6f 20 stack depth to
4550: 62 65 20 74 72 61 63 6b 65 64 0a 20 20 61 6e 64 be tracked. and
4560: 20 72 65 70 6f 72 74 65 64 20 75 73 69 6e 67 20 reported using
4570: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 74 61 the [sqlite3_sta
4580: 74 75 73 5d 28 5b 53 51 4c 49 54 45 5f 53 54 41 tus]([SQLITE_STA
4590: 54 55 53 5f 50 41 52 53 45 52 5f 53 54 41 43 4b TUS_PARSER_STACK
45a0: 5d 2c 2e 2e 2e 29 0a 20 20 69 6e 74 65 72 66 61 ],...). interfa
45b0: 63 65 2e 20 20 53 51 4c 69 74 65 27 73 20 4c 41 ce. SQLite's LA
45c0: 4c 52 28 31 29 20 70 61 72 73 65 72 20 68 61 73 LR(1) parser has
45d0: 20 61 20 66 69 78 65 64 20 73 74 61 63 6b 20 64 a fixed stack d
45e0: 65 70 74 68 0a 20 20 28 64 65 74 65 72 6d 69 6e epth. (determin
45f0: 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 ed at compile-ti
4600: 6d 65 20 75 73 69 6e 67 20 74 68 65 20 5b 59 59 me using the [YY
4610: 53 54 41 43 4b 44 45 50 54 48 5d 20 6f 70 74 69 STACKDEPTH] opti
4620: 6f 6e 73 29 2e 0a 20 20 54 68 69 73 20 6f 70 74 ons).. This opt
4630: 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 ion can be used
4640: 74 6f 20 68 65 6c 70 20 64 65 74 65 72 6d 69 6e to help determin
4650: 65 20 69 66 20 61 6e 20 61 70 70 6c 69 63 61 74 e if an applicat
4660: 69 6f 6e 20 69 73 0a 20 20 67 65 74 74 69 6e 67 ion is. getting
4670: 20 63 6c 6f 73 65 20 74 6f 20 65 78 63 65 65 64 close to exceed
4680: 69 6e 67 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 ing the maximum
4690: 4c 41 4c 52 28 31 29 20 73 74 61 63 6b 20 64 65 LALR(1) stack de
46a0: 70 74 68 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c pth..}.</tcl>..<
46b0: 61 20 6e 61 6d 65 3d 22 64 69 73 61 62 6c 65 66 a name="disablef
46c0: 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 eatures"></a>.<h
46d0: 32 3e 31 2e 35 20 4f 70 74 69 6f 6e 73 20 54 6f 2>1.5 Options To
46e0: 20 44 69 73 61 62 6c 65 20 46 65 61 74 75 72 65 Disable Feature
46f0: 73 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e 65 s Normally Turne
4700: 64 20 4f 6e 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e d On</h2>..<tcl>
4710: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
4720: 7b 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f {SQLITE_DISABLE_
4730: 4c 46 53 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 LFS} {. If this
4740: 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 C-preprocessor
4750: 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 macro is defined
4760: 2c 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70 , large file sup
4770: 70 6f 72 74 0a 20 20 69 73 20 64 69 73 61 62 6c port. is disabl
4780: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f ed..}..COMPILE_O
4790: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 49 PTION {SQLITE_DI
47a0: 53 41 42 4c 45 5f 44 49 52 53 59 4e 43 7d 20 7b SABLE_DIRSYNC} {
47b0: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65 . If this C-pre
47c0: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20 processor macro
47d0: 69 73 20 64 65 66 69 6e 65 64 2c 20 64 69 72 65 is defined, dire
47e0: 63 74 6f 72 79 20 73 79 6e 63 73 0a 20 20 61 72 ctory syncs. ar
47f0: 65 20 64 69 73 61 62 6c 65 64 2e 20 20 53 51 4c e disabled. SQL
4800: 69 74 65 20 74 79 70 69 63 61 6c 6c 79 20 61 74 ite typically at
4810: 74 65 6d 70 74 73 20 74 6f 20 73 79 6e 63 20 74 tempts to sync t
4820: 68 65 20 70 61 72 65 6e 74 0a 20 20 64 69 72 65 he parent. dire
4830: 63 74 6f 72 79 20 77 68 65 6e 20 61 20 66 69 6c ctory when a fil
4840: 65 20 69 73 20 64 65 6c 65 74 65 64 20 74 6f 20 e is deleted to
4850: 65 6e 73 75 72 65 20 74 68 65 20 64 69 72 65 63 ensure the direc
4860: 74 6f 72 79 0a 20 20 65 6e 74 72 69 65 73 20 61 tory. entries a
4870: 72 65 20 75 70 64 61 74 65 64 20 69 6d 6d 65 64 re updated immed
4880: 69 61 74 65 6c 79 20 6f 6e 20 64 69 73 6b 2e 0a iately on disk..
4890: 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 74 63 6c 3e 0a }.</tcl>..<tcl>.
48a0: 20 20 68 64 5f 66 72 61 67 6d 65 6e 74 20 22 6f hd_fragment "o
48b0: 6d 69 74 66 65 61 74 75 72 65 73 22 0a 20 20 68 mitfeatures". h
48c0: 64 5f 6b 65 79 77 6f 72 64 73 20 22 6f 6d 69 74 d_keywords "omit
48d0: 66 65 61 74 75 72 65 73 22 0a 3c 2f 74 63 6c 3e features".</tcl>
48e0: 0a 3c 68 32 3e 31 2e 36 20 4f 70 74 69 6f 6e 73 .<h2>1.6 Options
48f0: 20 54 6f 20 4f 6d 69 74 20 46 65 61 74 75 72 65 To Omit Feature
4900: 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 20 66 s</h2>..<p>The f
4910: 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69 6f 6e 73 ollowing options
4920: 20 63 61 6e 20 75 73 65 64 20 74 6f 20 72 65 64 can used to red
4930: 75 63 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 uce the size of
4940: 74 68 65 20 63 6f 6d 70 69 6c 65 64 0a 6c 69 62 the compiled.lib
4950: 72 61 72 79 20 62 79 20 6f 6d 69 74 74 69 6e 67 rary by omitting
4960: 20 6f 70 74 69 6f 6e 61 6c 20 66 65 61 74 75 72 optional featur
4970: 65 73 2e 20 54 68 69 73 20 69 73 20 70 72 6f 62 es. This is prob
4980: 61 62 6c 79 20 6f 6e 6c 79 20 75 73 65 66 75 6c ably only useful
4990: 0a 69 6e 20 65 6d 62 65 64 64 65 64 20 73 79 73 .in embedded sys
49a0: 74 65 6d 73 20 77 68 65 72 65 20 73 70 61 63 65 tems where space
49b0: 20 69 73 20 65 73 70 65 63 69 61 6c 6c 79 20 74 is especially t
49c0: 69 67 68 74 2c 20 61 73 20 65 76 65 6e 20 77 69 ight, as even wi
49d0: 74 68 20 61 6c 6c 0a 66 65 61 74 75 72 65 73 20 th all.features
49e0: 69 6e 63 6c 75 64 65 64 20 74 68 65 20 53 51 4c included the SQL
49f0: 69 74 65 20 6c 69 62 72 61 72 79 20 69 73 20 72 ite library is r
4a00: 65 6c 61 74 69 76 65 6c 79 20 73 6d 61 6c 6c 2e elatively small.
4a10: 20 44 6f 6e 27 74 20 66 6f 72 67 65 74 0a 74 6f Don't forget.to
4a20: 20 74 65 6c 6c 20 79 6f 75 72 20 63 6f 6d 70 69 tell your compi
4a30: 6c 65 72 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 ler to optimize
4a40: 66 6f 72 20 62 69 6e 61 72 79 20 73 69 7a 65 21 for binary size!
4a50: 20 28 74 68 65 20 2d 4f 73 20 6f 70 74 69 6f 6e (the -Os option
4a60: 20 69 66 0a 75 73 69 6e 67 20 47 43 43 29 2e 20 if.using GCC).
4a70: 20 54 65 6c 6c 69 6e 67 20 79 6f 75 72 20 63 6f Telling your co
4a80: 6d 70 69 6c 65 72 20 74 6f 20 6f 70 74 69 6d 69 mpiler to optimi
4a90: 7a 65 20 66 6f 72 20 73 69 7a 65 20 75 73 75 61 ze for size usua
4aa0: 6c 6c 79 20 68 61 73 0a 61 20 6d 75 63 68 20 6c lly has.a much l
4ab0: 61 72 67 65 72 20 69 6d 70 61 63 74 20 6f 6e 20 arger impact on
4ac0: 6c 69 62 72 61 72 79 20 66 6f 6f 74 70 72 69 6e library footprin
4ad0: 74 20 74 68 61 6e 20 65 6d 70 6c 6f 79 69 6e 67 t than employing
4ae0: 20 61 6e 79 20 6f 66 20 74 68 65 73 65 0a 63 6f any of these.co
4af0: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f mpile-time optio
4b00: 6e 73 2e 20 20 59 6f 75 20 73 68 6f 75 6c 64 20 ns. You should
4b10: 61 6c 73 6f 20 76 65 72 69 66 79 20 74 68 61 74 also verify that
4b20: 20 0a 3c 61 20 68 72 65 66 3d 22 23 64 65 62 75 .<a href="#debu
4b30: 67 6f 70 74 69 6f 6e 73 22 3e 64 65 62 75 67 67 goptions">debugg
4b40: 69 6e 67 20 6f 70 74 69 6f 6e 73 3c 2f 61 3e 20 ing options</a>
4b50: 61 72 65 20 64 69 73 61 62 6c 65 64 2e 3c 2f 70 are disabled.</p
4b60: 3e 0a 0a 3c 70 3e 54 68 65 20 6d 61 63 72 6f 73 >..<p>The macros
4b70: 20 69 6e 20 74 68 69 73 20 73 65 63 74 69 6f 6e in this section
4b80: 20 64 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 20 do not require
4b90: 76 61 6c 75 65 73 2e 20 54 68 65 20 66 6f 6c 6c values. The foll
4ba0: 6f 77 69 6e 67 20 0a 63 6f 6d 70 69 6c 61 74 69 owing .compilati
4bb0: 6f 6e 20 73 77 69 74 63 68 65 73 20 61 6c 6c 20 on switches all
4bc0: 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 65 66 have the same ef
4bd0: 66 65 63 74 3a 3c 62 72 3e 0a 2d 44 53 51 4c 49 fect:<br>.-DSQLI
4be0: 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42 TE_OMIT_ALTERTAB
4bf0: 4c 45 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f LE<br>.-DSQLITE_
4c00: 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d OMIT_ALTERTABLE=
4c10: 31 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 1<br>.-DSQLITE_O
4c20: 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d 30 MIT_ALTERTABLE=0
4c30: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 6e 79 .</p>..<p>If any
4c40: 20 6f 66 20 74 68 65 73 65 20 6f 70 74 69 6f 6e of these option
4c50: 73 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 74 s are defined, t
4c60: 68 65 6e 20 74 68 65 20 73 61 6d 65 20 73 65 74 hen the same set
4c70: 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f of SQLITE_OMIT_
4c80: 2a 0a 6f 70 74 69 6f 6e 73 20 6d 75 73 74 20 61 *.options must a
4c90: 6c 73 6f 20 62 65 20 64 65 66 69 6e 65 64 20 77 lso be defined w
4ca0: 68 65 6e 20 75 73 69 6e 67 20 74 68 65 20 27 6c hen using the 'l
4cb0: 65 6d 6f 6e 27 20 74 6f 6f 6c 20 74 6f 20 67 65 emon' tool to ge
4cc0: 6e 65 72 61 74 65 20 74 68 65 0a 70 61 72 73 65 nerate the.parse
4cd0: 2e 63 20 66 69 6c 65 20 61 6e 64 20 77 68 65 6e .c file and when
4ce0: 20 63 6f 6d 70 69 6c 69 6e 67 20 74 68 65 20 27 compiling the '
4cf0: 6d 6b 6b 65 79 77 6f 72 64 68 61 73 68 27 20 74 mkkeywordhash' t
4d00: 6f 6f 6c 20 77 68 69 63 68 20 67 65 6e 65 72 61 ool which genera
4d10: 74 65 73 20 0a 74 68 65 20 6b 65 79 77 6f 72 64 tes .the keyword
4d20: 68 61 73 68 2e 68 20 66 69 6c 65 2e 0a 42 65 63 hash.h file..Bec
4d30: 61 75 73 65 20 6f 66 20 74 68 69 73 2c 20 74 68 ause of this, th
4d40: 65 73 65 20 6f 70 74 69 6f 6e 73 20 6d 61 79 20 ese options may
4d50: 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 77 68 65 only be used whe
4d60: 6e 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 n the library is
4d70: 20 62 75 69 6c 74 0a 66 72 6f 6d 20 63 61 6e 6f built.from cano
4d80: 6e 69 63 61 6c 20 73 6f 75 72 63 65 2c 20 6e 6f nical source, no
4d90: 74 20 66 72 6f 6d 20 74 68 65 20 5b 61 6d 61 6c t from the [amal
4da0: 67 61 6d 61 74 69 6f 6e 5d 20 6f 72 20 66 72 6f gamation] or fro
4db0: 6d 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e m the collection
4dc0: 20 6f 66 0a 70 72 65 2d 70 61 63 6b 61 67 65 64 of.pre-packaged
4dd0: 20 43 20 66 69 6c 65 73 20 70 72 6f 76 69 64 65 C files provide
4de0: 64 20 66 6f 72 20 6e 6f 6e 2d 55 6e 69 78 20 6c d for non-Unix l
4df0: 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73 20 6f 6e ike platforms on
4e00: 20 74 68 65 20 77 65 62 73 69 74 65 2e 0a 41 6e the website..An
4e10: 79 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 y SQLITE_OMIT_*
4e20: 6f 70 74 69 6f 6e 73 20 77 68 69 63 68 20 63 61 options which ca
4e30: 6e 20 62 65 20 75 73 65 64 20 64 69 72 65 63 74 n be used direct
4e40: 6c 79 20 77 69 74 68 20 74 68 65 20 5b 61 6d 61 ly with the [ama
4e50: 6c 67 61 6d 61 74 69 6f 6e 5d 20 0a 61 72 65 20 lgamation] .are
4e60: 6c 69 73 74 65 64 20 62 65 6c 6f 77 2c 20 68 6f listed below, ho
4e70: 77 65 76 65 72 2c 20 74 68 65 20 77 61 72 6e 69 wever, the warni
4e80: 6e 67 73 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f ngs in the follo
4e90: 77 69 6e 67 20 70 61 72 61 67 72 61 70 68 20 73 wing paragraph s
4ea0: 68 6f 75 6c 64 20 62 65 20 6e 6f 74 65 64 2e 0a hould be noted..
4eb0: 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 </p>..<blockquot
4ec0: 65 3e 0a 3c 69 3e 3c 62 3e 49 6d 70 6f 72 74 61 e>.<i><b>Importa
4ed0: 6e 74 20 4e 6f 74 65 3a 3c 2f 62 3e 20 54 68 65 nt Note:</b> The
4ee0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 6f SQLITE_OMIT_* o
4ef0: 70 74 69 6f 6e 73 20 64 6f 20 6e 6f 74 20 77 6f ptions do not wo
4f00: 72 6b 20 77 69 74 68 20 74 68 65 0a 5b 61 6d 61 rk with the.[ama
4f10: 6c 67 61 6d 61 74 69 6f 6e 5d 20 6f 72 20 77 69 lgamation] or wi
4f20: 74 68 20 70 72 65 2d 70 61 63 6b 61 67 65 64 20 th pre-packaged
4f30: 43 20 63 6f 64 65 20 66 69 6c 65 73 2e 20 20 53 C code files. S
4f40: 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 63 6f 6d QLITE_OMIT_* com
4f50: 70 69 6c 65 2d 74 69 6d 65 0a 6f 70 74 69 6f 6e pile-time.option
4f60: 73 20 6f 6e 6c 79 20 77 6f 72 6b 20 63 6f 72 72 s only work corr
4f70: 65 63 74 6c 79 20 77 68 65 6e 20 53 51 4c 69 74 ectly when SQLit
4f80: 65 20 69 73 20 62 75 69 6c 74 20 66 72 6f 6d 20 e is built from
4f90: 63 61 6e 6f 6e 69 63 61 6c 20 73 6f 75 72 63 65 canonical source
4fa0: 20 66 69 6c 65 73 2e 0a 3c 2f 69 3e 0a 3c 2f 62 files..</i>.</b
4fb0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 0a 3c 70 3e lockquote>...<p>
4fc0: 53 70 65 63 69 61 6c 20 76 65 72 73 69 6f 6e 73 Special versions
4fd0: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 61 of the SQLite a
4fe0: 6d 61 6c 67 61 6d 61 74 69 6f 6e 20 74 68 61 74 malgamation that
4ff0: 20 64 6f 20 77 6f 72 6b 20 77 69 74 68 20 61 0a do work with a.
5000: 70 72 65 64 65 74 65 72 6d 69 6e 65 64 20 73 65 predetermined se
5010: 74 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 t of SQLITE_OMIT
5020: 5f 2a 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 62 _* options can b
5030: 65 20 67 65 6e 65 72 61 74 65 64 2e 20 20 54 6f e generated. To
5040: 20 64 6f 20 73 6f 2c 0a 6d 61 6b 65 20 61 20 63 do so,.make a c
5050: 6f 70 79 20 6f 66 20 74 68 65 20 4d 61 6b 65 66 opy of the Makef
5060: 69 6c 65 2e 6c 69 6e 75 78 2d 67 63 63 20 6d 61 ile.linux-gcc ma
5070: 6b 65 66 69 6c 65 20 74 65 6d 70 6c 61 74 65 20 kefile template
5080: 69 6e 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c in the canonical
5090: 0a 73 6f 75 72 63 65 20 63 6f 64 65 20 64 69 73 .source code dis
50a0: 74 72 69 62 75 74 69 6f 6e 2e 20 20 43 68 61 6e tribution. Chan
50b0: 67 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 79 ge the name of y
50c0: 6f 75 72 20 63 6f 70 79 20 74 6f 20 73 69 6d 70 our copy to simp
50d0: 6c 79 20 22 4d 61 6b 65 66 69 6c 65 22 2e 0a 54 ly "Makefile"..T
50e0: 68 65 6e 20 65 64 69 74 20 22 4d 61 6b 65 66 69 hen edit "Makefi
50f0: 6c 65 22 20 74 6f 20 73 65 74 20 75 70 20 61 70 le" to set up ap
5100: 70 72 6f 70 72 69 61 74 65 20 63 6f 6d 70 69 6c propriate compil
5110: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 2e 20 e-time options.
5120: 20 54 68 65 6e 0a 74 79 70 65 3a 0a 3c 62 6c 6f Then.type:.<blo
5130: 63 6b 71 75 6f 74 65 3e 3c 74 74 3e 6d 61 6b 65 ckquote><tt>make
5140: 20 63 6c 65 61 6e 3b 20 6d 61 6b 65 20 73 71 6c clean; make sql
5150: 69 74 65 33 2e 63 3c 2f 74 74 3e 3c 2f 62 6c 6f ite3.c</tt></blo
5160: 63 6b 71 75 6f 74 65 3e 0a 54 68 65 20 72 65 73 ckquote>.The res
5170: 75 6c 74 69 6e 67 20 22 73 71 6c 69 74 65 33 2e ulting "sqlite3.
5180: 63 22 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 20 c" amalgamation
5190: 63 6f 64 65 20 66 69 6c 65 20 28 61 6e 64 20 69 code file (and i
51a0: 74 73 20 61 73 73 6f 63 69 61 74 65 64 0a 68 65 ts associated.he
51b0: 61 64 65 72 20 66 69 6c 65 20 22 73 71 6c 69 74 ader file "sqlit
51c0: 65 33 2e 68 22 29 20 63 61 6e 20 74 68 65 6e 20 e3.h") can then
51d0: 62 65 20 6d 6f 76 65 64 20 74 6f 20 61 20 6e 6f be moved to a no
51e0: 6e 2d 75 6e 69 78 20 70 6c 61 74 66 6f 72 6d 0a n-unix platform.
51f0: 66 6f 72 20 66 69 6e 61 6c 20 63 6f 6d 70 69 6c for final compil
5200: 61 74 69 6f 6e 20 75 73 69 6e 67 20 61 20 6e 61 ation using a na
5210: 74 69 76 65 20 63 6f 6d 70 69 6c 65 72 2e 3c 2f tive compiler.</
5220: 70 3e 0a 0a 3c 70 3e 41 6c 6c 20 6f 66 20 74 68 p>..<p>All of th
5230: 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 2a 20 e SQLITE_OMIT_*
5240: 6f 70 74 69 6f 6e 73 20 61 72 65 20 75 6e 73 75 options are unsu
5250: 70 70 6f 72 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 62 pported.</p>..<b
5260: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 69 3e 3c 62 lockquote>.<i><b
5270: 3e 49 6d 70 6f 72 74 61 6e 74 20 4e 6f 74 65 3a >Important Note:
5280: 3c 2f 62 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f </b>.The SQLITE_
5290: 4f 4d 49 54 5f 2a 20 63 6f 6d 70 69 6c 65 2d 74 OMIT_* compile-t
52a0: 69 6d 65 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 ime options are
52b0: 75 6e 73 75 70 70 6f 72 74 65 64 2e 0a 3c 2f 69 unsupported..</i
52c0: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>..
52d0: 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f 4f <p>.The SQLITE_O
52e0: 4d 49 54 5f 2a 20 63 6f 6d 70 69 6c 65 2d 74 69 MIT_* compile-ti
52f0: 6d 65 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 75 me options are u
5300: 73 75 61 6c 6c 79 20 75 6e 74 65 73 74 65 64 20 sually untested
5310: 61 6e 64 0a 61 72 65 20 61 6c 6d 6f 73 74 20 63 and.are almost c
5320: 65 72 74 61 69 6e 6c 79 20 75 6e 74 65 73 74 65 ertainly unteste
5330: 64 20 69 6e 20 63 6f 6d 62 69 6e 61 74 69 6f 6e d in combination
5340: 2e 0a 41 6e 79 20 6f 72 20 61 6c 6c 20 6f 66 20 ..Any or all of
5350: 74 68 65 73 65 20 6f 70 74 69 6f 6e 73 20 6d 61 these options ma
5360: 79 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f y be removed fro
5370: 6d 20 74 68 65 20 63 6f 64 65 20 69 6e 20 66 75 m the code in fu
5380: 74 75 72 65 20 72 65 6c 65 61 73 65 73 0a 61 6e ture releases.an
5390: 64 20 77 69 74 68 6f 75 74 20 77 61 72 6e 69 6e d without warnin
53a0: 67 2e 20 20 46 6f 72 20 61 6e 79 20 70 61 72 74 g. For any part
53b0: 69 63 75 6c 61 72 20 72 65 6c 65 61 73 65 2c 20 icular release,
53c0: 73 6f 6d 65 20 6f 66 20 74 68 65 73 65 0a 6f 70 some of these.op
53d0: 74 69 6f 6e 73 20 6d 61 79 20 63 61 75 73 65 20 tions may cause
53e0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 72 20 compile-time or
53f0: 72 75 6e 2d 74 69 6d 65 20 66 61 69 6c 75 72 65 run-time failure
5400: 73 2c 20 70 61 72 74 69 63 75 6c 61 72 6c 79 0a s, particularly.
5410: 77 68 65 6e 20 75 73 65 64 20 69 6e 20 63 6f 6d when used in com
5420: 62 69 6e 61 74 69 6f 6e 20 77 69 74 68 20 6f 74 bination with ot
5430: 68 65 72 20 6f 70 74 69 6f 6e 73 2e 3c 2f 70 3e her options.</p>
5440: 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f ..<tcl>.COMPILE_
5450: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f OPTION {SQLITE_O
5460: 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 7d 20 MIT_ALTERTABLE}
5470: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 {. When this op
5480: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c tion is defined,
5490: 20 74 68 65 20 0a 20 20 5b 41 4c 54 45 52 20 54 the . [ALTER T
54a0: 41 42 4c 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 ABLE] command is
54b0: 20 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 69 6e not included in
54c0: 20 74 68 65 20 0a 20 20 6c 69 62 72 61 72 79 2e the . library.
54d0: 20 45 78 65 63 75 74 69 6e 67 20 61 6e 20 5b 41 Executing an [A
54e0: 4c 54 45 52 20 54 41 42 4c 45 5d 20 73 74 61 74 LTER TABLE] stat
54f0: 65 6d 65 6e 74 20 63 61 75 73 65 73 20 61 20 70 ement causes a p
5500: 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 arse error..}..C
5510: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 OMPILE_OPTION {S
5520: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4e 41 4c 59 QLITE_OMIT_ANALY
5530: 5a 45 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 ZE} {. When thi
5540: 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 s option is defi
5550: 6e 65 64 2c 20 74 68 65 20 5b 41 4e 41 4c 59 5a ned, the [ANALYZ
5560: 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6f 6d E] command is om
5570: 69 74 74 65 64 20 66 72 6f 6d 0a 20 20 74 68 65 itted from. the
5580: 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 build..}..COMPI
5590: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 LE_OPTION {SQLIT
55a0: 45 5f 4f 4d 49 54 5f 41 54 54 41 43 48 7d 20 7b E_OMIT_ATTACH} {
55b0: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 . When this opt
55c0: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 ion is defined,
55d0: 74 68 65 20 5b 41 54 54 41 43 48 5d 20 61 6e 64 the [ATTACH] and
55e0: 20 5b 44 45 54 41 43 48 5d 20 63 6f 6d 6d 61 6e [DETACH] comman
55f0: 64 73 20 61 72 65 0a 20 20 6f 6d 69 74 74 65 64 ds are. omitted
5600: 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e from the build.
5610: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
5620: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
5630: 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 7d 20 7b AUTHORIZATION} {
5640: 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 . Defining this
5650: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 option omits th
5660: 65 20 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 e authorization
5670: 63 61 6c 6c 62 61 63 6b 20 66 65 61 74 75 72 65 callback feature
5680: 20 66 72 6f 6d 20 74 68 65 0a 20 20 6c 69 62 72 from the. libr
5690: 61 72 79 2e 20 54 68 65 20 5b 73 71 6c 69 74 65 ary. The [sqlite
56a0: 33 5f 73 65 74 5f 61 75 74 68 6f 72 69 7a 65 72 3_set_authorizer
56b0: 28 29 5d 20 41 50 49 20 66 75 6e 63 74 69 6f 6e ()] API function
56c0: 20 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 0a is not present.
56d0: 20 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79 in the library
56e0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 ..}..COMPILE_OPT
56f0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 ION {SQLITE_OMIT
5700: 5f 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 7d 20 _AUTOINCREMENT}
5710: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 {. This option
5720: 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 is used to omit
5730: 74 68 65 20 0a 20 20 5b 41 55 54 4f 49 4e 43 52 the . [AUTOINCR
5740: 45 4d 45 4e 54 5d 20 66 75 6e 63 74 69 6f 6e 61 EMENT] functiona
5750: 6c 69 74 79 2e 20 57 68 65 6e 20 74 68 69 73 20 lity. When this
5760: 0a 20 20 69 73 20 6d 61 63 72 6f 20 69 73 20 64 . is macro is d
5770: 65 66 69 6e 65 64 2c 20 63 6f 6c 75 6d 6e 73 20 efined, columns
5780: 64 65 63 6c 61 72 65 64 20 61 73 20 0a 20 20 22 declared as . "
5790: 5b 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 [INTEGER PRIMARY
57a0: 20 4b 45 59 5d 20 41 55 54 4f 49 4e 43 52 45 4d KEY] AUTOINCREM
57b0: 45 4e 54 22 0a 20 20 62 65 68 61 76 65 20 69 6e ENT". behave in
57c0: 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 the same way as
57d0: 20 63 6f 6c 75 6d 6e 73 20 64 65 63 6c 61 72 65 columns declare
57e0: 64 20 61 73 20 22 5b 49 4e 54 45 47 45 52 20 50 d as "[INTEGER P
57f0: 52 49 4d 41 52 59 20 4b 45 59 5d 22 20 77 68 65 RIMARY KEY]" whe
5800: 6e 20 61 20 0a 20 20 4e 55 4c 4c 20 69 73 20 69 n a . NULL is i
5810: 6e 73 65 72 74 65 64 2e 20 54 68 65 20 73 71 6c nserted. The sql
5820: 69 74 65 5f 73 65 71 75 65 6e 63 65 20 73 79 73 ite_sequence sys
5830: 74 65 6d 20 74 61 62 6c 65 20 69 73 20 6e 65 69 tem table is nei
5840: 74 68 65 72 20 63 72 65 61 74 65 64 2c 20 6e 6f ther created, no
5850: 72 0a 20 20 72 65 73 70 65 63 74 65 64 20 69 66 r. respected if
5860: 20 69 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 it already exis
5870: 74 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f ts..}..COMPILE_O
5880: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d PTION {SQLITE_OM
5890: 49 54 5f 41 55 54 4f 49 4e 49 54 7d 20 7b 0a 20 IT_AUTOINIT} {.
58a0: 20 46 6f 72 20 62 61 63 6b 77 61 72 64 73 20 63 For backwards c
58b0: 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 ompatibility wit
58c0: 68 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 h older versions
58d0: 20 6f 66 20 53 51 4c 69 74 65 20 74 68 61 74 20 of SQLite that
58e0: 6c 61 63 6b 0a 20 20 74 68 65 20 5b 73 71 6c 69 lack. the [sqli
58f0: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
5900: 5d 20 69 6e 74 65 72 66 61 63 65 2c 20 74 68 65 ] interface, the
5910: 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 [sqlite3_initia
5920: 6c 69 7a 65 28 29 5d 20 69 6e 74 65 72 66 61 63 lize()] interfac
5930: 65 0a 20 20 69 73 20 63 61 6c 6c 65 64 20 61 75 e. is called au
5940: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 70 6f 6e tomatically upon
5950: 20 65 6e 74 72 79 20 74 6f 20 63 65 72 74 61 69 entry to certai
5960: 6e 20 6b 65 79 20 69 6e 74 65 72 66 61 63 65 73 n key interfaces
5970: 20 73 75 63 68 20 61 73 0a 20 20 5b 73 71 6c 69 such as. [sqli
5980: 74 65 33 5f 6f 70 65 6e 28 29 5d 2c 20 5b 73 71 te3_open()], [sq
5990: 6c 69 74 65 33 5f 76 66 73 5f 72 65 67 69 73 74 lite3_vfs_regist
59a0: 65 72 28 29 5d 2c 20 61 6e 64 20 5b 73 71 6c 69 er()], and [sqli
59b0: 74 65 33 5f 6d 70 72 69 6e 74 66 28 29 5d 2e 0a te3_mprintf()]..
59c0: 20 20 54 68 65 20 6f 76 65 72 68 65 61 64 20 6f The overhead o
59d0: 66 20 69 6e 76 6f 6b 69 6e 67 20 5b 73 71 6c 69 f invoking [sqli
59e0: 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
59f0: 5d 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 ] automatically
5a00: 69 6e 20 74 68 69 73 0a 20 20 77 61 79 20 6d 61 in this. way ma
5a10: 79 20 62 65 20 6f 6d 69 74 74 65 64 20 62 79 20 y be omitted by
5a20: 62 75 69 6c 64 69 6e 67 20 53 51 4c 69 74 65 20 building SQLite
5a30: 77 69 74 68 20 74 68 65 20 53 51 4c 49 54 45 5f with the SQLITE_
5a40: 4f 4d 49 54 5f 41 55 54 4f 49 4e 49 54 0a 20 20 OMIT_AUTOINIT.
5a50: 43 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d C-preprocessor m
5a60: 61 63 72 6f 2e 20 20 57 68 65 6e 20 62 75 69 6c acro. When buil
5a70: 74 20 75 73 69 6e 67 20 53 51 4c 49 54 45 5f 4f t using SQLITE_O
5a80: 4d 49 54 5f 41 55 54 4f 49 4e 49 54 2c 20 53 51 MIT_AUTOINIT, SQ
5a90: 4c 69 74 65 0a 20 20 77 69 6c 6c 20 6e 6f 74 20 Lite. will not
5aa0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e automatically in
5ab0: 69 74 69 61 6c 69 7a 65 20 69 74 73 65 6c 66 20 itialize itself
5ac0: 61 6e 64 20 74 68 65 20 61 70 70 6c 69 63 61 74 and the applicat
5ad0: 69 6f 6e 20 69 73 20 72 65 71 75 69 72 65 64 0a ion is required.
5ae0: 20 20 74 6f 20 69 6e 76 6f 6b 65 20 5b 73 71 6c to invoke [sql
5af0: 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 ite3_initialize(
5b00: 29 5d 20 64 69 72 65 63 74 6c 79 20 70 72 69 6f )] directly prio
5b10: 72 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 75 r to beginning u
5b20: 73 65 20 6f 66 20 74 68 65 0a 20 20 53 51 4c 69 se of the. SQLi
5b30: 74 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 te library..}..C
5b40: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 OMPILE_OPTION {S
5b50: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
5b60: 41 43 55 55 4d 7d 20 7b 0a 20 20 49 66 20 74 68 ACUUM} {. If th
5b70: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 is option is def
5b80: 69 6e 65 64 2c 20 74 68 65 20 6c 69 62 72 61 72 ined, the librar
5b90: 79 20 63 61 6e 6e 6f 74 20 63 72 65 61 74 65 20 y cannot create
5ba0: 6f 72 20 77 72 69 74 65 20 74 6f 20 0a 20 20 64 or write to . d
5bb0: 61 74 61 62 61 73 65 73 20 74 68 61 74 20 73 75 atabases that su
5bc0: 70 70 6f 72 74 20 5b 61 75 74 6f 5f 76 61 63 75 pport [auto_vacu
5bd0: 75 6d 5d 2e 0a 20 20 45 78 65 63 75 74 69 6e 67 um].. Executing
5be0: 20 61 20 5b 50 52 41 47 4d 41 20 61 75 74 6f 5f a [PRAGMA auto_
5bf0: 76 61 63 75 75 6d 5d 20 73 74 61 74 65 6d 65 6e vacuum] statemen
5c00: 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 72 72 6f t is not an erro
5c10: 72 0a 20 20 28 73 69 6e 63 65 20 75 6e 6b 6e 6f r. (since unkno
5c20: 77 6e 20 50 52 41 47 4d 41 73 20 61 72 65 20 73 wn PRAGMAs are s
5c30: 69 6c 65 6e 74 6c 79 20 69 67 6e 6f 72 65 64 29 ilently ignored)
5c40: 2c 20 62 75 74 20 64 6f 65 73 20 6e 6f 74 20 72 , but does not r
5c50: 65 74 75 72 6e 20 61 20 76 61 6c 75 65 0a 20 20 eturn a value.
5c60: 6f 72 20 6d 6f 64 69 66 79 20 74 68 65 20 61 75 or modify the au
5c70: 74 6f 2d 76 61 63 75 75 6d 20 66 6c 61 67 20 69 to-vacuum flag i
5c80: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
5c90: 69 6c 65 2e 20 49 66 20 61 20 64 61 74 61 62 61 ile. If a databa
5ca0: 73 65 20 74 68 61 74 0a 20 20 73 75 70 70 6f 72 se that. suppor
5cb0: 74 73 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 69 ts auto-vacuum i
5cc0: 73 20 6f 70 65 6e 65 64 20 62 79 20 61 20 6c 69 s opened by a li
5cd0: 62 72 61 72 79 20 63 6f 6d 70 69 6c 65 64 20 77 brary compiled w
5ce0: 69 74 68 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c ith this option,
5cf0: 20 69 74 0a 20 20 69 73 20 61 75 74 6f 6d 61 74 it. is automat
5d00: 69 63 61 6c 6c 79 20 6f 70 65 6e 65 64 20 69 6e ically opened in
5d10: 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 6f 64 65 2e read-only mode.
5d20: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
5d30: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
5d40: 42 45 54 57 45 45 4e 5f 4f 50 54 49 4d 49 5a 41 BETWEEN_OPTIMIZA
5d50: 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f TION} {. This o
5d60: 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 73 20 74 ption disables t
5d70: 68 65 20 75 73 65 20 6f 66 20 69 6e 64 69 63 65 he use of indice
5d80: 73 20 77 69 74 68 20 57 48 45 52 45 20 63 6c 61 s with WHERE cla
5d90: 75 73 65 20 74 65 72 6d 73 0a 20 20 74 68 61 74 use terms. that
5da0: 20 65 6d 70 6c 6f 79 20 74 68 65 20 42 45 54 57 employ the BETW
5db0: 45 45 4e 20 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a EEN operator..}.
5dc0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
5dd0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 4c 4f {SQLITE_OMIT_BLO
5de0: 42 5f 4c 49 54 45 52 41 4c 7d 20 7b 0a 20 20 57 B_LITERAL} {. W
5df0: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 hen this option
5e00: 69 73 20 64 65 66 69 6e 65 64 2c 20 69 74 20 69 is defined, it i
5e10: 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 s not possible t
5e20: 6f 20 73 70 65 63 69 66 79 20 61 20 62 6c 6f 62 o specify a blob
5e30: 20 69 6e 0a 20 20 61 6e 20 53 51 4c 20 73 74 61 in. an SQL sta
5e40: 74 65 6d 65 6e 74 20 75 73 69 6e 67 20 74 68 65 tement using the
5e50: 20 58 27 41 42 43 44 27 20 73 79 6e 74 61 78 2e X'ABCD' syntax.
5e60: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
5e70: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
5e80: 42 55 49 4c 54 49 4e 5f 54 45 53 54 7d 20 7b 0a BUILTIN_TEST} {.
5e90: 20 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c A standard SQL
5ea0: 69 74 65 20 62 75 69 6c 64 20 69 6e 63 6c 75 64 ite build includ
5eb0: 65 73 20 61 20 73 6d 61 6c 6c 20 61 6d 6f 75 6e es a small amoun
5ec0: 74 20 6f 66 20 6c 6f 67 69 63 20 63 6f 6e 74 72 t of logic contr
5ed0: 6f 6c 6c 65 64 0a 20 20 62 79 20 74 68 65 20 5b olled. by the [
5ee0: 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
5ef0: 74 72 6f 6c 28 29 5d 20 69 6e 74 65 72 66 61 63 trol()] interfac
5f00: 65 20 74 68 61 74 20 69 73 20 75 73 65 64 20 74 e that is used t
5f10: 6f 20 65 78 65 72 63 69 73 65 0a 20 20 70 61 72 o exercise. par
5f20: 74 73 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 ts of the SQLite
5f30: 20 63 6f 72 65 20 74 68 61 74 20 61 72 65 20 64 core that are d
5f40: 69 66 66 69 63 75 6c 74 20 74 6f 20 63 6f 6e 74 ifficult to cont
5f50: 72 6f 6c 20 61 6e 64 20 6d 65 61 73 75 72 65 20 rol and measure
5f60: 75 73 69 6e 67 0a 20 20 74 68 65 20 73 74 61 6e using. the stan
5f70: 64 61 72 64 20 41 50 49 2e 20 20 54 68 69 73 20 dard API. This
5f80: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 61 option omits tha
5f90: 74 20 62 75 69 6c 74 2d 69 6e 20 74 65 73 74 20 t built-in test
5fa0: 6c 6f 67 69 63 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c logic..}..COMPIL
5fb0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 E_OPTION {SQLITE
5fc0: 5f 4f 4d 49 54 5f 43 41 53 54 7d 20 7b 0a 20 20 _OMIT_CAST} {.
5fd0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 This option caus
5fe0: 65 73 20 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69 es SQLite to omi
5ff0: 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 t support for th
6000: 65 20 43 41 53 54 20 6f 70 65 72 61 74 6f 72 2e e CAST operator.
6010: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
6020: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
6030: 43 48 45 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 CHECK} {. This
6040: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51 option causes SQ
6050: 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 Lite to omit sup
6060: 70 6f 72 74 20 66 6f 72 20 43 48 45 43 4b 20 63 port for CHECK c
6070: 6f 6e 73 74 72 61 69 6e 74 73 2e 0a 20 20 54 68 onstraints.. Th
6080: 65 20 70 61 72 73 65 72 20 77 69 6c 6c 20 73 74 e parser will st
6090: 69 6c 6c 20 61 63 63 65 70 74 20 43 48 45 43 4b ill accept CHECK
60a0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 69 6e 20 constraints in
60b0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 2c 0a SQL statements,.
60c0: 20 20 74 68 65 79 20 77 69 6c 6c 20 6a 75 73 74 they will just
60d0: 20 6e 6f 74 20 62 65 20 65 6e 66 6f 72 63 65 64 not be enforced
60e0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 ..}..COMPILE_OPT
60f0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 ION {SQLITE_OMIT
6100: 5f 43 4f 4d 50 4c 45 54 45 7d 20 7b 0a 20 20 54 _COMPLETE} {. T
6110: 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 his option cause
6120: 73 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 s the [sqlite3_c
6130: 6f 6d 70 6c 65 74 65 28 29 5d 20 61 6e 64 20 5b omplete()] and [
6140: 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65 sqlite3_complete
6150: 31 36 28 29 5d 0a 20 20 69 6e 74 65 72 66 61 63 16()]. interfac
6160: 65 73 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 es to be omitted
6170: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 ..}..COMPILE_OPT
6180: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 ION {SQLITE_OMIT
6190: 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54 _COMPOUND_SELECT
61a0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f } {. This optio
61b0: 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 n is used to omi
61c0: 74 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64 20 5b t the compound [
61d0: 53 45 4c 45 43 54 5d 20 66 75 6e 63 74 69 6f 6e SELECT] function
61e0: 61 6c 69 74 79 2e 20 0a 20 20 5b 53 45 4c 45 43 ality. . [SELEC
61f0: 54 5d 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 T] statements th
6200: 61 74 20 75 73 65 20 74 68 65 20 0a 20 20 55 4e at use the . UN
6210: 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c 2c 20 ION, UNION ALL,
6220: 49 4e 54 45 52 53 45 43 54 20 6f 72 20 45 58 43 INTERSECT or EXC
6230: 45 50 54 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c EPT compound SEL
6240: 45 43 54 20 6f 70 65 72 61 74 6f 72 73 20 77 69 ECT operators wi
6250: 6c 6c 20 0a 20 20 63 61 75 73 65 20 61 20 70 61 ll . cause a pa
6260: 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f rse error..}..CO
6270: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 MPILE_OPTION {SQ
6280: 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4e 46 4c 49 LITE_OMIT_CONFLI
6290: 43 54 5f 43 4c 41 55 53 45 7d 20 7b 0a 20 20 49 CT_CLAUSE} {. I
62a0: 6e 20 74 68 65 20 66 75 74 75 72 65 2c 20 74 68 n the future, th
62b0: 69 73 20 6f 70 74 69 6f 6e 20 77 69 6c 6c 20 62 is option will b
62c0: 65 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74 e used to omit t
62d0: 68 65 20 0a 20 20 5b 4f 4e 20 43 4f 4e 46 4c 49 he . [ON CONFLI
62e0: 43 54 5d 20 63 6c 61 75 73 65 20 66 72 6f 6d 20 CT] clause from
62f0: 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a the library..}..
6300: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b COMPILE_OPTION {
6310: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 41 54 45 SQLITE_OMIT_DATE
6320: 54 49 4d 45 5f 46 55 4e 43 53 7d 20 7b 0a 20 20 TIME_FUNCS} {.
6330: 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 If this option i
6340: 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c 69 74 s defined, SQLit
6350: 65 27 73 20 62 75 69 6c 74 2d 69 6e 20 64 61 74 e's built-in dat
6360: 65 20 61 6e 64 20 74 69 6d 65 20 6d 61 6e 69 70 e and time manip
6370: 75 6c 61 74 69 6f 6e 0a 20 20 66 75 6e 63 74 69 ulation. functi
6380: 6f 6e 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2e ons are omitted.
6390: 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 Specifically, t
63a0: 68 65 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 he SQL functions
63b0: 20 6a 75 6c 69 61 6e 64 61 79 28 29 2c 20 64 61 julianday(), da
63c0: 74 65 28 29 2c 0a 20 20 74 69 6d 65 28 29 2c 20 te(),. time(),
63d0: 64 61 74 65 74 69 6d 65 28 29 20 61 6e 64 20 73 datetime() and s
63e0: 74 72 66 74 69 6d 65 28 29 20 61 72 65 20 6e 6f trftime() are no
63f0: 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 54 68 65 t available. The
6400: 20 64 65 66 61 75 6c 74 20 63 6f 6c 75 6d 6e 0a default column.
6410: 20 20 76 61 6c 75 65 73 20 43 55 52 52 45 4e 54 values CURRENT
6420: 5f 54 49 4d 45 2c 20 43 55 52 52 45 4e 54 5f 44 _TIME, CURRENT_D
6430: 41 54 45 20 61 6e 64 20 43 55 52 52 45 4e 54 5f ATE and CURRENT_
6440: 44 41 54 45 54 49 4d 45 20 61 72 65 20 73 74 69 DATETIME are sti
6450: 6c 6c 20 61 76 61 69 6c 61 62 6c 65 2e 0a 7d 0a ll available..}.
6460: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
6470: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 {SQLITE_OMIT_DEC
6480: 4c 54 59 50 45 7d 20 7b 0a 20 20 54 68 69 73 20 LTYPE} {. This
6490: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51 option causes SQ
64a0: 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 Lite to omit sup
64b0: 70 6f 72 74 20 66 6f 72 20 74 68 65 0a 20 20 5b port for the. [
64c0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 sqlite3_column_d
64d0: 65 63 6c 74 79 70 65 28 29 5d 20 61 6e 64 20 5b ecltype()] and [
64e0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 sqlite3_column_d
64f0: 65 63 6c 74 79 70 65 31 36 28 29 5d 0a 20 20 69 ecltype16()]. i
6500: 6e 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f nterfaces..}..CO
6510: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 MPILE_OPTION {SQ
6520: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 LITE_OMIT_DEPREC
6530: 41 54 45 44 7d 20 7b 0a 20 20 54 68 69 73 20 6f ATED} {. This o
6540: 70 74 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c ption causes SQL
6550: 69 74 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 ite to omit supp
6560: 6f 72 74 20 66 6f 72 20 69 6e 74 65 72 66 61 63 ort for interfac
6570: 65 73 0a 20 20 6d 61 72 6b 65 64 20 61 73 20 64 es. marked as d
6580: 65 70 72 65 63 61 74 65 64 2e 20 20 54 68 69 73 eprecated. This
6590: 20 69 6e 63 6c 75 64 65 73 20 0a 20 20 5b 73 71 includes . [sq
65a0: 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f lite3_aggregate_
65b0: 63 6f 75 6e 74 28 29 5d 2c 0a 20 20 5b 73 71 6c count()],. [sql
65c0: 69 74 65 33 5f 65 78 70 69 72 65 64 28 29 5d 2c ite3_expired()],
65d0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 74 72 61 6e . [sqlite3_tran
65e0: 73 66 65 72 5f 62 69 6e 64 69 6e 67 73 28 29 5d sfer_bindings()]
65f0: 2c 0a 20 20 5b 73 71 6c 69 74 65 33 5f 67 6c 6f ,. [sqlite3_glo
6600: 62 61 6c 5f 72 65 63 6f 76 65 72 28 29 5d 2c 0a bal_recover()],.
6610: 20 20 5b 73 71 6c 69 74 65 33 5f 74 68 72 65 61 [sqlite3_threa
6620: 64 5f 63 6c 65 61 6e 75 70 28 29 5d 20 61 6e 64 d_cleanup()] and
6630: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6d 65 6d 6f . [sqlite3_memo
6640: 72 79 5f 61 6c 61 72 6d 28 29 5d 20 69 6e 74 65 ry_alarm()] inte
6650: 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 rfaces..}..COMPI
6660: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 LE_OPTION {SQLIT
6670: 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 7d 20 7b E_OMIT_DISKIO} {
6680: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f . This option o
6690: 6d 69 74 73 20 61 6c 6c 20 73 75 70 70 6f 72 74 mits all support
66a0: 20 66 6f 72 20 77 72 69 74 69 6e 67 20 74 6f 20 for writing to
66b0: 74 68 65 20 64 69 73 6b 20 61 6e 64 20 66 6f 72 the disk and for
66c0: 63 65 73 0a 20 20 64 61 74 61 62 61 73 65 73 20 ces. databases
66d0: 74 6f 20 65 78 69 73 74 20 69 6e 20 6d 65 6d 6f to exist in memo
66e0: 72 79 20 6f 6e 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 ry only..}..COMP
66f0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 ILE_OPTION {SQLI
6700: 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 7d TE_OMIT_EXPLAIN}
6710: 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 {. Defining th
6720: 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 is option causes
6730: 20 74 68 65 20 5b 45 58 50 4c 41 49 4e 5d 20 63 the [EXPLAIN] c
6740: 6f 6d 6d 61 6e 64 20 74 6f 20 62 65 20 6f 6d 69 ommand to be omi
6750: 74 74 65 64 20 66 72 6f 6d 20 74 68 65 0a 20 20 tted from the.
6760: 6c 69 62 72 61 72 79 2e 20 41 74 74 65 6d 70 74 library. Attempt
6770: 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65 20 61 ing to execute a
6780: 6e 20 5b 45 58 50 4c 41 49 4e 5d 20 73 74 61 74 n [EXPLAIN] stat
6790: 65 6d 65 6e 74 20 77 69 6c 6c 20 63 61 75 73 65 ement will cause
67a0: 20 61 20 70 61 72 73 65 0a 20 20 65 72 72 6f 72 a parse. error
67b0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 ..}..COMPILE_OPT
67c0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 ION {SQLITE_OMIT
67d0: 5f 46 4c 41 47 5f 50 52 41 47 4d 41 53 7d 20 7b _FLAG_PRAGMAS} {
67e0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f . This option o
67f0: 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 mits support for
6800: 20 61 20 73 75 62 73 65 74 20 6f 66 20 5b 50 52 a subset of [PR
6810: 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 73 20 74 AGMA] commands t
6820: 68 61 74 0a 20 20 71 75 65 72 79 20 61 6e 64 20 hat. query and
6830: 73 65 74 20 62 6f 6f 6c 65 61 6e 20 70 72 6f 70 set boolean prop
6840: 65 72 74 69 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 erties..}..COMPI
6850: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 LE_OPTION {SQLIT
6860: 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f E_OMIT_FLOATING_
6870: 50 4f 49 4e 54 7d 20 7b 0a 20 20 54 68 69 73 20 POINT} {. This
6880: 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 option is used t
6890: 6f 20 6f 6d 69 74 20 66 6c 6f 61 74 69 6e 67 2d o omit floating-
68a0: 70 6f 69 6e 74 20 6e 75 6d 62 65 72 20 73 75 70 point number sup
68b0: 70 6f 72 74 20 66 72 6f 6d 20 74 68 65 20 53 51 port from the SQ
68c0: 4c 69 74 65 0a 20 20 6c 69 62 72 61 72 79 2e 20 Lite. library.
68d0: 57 68 65 6e 20 73 70 65 63 69 66 69 65 64 2c 20 When specified,
68e0: 73 70 65 63 69 66 79 69 6e 67 20 61 20 66 6c 6f specifying a flo
68f0: 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e 75 6d 62 ating point numb
6900: 65 72 20 61 73 20 61 20 6c 69 74 65 72 61 6c 20 er as a literal
6910: 0a 20 20 28 69 2e 65 2e 20 22 31 2e 30 31 22 29 . (i.e. "1.01")
6920: 20 72 65 73 75 6c 74 73 20 69 6e 20 61 20 70 61 results in a pa
6930: 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20 20 3c 70 rse error... <p
6940: 3e 49 6e 20 74 68 65 20 66 75 74 75 72 65 2c 20 >In the future,
6950: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d 61 79 20 this option may
6960: 61 6c 73 6f 20 64 69 73 61 62 6c 65 20 6f 74 68 also disable oth
6970: 65 72 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e er floating poin
6980: 74 20 0a 20 20 66 75 6e 63 74 69 6f 6e 61 6c 69 t . functionali
6990: 74 79 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 ty, for example
69a0: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 72 65 73 the [sqlite3_res
69b0: 75 6c 74 5f 64 6f 75 62 6c 65 28 29 5d 2c 20 0a ult_double()], .
69c0: 20 20 5b 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f [sqlite3_bind_
69d0: 64 6f 75 62 6c 65 28 29 5d 2c 20 5b 73 71 6c 69 double()], [sqli
69e0: 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c 65 te3_value_double
69f0: 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 ()] and. [sqlit
6a00: 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62 6c 65 e3_column_double
6a10: 28 29 5d 20 41 50 49 20 66 75 6e 63 74 69 6f 6e ()] API function
6a20: 73 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a 43 4f 4d s.. </p>.}..COM
6a30: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c PILE_OPTION {SQL
6a40: 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e ITE_OMIT_FOREIGN
6a50: 5f 4b 45 59 7d 20 7b 0a 20 20 49 66 20 74 68 69 _KEY} {. If thi
6a60: 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 s option is defi
6a70: 6e 65 64 2c 20 46 4f 52 45 49 47 4e 20 4b 45 59 ned, FOREIGN KEY
6a80: 20 63 6c 61 75 73 65 73 20 69 6e 20 63 6f 6c 75 clauses in colu
6a90: 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 mn declarations
6aa0: 61 72 65 0a 20 20 69 67 6e 6f 72 65 64 2e 0a 7d are. ignored..}
6ab0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e ..COMPILE_OPTION
6ac0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 45 {SQLITE_OMIT_GE
6ad0: 54 5f 54 41 42 4c 45 7d 20 7b 0a 20 20 54 68 69 T_TABLE} {. Thi
6ae0: 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 s option causes
6af0: 73 75 70 70 6f 72 74 20 66 6f 72 20 5b 73 71 6c support for [sql
6b00: 69 74 65 33 5f 67 65 74 5f 74 61 62 6c 65 28 29 ite3_get_table()
6b10: 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 ] and. [sqlite3
6b20: 5f 66 72 65 65 5f 74 61 62 6c 65 28 29 5d 20 74 _free_table()] t
6b30: 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e 0a 7d 0a o be omitted..}.
6b40: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
6b50: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 {SQLITE_OMIT_INC
6b60: 52 42 4c 4f 42 7d 20 7b 0a 20 20 54 68 69 73 20 RBLOB} {. This
6b70: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 73 75 option causes su
6b80: 70 70 6f 72 74 20 66 6f 72 20 5b 73 71 6c 69 74 pport for [sqlit
6b90: 65 33 5f 62 6c 6f 62 20 7c 20 69 6e 63 72 65 6d e3_blob | increm
6ba0: 65 6e 74 61 6c 20 42 4c 4f 42 20 49 2f 4f 5d 0a ental BLOB I/O].
6bb0: 20 20 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 2e to be omitted.
6bc0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
6bd0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
6be0: 49 4e 54 45 47 52 49 54 59 5f 43 48 45 43 4b 7d INTEGRITY_CHECK}
6bf0: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e {. This option
6c00: 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20 66 omits support f
6c10: 6f 72 20 74 68 65 20 5b 69 6e 74 65 67 72 69 74 or the [integrit
6c20: 79 5f 63 68 65 63 6b 20 70 72 61 67 6d 61 5d 2e y_check pragma].
6c30: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
6c40: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
6c50: 4c 49 4b 45 5f 4f 50 54 49 4d 49 5a 41 54 49 4f LIKE_OPTIMIZATIO
6c60: 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 N} {. This opti
6c70: 6f 6e 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 on disables the
6c80: 61 62 69 6c 69 74 79 20 6f 66 20 53 51 4c 69 74 ability of SQLit
6c90: 65 20 74 6f 20 75 73 65 20 69 6e 64 69 63 65 73 e to use indices
6ca0: 20 74 6f 20 68 65 6c 70 0a 20 20 72 65 73 6f 6c to help. resol
6cb0: 76 65 20 5b 4c 49 4b 45 5d 20 61 6e 64 20 5b 47 ve [LIKE] and [G
6cc0: 4c 4f 42 5d 20 6f 70 65 72 61 74 6f 72 73 20 69 LOB] operators i
6cd0: 6e 20 61 20 57 48 45 52 45 20 63 6c 61 75 73 65 n a WHERE clause
6ce0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 ..}..COMPILE_OPT
6cf0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 ION {SQLITE_OMIT
6d00: 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e 7d _LOAD_EXTENSION}
6d10: 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e {. This option
6d20: 20 6f 6d 69 74 73 20 74 68 65 20 65 6e 74 69 72 omits the entir
6d30: 65 20 65 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64 e extension load
6d40: 69 6e 67 20 6d 65 63 68 61 6e 69 73 6d 20 66 72 ing mechanism fr
6d50: 6f 6d 0a 20 20 53 51 4c 69 74 65 2c 20 69 6e 63 om. SQLite, inc
6d60: 6c 75 64 69 6e 67 20 5b 73 71 6c 69 74 65 33 5f luding [sqlite3_
6d70: 65 6e 61 62 6c 65 5f 6c 6f 61 64 5f 65 78 74 65 enable_load_exte
6d80: 6e 73 69 6f 6e 28 29 5d 20 61 6e 64 0a 20 20 5b nsion()] and. [
6d90: 73 71 6c 69 74 65 33 5f 6c 6f 61 64 5f 65 78 74 sqlite3_load_ext
6da0: 65 6e 73 69 6f 6e 28 29 5d 20 69 6e 74 65 72 66 ension()] interf
6db0: 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 aces..}..COMPILE
6dc0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f _OPTION {SQLITE_
6dd0: 4f 4d 49 54 5f 4c 4f 43 41 4c 54 49 4d 45 7d 20 OMIT_LOCALTIME}
6de0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 {. This option
6df0: 6f 6d 69 74 73 20 74 68 65 20 22 6c 6f 63 61 6c omits the "local
6e00: 74 69 6d 65 22 20 6d 6f 64 69 66 69 65 72 20 66 time" modifier f
6e10: 72 6f 6d 20 74 68 65 20 64 61 74 65 20 61 6e 64 rom the date and
6e20: 20 74 69 6d 65 0a 20 20 66 75 6e 63 74 69 6f 6e time. function
6e30: 73 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 s. This option
6e40: 69 73 20 73 6f 6d 65 74 69 6d 65 73 20 75 73 65 is sometimes use
6e50: 66 75 6c 20 77 68 65 6e 20 74 72 79 69 6e 67 20 ful when trying
6e60: 74 6f 20 63 6f 6d 70 69 6c 65 0a 20 20 74 68 65 to compile. the
6e70: 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 66 date and time f
6e80: 75 6e 63 74 69 6f 6e 73 20 6f 6e 20 61 20 70 6c unctions on a pl
6e90: 61 74 66 6f 72 6d 20 74 68 61 74 20 64 6f 65 73 atform that does
6ea0: 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 74 68 65 not support the
6eb0: 0a 20 20 63 6f 6e 63 65 70 74 20 6f 66 20 6c 6f . concept of lo
6ec0: 63 61 6c 20 74 69 6d 65 2e 0a 7d 0a 0a 43 4f 4d cal time..}..COM
6ed0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c PILE_OPTION {SQL
6ee0: 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 ITE_OMIT_MEMORYD
6ef0: 42 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 B} {. When this
6f00: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 is defined, the
6f10: 20 6c 69 62 72 61 72 79 20 64 6f 65 73 20 6e 6f library does no
6f20: 74 20 72 65 73 70 65 63 74 20 74 68 65 20 73 70 t respect the sp
6f30: 65 63 69 61 6c 20 64 61 74 61 62 61 73 65 0a 20 ecial database.
6f40: 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 name ":memory:"
6f50: 20 28 6e 6f 72 6d 61 6c 6c 79 20 75 73 65 64 20 (normally used
6f60: 74 6f 20 63 72 65 61 74 65 20 61 6e 20 5b 69 6e to create an [in
6f70: 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 -memory database
6f80: 5d 29 2e 20 49 66 20 0a 20 20 22 3a 6d 65 6d 6f ]). If . ":memo
6f90: 72 79 3a 22 20 69 73 20 70 61 73 73 65 64 20 74 ry:" is passed t
6fa0: 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 o [sqlite3_open(
6fb0: 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 )], [sqlite3_ope
6fc0: 6e 31 36 28 29 5d 2c 20 6f 72 0a 20 20 5b 73 71 n16()], or. [sq
6fd0: 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d lite3_open_v2()]
6fe0: 2c 20 61 20 66 69 6c 65 20 77 69 74 68 20 74 68 , a file with th
6ff0: 69 73 20 6e 61 6d 65 20 77 69 6c 6c 20 62 65 20 is name will be
7000: 0a 20 20 6f 70 65 6e 65 64 20 6f 72 20 63 72 65 . opened or cre
7010: 61 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 ated..}..COMPILE
7020: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f _OPTION {SQLITE_
7030: 4f 4d 49 54 5f 4f 52 5f 4f 50 54 49 4d 49 5a 41 OMIT_OR_OPTIMIZA
7040: 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f TION} {. This o
7050: 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 73 20 74 ption disables t
7060: 68 65 20 61 62 69 6c 69 74 79 20 6f 66 20 53 51 he ability of SQ
7070: 4c 69 74 65 20 74 6f 20 75 73 65 20 61 6e 20 69 Lite to use an i
7080: 6e 64 65 78 20 74 6f 67 65 74 68 65 72 0a 20 20 ndex together.
7090: 77 69 74 68 20 74 65 72 6d 73 20 6f 66 20 61 20 with terms of a
70a0: 57 48 45 52 45 20 63 6c 61 75 73 65 20 63 6f 6e WHERE clause con
70b0: 6e 65 63 74 65 64 20 62 79 20 74 68 65 20 4f 52 nected by the OR
70c0: 20 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a 43 4f operator..}..CO
70d0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 MPILE_OPTION {SQ
70e0: 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f LITE_OMIT_PAGER_
70f0: 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20 44 65 66 PRAGMAS} {. Def
7100: 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f ining this optio
7110: 6e 20 6f 6d 69 74 73 20 70 72 61 67 6d 61 73 20 n omits pragmas
7120: 72 65 6c 61 74 65 64 20 74 6f 20 74 68 65 20 70 related to the p
7130: 61 67 65 72 20 73 75 62 73 79 73 74 65 6d 20 66 ager subsystem f
7140: 72 6f 6d 20 0a 20 20 74 68 65 20 62 75 69 6c 64 rom . the build
7150: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 ..}..COMPILE_OPT
7160: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 ION {SQLITE_OMIT
7170: 5f 50 52 41 47 4d 41 7d 20 7b 0a 20 20 54 68 69 _PRAGMA} {. Thi
7180: 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 s option is used
7190: 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 5b 50 52 to omit the [PR
71a0: 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 0a 20 20 AGMA] command.
71b0: 66 72 6f 6d 20 74 68 65 20 6c 69 62 72 61 72 79 from the library
71c0: 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 74 20 69 . Note that it i
71d0: 73 20 75 73 65 66 75 6c 20 74 6f 20 64 65 66 69 s useful to defi
71e0: 6e 65 20 74 68 65 20 6d 61 63 72 6f 73 20 74 68 ne the macros th
71f0: 61 74 20 6f 6d 69 74 0a 20 20 73 70 65 63 69 66 at omit. specif
7200: 69 63 20 70 72 61 67 6d 61 73 20 69 6e 20 61 64 ic pragmas in ad
7210: 64 69 74 69 6f 6e 20 74 6f 20 74 68 69 73 2c 20 dition to this,
7220: 61 73 20 74 68 65 79 20 6d 61 79 20 61 6c 73 6f as they may also
7230: 20 72 65 6d 6f 76 65 20 73 75 70 70 6f 72 74 69 remove supporti
7240: 6e 67 20 63 6f 64 65 0a 20 20 69 6e 20 6f 74 68 ng code. in oth
7250: 65 72 20 73 75 62 2d 73 79 73 74 65 6d 73 2e 20 er sub-systems.
7260: 54 68 69 73 20 6d 61 63 72 6f 20 72 65 6d 6f 76 This macro remov
7270: 65 73 20 74 68 65 20 5b 50 52 41 47 4d 41 5d 20 es the [PRAGMA]
7280: 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 2e 0a 7d 0a command only..}.
7290: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 .COMPILE_OPTION
72a0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f {SQLITE_OMIT_PRO
72b0: 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 7d 20 GRESS_CALLBACK}
72c0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 {. This option
72d0: 6d 61 79 20 62 65 20 64 65 66 69 6e 65 64 20 74 may be defined t
72e0: 6f 20 6f 6d 69 74 20 74 68 65 20 63 61 70 61 62 o omit the capab
72f0: 69 6c 69 74 79 20 74 6f 20 69 73 73 75 65 20 22 ility to issue "
7300: 70 72 6f 67 72 65 73 73 22 20 0a 20 20 63 61 6c progress" . cal
7310: 6c 62 61 63 6b 73 20 64 75 72 69 6e 67 20 6c 6f lbacks during lo
7320: 6e 67 2d 72 75 6e 6e 69 6e 67 20 53 51 4c 20 73 ng-running SQL s
7330: 74 61 74 65 6d 65 6e 74 73 2e 20 54 68 65 20 0a tatements. The .
7340: 20 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 [sqlite3_progr
7350: 65 73 73 5f 68 61 6e 64 6c 65 72 28 29 5d 0a 20 ess_handler()].
7360: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 69 73 API function is
7370: 20 6e 6f 74 20 70 72 65 73 65 6e 74 20 69 6e 20 not present in
7380: 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a the library..}..
7390: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b COMPILE_OPTION {
73a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 55 49 43 SQLITE_OMIT_QUIC
73b0: 4b 42 41 4c 41 4e 43 45 7d 20 7b 0a 20 20 54 68 KBALANCE} {. Th
73c0: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 is option omits
73d0: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 2c 20 an alternative,
73e0: 66 61 73 74 65 72 20 42 2d 54 72 65 65 20 62 61 faster B-Tree ba
73f0: 6c 61 6e 63 69 6e 67 20 72 6f 75 74 69 6e 65 2e lancing routine.
7400: 0a 20 20 55 73 69 6e 67 20 74 68 69 73 20 6f 70 . Using this op
7410: 74 69 6f 6e 20 6d 61 6b 65 73 20 53 51 4c 69 74 tion makes SQLit
7420: 65 20 73 6c 69 67 68 74 6c 79 20 73 6d 61 6c 6c e slightly small
7430: 65 72 20 61 74 20 74 68 65 20 65 78 70 65 6e 73 er at the expens
7440: 65 20 6f 66 0a 20 20 6d 61 6b 69 6e 67 20 69 74 e of. making it
7450: 20 72 75 6e 20 73 6c 69 67 68 74 6c 79 20 73 6c run slightly sl
7460: 6f 77 65 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 ower..}..COMPILE
7470: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f _OPTION {SQLITE_
7480: 4f 4d 49 54 5f 52 45 49 4e 44 45 58 7d 20 7b 0a OMIT_REINDEX} {.
7490: 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 When this opti
74a0: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 on is defined, t
74b0: 68 65 20 5b 52 45 49 4e 44 45 58 5d 0a 20 20 63 he [REINDEX]. c
74c0: 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e ommand is not in
74d0: 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 6c 69 cluded in the li
74e0: 62 72 61 72 79 2e 0a 20 20 45 78 65 63 75 74 69 brary.. Executi
74f0: 6e 67 20 61 20 5b 52 45 49 4e 44 45 58 5d 20 73 ng a [REINDEX] s
7500: 74 61 74 65 6d 65 6e 74 20 63 61 75 73 65 73 20 tatement causes
7510: 0a 20 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 . a parse error
7520: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 ..}..COMPILE_OPT
7530: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 ION {SQLITE_OMIT
7540: 5f 53 43 48 45 4d 41 5f 50 52 41 47 4d 41 53 7d _SCHEMA_PRAGMAS}
7550: 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 {. Defining th
7560: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 is option omits
7570: 70 72 61 67 6d 61 73 20 66 6f 72 20 71 75 65 72 pragmas for quer
7580: 79 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 ying the databas
7590: 65 20 73 63 68 65 6d 61 20 66 72 6f 6d 20 0a 20 e schema from .
75a0: 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 the build..}..C
75b0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 OMPILE_OPTION {S
75c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 43 48 45 4d QLITE_OMIT_SCHEM
75d0: 41 5f 56 45 52 53 49 4f 4e 5f 50 52 41 47 4d 41 A_VERSION_PRAGMA
75e0: 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 S} {. Defining
75f0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 this option omit
7600: 73 20 70 72 61 67 6d 61 73 20 66 6f 72 20 71 75 s pragmas for qu
7610: 65 72 79 69 6e 67 20 61 6e 64 20 6d 6f 64 69 66 erying and modif
7620: 79 69 6e 67 20 74 68 65 20 0a 20 20 64 61 74 61 ying the . data
7630: 62 61 73 65 20 73 63 68 65 6d 61 20 76 65 72 73 base schema vers
7640: 69 6f 6e 20 61 6e 64 20 75 73 65 72 20 76 65 72 ion and user ver
7650: 73 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 62 75 sion from the bu
7660: 69 6c 64 2e 20 53 70 65 63 69 66 69 63 61 6c 6c ild. Specificall
7670: 79 2c 20 74 68 65 20 0a 20 20 5b 73 63 68 65 6d y, the . [schem
7680: 61 5f 76 65 72 73 69 6f 6e 5d 20 61 6e 64 20 5b a_version] and [
7690: 75 73 65 72 5f 76 65 72 73 69 6f 6e 5d 20 50 52 user_version] PR
76a0: 41 47 4d 41 73 20 61 72 65 20 6f 6d 69 74 74 65 AGMAs are omitte
76b0: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 d..}..COMPILE_OP
76c0: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 TION {SQLITE_OMI
76d0: 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 7d 20 T_SHARED_CACHE}
76e0: 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 {. This option
76f0: 62 75 69 6c 64 73 20 53 51 4c 69 74 65 20 77 69 builds SQLite wi
7700: 74 68 6f 75 74 20 73 75 70 70 6f 72 74 20 66 6f thout support fo
7710: 72 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d r shared-cache m
7720: 6f 64 65 2e 0a 20 20 54 68 65 20 5b 73 71 6c 69 ode.. The [sqli
7730: 74 65 33 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 te3_enable_share
7740: 64 5f 63 61 63 68 65 28 29 5d 20 69 73 20 6f 6d d_cache()] is om
7750: 69 74 74 65 64 20 61 6c 6f 6e 67 20 77 69 74 68 itted along with
7760: 20 61 20 66 61 69 72 0a 20 20 61 6d 6f 75 6e 74 a fair. amount
7770: 20 6f 66 20 6c 6f 67 69 63 20 77 69 74 68 69 6e of logic within
7780: 20 74 68 65 20 42 2d 54 72 65 65 20 73 75 62 73 the B-Tree subs
7790: 79 73 74 65 6d 20 61 73 73 6f 63 69 61 74 65 64 ystem associated
77a0: 20 77 69 74 68 20 73 68 61 72 65 64 0a 20 20 63 with shared. c
77b0: 61 63 68 65 20 6d 61 6e 61 67 65 6d 65 6e 74 2e ache management.
77c0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
77d0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
77e0: 53 55 42 51 55 45 52 59 7d 20 7b 0a 20 20 49 66 SUBQUERY} {. If
77f0: 20 64 65 66 69 6e 65 64 2c 20 73 75 70 70 6f 72 defined, suppor
7800: 74 20 66 6f 72 20 73 75 62 2d 73 65 6c 65 63 74 t for sub-select
7810: 73 20 61 6e 64 20 74 68 65 20 49 4e 28 29 20 6f s and the IN() o
7820: 70 65 72 61 74 6f 72 20 61 72 65 20 6f 6d 69 74 perator are omit
7830: 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f ted..}..COMPILE_
7840: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f OPTION {SQLITE_O
7850: 4d 49 54 5f 54 43 4c 5f 56 41 52 49 41 42 4c 45 MIT_TCL_VARIABLE
7860: 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6d 61 } {. If this ma
7870: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20 cro is defined,
7880: 74 68 65 6e 20 74 68 65 20 73 70 65 63 69 61 6c then the special
7890: 20 22 24 3c 76 61 72 69 61 62 6c 65 2d 6e 61 6d "$<variable-nam
78a0: 65 3e 22 20 73 79 6e 74 61 78 0a 20 20 75 73 65 e>" syntax. use
78b0: 64 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c d to automatical
78c0: 6c 79 20 62 69 6e 64 20 53 51 4c 20 76 61 72 69 ly bind SQL vari
78d0: 61 62 6c 65 73 20 74 6f 20 54 43 4c 20 76 61 72 ables to TCL var
78e0: 69 61 62 6c 65 73 20 69 73 20 6f 6d 69 74 74 65 iables is omitte
78f0: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 d..}..COMPILE_OP
7900: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 TION {SQLITE_OMI
7910: 54 5f 54 45 4d 50 44 42 7d 20 7b 0a 20 20 54 68 T_TEMPDB} {. Th
7920: 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 is option omits
7930: 73 75 70 70 6f 72 74 20 66 6f 72 20 54 45 4d 50 support for TEMP
7940: 20 6f 72 20 54 45 4d 50 4f 52 41 52 59 20 74 61 or TEMPORARY ta
7950: 62 6c 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 bles..}..COMPILE
7960: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f _OPTION {SQLITE_
7970: 4f 4d 49 54 5f 54 52 41 43 45 7d 20 7b 0a 20 20 OMIT_TRACE} {.
7980: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 This option omit
7990: 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 s support for th
79a0: 65 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f 66 69 e [sqlite3_profi
79b0: 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c le()] and. [sql
79c0: 69 74 65 33 5f 74 72 61 63 65 28 29 5d 20 69 6e ite3_trace()] in
79d0: 74 65 72 66 61 63 65 73 20 61 6e 64 20 74 68 65 terfaces and the
79e0: 69 72 20 61 73 73 6f 63 69 61 74 65 64 20 6c 6f ir associated lo
79f0: 67 69 63 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f gic..}..COMPILE_
7a00: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f OPTION {SQLITE_O
7a10: 4d 49 54 5f 54 52 49 47 47 45 52 7d 20 7b 0a 20 MIT_TRIGGER} {.
7a20: 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f Defining this o
7a30: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 ption omits supp
7a40: 6f 72 74 20 66 6f 72 20 54 52 49 47 47 45 52 20 ort for TRIGGER
7a50: 6f 62 6a 65 63 74 73 2e 20 4e 65 69 74 68 65 72 objects. Neither
7a60: 20 74 68 65 20 0a 20 20 5b 43 52 45 41 54 45 20 the . [CREATE
7a70: 54 52 49 47 47 45 52 5d 20 6f 72 20 5b 44 52 4f TRIGGER] or [DRO
7a80: 50 20 54 52 49 47 47 45 52 5d 0a 20 20 63 6f 6d P TRIGGER]. com
7a90: 6d 61 6e 64 73 20 61 72 65 20 61 76 61 69 6c 61 mands are availa
7aa0: 62 6c 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 ble in this case
7ab0: 2c 20 61 6e 64 20 61 74 74 65 6d 70 74 69 6e 67 , and attempting
7ac0: 20 74 6f 20 65 78 65 63 75 74 65 0a 20 20 65 69 to execute. ei
7ad0: 74 68 65 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 ther will result
7ae0: 20 69 6e 20 61 20 70 61 72 73 65 20 65 72 72 6f in a parse erro
7af0: 72 2e 0a 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49 r... WARNING: I
7b00: 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 f this macro is
7b10: 64 65 66 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c defined, it will
7b20: 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65 not be possible
7b30: 20 74 6f 20 6f 70 65 6e 20 61 20 64 61 74 61 62 to open a datab
7b40: 61 73 65 0a 20 20 66 6f 72 20 77 68 69 63 68 20 ase. for which
7b50: 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6e 74 61 the schema conta
7b60: 69 6e 73 20 54 52 49 47 47 45 52 20 6f 62 6a 65 ins TRIGGER obje
7b70: 63 74 73 2e 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 cts. .}..COMPILE
7b80: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f _OPTION {SQLITE_
7b90: 4f 4d 49 54 5f 54 52 55 4e 43 41 54 45 5f 4f 50 OMIT_TRUNCATE_OP
7ba0: 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 TIMIZATION} {.
7bb0: 41 20 64 65 66 61 75 6c 74 20 62 75 69 6c 64 20 A default build
7bc0: 6f 66 20 53 51 4c 69 74 65 2c 20 69 66 20 61 20 of SQLite, if a
7bd0: 5b 44 45 4c 45 54 45 5d 20 73 74 61 74 65 6d 65 [DELETE] stateme
7be0: 6e 74 20 68 61 73 20 6e 6f 20 57 48 45 52 45 20 nt has no WHERE
7bf0: 63 6c 61 75 73 65 0a 20 20 61 6e 64 20 6f 70 65 clause. and ope
7c00: 72 61 74 65 73 20 6f 6e 20 61 20 74 61 62 6c 65 rates on a table
7c10: 20 77 69 74 68 20 6e 6f 20 74 72 69 67 67 65 72 with no trigger
7c20: 73 2c 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 s, an optimizati
7c30: 6f 6e 20 6f 63 63 75 72 73 20 74 68 61 74 0a 20 on occurs that.
7c40: 20 63 61 75 73 65 73 20 74 68 65 20 44 45 4c 45 causes the DELE
7c50: 54 45 20 74 6f 20 6f 63 63 75 72 20 62 79 20 64 TE to occur by d
7c60: 72 6f 70 70 69 6e 67 20 61 6e 64 20 72 65 63 72 ropping and recr
7c70: 65 61 74 69 6e 67 20 74 68 65 20 74 61 62 6c 65 eating the table
7c80: 2e 20 20 0a 20 20 44 72 6f 70 70 69 6e 67 20 61 . . Dropping a
7c90: 6e 64 20 72 65 63 72 65 61 74 69 6e 67 20 61 20 nd recreating a
7ca0: 74 61 62 6c 65 20 69 73 20 75 73 75 61 6c 6c 79 table is usually
7cb0: 20 6d 75 63 68 20 66 61 73 74 65 72 20 74 68 61 much faster tha
7cc0: 6e 20 64 65 6c 65 74 69 6e 67 0a 20 20 74 68 65 n deleting. the
7cd0: 20 74 61 62 6c 65 20 63 6f 6e 74 65 6e 74 20 72 table content r
7ce0: 6f 77 20 62 79 20 72 6f 77 2e 20 20 54 68 69 73 ow by row. This
7cf0: 20 69 73 20 74 68 65 20 22 74 72 75 6e 63 61 74 is the "truncat
7d00: 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 22 2e e optimization".
7d10: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
7d20: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
7d30: 55 54 46 31 36 7d 20 7b 0a 20 20 54 68 69 73 20 UTF16} {. This
7d40: 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f macro is used to
7d50: 20 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f omit support fo
7d60: 72 20 55 54 46 31 36 20 74 65 78 74 20 65 6e 63 r UTF16 text enc
7d70: 6f 64 69 6e 67 2e 20 57 68 65 6e 20 74 68 69 73 oding. When this
7d80: 20 69 73 0a 20 20 64 65 66 69 6e 65 64 20 61 6c is. defined al
7d90: 6c 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 20 l API functions
7da0: 74 68 61 74 20 72 65 74 75 72 6e 20 6f 72 20 61 that return or a
7db0: 63 63 65 70 74 20 55 54 46 31 36 20 65 6e 63 6f ccept UTF16 enco
7dc0: 64 65 64 20 74 65 78 74 20 61 72 65 0a 20 20 75 ded text are. u
7dd0: 6e 61 76 61 69 6c 61 62 6c 65 2e 20 54 68 65 73 navailable. Thes
7de0: 65 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20 e functions can
7df0: 62 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 be identified by
7e00: 20 74 68 65 20 66 61 63 74 20 74 68 61 74 20 74 the fact that t
7e10: 68 65 79 20 65 6e 64 0a 20 20 77 69 74 68 20 27 hey end. with '
7e20: 31 36 27 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 16', for example
7e30: 20 5b 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 [sqlite3_prepar
7e40: 65 31 36 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 e16()], [sqlite3
7e50: 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 _column_text16()
7e60: 5d 20 61 6e 64 0a 20 20 5b 73 71 6c 69 74 65 33 ] and. [sqlite3
7e70: 5f 62 69 6e 64 5f 74 65 78 74 31 36 28 29 5d 2e _bind_text16()].
7e80: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
7e90: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
7ea0: 56 41 43 55 55 4d 7d 20 7b 0a 20 20 57 68 65 6e VACUUM} {. When
7eb0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 this option is
7ec0: 64 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 56 41 defined, the [VA
7ed0: 43 55 55 4d 5d 0a 20 20 63 6f 6d 6d 61 6e 64 20 CUUM]. command
7ee0: 69 73 20 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 is not included
7ef0: 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a in the library..
7f00: 20 20 45 78 65 63 75 74 69 6e 67 20 61 20 5b 56 Executing a [V
7f10: 41 43 55 55 4d 5d 20 73 74 61 74 65 6d 65 6e 74 ACUUM] statement
7f20: 20 63 61 75 73 65 73 20 0a 20 20 61 20 70 61 72 causes . a par
7f30: 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d se error..}..COM
7f40: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c PILE_OPTION {SQL
7f50: 49 54 45 5f 4f 4d 49 54 5f 56 49 45 57 7d 20 7b ITE_OMIT_VIEW} {
7f60: 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 . Defining this
7f70: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 option omits su
7f80: 70 70 6f 72 74 20 66 6f 72 20 56 49 45 57 20 6f pport for VIEW o
7f90: 62 6a 65 63 74 73 2e 20 4e 65 69 74 68 65 72 20 bjects. Neither
7fa0: 74 68 65 20 0a 20 20 5b 43 52 45 41 54 45 20 56 the . [CREATE V
7fb0: 49 45 57 5d 20 6e 6f 72 20 74 68 65 20 5b 44 52 IEW] nor the [DR
7fc0: 4f 50 20 56 49 45 57 5d 0a 20 20 63 6f 6d 6d 61 OP VIEW]. comma
7fd0: 6e 64 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c nds are availabl
7fe0: 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 2c 20 e in this case,
7ff0: 61 6e 64 0a 20 20 61 74 74 65 6d 70 74 69 6e 67 and. attempting
8000: 20 74 6f 20 65 78 65 63 75 74 65 20 65 69 74 68 to execute eith
8010: 65 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 er will result i
8020: 6e 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e n a parse error.
8030: 0a 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49 66 20 .. WARNING: If
8040: 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 64 65 this macro is de
8050: 66 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c 20 6e fined, it will n
8060: 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65 20 74 ot be possible t
8070: 6f 20 6f 70 65 6e 20 61 20 64 61 74 61 62 61 73 o open a databas
8080: 65 0a 20 20 66 6f 72 20 77 68 69 63 68 20 74 68 e. for which th
8090: 65 20 73 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e e schema contain
80a0: 73 20 56 49 45 57 20 6f 62 6a 65 63 74 73 2e 20 s VIEW objects.
80b0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 .}..COMPILE_OPTI
80c0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ON {SQLITE_OMIT_
80d0: 56 49 52 54 55 41 4c 54 41 42 4c 45 7d 20 7b 0a VIRTUALTABLE} {.
80e0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d This option om
80f0: 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 its support for
8100: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 76 74 61 the [sqlite3_vta
8110: 62 20 7c 20 56 69 72 74 75 61 6c 20 54 61 62 6c b | Virtual Tabl
8120: 65 5d 0a 20 20 6d 65 63 68 61 6e 69 73 6d 20 69 e]. mechanism i
8130: 6e 20 53 51 4c 69 74 65 2e 0a 7d 0a 0a 43 4f 4d n SQLite..}..COM
8140: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c PILE_OPTION {SQL
8150: 49 54 45 5f 4f 4d 49 54 5f 57 53 44 7d 20 7b 0a ITE_OMIT_WSD} {.
8160: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 73 20 62 This options b
8170: 75 69 6c 64 73 20 61 20 76 65 72 73 69 6f 6e 20 uilds a version
8180: 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 of the SQLite li
8190: 62 72 61 72 79 20 74 68 61 74 20 63 6f 6e 74 61 brary that conta
81a0: 69 6e 73 20 6e 6f 0a 20 20 57 72 69 74 61 62 6c ins no. Writabl
81b0: 65 20 53 74 61 74 69 63 20 44 61 74 61 20 28 57 e Static Data (W
81c0: 53 44 29 2e 20 20 57 53 44 20 69 73 20 67 6c 6f SD). WSD is glo
81d0: 62 61 6c 20 76 61 72 69 61 62 6c 65 73 20 61 6e bal variables an
81e0: 64 2f 6f 72 20 73 74 61 74 69 63 0a 20 20 76 61 d/or static. va
81f0: 72 69 61 62 6c 65 73 2e 20 20 53 6f 6d 65 20 70 riables. Some p
8200: 6c 61 74 66 6f 72 6d 73 20 64 6f 20 6e 6f 74 20 latforms do not
8210: 73 75 70 70 6f 72 74 20 57 53 44 2c 20 61 6e 64 support WSD, and
8220: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 this option is
8230: 6e 65 63 65 73 73 61 72 79 0a 20 20 69 6e 20 6f necessary. in o
8240: 72 64 65 72 20 66 6f 72 20 53 51 4c 69 74 65 20 rder for SQLite
8250: 74 6f 20 77 6f 72 6b 20 74 68 6f 73 65 20 70 6c to work those pl
8260: 61 74 66 6f 72 6d 73 2e 20 20 0a 0a 20 20 55 6e atforms. .. Un
8270: 6c 69 6b 65 20 6f 74 68 65 72 20 4f 4d 49 54 20 like other OMIT
8280: 6f 70 74 69 6f 6e 73 20 77 68 69 63 68 20 6d 61 options which ma
8290: 6b 65 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 ke the SQLite li
82a0: 62 72 61 72 79 20 73 6d 61 6c 6c 65 72 2c 0a 20 brary smaller,.
82b0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 61 63 74 this option act
82c0: 75 61 6c 6c 79 20 69 6e 63 72 65 61 73 65 73 20 ually increases
82d0: 74 68 65 20 73 69 7a 65 20 6f 66 20 53 51 4c 69 the size of SQLi
82e0: 74 65 20 61 6e 64 20 6d 61 6b 65 73 20 69 74 20 te and makes it
82f0: 72 75 6e 0a 20 20 61 20 6c 69 74 74 6c 65 20 73 run. a little s
8300: 6c 6f 77 65 72 2e 20 20 4f 6e 6c 79 20 75 73 65 lower. Only use
8310: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 66 20 this option if
8320: 53 51 4c 69 74 65 20 69 73 20 62 65 69 6e 67 20 SQLite is being
8330: 62 75 69 6c 74 20 66 6f 72 20 61 6e 0a 20 20 65 built for an. e
8340: 6d 62 65 64 64 65 64 20 74 61 72 67 65 74 20 74 mbedded target t
8350: 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 75 70 hat does not sup
8360: 70 6f 72 74 20 57 53 44 2e 0a 7d 0a 0a 43 4f 4d port WSD..}..COM
8370: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c PILE_OPTION {SQL
8380: 49 54 45 5f 4f 4d 49 54 5f 58 46 45 52 5f 4f 50 ITE_OMIT_XFER_OP
8390: 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 T} {. This opti
83a0: 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 on omits support
83b0: 20 66 6f 72 20 6f 70 74 69 6d 69 7a 61 74 69 6f for optimizatio
83c0: 6e 73 20 74 68 61 74 20 68 65 6c 70 20 73 74 61 ns that help sta
83d0: 74 65 6d 65 6e 74 73 0a 20 20 6f 66 20 74 68 65 tements. of the
83e0: 20 66 6f 72 6d 20 22 49 4e 53 45 52 54 20 49 4e form "INSERT IN
83f0: 54 4f 20 2e 2e 2e 20 53 45 4c 45 43 54 20 2e 2e TO ... SELECT ..
8400: 2e 22 20 72 75 6e 20 66 61 73 74 65 72 2e 0a 7d ." run faster..}
8410: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e ..COMPILE_OPTION
8420: 20 7b 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 {SQLITE_ZERO_MA
8430: 4c 4c 4f 43 7d 20 7b 0a 20 20 54 68 69 73 20 6f LLOC} {. This o
8440: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 62 6f 74 68 ption omits both
8450: 20 74 68 65 20 5b 64 65 66 61 75 6c 74 20 6d 65 the [default me
8460: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 5d 20 mory allocator]
8470: 61 6e 64 20 74 68 65 0a 20 20 5b 64 65 62 75 67 and the. [debug
8480: 67 69 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f ging memory allo
8490: 63 61 74 6f 72 5d 20 66 72 6f 6d 20 74 68 65 20 cator] from the
84a0: 62 75 69 6c 64 20 61 6e 64 20 73 75 62 73 74 69 build and substi
84b0: 74 75 74 65 73 20 61 20 73 74 75 62 0a 20 20 6d tutes a stub. m
84c0: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 20 emory allocator
84d0: 74 68 61 74 20 61 6c 77 61 79 73 20 66 61 69 6c that always fail
84e0: 73 2e 20 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 s. SQLite will
84f0: 6e 6f 74 20 72 75 6e 20 77 69 74 68 20 74 68 69 not run with thi
8500: 73 0a 20 20 73 74 75 62 20 6d 65 6d 6f 72 79 20 s. stub memory
8510: 61 6c 6c 6f 63 61 74 6f 72 20 73 69 6e 63 65 20 allocator since
8520: 69 74 20 77 69 6c 6c 20 62 65 20 75 6e 61 62 6c it will be unabl
8530: 65 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 6d 65 e to allocate me
8540: 6d 6f 72 79 2e 20 20 42 75 74 0a 20 20 74 68 69 mory. But. thi
8550: 73 20 73 74 75 62 20 63 61 6e 20 62 65 20 72 65 s stub can be re
8560: 70 6c 61 63 65 64 20 61 74 20 73 74 61 72 74 2d placed at start-
8570: 74 69 6d 65 20 75 73 69 6e 67 0a 20 20 5b 73 71 time using. [sq
8580: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5d 28 5b 53 lite3_config]([S
8590: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c QLITE_CONFIG_MAL
85a0: 4c 4f 43 5d 2c 2e 2e 2e 29 20 6f 72 0a 20 20 5b LOC],...) or. [
85b0: 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 5d 28 sqlite3_config](
85c0: 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 48 [SQLITE_CONFIG_H
85d0: 45 41 50 5d 2c 2e 2e 2e 29 2e 0a 20 20 53 6f 20 EAP],...).. So
85e0: 74 68 65 20 6e 65 74 20 65 66 66 65 63 74 20 6f the net effect o
85f0: 66 20 74 68 69 73 20 63 6f 6d 70 69 6c 65 2d 74 f this compile-t
8600: 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 74 68 ime option is th
8610: 61 74 20 69 74 20 61 6c 6c 6f 77 73 20 53 51 4c at it allows SQL
8620: 69 74 65 0a 20 20 74 6f 20 62 65 20 63 6f 6d 70 ite. to be comp
8630: 69 6c 65 64 20 61 6e 64 20 6c 69 6e 6b 65 64 20 iled and linked
8640: 61 67 61 69 6e 73 74 20 61 20 73 79 73 74 65 6d against a system
8650: 20 6c 69 62 72 61 72 79 20 74 68 61 74 20 64 6f library that do
8660: 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 0a 20 es not support.
8670: 20 6d 61 6c 6c 6f 63 28 29 2c 20 66 72 65 65 28 malloc(), free(
8680: 29 2c 20 61 6e 64 2f 6f 72 20 72 65 61 6c 6c 6f ), and/or reallo
8690: 63 28 29 2e 0a 7d 0a 0a 3c 2f 74 63 6c 3e 0a 3c c()..}..</tcl>.<
86a0: 61 20 6e 61 6d 65 3d 22 64 65 62 75 67 6f 70 74 a name="debugopt
86b0: 69 6f 6e 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 ions"></a>.<h2>1
86c0: 2e 37 20 41 6e 61 6c 79 73 69 73 20 61 6e 64 20 .7 Analysis and
86d0: 44 65 62 75 67 67 69 6e 67 20 4f 70 74 69 6f 6e Debugging Option
86e0: 73 3c 2f 68 32 3e 0a 3c 74 63 6c 3e 0a 0a 43 4f s</h2>.<tcl>..CO
86f0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 MPILE_OPTION {SQ
8700: 4c 49 54 45 5f 44 45 42 55 47 7d 20 7b 0a 20 20 LITE_DEBUG} {.
8710: 54 68 65 20 53 51 4c 69 74 65 20 73 6f 75 72 63 The SQLite sourc
8720: 65 20 63 6f 64 65 20 63 6f 6e 74 61 69 6e 73 20 e code contains
8730: 6c 69 74 65 72 61 6c 6c 79 20 74 68 6f 75 73 61 literally thousa
8740: 6e 64 73 20 6f 66 20 61 73 73 65 72 74 28 29 20 nds of assert()
8750: 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 75 73 65 statements. use
8760: 64 20 74 6f 20 76 65 72 69 66 79 20 69 6e 74 65 d to verify inte
8770: 72 6e 61 6c 20 61 73 73 75 6d 70 74 69 6f 6e 73 rnal assumptions
8780: 20 61 6e 64 20 73 75 62 72 6f 75 74 69 6e 65 20 and subroutine
8790: 70 72 65 63 6f 6e 64 69 74 69 6f 6e 73 20 61 6e preconditions an
87a0: 64 0a 20 20 70 6f 73 74 63 6f 6e 64 69 74 69 6f d. postconditio
87b0: 6e 73 2e 20 20 54 68 65 73 65 20 61 73 73 65 72 ns. These asser
87c0: 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 61 t() statements a
87d0: 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 74 75 72 6e re normally turn
87e0: 65 64 20 6f 66 66 0a 20 20 28 74 68 65 79 20 67 ed off. (they g
87f0: 65 6e 65 72 61 74 65 20 6e 6f 20 63 6f 64 65 29 enerate no code)
8800: 20 73 69 6e 63 65 20 74 75 72 6e 69 6e 67 20 74 since turning t
8810: 68 65 6d 20 6f 6e 20 6d 61 6b 65 73 20 53 51 4c hem on makes SQL
8820: 69 74 65 20 72 75 6e 20 61 70 70 72 6f 78 69 6d ite run approxim
8830: 61 74 65 6c 79 0a 20 20 74 68 72 65 65 20 74 69 ately. three ti
8840: 6d 65 73 20 73 6c 6f 77 65 72 2e 20 20 42 75 74 mes slower. But
8850: 20 66 6f 72 20 74 65 73 74 69 6e 67 20 61 6e 64 for testing and
8860: 20 61 6e 61 6c 79 73 69 73 2c 20 69 74 20 69 73 analysis, it is
8870: 20 75 73 65 66 75 6c 20 74 6f 20 74 75 72 6e 0a useful to turn.
8880: 20 20 74 68 65 20 61 73 73 65 72 74 28 29 20 73 the assert() s
8890: 74 61 74 65 6d 65 6e 74 73 20 6f 6e 2e 20 20 54 tatements on. T
88a0: 68 65 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 he SQLITE_DEBUG
88b0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 compile-time opt
88c0: 69 6f 6e 20 64 6f 65 73 20 74 68 69 73 2e 0a 20 ion does this..
88d0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 61 6c SQLITE_DEBUG al
88e0: 73 6f 20 74 75 72 6e 73 20 6f 6e 20 73 6f 6d 65 so turns on some
88f0: 20 6f 74 68 65 72 20 64 65 62 75 67 67 69 6e 67 other debugging
8900: 20 66 65 61 74 75 72 65 73 2e 0a 7d 0a 0a 43 4f features..}..CO
8910: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 MPILE_OPTION {SQ
8920: 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 7d 20 7b LITE_MEMDEBUG} {
8930: 0a 20 20 54 68 65 20 53 51 4c 49 54 45 5f 4d 45 . The SQLITE_ME
8940: 4d 44 45 42 55 47 20 6f 70 74 69 6f 6e 20 63 61 MDEBUG option ca
8950: 75 73 65 73 20 61 6e 20 69 6e 73 74 72 75 6d 65 uses an instrume
8960: 6e 74 65 64 20 0a 20 20 5b 64 65 62 75 67 67 69 nted . [debuggi
8970: 6e 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 ng memory alloca
8980: 74 6f 72 5d 0a 20 20 74 6f 20 62 65 20 75 73 65 tor]. to be use
8990: 64 20 61 73 20 74 68 65 20 64 65 66 61 75 6c 74 d as the default
89a0: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f memory allocato
89b0: 72 20 77 69 74 68 69 6e 20 53 51 4c 69 74 65 2e r within SQLite.
89c0: 20 20 54 68 65 0a 20 20 69 6e 73 74 72 75 6d 65 The. instrume
89d0: 6e 74 65 64 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f nted memory allo
89e0: 63 61 74 6f 72 20 63 68 65 63 6b 73 20 66 6f 72 cator checks for
89f0: 20 6d 69 73 75 73 65 20 6f 66 20 64 79 6e 61 6d misuse of dynam
8a00: 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 64 ically allocated
8a10: 0a 20 20 6d 65 6d 6f 72 79 2e 20 20 45 78 61 6d . memory. Exam
8a20: 70 6c 65 73 20 6f 66 20 6d 69 73 75 73 65 20 69 ples of misuse i
8a30: 6e 63 6c 75 64 65 20 75 73 69 6e 67 20 6d 65 6d nclude using mem
8a40: 6f 72 79 20 61 66 74 65 72 20 69 74 20 69 73 20 ory after it is
8a50: 66 72 65 65 64 2c 0a 20 20 77 72 69 74 69 6e 67 freed,. writing
8a60: 20 6f 66 66 20 74 68 65 20 65 6e 64 73 20 6f 66 off the ends of
8a70: 20 61 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 a memory alloca
8a80: 74 69 6f 6e 2c 20 66 72 65 65 69 6e 67 20 6d 65 tion, freeing me
8a90: 6d 6f 72 79 20 6e 6f 74 20 70 72 65 76 69 6f 75 mory not previou
8aa0: 73 6c 79 0a 20 20 6f 62 74 61 69 6e 65 64 20 66 sly. obtained f
8ab0: 72 6f 6d 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 rom the memory a
8ac0: 6c 6c 6f 63 61 74 6f 72 2c 20 6f 72 20 66 61 69 llocator, or fai
8ad0: 6c 69 6e 67 20 74 6f 20 69 6e 69 74 69 61 6c 69 ling to initiali
8ae0: 7a 65 20 6e 65 77 6c 79 0a 20 20 61 6c 6c 6f 63 ze newly. alloc
8af0: 61 74 65 64 20 6d 65 6d 6f 72 79 2e 0a 7d 0a 0a ated memory..}..
8b00: 3c 2f 74 63 6c 3e 0a </tcl>.