Documentation Source Text

Hex Artifact Content
Login

Artifact f79597f0f4289fa3e90f13b958167ad890f8acc1:


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 0a 3c  QLite</title>..<
0030: 68 31 3e 31 2e 30 20 43 6f 6d 70 69 6c 61 74 69  h1>1.0 Compilati
0040: 6f 6e 20 4f 70 74 69 6f 6e 73 20 46 6f 72 20 53  on Options For S
0050: 51 4c 69 74 65 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a  QLite</h1>..<p>.
0060: 46 6f 72 20 6d 6f 73 74 20 70 75 72 70 6f 73 65  For most purpose
0070: 73 2c 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65  s, SQLite can be
0080: 20 62 75 69 6c 74 20 6a 75 73 74 20 66 69 6e 65   built just fine
0090: 20 75 73 69 6e 67 20 74 68 65 20 64 65 66 61 75   using the defau
00a0: 6c 74 0a 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f  lt.compilation o
00b0: 70 74 69 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c  ptions. However,
00c0: 20 69 66 20 72 65 71 75 69 72 65 64 2c 20 74 68   if required, th
00d0: 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  e compile-time o
00e0: 70 74 69 6f 6e 73 0a 64 6f 63 75 6d 65 6e 74 65  ptions.documente
00f0: 64 20 62 65 6c 6f 77 20 63 61 6e 20 62 65 20 75  d below can be u
0100: 73 65 64 20 74 6f 20 0a 3c 61 20 68 72 65 66 3d  sed to .<a href=
0110: 22 23 6f 6d 69 74 66 65 61 74 75 72 65 73 22 3e  "#omitfeatures">
0120: 6f 6d 69 74 20 53 51 4c 69 74 65 20 66 65 61 74  omit SQLite feat
0130: 75 72 65 73 3c 2f 61 3e 20 28 72 65 73 75 6c 74  ures</a> (result
0140: 69 6e 67 20 69 6e 0a 61 20 73 6d 61 6c 6c 65 72  ing in.a smaller
0150: 20 63 6f 6d 70 69 6c 65 64 20 6c 69 62 72 61 72   compiled librar
0160: 79 20 73 69 7a 65 29 20 6f 72 20 74 6f 20 63 68  y size) or to ch
0170: 61 6e 67 65 20 74 68 65 0a 3c 61 20 68 72 65 66  ange the.<a href
0180: 3d 22 23 64 65 66 61 75 6c 74 73 22 3e 64 65 66  ="#defaults">def
0190: 61 75 6c 74 20 76 61 6c 75 65 73 3c 2f 61 3e 20  ault values</a> 
01a0: 6f 66 20 73 6f 6d 65 20 70 61 72 61 6d 65 74 65  of some paramete
01b0: 72 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 76  rs..</p>..<p>.Ev
01c0: 65 72 79 20 65 66 66 6f 72 74 20 68 61 73 20 62  ery effort has b
01d0: 65 65 6e 20 6d 61 64 65 20 74 6f 20 65 6e 73 75  een made to ensu
01e0: 72 65 20 74 68 61 74 20 74 68 65 20 76 61 72 69  re that the vari
01f0: 6f 75 73 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73  ous combinations
0200: 0a 6f 66 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20  .of compilation 
0210: 6f 70 74 69 6f 6e 73 20 77 6f 72 6b 20 68 61 72  options work har
0220: 6d 6f 6e 69 6f 75 73 6c 79 20 61 6e 64 20 70 72  moniously and pr
0230: 6f 64 75 63 65 20 61 20 77 6f 72 6b 69 6e 67 20  oduce a working 
0240: 6c 69 62 72 61 72 79 2e 0a 4e 65 76 65 72 74 68  library..Neverth
0250: 65 6c 65 73 73 2c 20 69 74 20 69 73 20 73 74 72  eless, it is str
0260: 6f 6e 67 6c 79 20 72 65 63 6f 6d 6d 65 6e 64 65  ongly recommende
0270: 64 20 74 68 61 74 20 74 68 65 20 53 51 4c 69 74  d that the SQLit
0280: 65 20 74 65 73 74 2d 73 75 69 74 65 0a 62 65 20  e test-suite.be 
0290: 65 78 65 63 75 74 65 64 20 74 6f 20 63 68 65 63  executed to chec
02a0: 6b 20 66 6f 72 20 65 72 72 6f 72 73 20 62 65 66  k for errors bef
02b0: 6f 72 65 20 75 73 69 6e 67 20 61 6e 20 53 51 4c  ore using an SQL
02c0: 69 74 65 20 6c 69 62 72 61 72 79 20 62 75 69 6c  ite library buil
02d0: 74 0a 77 69 74 68 20 6e 6f 6e 2d 73 74 61 6e 64  t.with non-stand
02e0: 61 72 64 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20  ard compilation 
02f0: 6f 70 74 69 6f 6e 73 2e 0a 3c 2f 70 3e 0a 3c 61  options..</p>.<a
0300: 20 6e 61 6d 65 3d 22 64 65 66 61 75 6c 74 73 22   name="defaults"
0310: 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 31 20 4f 70  ></a>.<h2>1.1 Op
0320: 74 69 6f 6e 73 20 54 6f 20 53 65 74 20 44 65 66  tions To Set Def
0330: 61 75 6c 74 20 50 61 72 61 6d 65 74 65 72 20 56  ault Parameter V
0340: 61 6c 75 65 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c  alues</h2>..<tcl
0350: 3e 0a 70 72 6f 63 20 43 4f 4d 50 49 4c 45 5f 4f  >.proc COMPILE_O
0360: 50 54 49 4f 4e 20 7b 6e 61 6d 65 20 74 65 78 74  PTION {name text
0370: 7d 20 7b 0a 20 20 69 66 20 7b 5b 72 65 67 65 78  } {.  if {[regex
0380: 70 20 7b 53 51 4c 49 54 45 5f 28 5b 41 2d 5a 30  p {SQLITE_([A-Z0
0390: 2d 39 5f 5d 2b 29 7d 20 24 6e 61 6d 65 20 61 6c  -9_]+)} $name al
03a0: 6c 20 6c 61 62 65 6c 5d 7d 20 7b 0a 20 20 20 20  l label]} {.    
03b0: 68 64 5f 66 72 61 67 6d 65 6e 74 20 5b 73 74 72  hd_fragment [str
03c0: 69 6e 67 20 74 6f 6c 6f 77 65 72 20 24 6c 61 62  ing tolower $lab
03d0: 65 6c 5d 0a 20 20 20 20 68 64 5f 6b 65 79 77 6f  el].    hd_keywo
03e0: 72 64 73 20 24 61 6c 6c 0a 20 20 7d 0a 20 20 68  rds $all.  }.  h
03f0: 64 5f 70 75 74 73 20 3c 70 3e 3c 62 3e 24 6e 61  d_puts <p><b>$na
0400: 6d 65 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 72 65 67  me</b></p>.  reg
0410: 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 5c 5c 73 2a  sub -all "\n\\s*
0420: 5c 6e 22 20 24 74 65 78 74 20 22 3c 2f 70 3e 5c  \n" $text "</p>\
0430: 6e 5c 6e 3c 70 3e 22 20 74 65 78 74 0a 20 20 68  n\n<p>" text.  h
0440: 64 5f 72 65 73 6f 6c 76 65 20 3c 62 6c 6f 63 6b  d_resolve <block
0450: 71 75 6f 74 65 3e 3c 70 3e 24 74 65 78 74 3c 2f  quote><p>$text</
0460: 70 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  p></blockquote>.
0470: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
0480: 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41 55 4c  N {SQLITE_DEFAUL
0490: 54 5f 41 55 54 4f 56 41 43 55 55 4d 3d 3c 69 3e  T_AUTOVACUUM=<i>
04a0: 26 6c 74 3b 31 20 6f 72 20 30 26 67 74 3b 3c 2f  &lt;1 or 0&gt;</
04b0: 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63  i>} {.  This mac
04c0: 72 6f 20 64 65 74 65 72 6d 69 6e 65 73 20 69 66  ro determines if
04d0: 20 53 51 4c 69 74 65 20 63 72 65 61 74 65 73 20   SQLite creates 
04e0: 64 61 74 61 62 61 73 65 73 20 77 69 74 68 20 74  databases with t
04f0: 68 65 20 0a 20 20 5b 61 75 74 6f 5f 76 61 63 75  he .  [auto_vacu
0500: 75 6d 5d 20 66 6c 61 67 20 73 65 74 20 62 79 20  um] flag set by 
0510: 64 65 66 61 75 6c 74 2e 20 54 68 65 20 64 65 66  default. The def
0520: 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 30 20  ault value is 0 
0530: 0a 20 20 28 64 6f 20 6e 6f 74 20 63 72 65 61 74  .  (do not creat
0540: 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 61  e auto-vacuum da
0550: 74 61 62 61 73 65 73 29 2e 20 49 6e 20 61 6e 79  tabases). In any
0560: 20 63 61 73 65 20 74 68 65 0a 20 20 63 6f 6d 70   case the.  comp
0570: 69 6c 65 2d 74 69 6d 65 20 64 65 66 61 75 6c 74  ile-time default
0580: 20 6d 61 79 20 62 65 20 6f 76 65 72 72 69 64 64   may be overridd
0590: 65 6e 20 62 79 20 74 68 65 20 0a 20 20 5b 50 52  en by the .  [PR
05a0: 41 47 4d 41 20 61 75 74 6f 5f 76 61 63 75 75 6d  AGMA auto_vacuum
05b0: 5d 20 63 6f 6d 6d 61 6e 64 2e 0a 7d 0a 0a 43 4f  ] command..}..CO
05c0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
05d0: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43  LITE_DEFAULT_CAC
05e0: 48 45 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b 70  HE_SIZE=<i>&lt;p
05f0: 61 67 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a  ages&gt;</i>} {.
0600: 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73 65 74    This macro set
0610: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 69  s the default si
0620: 7a 65 20 6f 66 20 74 68 65 20 70 61 67 65 2d 63  ze of the page-c
0630: 61 63 68 65 20 66 6f 72 20 65 61 63 68 20 61 74  ache for each at
0640: 74 61 63 68 65 64 0a 20 20 64 61 74 61 62 61 73  tached.  databas
0650: 65 2c 20 69 6e 20 70 61 67 65 73 2e 20 54 68 69  e, in pages. Thi
0660: 73 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64  s can be overrid
0670: 64 65 6e 20 62 79 20 74 68 65 20 0a 20 20 5b 50  den by the .  [P
0680: 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69 7a 65  RAGMA cache_size
0690: 5d 20 63 6f 6d 61 6d 6e 64 2e 20 54 68 65 20 64  ] comamnd. The d
06a0: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20  efault value is 
06b0: 32 30 30 30 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  2000..}..COMPILE
06c0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
06d0: 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52  DEFAULT_FILE_FOR
06e0: 4d 41 54 3d 3c 69 3e 26 6c 74 3b 31 20 6f 72 20  MAT=<i>&lt;1 or 
06f0: 34 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  4&gt;</i>} {.  T
0700: 68 65 20 64 65 66 61 75 6c 74 20 73 63 68 65 6d  he default schem
0710: 61 2d 6c 65 76 65 6c 20 66 69 6c 65 20 66 6f 72  a-level file for
0720: 6d 61 74 20 75 73 65 64 20 62 79 20 53 51 4c 69  mat used by SQLi
0730: 74 65 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67  te when creating
0740: 0a 20 20 6e 65 77 20 64 61 74 61 62 61 73 65 20  .  new database 
0750: 66 69 6c 65 73 20 69 73 20 73 65 74 20 62 79 20  files is set by 
0760: 74 68 69 73 20 6d 61 63 72 6f 2e 20 20 54 68 65  this macro.  The
0770: 20 66 69 6c 65 20 66 6f 72 6d 61 74 73 20 61 72   file formats ar
0780: 65 20 61 6c 6c 0a 20 20 76 65 72 79 20 73 69 6d  e all.  very sim
0790: 69 6c 61 72 2e 20 20 54 68 65 20 64 69 66 66 65  ilar.  The diffe
07a0: 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 66 6f  rence between fo
07b0: 72 6d 61 74 73 20 31 20 61 6e 64 20 34 20 69 73  rmats 1 and 4 is
07c0: 20 74 68 61 74 20 66 6f 72 6d 61 74 0a 20 20 34   that format.  4
07d0: 20 75 6e 64 65 72 73 74 61 6e 64 73 20 64 65 73   understands des
07e0: 63 65 6e 64 69 6e 67 20 69 6e 64 69 63 65 73 20  cending indices 
07f0: 61 6e 64 20 68 61 73 20 61 20 74 69 67 68 74 65  and has a tighte
0800: 72 20 65 6e 63 6f 64 69 6e 67 20 66 6f 72 0a 20  r encoding for. 
0810: 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 73 2e   boolean values.
0820: 0a 0a 20 20 53 51 4c 69 74 65 20 28 61 73 20 6f  ..  SQLite (as o
0830: 66 20 5b 76 65 72 73 69 6f 6e 20 33 2e 36 2e 30  f [version 3.6.0
0840: 5d 29 20 63 61 6e 20 72 65 61 64 20 61 6e 64 20  ]) can read and 
0850: 77 72 69 74 65 20 61 6e 79 20 66 69 6c 65 20 66  write any file f
0860: 6f 72 6d 61 74 0a 20 20 62 65 74 77 65 65 6e 20  ormat.  between 
0870: 31 20 61 6e 64 20 34 2e 20 20 42 75 74 20 6f 6c  1 and 4.  But ol
0880: 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  der versions of 
0890: 53 51 4c 69 74 65 20 6d 69 67 68 74 20 6e 6f 74  SQLite might not
08a0: 20 62 65 20 61 62 6c 65 20 74 6f 0a 20 20 72 65   be able to.  re
08b0: 61 64 20 66 6f 72 6d 61 74 73 20 67 72 65 61 74  ad formats great
08c0: 65 72 20 74 68 61 6e 20 31 2e 20 20 53 6f 20 74  er than 1.  So t
08d0: 68 61 74 20 6f 6c 64 65 72 20 76 65 72 73 69 6f  hat older versio
08e0: 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 77 69 6c  ns of SQLite wil
08f0: 6c 0a 20 20 62 65 20 61 62 6c 65 20 74 6f 20 72  l.  be able to r
0900: 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 64 61  ead and write da
0910: 74 61 62 61 73 65 20 66 69 6c 65 73 20 63 72 65  tabase files cre
0920: 61 74 65 64 20 62 79 20 6e 65 77 65 72 20 76 65  ated by newer ve
0930: 72 73 69 6f 6e 73 0a 20 20 6f 66 20 53 51 4c 69  rsions.  of SQLi
0940: 74 65 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20  te, the default 
0950: 66 69 6c 65 20 66 6f 72 6d 61 74 20 69 73 20 73  file format is s
0960: 65 74 20 74 6f 20 31 20 66 6f 72 20 6d 61 78 69  et to 1 for maxi
0970: 6d 75 6d 0a 20 20 63 6f 6d 70 61 74 61 62 69 6c  mum.  compatabil
0980: 69 74 79 2e 0a 0a 20 20 54 68 65 20 66 69 6c 65  ity...  The file
0990: 20 66 6f 72 6d 61 74 20 66 6f 72 20 61 20 6e 65   format for a ne
09a0: 77 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62  w database can b
09b0: 65 20 73 65 74 20 61 74 20 72 75 6e 74 69 6d 65  e set at runtime
09c0: 20 75 73 69 6e 67 0a 20 20 74 68 65 20 5b 50 52   using.  the [PR
09d0: 41 47 4d 41 20 6c 65 67 61 63 79 5f 66 69 6c 65  AGMA legacy_file
09e0: 5f 66 6f 72 6d 61 74 5d 20 63 6f 6d 6d 61 6e 64  _format] command
09f0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
0a00: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41  ION {SQLITE_DEFA
0a10: 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3d 3c 69  ULT_PAGE_SIZE=<i
0a20: 3e 26 6c 74 3b 62 79 74 65 73 26 67 74 3b 3c 2f  >&lt;bytes&gt;</
0a30: 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63  i>} {.  This mac
0a40: 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20 73 65  ro is used to se
0a50: 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 70 61  t the default pa
0a60: 67 65 2d 73 69 7a 65 20 75 73 65 64 20 77 68 65  ge-size used whe
0a70: 6e 20 61 0a 20 20 64 61 74 61 62 61 73 65 20 69  n a.  database i
0a80: 73 20 63 72 65 61 74 65 64 2e 20 54 68 65 20 76  s created. The v
0a90: 61 6c 75 65 20 61 73 73 69 67 6e 65 64 20 6d 75  alue assigned mu
0aa0: 73 74 20 62 65 20 61 20 70 6f 77 65 72 20 6f 66  st be a power of
0ab0: 20 32 2e 20 54 68 65 0a 20 20 64 65 66 61 75 6c   2. The.  defaul
0ac0: 74 20 76 61 6c 75 65 20 69 73 20 31 30 32 34 2e  t value is 1024.
0ad0: 20 54 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d   The compile-tim
0ae0: 65 20 64 65 66 61 75 6c 74 20 6d 61 79 20 62 65  e default may be
0af0: 20 6f 76 65 72 72 69 64 64 65 6e 20 61 74 20 0a   overridden at .
0b00: 20 20 72 75 6e 74 69 6d 65 20 62 79 20 74 68 65    runtime by the
0b10: 20 5b 50 52 41 47 4d 41 20 70 61 67 65 5f 73 69   [PRAGMA page_si
0b20: 7a 65 5d 20 63 6f 6d 6d 61 6e 64 2e 0a 7d 0a 0a  ze] command..}..
0b30: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
0b40: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 54  SQLITE_DEFAULT_T
0b50: 45 4d 50 5f 43 41 43 48 45 5f 53 49 5a 45 3d 3c  EMP_CACHE_SIZE=<
0b60: 69 3e 26 6c 74 3b 70 61 67 65 73 26 67 74 3b 3c  i>&lt;pages&gt;<
0b70: 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61  /i>} {.  This ma
0b80: 63 72 6f 20 73 65 74 73 20 74 68 65 20 64 65 66  cro sets the def
0b90: 61 75 6c 74 20 73 69 7a 65 20 6f 66 20 74 68 65  ault size of the
0ba0: 20 70 61 67 65 2d 63 61 63 68 65 20 66 6f 72 20   page-cache for 
0bb0: 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 0a  temporary files.
0bc0: 20 20 63 72 65 61 74 65 64 20 62 79 20 53 51 4c    created by SQL
0bd0: 69 74 65 20 74 6f 20 73 74 6f 72 65 20 69 6e 74  ite to store int
0be0: 65 72 6d 65 64 69 61 74 65 20 72 65 73 75 6c 74  ermediate result
0bf0: 73 2c 20 69 6e 20 70 61 67 65 73 2e 20 49 74 20  s, in pages. It 
0c00: 64 6f 65 73 0a 20 20 6e 6f 74 20 61 66 66 65 63  does.  not affec
0c10: 74 20 74 68 65 20 70 61 67 65 2d 63 61 63 68 65  t the page-cache
0c20: 20 66 6f 72 20 74 68 65 20 74 65 6d 70 20 64 61   for the temp da
0c30: 74 61 62 61 73 65 2c 20 77 68 65 72 65 20 74 61  tabase, where ta
0c40: 62 6c 65 73 20 63 72 65 61 74 65 64 0a 20 20 75  bles created.  u
0c50: 73 69 6e 67 20 5b 43 52 45 41 54 45 20 54 41 42  sing [CREATE TAB
0c60: 4c 45 20 7c 20 43 52 45 41 54 45 20 54 45 4d 50  LE | CREATE TEMP
0c70: 20 54 41 42 4c 45 5d 20 61 72 65 20 73 74 6f 72   TABLE] are stor
0c80: 65 64 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20  ed. The default 
0c90: 76 61 6c 75 65 0a 20 20 69 73 20 35 30 30 2e 0a  value.  is 500..
0ca0: 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 68 32 3e 31 2e  }.</tcl>..<h2>1.
0cb0: 32 20 4f 70 74 69 6f 6e 73 20 54 6f 20 53 65 74  2 Options To Set
0cc0: 20 53 69 7a 65 20 4c 69 6d 69 74 73 3c 2f 68 32   Size Limits</h2
0cd0: 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72 65 20  >..<p>There are 
0ce0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74  compile-time opt
0cf0: 69 6f 6e 73 20 74 68 61 74 20 77 69 6c 6c 20 73  ions that will s
0d00: 65 74 20 75 70 70 65 72 20 62 6f 75 6e 64 73 0a  et upper bounds.
0d10: 6f 6e 20 74 68 65 20 73 69 7a 65 73 20 6f 66 20  on the sizes of 
0d20: 76 61 72 69 6f 75 73 20 73 74 72 75 63 74 75 72  various structur
0d30: 65 73 20 69 6e 20 53 51 4c 69 74 65 2e 20 20 54  es in SQLite.  T
0d40: 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 0a  he compile-time.
0d50: 6f 70 74 69 6f 6e 73 20 6e 6f 72 6d 61 6c 6c 79  options normally
0d60: 20 73 65 74 20 61 20 68 61 72 64 20 75 70 70 65   set a hard uppe
0d70: 72 20 62 6f 75 6e 64 20 77 68 69 63 68 20 63 61  r bound which ca
0d80: 6e 20 62 65 20 63 68 61 6e 67 65 64 0a 61 74 20  n be changed.at 
0d90: 72 75 6e 2d 74 69 6d 65 20 6f 6e 20 69 6e 64 69  run-time on indi
0da0: 76 69 64 75 61 6c 20 5b 64 61 74 61 62 61 73 65  vidual [database
0db0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 5d 20 75 73   connections] us
0dc0: 69 6e 67 20 74 68 65 0a 5b 73 71 6c 69 74 65 33  ing the.[sqlite3
0dd0: 5f 6c 69 6d 69 74 28 29 5d 20 69 6e 74 65 72 66  _limit()] interf
0de0: 61 63 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ace.</p>..<p>The
0df0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70   compile-time op
0e00: 74 69 6f 6e 73 20 66 6f 72 20 73 65 74 74 69 6e  tions for settin
0e10: 67 20 75 70 70 65 72 20 62 6f 75 6e 64 73 20 61  g upper bounds a
0e20: 72 65 0a 5b 6c 69 6d 69 74 73 20 7c 20 64 6f 63  re.[limits | doc
0e30: 75 6d 65 6e 74 65 64 20 73 65 70 61 72 61 74 65  umented separate
0e40: 6c 79 5d 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77  ly].  The follow
0e50: 69 6e 67 20 69 73 20 61 20 6c 69 73 74 20 6f 66  ing is a list of
0e60: 0a 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 73  .the available s
0e70: 65 74 74 69 6e 67 73 3a 3c 2f 70 3e 0a 0a 3c 75  ettings:</p>..<u
0e80: 6c 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  l>.<li> [SQLITE_
0e90: 4d 41 58 5f 41 54 54 41 43 48 45 44 5d 20 20 3c  MAX_ATTACHED]  <
0ea0: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
0eb0: 45 5f 4d 41 58 5f 43 4f 4c 55 4d 4e 5d 20 20 3c  E_MAX_COLUMN]  <
0ec0: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
0ed0: 45 5f 4d 41 58 5f 43 4f 4d 50 4f 55 4e 44 5f 53  E_MAX_COMPOUND_S
0ee0: 45 4c 45 43 54 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c  ELECT]  </li>.<l
0ef0: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 45  i> [SQLITE_MAX_E
0f00: 58 50 52 5f 44 45 50 54 48 5d 20 20 3c 2f 6c 69  XPR_DEPTH]  </li
0f10: 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d  >.<li> [SQLITE_M
0f20: 41 58 5f 46 55 4e 43 54 49 4f 4e 5f 41 52 47 5d  AX_FUNCTION_ARG]
0f30: 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51    </li>.<li> [SQ
0f40: 4c 49 54 45 5f 4d 41 58 5f 4c 45 4e 47 54 48 5d  LITE_MAX_LENGTH]
0f50: 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51    </li>.<li> [SQ
0f60: 4c 49 54 45 5f 4d 41 58 5f 4c 49 4b 45 5f 50 41  LITE_MAX_LIKE_PA
0f70: 54 54 45 52 4e 5f 4c 45 4e 47 54 48 5d 20 20 3c  TTERN_LENGTH]  <
0f80: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54  /li>.<li> [SQLIT
0f90: 45 5f 4d 41 58 5f 50 41 47 45 5f 43 4f 55 4e 54  E_MAX_PAGE_COUNT
0fa0: 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53  ]  </li>.<li> [S
0fb0: 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53  QLITE_MAX_PAGE_S
0fc0: 49 5a 45 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e  IZE]  </li>.<li>
0fd0: 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 53 51 4c   [SQLITE_MAX_SQL
0fe0: 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a  _LENGTH]  </li>.
0ff0: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
1000: 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52  _VARIABLE_NUMBER
1010: 5d 20 20 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a  ]  </li>.</ul>..
1020: 3c 61 20 6e 61 6d 65 3d 22 63 6f 6e 74 72 6f 6c  <a name="control
1030: 66 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c  features"></a>.<
1040: 68 32 3e 31 2e 33 20 4f 70 74 69 6f 6e 73 20 54  h2>1.3 Options T
1050: 6f 20 43 6f 6e 74 72 6f 6c 20 4f 70 65 72 61 74  o Control Operat
1060: 69 6e 67 20 43 68 61 72 61 63 74 65 72 69 73 74  ing Characterist
1070: 69 63 73 3c 2f 68 32 3e 0a 0a 3c 74 63 6c 3e 0a  ics</h2>..<tcl>.
1080: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
1090: 53 51 4c 49 54 45 5f 53 45 43 55 52 45 5f 44 45  SQLITE_SECURE_DE
10a0: 4c 45 54 45 7d 20 7b 0a 20 20 54 68 69 73 20 63  LETE} {.  This c
10b0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69  ompile-time opti
10c0: 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65  on causes SQLite
10d0: 20 74 6f 20 6f 76 65 72 77 72 69 74 65 20 64 65   to overwrite de
10e0: 6c 65 74 65 64 0a 20 20 69 6e 66 6f 72 6d 61 74  leted.  informat
10f0: 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f 73 20 69  ion with zeros i
1100: 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 6d 61  n addition to ma
1110: 72 6b 69 6e 67 20 74 68 65 20 73 70 61 63 65 0a  rking the space.
1120: 20 20 61 73 20 61 76 61 69 6c 61 62 6c 65 20 66    as available f
1130: 6f 72 20 72 65 75 73 65 2e 20 20 57 69 74 68 6f  or reuse.  Witho
1140: 75 74 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20  ut this option, 
1150: 64 65 6c 65 74 65 64 20 64 61 74 61 0a 20 20 6d  deleted data.  m
1160: 69 67 68 74 20 62 65 20 72 65 63 6f 76 65 72 61  ight be recovera
1170: 62 6c 65 20 66 72 6f 6d 20 61 20 64 61 74 61 62  ble from a datab
1180: 61 73 65 20 75 73 69 6e 67 20 61 20 62 69 6e 61  ase using a bina
1190: 72 79 20 65 64 69 74 6f 72 2e 0a 20 20 48 6f 77  ry editor..  How
11a0: 65 76 65 72 2c 20 74 68 65 72 65 20 69 73 20 61  ever, there is a
11b0: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 70 65 6e   performance pen
11c0: 61 6c 74 79 20 66 6f 72 20 75 73 69 6e 67 20 74  alty for using t
11d0: 68 69 73 20 6f 70 74 69 6f 6e 2e 0a 0a 20 20 54  his option...  T
11e0: 68 69 73 20 6f 70 74 69 6f 6e 20 64 6f 65 73 20  his option does 
11f0: 3c 75 3e 6e 6f 74 3c 2f 75 3e 20 63 61 75 73 65  <u>not</u> cause
1200: 20 64 65 6c 65 74 65 64 20 64 61 74 61 20 69 73   deleted data is
1210: 20 73 65 63 75 72 65 6c 79 0a 20 20 72 65 6d 6f   securely.  remo
1220: 76 65 64 20 66 72 6f 6d 20 74 68 65 20 75 6e 64  ved from the und
1230: 65 72 6c 79 69 6e 67 20 73 74 6f 72 61 67 65 20  erlying storage 
1240: 6d 65 64 69 61 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  media..}..COMPIL
1250: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
1260: 5f 54 48 52 45 41 44 53 41 46 45 3d 3c 69 3e 26  _THREADSAFE=<i>&
1270: 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c 2f 69  lt;0 or 1&gt;</i
1280: 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69  >} {.  This opti
1290: 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65 74  on controls whet
12a0: 68 65 72 20 6f 72 20 6e 6f 74 20 63 6f 64 65 20  her or not code 
12b0: 69 73 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 53  is included in S
12c0: 51 4c 69 74 65 20 74 6f 0a 20 20 65 6e 61 62 6c  QLite to.  enabl
12d0: 65 20 69 74 20 74 6f 20 6f 70 65 72 61 74 65 20  e it to operate 
12e0: 73 61 66 65 6c 79 20 69 6e 20 61 20 6d 75 6c 74  safely in a mult
12f0: 69 74 68 72 65 61 64 65 64 20 65 6e 76 69 72 6f  ithreaded enviro
1300: 6e 6d 65 6e 74 2e 20 20 54 68 65 0a 20 20 64 65  nment.  The.  de
1310: 66 61 75 6c 74 20 69 73 20 53 51 4c 49 54 45 5f  fault is SQLITE_
1320: 54 48 52 45 41 44 53 41 46 45 3d 31 20 77 68 69  THREADSAFE=1 whi
1330: 63 68 20 69 73 20 73 61 66 65 20 66 6f 72 20 75  ch is safe for u
1340: 73 65 20 69 6e 20 61 20 6d 75 6c 74 69 74 68 72  se in a multithr
1350: 65 61 64 65 64 0a 20 20 65 6e 76 69 72 6f 6e 6d  eaded.  environm
1360: 65 6e 74 2e 20 20 57 68 65 6e 20 63 6f 6d 70 69  ent.  When compi
1370: 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f  led with SQLITE_
1380: 54 48 52 45 41 44 53 41 46 45 3d 30 20 61 6c 6c  THREADSAFE=0 all
1390: 20 6d 75 74 65 78 69 6e 67 20 63 6f 64 65 0a 20   mutexing code. 
13a0: 20 69 73 20 6f 6d 69 74 74 65 64 20 61 6e 64 20   is omitted and 
13b0: 69 74 20 69 73 20 75 6e 73 61 66 65 20 74 6f 20  it is unsafe to 
13c0: 75 73 65 20 53 51 4c 69 74 65 20 69 6e 20 61 20  use SQLite in a 
13d0: 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 70 72  multithreaded pr
13e0: 6f 67 72 61 6d 2e 0a 0a 20 20 54 68 65 20 76 61  ogram...  The va
13f0: 6c 75 65 20 6f 66 20 53 51 4c 49 54 45 5f 54 48  lue of SQLITE_TH
1400: 52 45 41 44 53 41 46 45 20 63 61 6e 20 62 65 20  READSAFE can be 
1410: 64 65 74 65 72 6d 69 6e 65 64 20 61 74 20 72 75  determined at ru
1420: 6e 2d 74 69 6d 65 0a 20 20 75 73 69 6e 67 20 74  n-time.  using t
1430: 68 65 20 5b 73 71 6c 69 74 65 33 5f 74 68 72 65  he [sqlite3_thre
1440: 61 64 73 61 66 65 28 29 5d 20 69 6e 74 65 72 66  adsafe()] interf
1450: 61 63 65 2e 0a 0a 20 20 57 68 65 6e 20 53 51 4c  ace...  When SQL
1460: 69 74 65 20 68 61 73 20 62 65 65 6e 20 63 6f 6d  ite has been com
1470: 70 69 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54  piled with SQLIT
1480: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 31 20 74  E_THREADSAFE=1 t
1490: 68 65 6e 20 6d 75 74 65 78 69 6e 67 0a 20 20 63  hen mutexing.  c
14a0: 61 6e 20 62 65 20 64 69 73 61 62 6c 65 64 20 61  an be disabled a
14b0: 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67  t run-time using
14c0: 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f   the [sqlite3_co
14d0: 6e 66 69 67 28 29 5d 20 69 6e 74 65 72 66 61 63  nfig()] interfac
14e0: 65 20 74 6f 67 65 74 68 65 72 0a 20 20 77 69 74  e together.  wit
14f0: 68 20 74 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f  h the [SQLITE_CO
1500: 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 45 41  NFIG_SINGLETHREA
1510: 44 5d 2c 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  D], [SQLITE_CONF
1520: 49 47 5f 4d 55 4c 54 49 54 48 52 45 41 44 5d 2c  IG_MULTITHREAD],
1530: 20 61 6e 64 0a 20 20 5b 53 51 4c 49 54 45 5f 43   and.  [SQLITE_C
1540: 4f 4e 46 49 47 5f 53 45 52 49 41 4c 49 5a 45 44  ONFIG_SERIALIZED
1550: 5d 20 76 65 72 62 73 2e 0a 7d 0a 0a 43 4f 4d 50  ] verbs..}..COMP
1560: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
1570: 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3c 69  TE_TEMP_STORE=<i
1580: 3e 26 6c 74 3b 30 20 74 68 72 6f 75 67 68 20 33  >&lt;0 through 3
1590: 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54 68  &gt;</i>} {.  Th
15a0: 69 73 20 6f 70 74 69 6f 6e 20 63 6f 6e 74 72 6f  is option contro
15b0: 6c 73 20 77 68 65 74 68 65 72 20 74 65 6d 70 6f  ls whether tempo
15c0: 72 61 72 79 20 66 69 6c 65 73 20 61 72 65 20 73  rary files are s
15d0: 74 6f 72 65 64 20 6f 6e 20 64 69 73 6b 20 6f 72  tored on disk or
15e0: 0a 20 20 69 6e 20 6d 65 6d 6f 72 79 2e 20 20 54  .  in memory.  T
15f0: 68 65 20 6d 65 61 6e 69 6e 67 73 20 66 6f 72 20  he meanings for 
1600: 76 61 72 69 6f 75 73 20 73 65 74 74 69 6e 67 73  various settings
1610: 20 6f 66 20 74 68 69 73 20 63 6f 6d 70 69 6c 65   of this compile
1620: 2d 74 69 6d 65 0a 20 20 6f 70 74 69 6f 6e 20 61  -time.  option a
1630: 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a  re as follows:..
1640: 20 20 3c 74 61 62 6c 65 20 63 65 6c 6c 70 61 64    <table cellpad
1650: 64 69 6e 67 3d 22 32 22 20 62 6f 72 64 65 72 3d  ding="2" border=
1660: 22 31 22 3e 0a 20 20 3c 74 72 3e 3c 74 68 3e 53  "1">.  <tr><th>S
1670: 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45  QLITE_TEMP_STORE
1680: 3c 2f 74 68 3e 3c 74 68 3e 4d 65 61 6e 69 6e 67  </th><th>Meaning
1690: 3c 2f 74 68 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72  </th></tr>.  <tr
16a0: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74  ><td align="cent
16b0: 65 72 22 3e 30 3c 2f 74 64 3e 3c 74 64 3e 41 6c  er">0</td><td>Al
16c0: 77 61 79 73 20 75 73 65 20 74 65 6d 70 6f 72 61  ways use tempora
16d0: 72 79 20 66 69 6c 65 73 3c 2f 74 64 3e 3c 2f 74  ry files</td></t
16e0: 72 3e 0a 20 20 3c 74 72 3e 3c 74 64 20 61 6c 69  r>.  <tr><td ali
16f0: 67 6e 3d 22 63 65 6e 74 65 72 22 3e 31 3c 2f 74  gn="center">1</t
1700: 64 3e 3c 74 64 3e 55 73 65 20 66 69 6c 65 73 20  d><td>Use files 
1710: 62 79 20 64 65 66 61 75 6c 74 20 62 75 74 20 61  by default but a
1720: 6c 6c 6f 77 20 74 68 65 0a 20 20 5b 50 52 41 47  llow the.  [PRAG
1730: 4d 41 20 74 65 6d 70 5f 73 74 6f 72 65 5d 20 63  MA temp_store] c
1740: 6f 6d 6d 61 6e 64 20 74 6f 20 6f 76 65 72 72 69  ommand to overri
1750: 64 65 3c 2f 74 64 3e 3c 2f 74 72 3e 0a 20 20 3c  de</td></tr>.  <
1760: 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65  tr><td align="ce
1770: 6e 74 65 72 22 3e 32 3c 2f 74 64 3e 3c 74 64 3e  nter">2</td><td>
1780: 55 73 65 20 6d 65 6d 6f 72 79 20 62 79 20 64 65  Use memory by de
1790: 66 61 75 6c 74 20 62 75 74 20 61 6c 6c 6f 77 20  fault but allow 
17a0: 74 68 65 0a 20 20 5b 50 52 41 47 4d 41 20 74 65  the.  [PRAGMA te
17b0: 6d 70 5f 73 74 6f 72 65 5d 20 63 6f 6d 6d 61 6e  mp_store] comman
17c0: 64 20 74 6f 20 6f 76 65 72 72 69 64 65 3c 2f 74  d to override</t
17d0: 64 3e 3c 2f 74 72 3e 0a 20 20 3c 74 72 3e 3c 74  d></tr>.  <tr><t
17e0: 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22  d align="center"
17f0: 3e 33 3c 2f 74 64 3e 3c 74 64 3e 41 6c 77 61 79  >3</td><td>Alway
1800: 73 20 75 73 65 20 6d 65 6d 6f 72 79 3c 2f 74 64  s use memory</td
1810: 3e 3c 2f 74 72 3e 0a 20 20 3c 2f 74 61 62 6c 65  ></tr>.  </table
1820: 3e 0a 0a 20 20 54 68 65 20 64 65 66 61 75 6c 74  >..  The default
1830: 20 73 65 74 74 69 6e 67 20 69 73 20 31 2e 20 20   setting is 1.  
1840: 0a 20 20 41 64 64 69 74 69 6f 6e 61 6c 20 69 6e  .  Additional in
1850: 66 6f 72 6d 61 74 69 6f 6e 20 63 61 6e 20 62 65  formation can be
1860: 20 66 6f 75 6e 64 20 69 6e 20 5b 74 65 6d 70 73   found in [temps
1870: 74 6f 72 65 20 7c 20 74 65 6d 70 66 69 6c 65 73  tore | tempfiles
1880: 2e 68 74 6d 6c 5d 2e 0a 7d 0a 3c 2f 74 63 6c 3e  .html]..}.</tcl>
1890: 0a 0a 3c 61 20 6e 61 6d 65 3d 22 65 6e 61 62 6c  ..<a name="enabl
18a0: 65 66 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a  efeatures"></a>.
18b0: 3c 68 32 3e 31 2e 34 20 4f 70 74 69 6f 6e 73 20  <h2>1.4 Options 
18c0: 54 6f 20 45 6e 61 62 6c 65 20 46 65 61 74 75 72  To Enable Featur
18d0: 65 73 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e  es Normally Turn
18e0: 65 64 20 4f 66 66 3c 2f 68 32 3e 0a 0a 3c 74 63  ed Off</h2>..<tc
18f0: 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  l>.COMPILE_OPTIO
1900: 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  N {SQLITE_ENABLE
1910: 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 7d 20 7b  _ATOMIC_WRITE} {
1920: 0a 20 20 49 66 20 74 68 69 73 20 43 2d 70 72 65  .  If this C-pre
1930: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 20  processor macro 
1940: 69 73 20 64 65 66 69 6e 65 64 20 61 6e 64 20 69  is defined and i
1950: 66 20 74 68 65 0a 20 20 78 44 65 76 69 63 65 43  f the.  xDeviceC
1960: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 20 6d  haracteristics m
1970: 65 74 68 6f 64 20 6f 66 20 5b 73 71 6c 69 74 65  ethod of [sqlite
1980: 33 5f 69 6f 5f 6d 65 74 68 6f 64 73 5d 20 6f 62  3_io_methods] ob
1990: 6a 65 63 74 20 66 6f 72 0a 20 20 61 20 64 61 74  ject for.  a dat
19a0: 61 62 61 73 65 20 66 69 6c 65 20 72 65 70 6f 72  abase file repor
19b0: 74 73 20 28 76 69 61 20 6f 6e 65 20 6f 66 20 74  ts (via one of t
19c0: 68 65 20 5b 53 51 4c 49 54 45 5f 49 4f 43 41 50  he [SQLITE_IOCAP
19d0: 5f 41 54 4f 4d 49 43 5d 20 62 69 74 73 29 0a 20  _ATOMIC] bits). 
19e0: 20 74 68 61 74 20 74 68 65 20 66 69 6c 65 73 79   that the filesy
19f0: 73 74 65 6d 20 73 75 70 70 6f 72 74 73 20 61 74  stem supports at
1a00: 6f 6d 69 63 20 77 72 69 74 65 73 20 61 6e 64 20  omic writes and 
1a10: 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e  if a transaction
1a20: 0a 20 20 69 6e 76 6f 6c 76 65 73 20 61 20 63 68  .  involves a ch
1a30: 61 6e 67 65 20 74 6f 20 6f 6e 6c 79 20 61 20 73  ange to only a s
1a40: 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74 68  ingle page of th
1a50: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c  e database file,
1a60: 0a 20 20 74 68 65 6e 20 74 68 65 20 74 72 61 6e  .  then the tran
1a70: 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 74 73 20  saction commits 
1a80: 77 69 74 68 20 6a 75 73 74 20 61 20 73 69 6e 67  with just a sing
1a90: 6c 65 20 77 72 69 74 65 20 72 65 71 75 65 73 74  le write request
1aa0: 20 6f 66 0a 20 20 61 20 73 69 6e 67 6c 65 20 70   of.  a single p
1ab0: 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  age of the datab
1ac0: 61 73 65 20 61 6e 64 20 6e 6f 20 72 6f 6c 6c 62  ase and no rollb
1ad0: 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 69 73 20 63  ack journal is c
1ae0: 72 65 61 74 65 64 0a 20 20 6f 72 20 77 72 69 74  reated.  or writ
1af0: 74 65 6e 2e 20 20 4f 6e 20 66 69 6c 65 73 79 73  ten.  On filesys
1b00: 74 65 6d 73 20 74 68 61 74 20 73 75 70 70 6f 72  tems that suppor
1b10: 74 20 61 74 6f 6d 69 63 20 77 72 69 74 65 73 2c  t atomic writes,
1b20: 20 74 68 69 73 0a 20 20 6f 70 74 69 6d 69 7a 61   this.  optimiza
1b30: 74 69 6f 6e 20 63 61 6e 20 72 65 73 75 6c 74 20  tion can result 
1b40: 69 6e 20 73 69 67 6e 69 66 69 63 61 6e 74 20 73  in significant s
1b50: 70 65 65 64 20 69 6d 70 72 6f 76 65 6d 65 6e 74  peed improvement
1b60: 73 20 66 6f 72 0a 20 20 73 6d 61 6c 6c 20 75 70  s for.  small up
1b70: 64 61 74 65 73 2e 20 20 48 6f 77 65 76 65 72 2c  dates.  However,
1b80: 20 66 65 77 20 66 69 6c 65 73 79 73 74 65 6d 73   few filesystems
1b90: 20 73 75 70 70 6f 72 74 20 74 68 69 73 20 63 61   support this ca
1ba0: 70 61 62 69 6c 69 74 79 0a 20 20 61 6e 64 20 74  pability.  and t
1bb0: 68 65 20 63 6f 64 65 20 70 61 74 68 73 20 74 68  he code paths th
1bc0: 61 74 20 63 68 65 63 6b 20 66 6f 72 20 74 68 69  at check for thi
1bd0: 73 20 63 61 70 61 62 69 6c 69 74 79 20 73 6c 6f  s capability slo
1be0: 77 20 64 6f 77 6e 20 77 72 69 74 65 0a 20 20 70  w down write.  p
1bf0: 65 72 66 6f 72 6d 61 6e 63 65 20 6f 6e 20 73 79  erformance on sy
1c00: 73 74 65 6d 73 20 74 68 61 74 20 6c 61 63 6b 20  stems that lack 
1c10: 61 74 6f 6d 69 63 20 77 72 69 74 65 20 63 61 70  atomic write cap
1c20: 61 62 69 6c 69 74 79 2c 20 73 6f 20 74 68 69 73  ability, so this
1c30: 0a 20 20 66 65 61 74 75 72 65 20 69 73 20 64 69  .  feature is di
1c40: 73 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c  sabled by defaul
1c50: 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  t..}..COMPILE_OP
1c60: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41  TION {SQLITE_ENA
1c70: 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44  BLE_COLUMN_METAD
1c80: 41 54 41 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68  ATA} {.  When th
1c90: 69 73 20 43 2d 70 72 65 70 72 6f 63 65 73 73 6f  is C-preprocesso
1ca0: 72 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e  r macro is defin
1cb0: 65 64 2c 20 53 51 4c 69 74 65 20 69 6e 63 6c 75  ed, SQLite inclu
1cc0: 64 65 73 20 73 6f 6d 65 0a 20 20 61 64 64 69 74  des some.  addit
1cd0: 69 6f 6e 61 6c 20 41 50 49 73 20 74 68 61 74 20  ional APIs that 
1ce0: 70 72 6f 76 69 64 65 20 63 6f 6e 76 65 6e 69 65  provide convenie
1cf0: 6e 74 20 61 63 63 65 73 73 20 74 6f 20 6d 65 74  nt access to met
1d00: 61 2d 64 61 74 61 20 61 62 6f 75 74 0a 20 20 74  a-data about.  t
1d10: 61 62 6c 65 73 20 61 6e 64 20 71 75 65 72 69 65  ables and querie
1d20: 73 2e 20 20 54 68 65 20 41 50 49 73 20 74 68 61  s.  The APIs tha
1d30: 74 20 61 72 65 20 65 6e 61 62 6c 65 64 20 62 79  t are enabled by
1d40: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 61 72 65   this option are
1d50: 3a 0a 0a 20 20 3c 75 6c 3e 0a 20 20 3c 6c 69 3e  :..  <ul>.  <li>
1d60: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
1d70: 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 28 29  _database_name()
1d80: 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b  ] </li>.  <li> [
1d90: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
1da0: 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 36 28 29  atabase_name16()
1db0: 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e 20 5b  ] </li>.  <li> [
1dc0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74  sqlite3_column_t
1dd0: 61 62 6c 65 5f 6e 61 6d 65 28 29 5d 20 3c 2f 6c  able_name()] </l
1de0: 69 3e 0a 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74  i>.  <li> [sqlit
1df0: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f  e3_column_table_
1e00: 6e 61 6d 65 31 36 28 29 5d 20 3c 2f 6c 69 3e 0a  name16()] </li>.
1e10: 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 5f    <li> [sqlite3_
1e20: 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61  column_origin_na
1e30: 6d 65 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c  me()] </li>.  <l
1e40: 69 3e 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75  i> [sqlite3_colu
1e50: 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31 36  mn_origin_name16
1e60: 28 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 6c 69 3e  ()] </li>.  <li>
1e70: 20 5b 73 71 6c 69 74 65 33 5f 74 61 62 6c 65 5f   [sqlite3_table_
1e80: 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74 61 28  column_metadata(
1e90: 29 5d 20 3c 2f 6c 69 3e 0a 20 20 3c 2f 75 6c 3e  )] </li>.  </ul>
1ea0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
1eb0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ON {SQLITE_ENABL
1ec0: 45 5f 46 54 53 33 7d 20 7b 0a 20 20 57 68 65 6e  E_FTS3} {.  When
1ed0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
1ee0: 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 5b  defined in the [
1ef0: 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 2c 20 76  amalgamation], v
1f00: 65 72 73 69 6f 6e 20 33 0a 20 20 6f 66 20 74 68  ersion 3.  of th
1f10: 65 20 66 75 6c 6c 2d 74 65 78 74 20 73 65 61 72  e full-text sear
1f20: 63 68 20 65 6e 67 69 6e 65 20 69 73 20 61 64 64  ch engine is add
1f30: 65 64 20 74 6f 20 74 68 65 20 62 75 69 6c 64 20  ed to the build 
1f40: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 7d  automatically..}
1f50: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
1f60: 20 7b 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f   {SQLITE_ENABLE_
1f70: 49 43 55 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ICU} {.  This op
1f80: 74 69 6f 6e 20 63 61 75 73 65 73 20 74 68 65 20  tion causes the 
1f90: 0a 20 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70  .  <a href="http
1fa0: 3a 2f 2f 77 77 77 2e 69 63 75 2d 70 72 6f 6a 65  ://www.icu-proje
1fb0: 63 74 2e 6f 72 67 2f 22 3e 49 6e 74 65 72 6e 61  ct.org/">Interna
1fc0: 74 69 6f 6e 61 6c 20 43 6f 6d 70 6f 6e 65 6e 74  tional Component
1fd0: 73 20 66 6f 72 20 55 6e 69 63 6f 64 65 3c 2f 61  s for Unicode</a
1fe0: 3e 0a 20 20 6f 72 20 22 49 43 55 22 20 65 78 74  >.  or "ICU" ext
1ff0: 65 6e 73 69 6f 6e 20 74 6f 20 53 51 4c 69 74 65  ension to SQLite
2000: 20 74 6f 20 62 65 20 61 64 64 65 64 20 74 6f 20   to be added to 
2010: 74 68 65 20 62 75 69 6c 64 2e 20 20 0a 7d 0a 0a  the build.  .}..
2020: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
2030: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f  SQLITE_ENABLE_IO
2040: 54 52 41 43 45 7d 20 7b 0a 20 20 57 68 65 6e 20  TRACE} {.  When 
2050: 62 6f 74 68 20 74 68 65 20 53 51 4c 69 74 65 20  both the SQLite 
2060: 63 6f 72 65 20 61 6e 64 20 74 68 65 20 5b 43 6f  core and the [Co
2070: 6d 6d 61 6e 64 20 4c 69 6e 65 20 49 6e 74 65 72  mmand Line Inter
2080: 66 61 63 65 5d 20 28 43 4c 49 29 20 61 72 65 20  face] (CLI) are 
2090: 62 6f 74 68 20 0a 20 20 63 6f 6d 70 69 6c 65 64  both .  compiled
20a0: 20 77 69 74 68 20 74 68 69 73 20 6f 70 74 69 6f   with this optio
20b0: 6e 2c 20 74 68 65 6e 20 74 68 65 20 43 4c 49 20  n, then the CLI 
20c0: 70 72 6f 76 69 64 65 73 20 61 6e 20 65 78 74 72  provides an extr
20d0: 61 20 63 6f 6d 6d 61 6e 64 0a 20 20 6e 61 6d 65  a command.  name
20e0: 64 20 22 2e 69 6f 74 72 61 63 65 22 20 74 68 61  d ".iotrace" tha
20f0: 74 20 70 72 6f 76 69 64 65 73 20 61 20 6c 6f 77  t provides a low
2100: 2d 6c 65 76 65 6c 20 6c 6f 67 20 6f 66 20 49 2f  -level log of I/
2110: 4f 20 61 63 74 69 76 69 74 79 2e 0a 20 20 54 68  O activity..  Th
2120: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 65 78 70  is option is exp
2130: 65 72 69 6d 65 6e 74 61 6c 20 61 6e 64 20 6d 61  erimental and ma
2140: 79 20 62 65 20 64 69 73 63 6f 6e 74 69 6e 75 65  y be discontinue
2150: 64 20 69 6e 20 61 20 66 75 74 75 72 65 20 72 65  d in a future re
2160: 6c 65 61 73 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  lease..}..COMPIL
2170: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
2180: 5f 45 4e 41 42 4c 45 5f 4c 4f 43 4b 49 4e 47 5f  _ENABLE_LOCKING_
2190: 53 54 59 4c 45 7d 20 7b 0a 20 20 54 68 69 73 20  STYLE} {.  This 
21a0: 6f 70 74 69 6f 6e 20 65 6e 61 62 6c 65 73 20 61  option enables a
21b0: 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69 63 20  dditional logic 
21c0: 69 6e 20 74 68 65 20 4f 53 20 69 6e 74 65 72 66  in the OS interf
21d0: 61 63 65 20 6c 61 79 65 72 20 66 6f 72 0a 20 20  ace layer for.  
21e0: 4d 61 63 20 4f 53 20 58 2e 20 20 54 68 65 20 61  Mac OS X.  The a
21f0: 64 64 69 74 69 6f 6e 61 6c 20 6c 6f 67 69 63 20  dditional logic 
2200: 61 74 74 65 6d 70 74 73 20 74 6f 20 64 65 74 65  attempts to dete
2210: 72 6d 69 6e 65 20 74 68 65 20 74 79 70 65 20 6f  rmine the type o
2220: 66 20 74 68 65 0a 20 20 75 6e 64 65 72 6c 79 69  f the.  underlyi
2230: 6e 67 20 66 69 6c 65 73 79 73 74 65 6d 20 61 6e  ng filesystem an
2240: 64 20 63 68 6f 6f 73 65 20 61 6e 64 20 61 6c 74  d choose and alt
2250: 65 72 6e 61 74 69 76 65 20 6c 6f 63 6b 69 6e 67  ernative locking
2260: 20 73 74 72 61 74 65 67 79 0a 20 20 74 68 61 74   strategy.  that
2270: 20 77 6f 72 6b 73 20 63 6f 72 72 65 63 74 6c 79   works correctly
2280: 20 66 6f 72 20 74 68 61 74 20 66 69 6c 65 73 79   for that filesy
2290: 73 74 65 6d 20 74 79 70 65 2e 0a 7d 0a 0a 43 4f  stem type..}..CO
22a0: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
22b0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
22c0: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 7d 20 7b  RY_MANAGEMENT} {
22d0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 61  .  This option a
22e0: 64 64 73 20 65 78 74 72 61 20 6c 6f 67 69 63 20  dds extra logic 
22f0: 74 6f 20 53 51 4c 69 74 65 20 74 68 61 74 20 61  to SQLite that a
2300: 6c 6c 6f 77 73 20 69 74 20 74 6f 20 72 65 6c 65  llows it to rele
2310: 61 73 65 20 75 6e 75 73 65 64 0a 20 20 6d 65 6d  ase unused.  mem
2320: 6f 72 79 20 75 70 6f 6e 20 72 65 71 75 65 73 74  ory upon request
2330: 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6d  .  This option m
2340: 75 73 74 20 62 65 20 65 6e 61 62 6c 65 64 20 69  ust be enabled i
2350: 6e 20 6f 72 64 65 72 20 66 6f 72 20 74 68 65 0a  n order for the.
2360: 20 20 5b 73 71 6c 69 74 65 33 5f 72 65 6c 65 61    [sqlite3_relea
2370: 73 65 5f 6d 65 6d 6f 72 79 28 29 5d 20 69 6e 74  se_memory()] int
2380: 65 72 66 61 63 65 20 74 6f 20 77 6f 72 6b 2e 20  erface to work. 
2390: 20 49 66 20 74 68 69 73 20 63 6f 6d 70 69 6c 65   If this compile
23a0: 2d 74 69 6d 65 0a 20 20 6f 70 74 69 6f 6e 20 69  -time.  option i
23b0: 73 20 6e 6f 74 20 75 73 65 64 2c 20 74 68 65 20  s not used, the 
23c0: 5b 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65  [sqlite3_release
23d0: 5f 6d 65 6d 6f 72 79 28 29 5d 20 69 6e 74 65 72  _memory()] inter
23e0: 66 61 63 65 20 69 73 20 61 20 0a 20 20 6e 6f 2d  face is a .  no-
23f0: 6f 70 2e 20 20 53 69 6e 63 65 20 5b 73 71 6c 69  op.  Since [sqli
2400: 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f 6c 69  te3_soft_heap_li
2410: 6d 69 74 28 29 5d 20 64 65 70 65 6e 64 73 20 6f  mit()] depends o
2420: 6e 0a 20 20 5b 73 71 6c 69 74 65 33 5f 72 65 6c  n.  [sqlite3_rel
2430: 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 5d 2c 20  ease_memory()], 
2440: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 61  this option is a
2450: 6c 73 6f 20 6e 65 63 65 73 73 61 72 79 20 66 6f  lso necessary fo
2460: 72 0a 20 20 74 68 65 20 63 6f 72 72 65 63 74 20  r.  the correct 
2470: 6f 70 65 72 61 74 69 6f 6e 20 6f 66 20 5b 73 71  operation of [sq
2480: 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f  lite3_soft_heap_
2490: 6c 69 6d 69 74 28 29 5d 2e 0a 7d 0a 0a 43 4f 4d  limit()]..}..COM
24a0: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
24b0: 49 54 45 5f 45 4e 41 42 4c 45 5f 52 54 52 45 45  ITE_ENABLE_RTREE
24c0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
24d0: 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74 65 20  n causes SQLite 
24e0: 74 6f 20 69 6e 63 6c 75 64 65 20 73 75 70 70 6f  to include suppo
24f0: 72 74 20 66 6f 72 20 74 68 65 20 52 2a 54 72 65  rt for the R*Tre
2500: 65 20 69 6e 64 65 78 0a 20 20 65 78 74 65 6e 73  e index.  extens
2510: 69 6f 6e 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c  ion..}.</tcl>..<
2520: 61 20 6e 61 6d 65 3d 22 6f 6d 69 74 66 65 61 74  a name="omitfeat
2530: 75 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31  ures"></a>.<h2>1
2540: 2e 35 20 4f 70 74 69 6f 6e 73 20 54 6f 20 4f 6d  .5 Options To Om
2550: 69 74 20 46 65 61 74 75 72 65 73 3c 2f 68 32 3e  it Features</h2>
2560: 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 69  ..<p>The followi
2570: 6e 67 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 75  ng options can u
2580: 73 65 64 20 74 6f 20 72 65 64 75 63 65 20 74 68  sed to reduce th
2590: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 63 6f  e size of the co
25a0: 6d 70 69 6c 65 64 0a 6c 69 62 72 61 72 79 20 62  mpiled.library b
25b0: 79 20 6f 6d 69 74 74 69 6e 67 20 6f 70 74 69 6f  y omitting optio
25c0: 6e 61 6c 20 66 65 61 74 75 72 65 73 2e 20 54 68  nal features. Th
25d0: 69 73 20 69 73 20 70 72 6f 62 61 62 6c 79 20 6f  is is probably o
25e0: 6e 6c 79 20 75 73 65 66 75 6c 0a 69 6e 20 65 6d  nly useful.in em
25f0: 62 65 64 64 65 64 20 73 79 73 74 65 6d 73 20 77  bedded systems w
2600: 68 65 72 65 20 73 70 61 63 65 20 69 73 20 65 73  here space is es
2610: 70 65 63 69 61 6c 6c 79 20 74 69 67 68 74 2c 20  pecially tight, 
2620: 61 73 20 65 76 65 6e 20 77 69 74 68 20 61 6c 6c  as even with all
2630: 0a 66 65 61 74 75 72 65 73 20 69 6e 63 6c 75 64  .features includ
2640: 65 64 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69  ed the SQLite li
2650: 62 72 61 72 79 20 69 73 20 72 65 6c 61 74 69 76  brary is relativ
2660: 65 6c 79 20 73 6d 61 6c 6c 2e 20 44 6f 6e 27 74  ely small. Don't
2670: 20 66 6f 72 67 65 74 0a 74 6f 20 74 65 6c 6c 20   forget.to tell 
2680: 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72 20 74 6f  your compiler to
2690: 20 6f 70 74 69 6d 69 7a 65 20 66 6f 72 20 62 69   optimize for bi
26a0: 6e 61 72 79 20 73 69 7a 65 21 20 28 74 68 65 20  nary size! (the 
26b0: 2d 4f 73 20 6f 70 74 69 6f 6e 20 69 66 0a 75 73  -Os option if.us
26c0: 69 6e 67 20 47 43 43 29 2e 20 20 54 65 6c 6c 69  ing GCC).  Telli
26d0: 6e 67 20 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72  ng your compiler
26e0: 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 66 6f 72   to optimize for
26f0: 20 73 69 7a 65 20 75 73 75 61 6c 6c 79 20 68 61   size usually ha
2700: 73 0a 61 20 6d 75 63 68 20 6c 61 72 67 65 20 69  s.a much large i
2710: 6d 70 61 63 74 20 6f 6e 20 6c 69 62 72 61 72 79  mpact on library
2720: 20 66 6f 6f 74 70 72 69 6e 74 20 74 68 61 6e 20   footprint than 
2730: 65 6d 70 6c 6f 79 69 6e 67 20 61 6e 79 20 6f 66  employing any of
2740: 20 74 68 65 73 65 0a 63 6f 6d 70 69 6c 65 2d 74   these.compile-t
2750: 69 6d 65 20 6f 70 74 69 6f 6e 73 2e 3c 2f 70 3e  ime options.</p>
2760: 0a 0a 3c 70 3e 54 68 65 20 6d 61 63 72 6f 73 20  ..<p>The macros 
2770: 69 6e 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20  in this section 
2780: 64 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 20 76  do not require v
2790: 61 6c 75 65 73 2e 20 54 68 65 20 66 6f 6c 6c 6f  alues. The follo
27a0: 77 69 6e 67 20 0a 63 6f 6d 70 69 6c 61 74 69 6f  wing .compilatio
27b0: 6e 20 73 77 69 74 63 68 65 73 20 61 6c 6c 20 68  n switches all h
27c0: 61 76 65 20 74 68 65 20 73 61 6d 65 20 65 66 66  ave the same eff
27d0: 65 63 74 3a 3c 62 72 3e 0a 2d 44 53 51 4c 49 54  ect:<br>.-DSQLIT
27e0: 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c  E_OMIT_ALTERTABL
27f0: 45 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f  E<br>.-DSQLITE_O
2800: 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d 31  MIT_ALTERTABLE=1
2810: 3c 62 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d  <br>.-DSQLITE_OM
2820: 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 3d 30 0a  IT_ALTERTABLE=0.
2830: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 6e 79 20  </p>..<p>If any 
2840: 6f 66 20 74 68 65 73 65 20 6f 70 74 69 6f 6e 73  of these options
2850: 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 74 68   are defined, th
2860: 65 6e 20 74 68 65 20 73 61 6d 65 20 73 65 74 20  en the same set 
2870: 6f 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 58  of SQLITE_OMIT_X
2880: 58 58 0a 6f 70 74 69 6f 6e 73 20 6d 75 73 74 20  XX.options must 
2890: 61 6c 73 6f 20 62 65 20 64 65 66 69 6e 65 64 20  also be defined 
28a0: 77 68 65 6e 20 75 73 69 6e 67 20 74 68 65 20 27  when using the '
28b0: 6c 65 6d 6f 6e 27 20 74 6f 6f 6c 20 74 6f 20 67  lemon' tool to g
28c0: 65 6e 65 72 61 74 65 20 61 20 70 61 72 73 65 2e  enerate a parse.
28d0: 63 0a 66 69 6c 65 2e 20 42 65 63 61 75 73 65 20  c.file. Because 
28e0: 6f 66 20 74 68 69 73 2c 20 74 68 65 73 65 20 6f  of this, these o
28f0: 70 74 69 6f 6e 73 20 6d 61 79 20 6f 6e 6c 79 20  ptions may only 
2900: 62 65 20 75 73 65 64 20 77 68 65 6e 20 74 68 65  be used when the
2910: 20 6c 69 62 72 61 72 79 20 69 73 20 62 75 69 6c   library is buil
2920: 74 0a 66 72 6f 6d 20 73 6f 75 72 63 65 2c 20 6e  t.from source, n
2930: 6f 74 20 66 72 6f 6d 20 74 68 65 20 5b 61 6d 61  ot from the [ama
2940: 6c 67 61 6d 61 74 69 6f 6e 5d 20 6f 72 20 66 72  lgamation] or fr
2950: 6f 6d 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f  om the collectio
2960: 6e 20 6f 66 0a 70 72 65 2d 70 61 63 6b 61 67 65  n of.pre-package
2970: 64 20 43 20 66 69 6c 65 73 20 70 72 6f 76 69 64  d C files provid
2980: 65 64 20 66 6f 72 20 6e 6f 6e 2d 55 4e 49 58 20  ed for non-UNIX 
2990: 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73 20 6f  like platforms o
29a0: 6e 20 74 68 65 20 77 65 62 73 69 74 65 2e 0a 3c  n the website..<
29b0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 73 65 20 22 4f  /p>..<p>These "O
29c0: 4d 49 54 22 20 6f 70 74 69 6f 6e 73 20 61 72 65  MIT" options are
29d0: 20 63 6f 6e 73 69 64 65 72 65 64 20 75 6e 73 75   considered unsu
29e0: 70 70 6f 72 74 65 64 2e 20 20 41 6e 79 20 6f 66  pported.  Any of
29f0: 20 74 68 65 73 65 0a 6f 70 74 69 6f 6e 73 20 6d   these.options m
2a00: 61 79 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72  ay be removed fr
2a10: 6f 6d 20 74 68 65 20 63 6f 64 65 20 69 6e 20 61  om the code in a
2a20: 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 0a   future release.
2a30: 61 6e 64 20 77 69 74 68 6f 75 74 20 77 61 72 6e  and without warn
2a40: 69 6e 67 2e 20 20 46 6f 72 20 61 6e 79 20 70 61  ing.  For any pa
2a50: 72 74 69 63 75 6c 61 72 20 72 65 6c 65 61 73 65  rticular release
2a60: 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 73 65 0a  , some of these.
2a70: 6f 70 74 69 6f 6e 73 20 6d 61 79 20 63 61 75 73  options may caus
2a80: 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  e compile-time o
2a90: 72 20 72 75 6e 2d 74 69 6d 65 20 66 61 69 6c 75  r run-time failu
2aa0: 72 65 73 2e 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 0a  res.</p>..<tcl>.
2ab0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
2ac0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45  SQLITE_OMIT_ALTE
2ad0: 52 54 41 42 4c 45 7d 20 7b 0a 20 20 57 68 65 6e  RTABLE} {.  When
2ae0: 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20   this option is 
2af0: 64 65 66 69 6e 65 64 2c 20 74 68 65 20 0a 20 20  defined, the .  
2b00: 5b 41 4c 54 45 52 20 54 41 42 4c 45 5d 20 63 6f  [ALTER TABLE] co
2b10: 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63  mmand is not inc
2b20: 6c 75 64 65 64 20 69 6e 20 74 68 65 20 0a 20 20  luded in the .  
2b30: 6c 69 62 72 61 72 79 2e 20 45 78 65 63 75 74 69  library. Executi
2b40: 6e 67 20 61 6e 20 5b 41 4c 54 45 52 20 54 41 42  ng an [ALTER TAB
2b50: 4c 45 5d 20 73 74 61 74 65 6d 65 6e 74 20 63 61  LE] statement ca
2b60: 75 73 65 73 20 61 20 70 61 72 73 65 20 65 72 72  uses a parse err
2b70: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
2b80: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
2b90: 49 54 5f 41 4e 41 4c 59 5a 45 7d 20 7b 0a 20 20  IT_ANALYZE} {.  
2ba0: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
2bb0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65   is defined, the
2bc0: 20 5b 41 4e 41 4c 59 5a 45 5d 20 63 6f 6d 6d 61   [ANALYZE] comma
2bd0: 6e 64 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72  nd is omitted fr
2be0: 6f 6d 0a 20 20 74 68 65 20 62 75 69 6c 64 2e 0a  om.  the build..
2bf0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
2c00: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  N {SQLITE_OMIT_A
2c10: 54 54 41 43 48 7d 20 7b 0a 20 20 57 68 65 6e 20  TTACH} {.  When 
2c20: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
2c30: 65 66 69 6e 65 64 2c 20 74 68 65 20 5b 41 54 54  efined, the [ATT
2c40: 41 43 48 5d 20 61 6e 64 20 5b 44 45 54 41 43 48  ACH] and [DETACH
2c50: 5d 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 0a 20  ] commands are. 
2c60: 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68   omitted from th
2c70: 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50  e build..}..COMP
2c80: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
2c90: 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a  TE_OMIT_AUTHORIZ
2ca0: 41 54 49 4f 4e 7d 20 7b 0a 20 20 44 65 66 69 6e  ATION} {.  Defin
2cb0: 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  ing this option 
2cc0: 6f 6d 69 74 73 20 74 68 65 20 61 75 74 68 6f 72  omits the author
2cd0: 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62 61 63 6b  ization callback
2ce0: 20 66 65 61 74 75 72 65 20 66 72 6f 6d 20 74 68   feature from th
2cf0: 65 0a 20 20 6c 69 62 72 61 72 79 2e 20 54 68 65  e.  library. The
2d00: 20 5b 73 71 6c 69 74 65 33 5f 73 65 74 5f 61 75   [sqlite3_set_au
2d10: 74 68 6f 72 69 7a 65 72 28 29 5d 20 41 50 49 20  thorizer()] API 
2d20: 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20  function is not 
2d30: 70 72 65 73 65 6e 74 0a 20 20 69 6e 20 74 68 65  present.  in the
2d40: 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a 43 4f 4d   library..}..COM
2d50: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
2d60: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 43  ITE_OMIT_AUTOINC
2d70: 52 45 4d 45 4e 54 7d 20 7b 0a 20 20 54 68 69 73  REMENT} {.  This
2d80: 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20   option is used 
2d90: 74 6f 20 6f 6d 69 74 20 74 68 65 20 0a 20 20 5b  to omit the .  [
2da0: 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 5d 20 66  AUTOINCREMENT] f
2db0: 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2e 20 57 68  unctionality. Wh
2dc0: 65 6e 20 74 68 69 73 20 0a 20 20 69 73 20 6d 61  en this .  is ma
2dd0: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20  cro is defined, 
2de0: 63 6f 6c 75 6d 6e 73 20 64 65 63 6c 61 72 65 64  columns declared
2df0: 20 61 73 20 0a 20 20 22 5b 49 4e 54 45 47 45 52   as .  "[INTEGER
2e00: 20 50 52 49 4d 41 52 59 20 4b 45 59 5d 20 41 55   PRIMARY KEY] AU
2e10: 54 4f 49 4e 43 52 45 4d 45 4e 54 22 0a 20 20 62  TOINCREMENT".  b
2e20: 65 68 61 76 65 20 69 6e 20 74 68 65 20 73 61 6d  ehave in the sam
2e30: 65 20 77 61 79 20 61 73 20 63 6f 6c 75 6d 6e 73  e way as columns
2e40: 20 64 65 63 6c 61 72 65 64 20 61 73 20 22 5b 49   declared as "[I
2e50: 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b  NTEGER PRIMARY K
2e60: 45 59 5d 22 20 77 68 65 6e 20 61 20 0a 20 20 4e  EY]" when a .  N
2e70: 55 4c 4c 20 69 73 20 69 6e 73 65 72 74 65 64 2e  ULL is inserted.
2e80: 20 54 68 65 20 73 71 6c 69 74 65 5f 73 65 71 75   The sqlite_sequ
2e90: 65 6e 63 65 20 73 79 73 74 65 6d 20 74 61 62 6c  ence system tabl
2ea0: 65 20 69 73 20 6e 65 69 74 68 65 72 20 63 72 65  e is neither cre
2eb0: 61 74 65 64 2c 20 6e 6f 72 0a 20 20 72 65 73 70  ated, nor.  resp
2ec0: 65 63 74 65 64 20 69 66 20 69 74 20 61 6c 72 65  ected if it alre
2ed0: 61 64 79 20 65 78 69 73 74 73 2e 0a 7d 0a 0a 43  ady exists..}..C
2ee0: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
2ef0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49  QLITE_OMIT_AUTOI
2f00: 4e 49 54 7d 20 7b 0a 20 20 46 6f 72 20 62 61 63  NIT} {.  For bac
2f10: 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69  kwards compatibi
2f20: 6c 69 74 79 20 77 69 74 68 20 6f 6c 64 65 72 20  lity with older 
2f30: 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69  versions of SQLi
2f40: 74 65 20 74 68 61 74 20 6c 61 63 6b 0a 20 20 74  te that lack.  t
2f50: 68 65 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74  he [sqlite3_init
2f60: 69 61 6c 69 7a 65 28 29 5d 20 69 6e 74 65 72 66  ialize()] interf
2f70: 61 63 65 2c 20 74 68 65 20 5b 73 71 6c 69 74 65  ace, the [sqlite
2f80: 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 5d 20  3_initialize()] 
2f90: 69 6e 74 65 72 66 61 63 65 0a 20 20 69 73 20 63  interface.  is c
2fa0: 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74 69 63 61  alled automatica
2fb0: 6c 6c 79 20 75 70 6f 6e 20 65 6e 74 72 79 20 74  lly upon entry t
2fc0: 6f 20 63 65 72 74 61 69 6e 20 6b 65 79 20 69 6e  o certain key in
2fd0: 74 65 72 66 61 63 65 73 20 73 75 63 68 20 61 73  terfaces such as
2fe0: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e  .  [sqlite3_open
2ff0: 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 76 66  ()], [sqlite3_vf
3000: 73 5f 72 65 67 69 73 74 65 72 28 29 5d 2c 20 61  s_register()], a
3010: 6e 64 20 5b 73 71 6c 69 74 65 33 5f 6d 70 72 69  nd [sqlite3_mpri
3020: 6e 74 66 28 29 5d 2e 0a 20 20 54 68 65 20 6f 76  ntf()]..  The ov
3030: 65 72 68 65 61 64 20 6f 66 20 69 6e 76 6f 6b 69  erhead of invoki
3040: 6e 67 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69 74  ng [sqlite3_init
3050: 69 61 6c 69 7a 65 28 29 5d 20 61 75 74 6f 6d 61  ialize()] automa
3060: 74 69 63 61 6c 6c 79 20 69 6e 20 74 68 69 73 0a  tically in this.
3070: 20 20 77 61 79 20 6d 61 79 20 62 65 20 6f 6d 69    way may be omi
3080: 74 74 65 64 20 62 79 20 62 75 69 6c 64 69 6e 67  tted by building
3090: 20 53 51 4c 69 74 65 20 77 69 74 68 20 74 68 65   SQLite with the
30a0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54   SQLITE_OMIT_AUT
30b0: 4f 49 4e 49 54 0a 20 20 43 2d 70 72 65 70 72 6f  OINIT.  C-prepro
30c0: 63 65 73 73 6f 72 20 6d 61 63 72 6f 2e 20 20 57  cessor macro.  W
30d0: 68 65 6e 20 62 75 69 6c 74 20 75 73 69 6e 67 20  hen built using 
30e0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f  SQLITE_OMIT_AUTO
30f0: 49 4e 49 54 2c 20 53 51 4c 69 74 65 0a 20 20 77  INIT, SQLite.  w
3100: 69 6c 6c 20 6e 6f 74 20 61 75 74 6f 6d 61 74 69  ill not automati
3110: 63 61 6c 6c 79 20 69 6e 69 74 69 61 6c 69 7a 65  cally initialize
3120: 20 69 74 73 65 6c 66 20 61 6e 64 20 74 68 65 20   itself and the 
3130: 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 73 20 72  application is r
3140: 65 71 75 69 72 65 64 0a 20 20 74 6f 20 69 6e 76  equired.  to inv
3150: 6f 6b 65 20 5b 73 71 6c 69 74 65 33 5f 69 6e 69  oke [sqlite3_ini
3160: 74 69 61 6c 69 7a 65 28 29 5d 20 64 69 72 65 63  tialize()] direc
3170: 74 6c 79 20 70 72 69 6f 72 20 74 6f 20 62 65 67  tly prior to beg
3180: 69 6e 6e 69 6e 67 20 75 73 65 20 6f 66 20 74 68  inning use of th
3190: 65 0a 20 20 53 51 4c 69 74 65 20 6c 69 62 72 61  e.  SQLite libra
31a0: 72 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ry..}..COMPILE_O
31b0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
31c0: 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 7d 20 7b  IT_AUTOVACUUM} {
31d0: 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f  .  If this optio
31e0: 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68  n is defined, th
31f0: 65 20 6c 69 62 72 61 72 79 20 63 61 6e 6e 6f 74  e library cannot
3200: 20 63 72 65 61 74 65 20 6f 72 20 77 72 69 74 65   create or write
3210: 20 74 6f 20 0a 20 20 64 61 74 61 62 61 73 65 73   to .  databases
3220: 20 74 68 61 74 20 73 75 70 70 6f 72 74 20 5b 61   that support [a
3230: 75 74 6f 5f 76 61 63 75 75 6d 5d 2e 0a 20 20 45  uto_vacuum]..  E
3240: 78 65 63 75 74 69 6e 67 20 61 20 5b 50 52 41 47  xecuting a [PRAG
3250: 4d 41 20 61 75 74 6f 5f 76 61 63 75 75 6d 5d 20  MA auto_vacuum] 
3260: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 6e 6f 74  statement is not
3270: 20 61 6e 20 65 72 72 6f 72 0a 20 20 28 73 69 6e   an error.  (sin
3280: 63 65 20 75 6e 6b 6e 6f 77 6e 20 50 52 41 47 4d  ce unknown PRAGM
3290: 41 73 20 61 72 65 20 73 69 6c 65 6e 74 6c 79 20  As are silently 
32a0: 69 67 6e 6f 72 65 64 29 2c 20 62 75 74 20 64 6f  ignored), but do
32b0: 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 61 20  es not return a 
32c0: 76 61 6c 75 65 0a 20 20 6f 72 20 6d 6f 64 69 66  value.  or modif
32d0: 79 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75  y the auto-vacuu
32e0: 6d 20 66 6c 61 67 20 69 6e 20 74 68 65 20 64 61  m flag in the da
32f0: 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66 20  tabase file. If 
3300: 61 20 64 61 74 61 62 61 73 65 20 74 68 61 74 0a  a database that.
3310: 20 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f 2d    supports auto-
3320: 76 61 63 75 75 6d 20 69 73 20 6f 70 65 6e 65 64  vacuum is opened
3330: 20 62 79 20 61 20 6c 69 62 72 61 72 79 20 63 6f   by a library co
3340: 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 69 73  mpiled with this
3350: 20 6f 70 74 69 6f 6e 2c 20 69 74 0a 20 20 69 73   option, it.  is
3360: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6f   automatically o
3370: 70 65 6e 65 64 20 69 6e 20 72 65 61 64 2d 6f 6e  pened in read-on
3380: 6c 79 20 6d 6f 64 65 2e 0a 7d 0a 0a 43 4f 4d 50  ly mode..}..COMP
3390: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
33a0: 54 45 5f 4f 4d 49 54 5f 42 45 54 57 45 45 4e 5f  TE_OMIT_BETWEEN_
33b0: 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 7d 20 7b 0a  OPTIMIZATION} {.
33c0: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 64 69    This option di
33d0: 73 61 62 6c 65 73 20 74 68 65 20 75 73 65 20 6f  sables the use o
33e0: 66 20 69 6e 64 69 63 65 73 20 77 69 74 68 20 57  f indices with W
33f0: 48 45 52 45 20 63 6c 61 75 73 65 20 74 65 72 6d  HERE clause term
3400: 73 0a 20 20 74 68 61 74 20 65 6d 70 6c 6f 79 20  s.  that employ 
3410: 74 68 65 20 42 45 54 57 45 45 4e 20 6f 70 65 72  the BETWEEN oper
3420: 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ator..}..COMPILE
3430: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
3440: 4f 4d 49 54 5f 42 4c 4f 42 5f 4c 49 54 45 52 41  OMIT_BLOB_LITERA
3450: 4c 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69 73  L} {.  When this
3460: 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69 6e   option is defin
3470: 65 64 2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f  ed, it is not po
3480: 73 73 69 62 6c 65 20 74 6f 20 73 70 65 63 69 66  ssible to specif
3490: 79 20 61 20 62 6c 6f 62 20 69 6e 0a 20 20 61 6e  y a blob in.  an
34a0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 75   SQL statement u
34b0: 73 69 6e 67 20 74 68 65 20 58 27 41 42 43 44 27  sing the X'ABCD'
34c0: 20 73 79 6e 74 61 78 2e 0a 7d 0a 0a 43 4f 4d 50   syntax..}..COMP
34d0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
34e0: 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f  TE_OMIT_BUILTIN_
34f0: 54 45 53 54 7d 20 7b 0a 20 20 41 20 73 74 61 6e  TEST} {.  A stan
3500: 64 61 72 64 20 53 51 4c 69 74 65 20 62 75 69 6c  dard SQLite buil
3510: 64 20 69 6e 63 6c 75 64 65 73 20 61 20 73 6d 61  d includes a sma
3520: 6c 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 67  ll amount of log
3530: 69 63 20 63 6f 6e 74 72 6f 6c 6c 65 64 0a 20 20  ic controlled.  
3540: 62 79 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  by the [sqlite3_
3550: 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 5d 20  test_control()] 
3560: 69 6e 74 65 72 66 61 63 65 20 74 68 61 74 20 69  interface that i
3570: 73 20 75 73 65 64 20 74 6f 20 65 78 65 72 63 69  s used to exerci
3580: 73 65 0a 20 20 70 61 72 74 73 20 6f 66 20 74 68  se.  parts of th
3590: 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 74 68  e SQLite core th
35a0: 61 74 20 61 72 65 20 64 69 66 66 69 63 75 6c 74  at are difficult
35b0: 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 61 6e 64 20   to control and 
35c0: 6d 65 61 73 75 72 65 20 75 73 69 6e 67 0a 20 20  measure using.  
35d0: 74 68 65 20 73 74 61 6e 64 61 72 64 20 41 50 49  the standard API
35e0: 2e 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f  .  This option o
35f0: 6d 69 74 73 20 74 68 61 74 20 62 75 69 6c 74 2d  mits that built-
3600: 69 6e 20 74 65 73 74 20 6c 6f 67 69 63 2e 0a 7d  in test logic..}
3610: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
3620: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 41   {SQLITE_OMIT_CA
3630: 53 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  ST} {.  This opt
3640: 69 6f 6e 20 63 61 75 73 65 73 20 53 51 4c 69 74  ion causes SQLit
3650: 65 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72  e to omit suppor
3660: 74 20 66 6f 72 20 74 68 65 20 43 41 53 54 20 6f  t for the CAST o
3670: 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50  perator..}..COMP
3680: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
3690: 54 45 5f 4f 4d 49 54 5f 43 48 45 43 4b 7d 20 7b  TE_OMIT_CHECK} {
36a0: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
36b0: 61 75 73 65 73 20 53 51 4c 69 74 65 20 74 6f 20  auses SQLite to 
36c0: 6f 6d 69 74 20 73 75 70 70 6f 72 74 20 66 6f 72  omit support for
36d0: 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e   CHECK constrain
36e0: 74 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ts..}..COMPILE_O
36f0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
3700: 49 54 5f 43 4f 4d 50 4c 45 54 45 7d 20 7b 0a 20  IT_COMPLETE} {. 
3710: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75   This option cau
3720: 73 65 73 20 74 68 65 20 5b 73 71 6c 69 74 65 33  ses the [sqlite3
3730: 5f 63 6f 6d 70 6c 65 74 65 28 29 5d 20 61 6e 64  _complete()] and
3740: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65   [sqlite3_comple
3750: 74 65 31 36 28 29 5d 0a 20 20 69 6e 74 65 72 66  te16()].  interf
3760: 61 63 65 73 20 74 6f 20 62 65 20 6f 6d 69 74 74  aces to be omitt
3770: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
3780: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
3790: 49 54 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45  IT_COMPOUND_SELE
37a0: 43 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  CT} {.  This opt
37b0: 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 6f  ion is used to o
37c0: 6d 69 74 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64  mit the compound
37d0: 20 5b 53 45 4c 45 43 54 5d 20 66 75 6e 63 74 69   [SELECT] functi
37e0: 6f 6e 61 6c 69 74 79 2e 20 0a 20 20 5b 53 45 4c  onality. .  [SEL
37f0: 45 43 54 5d 20 73 74 61 74 65 6d 65 6e 74 73 20  ECT] statements 
3800: 74 68 61 74 20 75 73 65 20 74 68 65 20 0a 20 20  that use the .  
3810: 55 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c  UNION, UNION ALL
3820: 2c 20 49 4e 54 45 52 53 45 43 54 20 6f 72 20 45  , INTERSECT or E
3830: 58 43 45 50 54 20 63 6f 6d 70 6f 75 6e 64 20 53  XCEPT compound S
3840: 45 4c 45 43 54 20 6f 70 65 72 61 74 6f 72 73 20  ELECT operators 
3850: 77 69 6c 6c 20 0a 20 20 63 61 75 73 65 20 61 20  will .  cause a 
3860: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a  parse error..}..
3870: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3880: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4e 46  SQLITE_OMIT_CONF
3890: 4c 49 43 54 5f 43 4c 41 55 53 45 7d 20 7b 0a 20  LICT_CLAUSE} {. 
38a0: 20 49 6e 20 74 68 65 20 66 75 74 75 72 65 2c 20   In the future, 
38b0: 74 68 69 73 20 6f 70 74 69 6f 6e 20 77 69 6c 6c  this option will
38c0: 20 62 65 20 75 73 65 64 20 74 6f 20 6f 6d 69 74   be used to omit
38d0: 20 74 68 65 20 0a 20 20 5b 4f 4e 20 43 4f 4e 46   the .  [ON CONF
38e0: 4c 49 43 54 5d 20 63 6c 61 75 73 65 20 66 72 6f  LICT] clause fro
38f0: 6d 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d  m the library..}
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 4f 4d 49 54 5f 44 41   {SQLITE_OMIT_DA
3920: 54 45 54 49 4d 45 5f 46 55 4e 43 53 7d 20 7b 0a  TETIME_FUNCS} {.
3930: 20 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e    If this option
3940: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 53 51 4c   is defined, SQL
3950: 69 74 65 27 73 20 62 75 69 6c 74 2d 69 6e 20 64  ite's built-in d
3960: 61 74 65 20 61 6e 64 20 74 69 6d 65 20 6d 61 6e  ate and time man
3970: 69 70 75 6c 61 74 69 6f 6e 0a 20 20 66 75 6e 63  ipulation.  func
3980: 74 69 6f 6e 73 20 61 72 65 20 6f 6d 69 74 74 65  tions are omitte
3990: 64 2e 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c  d. Specifically,
39a0: 20 74 68 65 20 53 51 4c 20 66 75 6e 63 74 69 6f   the SQL functio
39b0: 6e 73 20 6a 75 6c 69 61 6e 64 61 79 28 29 2c 20  ns julianday(), 
39c0: 64 61 74 65 28 29 2c 0a 20 20 74 69 6d 65 28 29  date(),.  time()
39d0: 2c 20 64 61 74 65 74 69 6d 65 28 29 20 61 6e 64  , datetime() and
39e0: 20 73 74 72 66 74 69 6d 65 28 29 20 61 72 65 20   strftime() are 
39f0: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 54  not available. T
3a00: 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 75 6d  he default colum
3a10: 6e 0a 20 20 76 61 6c 75 65 73 20 43 55 52 52 45  n.  values CURRE
3a20: 4e 54 5f 54 49 4d 45 2c 20 43 55 52 52 45 4e 54  NT_TIME, CURRENT
3a30: 5f 44 41 54 45 20 61 6e 64 20 43 55 52 52 45 4e  _DATE and CURREN
3a40: 54 5f 44 41 54 45 54 49 4d 45 20 61 72 65 20 73  T_DATETIME are s
3a50: 74 69 6c 6c 20 61 76 61 69 6c 61 62 6c 65 2e 0a  till available..
3a60: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
3a70: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44  N {SQLITE_OMIT_D
3a80: 45 43 4c 54 59 50 45 7d 20 7b 0a 20 20 54 68 69  ECLTYPE} {.  Thi
3a90: 73 20 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20  s option causes 
3aa0: 53 51 4c 69 74 65 20 74 6f 20 6f 6d 69 74 20 73  SQLite to omit s
3ab0: 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 0a 20  upport for the. 
3ac0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
3ad0: 5f 64 65 63 6c 74 79 70 65 28 29 5d 20 61 6e 64  _decltype()] and
3ae0: 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   [sqlite3_column
3af0: 5f 64 65 63 6c 74 79 70 65 31 36 28 29 5d 0a 20  _decltype16()]. 
3b00: 20 69 6e 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a   interfaces..}..
3b10: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3b20: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b  SQLITE_OMIT_DISK
3b30: 49 4f 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  IO} {.  This opt
3b40: 69 6f 6e 20 6f 6d 69 74 73 20 61 6c 6c 20 73 75  ion omits all su
3b50: 70 70 6f 72 74 20 66 6f 72 20 77 72 69 74 69 6e  pport for writin
3b60: 67 20 74 6f 20 74 68 65 20 64 69 73 6b 20 61 6e  g to the disk an
3b70: 64 20 66 6f 72 63 65 73 0a 20 20 64 61 74 61 62  d forces.  datab
3b80: 61 73 65 73 20 74 6f 20 65 78 69 73 74 20 69 6e  ases to exist in
3b90: 20 6d 65 6d 6f 72 79 20 6f 6e 6c 79 2e 0a 7d 0a   memory only..}.
3ba0: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
3bb0: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50  {SQLITE_OMIT_EXP
3bc0: 4c 41 49 4e 7d 20 7b 0a 20 20 44 65 66 69 6e 69  LAIN} {.  Defini
3bd0: 6e 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 63  ng this option c
3be0: 61 75 73 65 73 20 74 68 65 20 5b 45 58 50 4c 41  auses the [EXPLA
3bf0: 49 4e 5d 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 62  IN] command to b
3c00: 65 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74  e omitted from t
3c10: 68 65 0a 20 20 6c 69 62 72 61 72 79 2e 20 41 74  he.  library. At
3c20: 74 65 6d 70 74 69 6e 67 20 74 6f 20 65 78 65 63  tempting to exec
3c30: 75 74 65 20 61 6e 20 5b 45 58 50 4c 41 49 4e 5d  ute an [EXPLAIN]
3c40: 20 73 74 61 74 65 6d 65 6e 74 20 77 69 6c 6c 20   statement will 
3c50: 63 61 75 73 65 20 61 20 70 61 72 73 65 0a 20 20  cause a parse.  
3c60: 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  error..}..COMPIL
3c70: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
3c80: 5f 4f 4d 49 54 5f 46 4c 41 47 5f 50 52 41 47 4d  _OMIT_FLAG_PRAGM
3c90: 41 53 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  AS} {.  This opt
3ca0: 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72  ion omits suppor
3cb0: 74 20 66 6f 72 20 61 20 73 75 62 73 65 74 20 6f  t for a subset o
3cc0: 66 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61  f [PRAGMA] comma
3cd0: 6e 64 73 20 74 68 61 74 0a 20 20 71 75 65 72 79  nds that.  query
3ce0: 20 61 6e 64 20 73 65 74 20 62 6f 6f 6c 65 61 6e   and set boolean
3cf0: 20 70 72 6f 70 65 72 74 69 65 73 2e 0a 7d 0a 0a   properties..}..
3d00: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
3d10: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41  SQLITE_OMIT_FLOA
3d20: 54 49 4e 47 5f 50 4f 49 4e 54 7d 20 7b 0a 20 20  TING_POINT} {.  
3d30: 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75  This option is u
3d40: 73 65 64 20 74 6f 20 6f 6d 69 74 20 66 6c 6f 61  sed to omit floa
3d50: 74 69 6e 67 2d 70 6f 69 6e 74 20 6e 75 6d 62 65  ting-point numbe
3d60: 72 20 73 75 70 70 6f 72 74 20 66 72 6f 6d 20 74  r support from t
3d70: 68 65 20 53 51 4c 69 74 65 0a 20 20 6c 69 62 72  he SQLite.  libr
3d80: 61 72 79 2e 20 57 68 65 6e 20 73 70 65 63 69 66  ary. When specif
3d90: 69 65 64 2c 20 73 70 65 63 69 66 79 69 6e 67 20  ied, specifying 
3da0: 61 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74  a floating point
3db0: 20 6e 75 6d 62 65 72 20 61 73 20 61 20 6c 69 74   number as a lit
3dc0: 65 72 61 6c 20 0a 20 20 28 69 2e 65 2e 20 22 31  eral .  (i.e. "1
3dd0: 2e 30 31 22 29 20 72 65 73 75 6c 74 73 20 69 6e  .01") results in
3de0: 20 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a   a parse error..
3df0: 0a 20 20 3c 70 3e 49 6e 20 74 68 65 20 66 75 74  .  <p>In the fut
3e00: 75 72 65 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e  ure, this option
3e10: 20 6d 61 79 20 61 6c 73 6f 20 64 69 73 61 62 6c   may also disabl
3e20: 65 20 6f 74 68 65 72 20 66 6c 6f 61 74 69 6e 67  e other floating
3e30: 20 70 6f 69 6e 74 20 0a 20 20 66 75 6e 63 74 69   point .  functi
3e40: 6f 6e 61 6c 69 74 79 2c 20 66 6f 72 20 65 78 61  onality, for exa
3e50: 6d 70 6c 65 20 74 68 65 20 5b 73 71 6c 69 74 65  mple the [sqlite
3e60: 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28  3_result_double(
3e70: 29 5d 2c 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f  )], .  [sqlite3_
3e80: 62 69 6e 64 5f 64 6f 75 62 6c 65 28 29 5d 2c 20  bind_double()], 
3e90: 5b 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64  [sqlite3_value_d
3ea0: 6f 75 62 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b  ouble()] and.  [
3eb0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
3ec0: 6f 75 62 6c 65 28 29 5d 20 41 50 49 20 66 75 6e  ouble()] API fun
3ed0: 63 74 69 6f 6e 73 2e 0a 20 20 3c 2f 70 3e 0a 7d  ctions..  </p>.}
3ee0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
3ef0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f   {SQLITE_OMIT_FO
3f00: 52 45 49 47 4e 5f 4b 45 59 7d 20 7b 0a 20 20 49  REIGN_KEY} {.  I
3f10: 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73  f this option is
3f20: 20 64 65 66 69 6e 65 64 2c 20 46 4f 52 45 49 47   defined, FOREIG
3f30: 4e 20 4b 45 59 20 63 6c 61 75 73 65 73 20 69 6e  N KEY clauses in
3f40: 20 63 6f 6c 75 6d 6e 20 64 65 63 6c 61 72 61 74   column declarat
3f50: 69 6f 6e 73 20 61 72 65 0a 20 20 69 67 6e 6f 72  ions are.  ignor
3f60: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
3f70: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
3f80: 49 54 5f 47 45 54 5f 54 41 42 4c 45 7d 20 7b 0a  IT_GET_TABLE} {.
3f90: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61    This option ca
3fa0: 75 73 65 73 20 73 75 70 70 6f 72 74 20 66 6f 72  uses support for
3fb0: 20 5b 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 61   [sqlite3_get_ta
3fc0: 62 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71  ble()] and.  [sq
3fd0: 6c 69 74 65 33 5f 66 72 65 65 5f 74 61 62 6c 65  lite3_free_table
3fe0: 28 29 5d 20 74 6f 20 62 65 20 6f 6d 69 74 74 65  ()] to be omitte
3ff0: 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  d..}..COMPILE_OP
4000: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
4010: 54 5f 49 4e 43 52 42 4c 4f 42 7d 20 7b 0a 20 20  T_INCRBLOB} {.  
4020: 54 68 69 73 20 6f 70 74 69 6f 6e 20 63 61 75 73  This option caus
4030: 65 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 5b  es support for [
4040: 73 71 6c 69 74 65 33 5f 62 6c 6f 62 20 7c 20 69  sqlite3_blob | i
4050: 6e 63 72 65 6d 65 6e 74 61 6c 20 42 4c 4f 42 20  ncremental BLOB 
4060: 49 2f 4f 5d 0a 20 20 74 6f 20 62 65 20 6f 6d 69  I/O].  to be omi
4070: 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  tted..}..COMPILE
4080: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
4090: 4f 4d 49 54 5f 49 4e 54 45 47 52 49 54 59 5f 43  OMIT_INTEGRITY_C
40a0: 48 45 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f  HECK} {.  This o
40b0: 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70  ption omits supp
40c0: 6f 72 74 20 66 6f 72 20 74 68 65 20 5b 69 6e 74  ort for the [int
40d0: 65 67 72 69 74 79 5f 63 68 65 63 6b 20 70 72 61  egrity_check pra
40e0: 67 6d 61 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  gma]..}..COMPILE
40f0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
4100: 4f 4d 49 54 5f 4c 49 4b 45 5f 4f 50 54 49 4d 49  OMIT_LIKE_OPTIMI
4110: 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73  ZATION} {.  This
4120: 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 20   option disable 
4130: 74 68 65 20 61 62 69 6c 69 74 79 20 6f 66 20 53  the ability of S
4140: 51 4c 69 74 65 20 74 6f 20 75 73 65 20 69 6e 64  QLite to use ind
4150: 69 63 65 73 20 74 6f 20 68 65 6c 70 0a 20 20 72  ices to help.  r
4160: 65 73 6f 6c 76 65 20 5b 4c 49 4b 45 5d 20 61 6e  esolve [LIKE] an
4170: 64 20 5b 47 4c 4f 42 5d 20 6f 70 65 72 61 74 6f  d [GLOB] operato
4180: 72 73 20 69 6e 20 61 20 57 48 45 52 45 20 63 6c  rs in a WHERE cl
4190: 61 75 73 65 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ause..}..COMPILE
41a0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
41b0: 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53  OMIT_LOAD_EXTENS
41c0: 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70  ION} {.  This op
41d0: 74 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 65  tion omits the e
41e0: 6e 74 69 72 65 20 65 78 74 65 6e 73 69 6f 6e 20  ntire extension 
41f0: 6c 6f 61 64 69 6e 67 20 6d 65 63 68 61 6e 69 73  loading mechanis
4200: 6d 20 66 72 6f 6d 0a 20 20 53 51 4c 69 74 65 2c  m from.  SQLite,
4210: 20 69 6e 63 6c 75 64 69 6e 67 20 5b 73 71 6c 69   including [sqli
4220: 74 65 33 5f 65 6e 61 62 6c 65 5f 6c 6f 61 64 5f  te3_enable_load_
4230: 65 78 74 65 6e 73 69 6f 6e 28 29 5d 20 61 6e 64  extension()] and
4240: 0a 20 20 5b 73 71 6c 69 74 65 33 5f 6c 6f 61 64  .  [sqlite3_load
4250: 5f 65 78 74 65 6e 73 69 6f 6e 28 29 5d 20 69 6e  _extension()] in
4260: 74 65 72 66 61 63 65 73 2e 0a 7d 0a 0a 43 4f 4d  terfaces..}..COM
4270: 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c  PILE_OPTION {SQL
4280: 49 54 45 5f 4f 4d 49 54 5f 4c 4f 43 41 4c 54 49  ITE_OMIT_LOCALTI
4290: 4d 45 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  ME} {.  This opt
42a0: 69 6f 6e 20 6f 6d 69 74 73 20 74 68 65 20 22 6c  ion omits the "l
42b0: 6f 63 61 6c 74 69 6d 65 22 20 6d 6f 64 69 66 69  ocaltime" modifi
42c0: 65 72 20 66 72 6f 6d 20 74 68 65 20 64 61 74 65  er from the date
42d0: 20 61 6e 64 20 74 69 6d 65 0a 20 20 66 75 6e 63   and time.  func
42e0: 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 6f 70 74  tions.  This opt
42f0: 69 6f 6e 20 69 73 20 73 6f 6d 65 74 69 6d 65 73  ion is sometimes
4300: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74 72 79   useful when try
4310: 69 6e 67 20 74 6f 20 63 6f 6d 70 69 6c 65 0a 20  ing to compile. 
4320: 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69   the date and ti
4330: 6d 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f 6e 20  me functions on 
4340: 61 20 70 6c 61 74 66 6f 72 6d 20 74 68 61 74 20  a platform that 
4350: 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74  does not support
4360: 20 74 68 65 0a 20 20 63 6f 6e 63 65 70 74 20 6f   the.  concept o
4370: 66 20 6c 6f 63 61 6c 20 74 69 6d 65 2e 0a 7d 0a  f local time..}.
4380: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
4390: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d  {SQLITE_OMIT_MEM
43a0: 4f 52 59 44 42 7d 20 7b 0a 20 20 57 68 65 6e 20  ORYDB} {.  When 
43b0: 74 68 69 73 20 69 73 20 64 65 66 69 6e 65 64 2c  this is defined,
43c0: 20 74 68 65 20 6c 69 62 72 61 72 79 20 64 6f 65   the library doe
43d0: 73 20 6e 6f 74 20 72 65 73 70 65 63 74 20 74 68  s not respect th
43e0: 65 20 73 70 65 63 69 61 6c 20 64 61 74 61 62 61  e special databa
43f0: 73 65 0a 20 20 6e 61 6d 65 20 22 3a 6d 65 6d 6f  se.  name ":memo
4400: 72 79 3a 22 20 28 6e 6f 72 6d 61 6c 6c 79 20 75  ry:" (normally u
4410: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6e  sed to create an
4420: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62   in-memory datab
4430: 61 73 65 29 2e 20 49 66 20 0a 20 20 22 3a 6d 65  ase). If .  ":me
4440: 6d 6f 72 79 3a 22 20 69 73 20 70 61 73 73 65 64  mory:" is passed
4450: 20 74 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65   to [sqlite3_ope
4460: 6e 28 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 6f  n()], [sqlite3_o
4470: 70 65 6e 31 36 28 29 5d 2c 20 6f 72 0a 20 20 5b  pen16()], or.  [
4480: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28  sqlite3_open_v2(
4490: 29 5d 2c 20 61 20 66 69 6c 65 20 77 69 74 68 20  )], a file with 
44a0: 74 68 69 73 20 6e 61 6d 65 20 77 69 6c 6c 20 62  this name will b
44b0: 65 20 0a 20 20 6f 70 65 6e 65 64 20 6f 72 20 63  e .  opened or c
44c0: 72 65 61 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  reated..}..COMPI
44d0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
44e0: 45 5f 4f 4d 49 54 5f 4f 52 5f 4f 50 54 49 4d 49  E_OMIT_OR_OPTIMI
44f0: 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 54 68 69 73  ZATION} {.  This
4500: 20 6f 70 74 69 6f 6e 20 64 69 73 61 62 6c 65 73   option disables
4510: 20 74 68 65 20 61 62 69 6c 69 74 79 20 6f 66 20   the ability of 
4520: 53 51 4c 69 74 65 20 74 6f 20 75 73 65 20 61 6e  SQLite to use an
4530: 20 69 6e 64 65 78 20 74 6f 67 65 74 68 65 72 0a   index together.
4540: 20 20 77 69 74 68 20 74 65 72 6d 73 20 6f 66 20    with terms of 
4550: 61 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 63  a WHERE clause c
4560: 6f 6e 6e 65 63 74 65 64 20 62 79 20 74 68 65 20  onnected by the 
4570: 4f 52 20 6f 70 65 72 61 74 6f 72 2e 0a 7d 0a 0a  OR operator..}..
4580: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
4590: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45  SQLITE_OMIT_PAGE
45a0: 52 5f 50 52 41 47 4d 41 53 7d 20 7b 0a 20 20 44  R_PRAGMAS} {.  D
45b0: 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74  efining this opt
45c0: 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61 67 6d 61  ion omits pragma
45d0: 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 68 65  s related to the
45e0: 20 70 61 67 65 72 20 73 75 62 73 79 73 74 65 6d   pager subsystem
45f0: 20 66 72 6f 6d 20 0a 20 20 74 68 65 20 62 75 69   from .  the bui
4600: 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ld..}..COMPILE_O
4610: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
4620: 49 54 5f 50 52 41 47 4d 41 7d 20 7b 0a 20 20 54  IT_PRAGMA} {.  T
4630: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73  his option is us
4640: 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 5b  ed to omit the [
4650: 50 52 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 0a  PRAGMA] command.
4660: 20 20 66 72 6f 6d 20 74 68 65 20 6c 69 62 72 61    from the libra
4670: 72 79 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 74  ry. Note that it
4680: 20 69 73 20 75 73 65 66 75 6c 20 74 6f 20 64 65   is useful to de
4690: 66 69 6e 65 20 74 68 65 20 6d 61 63 72 6f 73 20  fine the macros 
46a0: 74 68 61 74 20 6f 6d 69 74 0a 20 20 73 70 65 63  that omit.  spec
46b0: 69 66 69 63 20 70 72 61 67 6d 61 73 20 69 6e 20  ific pragmas in 
46c0: 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 69 73  addition to this
46d0: 2c 20 61 73 20 74 68 65 79 20 6d 61 79 20 61 6c  , as they may al
46e0: 73 6f 20 72 65 6d 6f 76 65 20 73 75 70 70 6f 72  so remove suppor
46f0: 74 69 6e 67 20 63 6f 64 65 0a 20 20 69 6e 20 6f  ting code.  in o
4700: 74 68 65 72 20 73 75 62 2d 73 79 73 74 65 6d 73  ther sub-systems
4710: 2e 20 54 68 69 73 20 6d 61 63 72 6f 20 72 65 6d  . This macro rem
4720: 6f 76 65 73 20 74 68 65 20 5b 50 52 41 47 4d 41  oves the [PRAGMA
4730: 5d 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 2e 0a  ] command only..
4740: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
4750: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50  N {SQLITE_OMIT_P
4760: 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b  ROGRESS_CALLBACK
4770: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
4780: 6e 20 6d 61 79 20 62 65 20 64 65 66 69 6e 65 64  n may be defined
4790: 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 63 61 70   to omit the cap
47a0: 61 62 69 6c 69 74 79 20 74 6f 20 69 73 73 75 65  ability to issue
47b0: 20 22 70 72 6f 67 72 65 73 73 22 20 0a 20 20 63   "progress" .  c
47c0: 61 6c 6c 62 61 63 6b 73 20 64 75 72 69 6e 67 20  allbacks during 
47d0: 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 53 51 4c  long-running SQL
47e0: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 54 68 65   statements. The
47f0: 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f   .  [sqlite3_pro
4800: 67 72 65 73 73 5f 68 61 6e 64 6c 65 72 28 29 5d  gress_handler()]
4810: 0a 20 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20  .  API function 
4820: 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 20 69  is not present i
4830: 6e 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d  n the library..}
4840: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
4850: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 55   {SQLITE_OMIT_QU
4860: 49 43 4b 42 41 4c 41 4e 43 45 7d 20 7b 0a 20 20  ICKBALANCE} {.  
4870: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
4880: 73 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65  s an alternative
4890: 2c 20 66 61 73 74 65 72 20 42 2d 54 72 65 65 20  , faster B-Tree 
48a0: 62 61 6c 61 6e 63 69 6e 67 20 72 6f 75 74 69 6e  balancing routin
48b0: 65 2e 0a 20 20 55 73 69 6e 67 20 74 68 69 73 20  e..  Using this 
48c0: 6f 70 74 69 6f 6e 20 6d 61 6b 65 73 20 53 51 4c  option makes SQL
48d0: 69 74 65 20 73 6c 69 67 68 74 6c 79 20 73 6d 61  ite slightly sma
48e0: 6c 6c 65 72 20 61 74 20 74 68 65 20 65 78 70 65  ller at the expe
48f0: 6e 73 65 20 6f 66 0a 20 20 6d 61 6b 69 6e 67 20  nse of.  making 
4900: 69 74 20 72 75 6e 20 73 6c 69 67 68 74 6c 79 20  it run slightly 
4910: 73 6c 6f 77 65 72 2e 0a 7d 0a 0a 43 4f 4d 50 49  slower..}..COMPI
4920: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
4930: 45 5f 4f 4d 49 54 5f 52 45 49 4e 44 45 58 7d 20  E_OMIT_REINDEX} 
4940: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  {.  When this op
4950: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
4960: 20 74 68 65 20 5b 52 45 49 4e 44 45 58 5d 0a 20   the [REINDEX]. 
4970: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 6f 74 20   command is not 
4980: 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20  included in the 
4990: 6c 69 62 72 61 72 79 2e 0a 20 20 45 78 65 63 75  library..  Execu
49a0: 74 69 6e 67 20 61 20 5b 52 45 49 4e 44 45 58 5d  ting a [REINDEX]
49b0: 20 73 74 61 74 65 6d 65 6e 74 20 63 61 75 73 65   statement cause
49c0: 73 20 0a 20 20 61 20 70 61 72 73 65 20 65 72 72  s .  a parse err
49d0: 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  or..}..COMPILE_O
49e0: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
49f0: 49 54 5f 53 43 48 45 4d 41 5f 50 52 41 47 4d 41  IT_SCHEMA_PRAGMA
4a00: 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20  S} {.  Defining 
4a10: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  this option omit
4a20: 73 20 70 72 61 67 6d 61 73 20 66 6f 72 20 71 75  s pragmas for qu
4a30: 65 72 79 69 6e 67 20 74 68 65 20 64 61 74 61 62  erying the datab
4a40: 61 73 65 20 73 63 68 65 6d 61 20 66 72 6f 6d 20  ase schema from 
4a50: 0a 20 20 74 68 65 20 62 75 69 6c 64 2e 0a 7d 0a  .  the build..}.
4a60: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
4a70: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 43 48  {SQLITE_OMIT_SCH
4a80: 45 4d 41 5f 56 45 52 53 49 4f 4e 5f 50 52 41 47  EMA_VERSION_PRAG
4a90: 4d 41 53 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e  MAS} {.  Definin
4aa0: 67 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d  g this option om
4ab0: 69 74 73 20 70 72 61 67 6d 61 73 20 66 6f 72 20  its pragmas for 
4ac0: 71 75 65 72 79 69 6e 67 20 61 6e 64 20 6d 6f 64  querying and mod
4ad0: 69 66 79 69 6e 67 20 74 68 65 20 0a 20 20 64 61  ifying the .  da
4ae0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 76 65  tabase schema ve
4af0: 72 73 69 6f 6e 20 61 6e 64 20 75 73 65 72 20 76  rsion and user v
4b00: 65 72 73 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20  ersion from the 
4b10: 62 75 69 6c 64 2e 20 53 70 65 63 69 66 69 63 61  build. Specifica
4b20: 6c 6c 79 2c 20 74 68 65 20 0a 20 20 5b 73 63 68  lly, the .  [sch
4b30: 65 6d 61 5f 76 65 72 73 69 6f 6e 5d 20 61 6e 64  ema_version] and
4b40: 20 5b 75 73 65 72 5f 76 65 72 73 69 6f 6e 5d 20   [user_version] 
4b50: 50 52 41 47 4d 41 73 20 61 72 65 20 6f 6d 69 74  PRAGMAs are omit
4b60: 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ted..}..COMPILE_
4b70: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
4b80: 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45  MIT_SHARED_CACHE
4b90: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
4ba0: 6e 20 62 75 69 6c 64 73 20 53 51 4c 69 74 65 20  n builds SQLite 
4bb0: 77 69 74 68 6f 75 74 20 73 75 70 70 6f 72 74 20  without support 
4bc0: 66 6f 72 20 73 68 61 72 65 64 2d 63 61 63 68 65  for shared-cache
4bd0: 20 6d 6f 64 65 2e 0a 20 20 54 68 65 20 5b 73 71   mode..  The [sq
4be0: 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f 73 68 61  lite3_enable_sha
4bf0: 72 65 64 5f 63 61 63 68 65 28 29 5d 20 69 73 20  red_cache()] is 
4c00: 6f 6d 69 74 74 65 64 20 61 6c 6f 6e 67 20 77 69  omitted along wi
4c10: 74 68 20 61 20 66 61 69 72 0a 20 20 61 6d 6f 75  th a fair.  amou
4c20: 6e 74 20 6f 66 20 6c 6f 67 69 63 20 77 69 74 68  nt of logic with
4c30: 69 6e 20 74 68 65 20 42 2d 54 72 65 65 20 73 75  in the B-Tree su
4c40: 62 73 79 73 74 65 6d 20 61 73 73 6f 63 69 61 74  bsystem associat
4c50: 65 64 20 77 69 74 68 20 73 68 61 72 65 64 0a 20  ed with shared. 
4c60: 20 63 61 63 68 65 20 6d 61 6e 61 67 65 6d 65 6e   cache managemen
4c70: 74 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  t..}..COMPILE_OP
4c80: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
4c90: 54 5f 53 55 42 51 55 45 52 59 7d 20 7b 0a 20 20  T_SUBQUERY} {.  
4ca0: 49 66 20 64 65 66 69 6e 65 64 2c 20 73 75 70 70  If defined, supp
4cb0: 6f 72 74 20 66 6f 72 20 73 75 62 2d 73 65 6c 65  ort for sub-sele
4cc0: 63 74 73 20 61 6e 64 20 74 68 65 20 49 4e 28 29  cts and the IN()
4cd0: 20 6f 70 65 72 61 74 6f 72 20 61 72 65 20 6f 6d   operator are om
4ce0: 69 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  itted..}..COMPIL
4cf0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
4d00: 5f 4f 4d 49 54 5f 54 43 4c 5f 56 41 52 49 41 42  _OMIT_TCL_VARIAB
4d10: 4c 45 7d 20 7b 0a 20 20 49 66 20 74 68 69 73 20  LE} {.  If this 
4d20: 6d 61 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64  macro is defined
4d30: 2c 20 74 68 65 6e 20 74 68 65 20 73 70 65 63 69  , then the speci
4d40: 61 6c 20 22 24 3c 76 61 72 69 61 62 6c 65 2d 6e  al "$<variable-n
4d50: 61 6d 65 3e 22 20 73 79 6e 74 61 78 0a 20 20 75  ame>" syntax.  u
4d60: 73 65 64 20 74 6f 20 61 75 74 6f 6d 61 74 69 63  sed to automatic
4d70: 61 6c 6c 79 20 62 69 6e 64 20 53 51 4c 20 76 61  ally bind SQL va
4d80: 72 69 61 62 6c 65 73 20 74 6f 20 54 43 4c 20 76  riables to TCL v
4d90: 61 72 69 61 62 6c 65 73 20 69 73 20 6f 6d 69 74  ariables is omit
4da0: 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ted..}..COMPILE_
4db0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
4dc0: 4d 49 54 5f 54 45 4d 50 44 42 7d 20 7b 0a 20 20  MIT_TEMPDB} {.  
4dd0: 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  This option omit
4de0: 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 54 45  s support for TE
4df0: 4d 50 20 6f 72 20 54 45 4d 50 4f 52 41 52 59 20  MP or TEMPORARY 
4e00: 74 61 62 6c 65 73 2e 0a 7d 0a 0a 43 4f 4d 50 49  tables..}..COMPI
4e10: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
4e20: 45 5f 4f 4d 49 54 5f 54 52 41 43 45 7d 20 7b 0a  E_OMIT_TRACE} {.
4e30: 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d    This option om
4e40: 69 74 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20  its support for 
4e50: 74 68 65 20 5b 73 71 6c 69 74 65 33 5f 70 72 6f  the [sqlite3_pro
4e60: 66 69 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73  file()] and.  [s
4e70: 71 6c 69 74 65 33 5f 74 72 61 63 65 28 29 5d 20  qlite3_trace()] 
4e80: 69 6e 74 65 72 66 61 63 65 73 20 61 6e 64 20 74  interfaces and t
4e90: 68 65 69 72 20 61 73 73 6f 63 69 61 74 65 64 20  heir associated 
4ea0: 6c 6f 67 69 63 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  logic..}..COMPIL
4eb0: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
4ec0: 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52 7d 20 7b  _OMIT_TRIGGER} {
4ed0: 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73  .  Defining this
4ee0: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75   option omits su
4ef0: 70 70 6f 72 74 20 66 6f 72 20 56 49 45 57 20 6f  pport for VIEW o
4f00: 62 6a 65 63 74 73 2e 20 4e 65 69 74 68 65 72 20  bjects. Neither 
4f10: 74 68 65 20 0a 20 20 5b 43 52 45 41 54 45 20 54  the .  [CREATE T
4f20: 52 49 47 47 45 52 5d 20 6f 72 20 5b 44 52 4f 50  RIGGER] or [DROP
4f30: 20 54 52 49 47 47 45 52 5d 0a 20 20 63 6f 6d 6d   TRIGGER].  comm
4f40: 61 6e 64 73 20 61 72 65 20 61 76 61 69 6c 61 62  ands are availab
4f50: 6c 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 2c  le in this case,
4f60: 20 61 6e 64 20 61 74 74 65 6d 70 74 69 6e 67 20   and attempting 
4f70: 74 6f 20 65 78 65 63 75 74 65 0a 20 20 65 69 74  to execute.  eit
4f80: 68 65 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20  her will result 
4f90: 69 6e 20 61 20 70 61 72 73 65 20 65 72 72 6f 72  in a parse error
4fa0: 2e 0a 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49 66  ...  WARNING: If
4fb0: 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 64   this macro is d
4fc0: 65 66 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c 20  efined, it will 
4fd0: 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65 20  not be possible 
4fe0: 74 6f 20 6f 70 65 6e 20 61 20 64 61 74 61 62 61  to open a databa
4ff0: 73 65 0a 20 20 66 6f 72 20 77 68 69 63 68 20 74  se.  for which t
5000: 68 65 20 73 63 68 65 6d 61 20 63 6f 6e 74 61 69  he schema contai
5010: 6e 73 20 54 52 49 47 47 45 52 20 6f 62 6a 65 63  ns TRIGGER objec
5020: 74 73 2e 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ts. .}..COMPILE_
5030: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
5040: 4d 49 54 5f 55 54 46 31 36 7d 20 7b 0a 20 20 54  MIT_UTF16} {.  T
5050: 68 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 65  his macro is use
5060: 64 20 74 6f 20 6f 6d 69 74 20 73 75 70 70 6f 72  d to omit suppor
5070: 74 20 66 6f 72 20 55 54 46 31 36 20 74 65 78 74  t for UTF16 text
5080: 20 65 6e 63 6f 64 69 6e 67 2e 20 57 68 65 6e 20   encoding. When 
5090: 74 68 69 73 20 69 73 0a 20 20 64 65 66 69 6e 65  this is.  define
50a0: 64 20 61 6c 6c 20 41 50 49 20 66 75 6e 63 74 69  d all API functi
50b0: 6f 6e 73 20 74 68 61 74 20 72 65 74 75 72 6e 20  ons that return 
50c0: 6f 72 20 61 63 63 65 70 74 20 55 54 46 31 36 20  or accept UTF16 
50d0: 65 6e 63 6f 64 65 64 20 74 65 78 74 20 61 72 65  encoded text are
50e0: 0a 20 20 75 6e 61 76 61 69 6c 61 62 6c 65 2e 20  .  unavailable. 
50f0: 54 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20  These functions 
5100: 63 61 6e 20 62 65 20 69 64 65 6e 74 69 66 69 65  can be identifie
5110: 64 20 62 79 20 74 68 65 20 66 61 63 74 20 74 68  d by the fact th
5120: 61 74 20 74 68 65 79 20 65 6e 64 0a 20 20 77 69  at they end.  wi
5130: 74 68 20 27 31 36 27 2c 20 66 6f 72 20 65 78 61  th '16', for exa
5140: 6d 70 6c 65 20 5b 73 71 6c 69 74 65 33 5f 70 72  mple [sqlite3_pr
5150: 65 70 61 72 65 31 36 28 29 5d 2c 20 5b 73 71 6c  epare16()], [sql
5160: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74  ite3_column_text
5170: 31 36 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71 6c  16()] and.  [sql
5180: 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31 36  ite3_bind_text16
5190: 28 29 5d 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ()]..}..COMPILE_
51a0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
51b0: 4d 49 54 5f 56 41 43 55 55 4d 7d 20 7b 0a 20 20  MIT_VACUUM} {.  
51c0: 57 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e  When this option
51d0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65   is defined, the
51e0: 20 5b 56 41 43 55 55 4d 5d 0a 20 20 63 6f 6d 6d   [VACUUM].  comm
51f0: 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75  and is not inclu
5200: 64 65 64 20 69 6e 20 74 68 65 20 6c 69 62 72 61  ded in the libra
5210: 72 79 2e 0a 20 20 45 78 65 63 75 74 69 6e 67 20  ry..  Executing 
5220: 61 20 5b 56 41 43 55 55 4d 5d 20 73 74 61 74 65  a [VACUUM] state
5230: 6d 65 6e 74 20 63 61 75 73 65 73 20 0a 20 20 61  ment causes .  a
5240: 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a   parse error..}.
5250: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
5260: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 45  {SQLITE_OMIT_VIE
5270: 57 7d 20 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20  W} {.  Defining 
5280: 74 68 69 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74  this option omit
5290: 73 20 73 75 70 70 6f 72 74 20 66 6f 72 20 56 49  s support for VI
52a0: 45 57 20 6f 62 6a 65 63 74 73 2e 20 4e 65 69 74  EW objects. Neit
52b0: 68 65 72 20 74 68 65 20 0a 20 20 5b 43 52 45 41  her the .  [CREA
52c0: 54 45 20 56 49 45 57 5d 20 6e 6f 72 20 74 68 65  TE VIEW] nor the
52d0: 20 5b 44 52 4f 50 20 56 49 45 57 5d 0a 20 20 63   [DROP VIEW].  c
52e0: 6f 6d 6d 61 6e 64 73 20 61 72 65 20 61 76 61 69  ommands are avai
52f0: 6c 61 62 6c 65 20 69 6e 20 74 68 69 73 20 63 61  lable in this ca
5300: 73 65 2c 20 61 6e 64 0a 20 20 61 74 74 65 6d 70  se, and.  attemp
5310: 74 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65 20  ting to execute 
5320: 65 69 74 68 65 72 20 77 69 6c 6c 20 72 65 73 75  either will resu
5330: 6c 74 20 69 6e 20 61 20 70 61 72 73 65 20 65 72  lt in a parse er
5340: 72 6f 72 2e 0a 0a 20 20 57 41 52 4e 49 4e 47 3a  ror...  WARNING:
5350: 20 49 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69   If this macro i
5360: 73 20 64 65 66 69 6e 65 64 2c 20 69 74 20 77 69  s defined, it wi
5370: 6c 6c 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 62  ll not be possib
5380: 6c 65 20 74 6f 20 6f 70 65 6e 20 61 20 64 61 74  le to open a dat
5390: 61 62 61 73 65 0a 20 20 66 6f 72 20 77 68 69 63  abase.  for whic
53a0: 68 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6e  h the schema con
53b0: 74 61 69 6e 73 20 56 49 45 57 20 6f 62 6a 65 63  tains VIEW objec
53c0: 74 73 2e 20 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f  ts. .}..COMPILE_
53d0: 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f  OPTION {SQLITE_O
53e0: 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45  MIT_VIRTUALTABLE
53f0: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
5400: 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74 20  n omits support 
5410: 66 6f 72 20 74 68 65 20 5b 73 71 6c 69 74 65 33  for the [sqlite3
5420: 5f 76 74 61 62 20 7c 20 56 69 72 74 75 61 6c 20  _vtab | Virtual 
5430: 54 61 62 6c 65 5d 0a 20 20 6d 65 63 68 61 6e 69  Table].  mechani
5440: 73 6d 20 69 6e 20 53 51 4c 69 74 65 2e 0a 7d 0a  sm in SQLite..}.
5450: 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20  .COMPILE_OPTION 
5460: 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 58 46 45  {SQLITE_OMIT_XFE
5470: 52 5f 4f 50 54 7d 20 7b 0a 20 20 54 68 69 73 20  R_OPT} {.  This 
5480: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70  option omits sup
5490: 70 6f 72 74 20 66 6f 72 20 6f 70 74 69 6d 69 7a  port for optimiz
54a0: 61 74 69 6f 6e 73 20 74 68 61 74 20 68 65 6c 70  ations that help
54b0: 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 6f 66   statements.  of
54c0: 20 74 68 65 20 66 6f 72 6d 20 22 49 4e 53 45 52   the form "INSER
54d0: 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45 4c 45 43  T INTO ... SELEC
54e0: 54 20 2e 2e 2e 22 20 72 75 6e 20 66 61 73 74 65  T ..." run faste
54f0: 72 2e 0a 7d 0a 3c 2f 74 63 6c 3e 0a              r..}.</tcl>.