Documentation Source Text

Hex Artifact Content
Login

Artifact 37e8f93e3f12ca0ed1bd329f634a86bf85055671:


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 68 64 5f  me</b></p>.  hd_
0410: 72 65 73 6f 6c 76 65 20 3c 62 6c 6f 63 6b 71 75  resolve <blockqu
0420: 6f 74 65 3e 24 74 65 78 74 3c 2f 62 6c 6f 63 6b  ote>$text</block
0430: 71 75 6f 74 65 3e 0a 7d 0a 0a 43 4f 4d 50 49 4c  quote>.}..COMPIL
0440: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
0450: 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43  _DEFAULT_AUTOVAC
0460: 55 55 4d 3d 3c 69 3e 26 6c 74 3b 31 20 6f 72 20  UUM=<i>&lt;1 or 
0470: 30 26 67 74 3b 3c 2f 69 3e 7d 20 7b 0a 20 20 54  0&gt;</i>} {.  T
0480: 68 69 73 20 6d 61 63 72 6f 20 64 65 74 65 72 6d  his macro determ
0490: 69 6e 65 73 20 69 66 20 53 51 4c 69 74 65 20 63  ines if SQLite c
04a0: 72 65 61 74 65 73 20 64 61 74 61 62 61 73 65 73  reates databases
04b0: 20 77 69 74 68 20 74 68 65 20 0a 20 20 5b 61 75   with the .  [au
04c0: 74 6f 5f 76 61 63 75 75 6d 5d 20 66 6c 61 67 20  to_vacuum] flag 
04d0: 73 65 74 20 62 79 20 64 65 66 61 75 6c 74 2e 20  set by default. 
04e0: 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75  The default valu
04f0: 65 20 69 73 20 30 20 0a 20 20 28 64 6f 20 6e 6f  e is 0 .  (do no
0500: 74 20 63 72 65 61 74 65 20 61 75 74 6f 2d 76 61  t create auto-va
0510: 63 75 75 6d 20 64 61 74 61 62 61 73 65 73 29 2e  cuum databases).
0520: 20 49 6e 20 61 6e 79 20 63 61 73 65 20 74 68 65   In any case the
0530: 0a 20 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  .  compile-time 
0540: 64 65 66 61 75 6c 74 20 6d 61 79 20 62 65 20 6f  default may be o
0550: 76 65 72 72 69 64 64 65 6e 20 62 79 20 74 68 65  verridden by the
0560: 20 0a 20 20 5b 50 52 41 47 4d 41 20 61 75 74 6f   .  [PRAGMA auto
0570: 5f 76 61 63 75 75 6d 5d 20 63 6f 6d 6d 61 6e 64  _vacuum] command
0580: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
0590: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 44 45 46 41  ION {SQLITE_DEFA
05a0: 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a 45 3d 3c  ULT_CACHE_SIZE=<
05b0: 69 3e 26 6c 74 3b 70 61 67 65 73 26 67 74 3b 3c  i>&lt;pages&gt;<
05c0: 2f 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61  /i>} {.  This ma
05d0: 63 72 6f 20 73 65 74 73 20 74 68 65 20 64 65 66  cro sets the def
05e0: 61 75 6c 74 20 73 69 7a 65 20 6f 66 20 74 68 65  ault size of the
05f0: 20 70 61 67 65 2d 63 61 63 68 65 20 66 6f 72 20   page-cache for 
0600: 65 61 63 68 20 61 74 74 61 63 68 65 64 0a 20 20  each attached.  
0610: 64 61 74 61 62 61 73 65 2c 20 69 6e 20 70 61 67  database, in pag
0620: 65 73 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20  es. This can be 
0630: 6f 76 65 72 72 69 64 64 65 6e 20 62 79 20 74 68  overridden by th
0640: 65 20 0a 20 20 5b 50 52 41 47 4d 41 20 63 61 63  e .  [PRAGMA cac
0650: 68 65 5f 73 69 7a 65 5d 20 63 6f 6d 61 6d 6e 64  he_size] comamnd
0660: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61  . The default va
0670: 6c 75 65 20 69 73 20 32 30 30 30 2e 0a 7d 0a 0a  lue is 2000..}..
0680: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
0690: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 50  SQLITE_DEFAULT_P
06a0: 41 47 45 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74 3b  AGE_SIZE=<i>&lt;
06b0: 62 79 74 65 73 26 67 74 3b 3c 2f 69 3e 7d 20 7b  bytes&gt;</i>} {
06c0: 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 69 73  .  This macro is
06d0: 20 75 73 65 64 20 74 6f 20 73 65 74 20 74 68 65   used to set the
06e0: 20 64 65 66 61 75 6c 74 20 70 61 67 65 2d 73 69   default page-si
06f0: 7a 65 20 75 73 65 64 20 77 68 65 6e 20 61 0a 20  ze used when a. 
0700: 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72 65   database is cre
0710: 61 74 65 64 2e 20 54 68 65 20 76 61 6c 75 65 20  ated. The value 
0720: 61 73 73 69 67 6e 65 64 20 6d 75 73 74 20 62 65  assigned must be
0730: 20 61 20 70 6f 77 65 72 20 6f 66 20 32 2e 20 54   a power of 2. T
0740: 68 65 0a 20 20 64 65 66 61 75 6c 74 20 76 61 6c  he.  default val
0750: 75 65 20 69 73 20 31 30 32 34 2e 20 54 68 65 20  ue is 1024. The 
0760: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 64 65 66  compile-time def
0770: 61 75 6c 74 20 6d 61 79 20 62 65 20 6f 76 65 72  ault may be over
0780: 72 69 64 64 65 6e 20 61 74 20 0a 20 20 72 75 6e  ridden at .  run
0790: 74 69 6d 65 20 62 79 20 74 68 65 20 5b 50 52 41  time by the [PRA
07a0: 47 4d 41 20 70 61 67 65 5f 73 69 7a 65 5d 20 63  GMA page_size] c
07b0: 6f 6d 6d 61 6e 64 2e 0a 7d 0a 0a 43 4f 4d 50 49  ommand..}..COMPI
07c0: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
07d0: 45 5f 44 45 46 41 55 4c 54 5f 54 45 4d 50 5f 43  E_DEFAULT_TEMP_C
07e0: 41 43 48 45 5f 53 49 5a 45 3d 3c 69 3e 26 6c 74  ACHE_SIZE=<i>&lt
07f0: 3b 70 61 67 65 73 26 67 74 3b 3c 2f 69 3e 7d 20  ;pages&gt;</i>} 
0800: 7b 0a 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73  {.  This macro s
0810: 65 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20  ets the default 
0820: 73 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67 65  size of the page
0830: 2d 63 61 63 68 65 20 66 6f 72 20 74 65 6d 70 6f  -cache for tempo
0840: 72 61 72 79 20 66 69 6c 65 73 0a 20 20 63 72 65  rary files.  cre
0850: 61 74 65 64 20 62 79 20 53 51 4c 69 74 65 20 74  ated by SQLite t
0860: 6f 20 73 74 6f 72 65 20 69 6e 74 65 72 6d 65 64  o store intermed
0870: 69 61 74 65 20 72 65 73 75 6c 74 73 2c 20 69 6e  iate results, in
0880: 20 70 61 67 65 73 2e 20 49 74 20 64 6f 65 73 0a   pages. It does.
0890: 20 20 6e 6f 74 20 61 66 66 65 63 74 20 74 68 65    not affect the
08a0: 20 70 61 67 65 2d 63 61 63 68 65 20 66 6f 72 20   page-cache for 
08b0: 74 68 65 20 74 65 6d 70 20 64 61 74 61 62 61 73  the temp databas
08c0: 65 2c 20 77 68 65 72 65 20 74 61 62 6c 65 73 20  e, where tables 
08d0: 63 72 65 61 74 65 64 0a 20 20 75 73 69 6e 67 20  created.  using 
08e0: 5b 43 52 45 41 54 45 20 54 41 42 4c 45 20 7c 20  [CREATE TABLE | 
08f0: 43 52 45 41 54 45 20 54 45 4d 50 20 54 41 42 4c  CREATE TEMP TABL
0900: 45 5d 20 61 72 65 20 73 74 6f 72 65 64 2e 20 54  E] are stored. T
0910: 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65  he default value
0920: 0a 20 20 69 73 20 35 30 30 2e 0a 7d 0a 3c 2f 74  .  is 500..}.</t
0930: 63 6c 3e 0a 0a 3c 68 32 3e 31 2e 32 20 4f 70 74  cl>..<h2>1.2 Opt
0940: 69 6f 6e 73 20 54 6f 20 53 65 74 20 53 69 7a 65  ions To Set Size
0950: 20 4c 69 6d 69 74 73 3c 2f 68 32 3e 0a 0a 3c 70   Limits</h2>..<p
0960: 3e 54 68 65 72 65 20 61 72 65 20 63 6f 6d 70 69  >There are compi
0970: 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73 20  le-time options 
0980: 74 68 61 74 20 77 69 6c 6c 20 73 65 74 20 75 70  that will set up
0990: 70 65 72 20 62 6f 75 6e 64 73 0a 6f 6e 20 74 68  per bounds.on th
09a0: 65 20 73 69 7a 65 73 20 6f 66 20 76 61 72 69 6f  e sizes of vario
09b0: 75 73 20 73 74 72 75 63 74 75 72 65 73 20 69 6e  us structures in
09c0: 20 53 51 4c 69 74 65 2e 20 20 54 68 65 20 63 6f   SQLite.  The co
09d0: 6d 70 69 6c 65 2d 74 69 6d 65 0a 6f 70 74 69 6f  mpile-time.optio
09e0: 6e 73 20 6e 6f 72 6d 61 6c 6c 79 20 73 65 74 20  ns normally set 
09f0: 61 20 68 61 72 64 20 75 70 70 65 72 20 62 6f 75  a hard upper bou
0a00: 6e 64 20 77 68 69 63 68 20 63 61 6e 20 62 65 20  nd which can be 
0a10: 63 68 61 6e 67 65 64 0a 61 74 20 72 75 6e 2d 74  changed.at run-t
0a20: 69 6d 65 20 6f 6e 20 69 6e 64 69 76 69 64 75 61  ime on individua
0a30: 6c 20 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  l [database conn
0a40: 65 63 74 69 6f 6e 73 5d 20 75 73 69 6e 67 20 74  ections] using t
0a50: 68 65 0a 5b 73 71 6c 69 74 65 33 5f 6c 69 6d 69  he.[sqlite3_limi
0a60: 74 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e 3c  t()] interface.<
0a70: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f 6d 70  /p>..<p>The comp
0a80: 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 73  ile-time options
0a90: 20 66 6f 72 20 73 65 74 74 69 6e 67 20 75 70 70   for setting upp
0aa0: 65 72 20 62 6f 75 6e 64 73 20 61 72 65 0a 5b 6c  er bounds are.[l
0ab0: 69 6d 69 74 73 20 7c 20 64 6f 63 75 6d 65 6e 74  imits | document
0ac0: 65 64 20 73 65 70 61 72 61 74 65 6c 79 5d 2e 20  ed separately]. 
0ad0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69   The following i
0ae0: 73 20 61 20 6c 69 73 74 20 6f 66 0a 74 68 65 20  s a list of.the 
0af0: 61 76 61 69 6c 61 62 6c 65 20 73 65 74 74 69 6e  available settin
0b00: 67 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c  gs:</p>..<ul>.<l
0b10: 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 41  i> [SQLITE_MAX_A
0b20: 54 54 41 43 48 45 44 5d 20 20 3c 2f 6c 69 3e 0a  TTACHED]  </li>.
0b30: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
0b40: 5f 43 4f 4c 55 4d 4e 5d 20 20 3c 2f 6c 69 3e 0a  _COLUMN]  </li>.
0b50: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
0b60: 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45 4c 45 43 54  _COMPOUND_SELECT
0b70: 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53  ]  </li>.<li> [S
0b80: 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44  QLITE_MAX_EXPR_D
0b90: 45 50 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69  EPTH]  </li>.<li
0ba0: 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 46 55  > [SQLITE_MAX_FU
0bb0: 4e 43 54 49 4f 4e 5f 41 52 47 5d 20 20 3c 2f 6c  NCTION_ARG]  </l
0bc0: 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  i>.<li> [SQLITE_
0bd0: 4d 41 58 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c  MAX_LENGTH]  </l
0be0: 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f  i>.<li> [SQLITE_
0bf0: 4d 41 58 5f 4c 49 4b 45 5f 50 41 54 54 45 52 4e  MAX_LIKE_PATTERN
0c00: 5f 4c 45 4e 47 54 48 5d 20 20 3c 2f 6c 69 3e 0a  _LENGTH]  </li>.
0c10: 3c 6c 69 3e 20 5b 53 51 4c 49 54 45 5f 4d 41 58  <li> [SQLITE_MAX
0c20: 5f 50 41 47 45 5f 43 4f 55 4e 54 5d 20 20 3c 2f  _PAGE_COUNT]  </
0c30: 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c 49 54 45  li>.<li> [SQLITE
0c40: 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 5d 20  _MAX_PAGE_SIZE] 
0c50: 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 53 51 4c   </li>.<li> [SQL
0c60: 49 54 45 5f 4d 41 58 5f 53 51 4c 5f 4c 45 4e 47  ITE_MAX_SQL_LENG
0c70: 54 48 5d 20 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20  TH]  </li>.<li> 
0c80: 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49  [SQLITE_MAX_VARI
0c90: 41 42 4c 45 5f 4e 55 4d 42 45 52 5d 20 20 3c 2f  ABLE_NUMBER]  </
0ca0: 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 61 20 6e 61  li>.</ul>..<a na
0cb0: 6d 65 3d 22 63 6f 6e 74 72 6f 6c 66 65 61 74 75  me="controlfeatu
0cc0: 72 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e  res"></a>.<h2>1.
0cd0: 33 20 4f 70 74 69 6f 6e 73 20 54 6f 20 43 6f 6e  3 Options To Con
0ce0: 74 72 6f 6c 20 4f 70 65 72 61 74 69 6e 67 20 43  trol Operating C
0cf0: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 3c 2f  haracteristics</
0d00: 68 32 3e 0a 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49  h2>..<tcl>.COMPI
0d10: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
0d20: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 3c 69 3e  E_THREADSAFE=<i>
0d30: 26 6c 74 3b 30 20 6f 72 20 31 26 67 74 3b 3c 2f  &lt;0 or 1&gt;</
0d40: 69 3e 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74  i>} {.  This opt
0d50: 69 6f 6e 20 63 6f 6e 74 72 6f 6c 73 20 77 68 65  ion controls whe
0d60: 74 68 65 72 20 6f 72 20 6e 6f 74 20 63 6f 64 65  ther or not code
0d70: 20 69 73 20 69 6e 63 6c 75 64 65 64 20 69 6e 20   is included in 
0d80: 53 51 4c 69 74 65 20 74 6f 0a 20 20 65 6e 61 62  SQLite to.  enab
0d90: 6c 65 20 69 74 20 74 6f 20 6f 70 65 72 61 74 65  le it to operate
0da0: 20 73 61 66 65 6c 79 20 69 6e 20 61 20 6d 75 6c   safely in a mul
0db0: 74 69 74 68 72 65 61 64 65 64 20 65 6e 76 69 72  tithreaded envir
0dc0: 6f 6e 6d 65 6e 74 2e 20 20 54 68 65 0a 20 20 64  onment.  The.  d
0dd0: 65 66 61 75 6c 74 20 69 73 20 53 51 4c 49 54 45  efault is SQLITE
0de0: 5f 54 48 52 45 41 44 53 41 46 45 3d 31 20 77 68  _THREADSAFE=1 wh
0df0: 69 63 68 20 69 73 20 73 61 66 65 20 66 6f 72 20  ich is safe for 
0e00: 75 73 65 20 69 6e 20 61 20 6d 75 6c 74 69 74 68  use in a multith
0e10: 72 65 61 64 65 64 0a 20 20 65 6e 76 69 72 6f 6e  readed.  environ
0e20: 6d 65 6e 74 2e 20 20 57 68 65 6e 20 63 6f 6d 70  ment.  When comp
0e30: 69 6c 65 64 20 77 69 74 68 20 53 51 4c 49 54 45  iled with SQLITE
0e40: 5f 54 48 52 45 41 44 53 41 46 45 3d 30 20 61 6c  _THREADSAFE=0 al
0e50: 6c 20 6d 75 74 65 78 69 6e 67 20 63 6f 64 65 0a  l mutexing code.
0e60: 20 20 69 73 20 6f 6d 69 74 74 65 64 20 61 6e 64    is omitted and
0e70: 20 69 74 20 69 73 20 75 6e 73 61 66 65 20 74 6f   it is unsafe to
0e80: 20 75 73 65 20 53 51 4c 69 74 65 20 69 6e 20 61   use SQLite in a
0e90: 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 70   multithreaded p
0ea0: 72 6f 67 72 61 6d 2e 0a 0a 20 20 3c 70 3e 54 68  rogram...  <p>Th
0eb0: 65 20 76 61 6c 75 65 20 6f 66 20 53 51 4c 49 54  e value of SQLIT
0ec0: 45 5f 54 48 52 45 41 44 53 41 46 45 20 63 61 6e  E_THREADSAFE can
0ed0: 20 62 65 20 64 65 74 65 72 6d 69 6e 65 64 20 61   be determined a
0ee0: 74 20 72 75 6e 2d 74 69 6d 65 0a 20 20 75 73 69  t run-time.  usi
0ef0: 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  ng the [sqlite3_
0f00: 74 68 72 65 61 64 73 61 66 65 28 29 5d 20 69 6e  threadsafe()] in
0f10: 74 65 72 66 61 63 65 2e 3c 2f 70 3e 0a 0a 20 20  terface.</p>..  
0f20: 3c 70 3e 57 68 65 6e 20 53 51 4c 69 74 65 20 68  <p>When SQLite h
0f30: 61 73 20 62 65 65 6e 20 63 6f 6d 70 69 6c 65 64  as been compiled
0f40: 20 77 69 74 68 20 53 51 4c 49 54 45 5f 54 48 52   with SQLITE_THR
0f50: 45 41 44 53 41 46 45 3d 31 20 74 68 65 6e 20 6d  EADSAFE=1 then m
0f60: 75 74 65 78 69 6e 67 0a 20 20 63 61 6e 20 62 65  utexing.  can be
0f70: 20 64 69 73 61 62 6c 65 64 20 61 74 20 72 75 6e   disabled at run
0f80: 2d 74 69 6d 65 20 75 73 69 6e 67 20 74 68 65 20  -time using the 
0f90: 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28  [sqlite3_config(
0fa0: 29 5d 20 69 6e 74 65 72 66 61 63 65 20 74 6f 67  )] interface tog
0fb0: 65 74 68 65 72 0a 20 20 77 69 74 68 20 74 68 65  ether.  with the
0fc0: 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f   [SQLITE_CONFIG_
0fd0: 53 49 4e 47 4c 45 54 48 52 45 41 44 5d 2c 20 5b  SINGLETHREAD], [
0fe0: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55  SQLITE_CONFIG_MU
0ff0: 4c 54 49 54 48 52 45 41 44 5d 2c 20 61 6e 64 0a  LTITHREAD], and.
1000: 20 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47    [SQLITE_CONFIG
1010: 5f 53 45 52 49 41 4c 49 5a 45 44 5d 20 76 65 72  _SERIALIZED] ver
1020: 62 73 2e 3c 2f 70 3e 0a 7d 0a 3c 2f 74 63 6c 3e  bs.</p>.}.</tcl>
1030: 0a 0a 3c 61 20 6e 61 6d 65 3d 22 65 6e 61 62 6c  ..<a name="enabl
1040: 65 66 65 61 74 75 72 65 73 22 3e 3c 2f 61 3e 0a  efeatures"></a>.
1050: 3c 68 32 3e 31 2e 34 20 4f 70 74 69 6f 6e 73 20  <h2>1.4 Options 
1060: 54 6f 20 45 6e 61 62 6c 65 20 46 65 61 74 75 72  To Enable Featur
1070: 65 73 20 4e 6f 72 6d 61 6c 6c 79 20 54 75 72 6e  es Normally Turn
1080: 65 64 20 4f 66 66 3c 2f 68 32 3e 0a 0a 3c 61 20  ed Off</h2>..<a 
1090: 6e 61 6d 65 3d 22 6f 6d 69 74 66 65 61 74 75 72  name="omitfeatur
10a0: 65 73 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 35  es"></a>.<h2>1.5
10b0: 20 4f 70 74 69 6f 6e 73 20 54 6f 20 4f 6d 69 74   Options To Omit
10c0: 20 46 65 61 74 75 72 65 73 3c 2f 68 32 3e 0a 0a   Features</h2>..
10d0: 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  <p>The following
10e0: 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 75 73 65   options are use
10f0: 64 20 74 6f 20 72 65 64 75 63 65 20 74 68 65 20  d to reduce the 
1100: 73 69 7a 65 20 6f 66 20 74 68 65 20 63 6f 6d 70  size of the comp
1110: 69 6c 65 64 0a 6c 69 62 72 61 72 79 20 62 79 20  iled.library by 
1120: 6f 6d 69 74 69 6e 67 20 6f 70 74 69 6f 6e 61 6c  omiting optional
1130: 20 66 65 61 74 75 72 65 73 2e 20 54 68 69 73 20   features. This 
1140: 69 73 20 70 72 6f 62 61 62 6c 79 20 6f 6e 6c 79  is probably only
1150: 20 75 73 65 66 75 6c 0a 69 6e 20 65 6d 62 65 64   useful.in embed
1160: 64 65 64 20 73 79 73 74 65 6d 73 20 77 68 65 72  ded systems wher
1170: 65 20 73 70 61 63 65 20 69 73 20 65 73 70 65 63  e space is espec
1180: 69 61 6c 6c 79 20 74 69 67 68 74 2c 20 61 73 20  ially tight, as 
1190: 65 76 65 6e 20 77 69 74 68 20 61 6c 6c 0a 66 65  even with all.fe
11a0: 61 74 75 72 65 73 20 69 6e 63 6c 75 64 65 64 20  atures included 
11b0: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
11c0: 72 79 20 69 73 20 72 65 6c 61 74 69 76 65 6c 79  ry is relatively
11d0: 20 73 6d 61 6c 6c 2e 20 44 6f 6e 27 74 20 66 6f   small. Don't fo
11e0: 72 67 65 74 0a 74 6f 20 74 65 6c 6c 20 79 6f 75  rget.to tell you
11f0: 72 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20 6f 70  r compiler to op
1200: 74 69 6d 69 7a 65 20 66 6f 72 20 62 69 6e 61 72  timize for binar
1210: 79 20 73 69 7a 65 21 20 28 74 68 65 20 2d 4f 73  y size! (the -Os
1220: 20 6f 70 74 69 6f 6e 20 69 66 0a 75 73 69 6e 67   option if.using
1230: 20 47 43 43 29 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54   GCC).</p>..<p>T
1240: 68 65 20 6d 61 63 72 6f 73 20 69 6e 20 74 68 69  he macros in thi
1250: 73 20 73 65 63 74 69 6f 6e 20 64 6f 20 6e 6f 74  s section do not
1260: 20 72 65 71 75 69 72 65 20 76 61 6c 75 65 73 2e   require values.
1270: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a   The following .
1280: 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 73 77 69 74  compilation swit
1290: 63 68 65 73 20 61 6c 6c 20 68 61 76 65 20 74 68  ches all have th
12a0: 65 20 73 61 6d 65 20 65 66 66 65 63 74 3a 3c 62  e same effect:<b
12b0: 72 3e 0a 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54  r>.-DSQLITE_OMIT
12c0: 5f 41 4c 54 45 52 54 41 42 4c 45 3c 62 72 3e 0a  _ALTERTABLE<br>.
12d0: 2d 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c  -DSQLITE_OMIT_AL
12e0: 54 45 52 54 41 42 4c 45 3d 31 3c 62 72 3e 0a 2d  TERTABLE=1<br>.-
12f0: 44 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54  DSQLITE_OMIT_ALT
1300: 45 52 54 41 42 4c 45 3d 30 0a 3c 2f 70 3e 0a 0a  ERTABLE=0.</p>..
1310: 3c 70 3e 49 66 20 61 6e 79 20 6f 66 20 74 68 65  <p>If any of the
1320: 73 65 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 64  se options are d
1330: 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68 65  efined, then the
1340: 20 73 61 6d 65 20 73 65 74 20 6f 66 20 53 51 4c   same set of SQL
1350: 49 54 45 5f 4f 4d 49 54 5f 58 58 58 0a 6f 70 74  ITE_OMIT_XXX.opt
1360: 69 6f 6e 73 20 6d 75 73 74 20 61 6c 73 6f 20 62  ions must also b
1370: 65 20 64 65 66 69 6e 65 64 20 77 68 65 6e 20 75  e defined when u
1380: 73 69 6e 67 20 74 68 65 20 27 6c 65 6d 6f 6e 27  sing the 'lemon'
1390: 20 74 6f 6f 6c 20 74 6f 20 67 65 6e 65 72 61 74   tool to generat
13a0: 65 20 61 20 70 61 72 73 65 2e 63 0a 66 69 6c 65  e a parse.c.file
13b0: 2e 20 42 65 63 61 75 73 65 20 6f 66 20 74 68 69  . Because of thi
13c0: 73 2c 20 74 68 65 73 65 20 6f 70 74 69 6f 6e 73  s, these options
13d0: 20 6d 61 79 20 6f 6e 6c 79 20 75 73 65 64 20 77   may only used w
13e0: 68 65 6e 20 74 68 65 20 6c 69 62 72 61 72 79 20  hen the library 
13f0: 69 73 20 62 75 69 6c 74 0a 66 72 6f 6d 20 73 6f  is built.from so
1400: 75 72 63 65 2c 20 6e 6f 74 20 66 72 6f 6d 20 74  urce, not from t
1410: 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66  he collection of
1420: 20 70 72 65 2d 70 61 63 6b 61 67 65 64 20 43 20   pre-packaged C 
1430: 66 69 6c 65 73 20 70 72 6f 76 69 64 65 64 20 66  files provided f
1440: 6f 72 0a 6e 6f 6e 2d 55 4e 49 58 20 6c 69 6b 65  or.non-UNIX like
1450: 20 70 6c 61 74 66 6f 72 6d 73 20 6f 6e 20 74 68   platforms on th
1460: 65 20 77 65 62 73 69 74 65 2e 0a 3c 2f 70 3e 0a  e website..</p>.
1470: 0a 3c 74 63 6c 3e 0a 43 4f 4d 50 49 4c 45 5f 4f  .<tcl>.COMPILE_O
1480: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
1490: 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 7d 20 7b  IT_ALTERTABLE} {
14a0: 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70 74  .  When this opt
14b0: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20  ion is defined, 
14c0: 74 68 65 20 0a 20 20 5b 41 4c 54 45 52 20 54 41  the .  [ALTER TA
14d0: 42 4c 45 5d 20 63 6f 6d 6d 61 6e 64 20 69 73 20  BLE] command is 
14e0: 6e 6f 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20  not included in 
14f0: 74 68 65 20 0a 20 20 6c 69 62 72 61 72 79 2e 20  the .  library. 
1500: 45 78 65 63 75 74 69 6e 67 20 61 6e 20 5b 41 4c  Executing an [AL
1510: 54 45 52 20 54 41 42 4c 45 5d 20 73 74 61 74 65  TER TABLE] state
1520: 6d 65 6e 74 20 63 61 75 73 65 73 20 61 20 70 61  ment causes a pa
1530: 72 73 65 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f  rse error..}..CO
1540: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
1550: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52  LITE_OMIT_AUTHOR
1560: 49 5a 41 54 49 4f 4e 7d 20 7b 0a 20 20 44 65 66  IZATION} {.  Def
1570: 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69 6f  ining this optio
1580: 6e 20 6f 6d 69 74 73 20 74 68 65 20 61 75 74 68  n omits the auth
1590: 6f 72 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62 61  orization callba
15a0: 63 6b 20 66 65 61 74 75 72 65 20 66 72 6f 6d 20  ck feature from 
15b0: 74 68 65 0a 20 20 6c 69 62 72 61 72 79 2e 20 54  the.  library. T
15c0: 68 65 20 5b 73 71 6c 69 74 65 33 5f 73 65 74 5f  he [sqlite3_set_
15d0: 61 75 74 68 6f 72 69 7a 65 72 28 29 5d 20 41 50  authorizer()] AP
15e0: 49 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f  I function is no
15f0: 74 20 70 72 65 73 65 6e 74 0a 20 20 69 6e 20 74  t present.  in t
1600: 68 65 20 6c 69 62 72 61 72 79 2e 0a 7d 0a 0a 43  he library..}..C
1610: 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53  OMPILE_OPTION {S
1620: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56  QLITE_OMIT_AUTOV
1630: 41 43 55 55 4d 7d 20 7b 0a 20 20 49 66 20 74 68  ACUUM} {.  If th
1640: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66  is option is def
1650: 69 6e 65 64 2c 20 74 68 65 20 6c 69 62 72 61 72  ined, the librar
1660: 79 20 63 61 6e 6e 6f 74 20 63 72 65 61 74 65 20  y cannot create 
1670: 6f 72 20 77 72 69 74 65 20 74 6f 20 0a 20 20 64  or write to .  d
1680: 61 74 61 62 61 73 65 73 20 74 68 61 74 20 73 75  atabases that su
1690: 70 70 6f 72 74 20 5b 61 75 74 6f 5f 76 61 63 75  pport [auto_vacu
16a0: 75 6d 5d 2e 0a 20 20 45 78 65 63 75 74 69 6e 67  um]..  Executing
16b0: 20 61 20 5b 50 52 41 47 4d 41 20 61 75 74 6f 5f   a [PRAGMA auto_
16c0: 76 61 63 75 75 6d 5d 20 73 74 61 74 65 6d 65 6e  vacuum] statemen
16d0: 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 72 72 6f  t is not an erro
16e0: 72 0a 20 20 28 73 69 6e 63 65 20 75 6e 6b 6e 6f  r.  (since unkno
16f0: 77 6e 20 50 52 41 47 4d 41 73 20 61 72 65 20 73  wn PRAGMAs are s
1700: 69 6c 65 6e 74 6c 79 20 69 67 6e 6f 72 65 64 29  ilently ignored)
1710: 2c 20 62 75 74 20 64 6f 65 73 20 6e 6f 74 20 72  , but does not r
1720: 65 74 75 72 6e 20 61 20 76 61 6c 75 65 0a 20 20  eturn a value.  
1730: 6f 72 20 6d 6f 64 69 66 79 20 74 68 65 20 61 75  or modify the au
1740: 74 6f 2d 76 61 63 75 75 6d 20 66 6c 61 67 20 69  to-vacuum flag i
1750: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  n the database f
1760: 69 6c 65 2e 20 49 66 20 61 20 64 61 74 61 62 61  ile. If a databa
1770: 73 65 20 74 68 61 74 0a 20 20 73 75 70 70 6f 72  se that.  suppor
1780: 74 73 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 69  ts auto-vacuum i
1790: 73 20 6f 70 65 6e 65 64 20 62 79 20 61 20 6c 69  s opened by a li
17a0: 62 72 61 72 79 20 63 6f 6d 70 69 6c 65 64 20 77  brary compiled w
17b0: 69 74 68 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c  ith this option,
17c0: 20 69 74 0a 20 20 69 73 20 61 75 74 6f 6d 61 74   it.  is automat
17d0: 69 63 61 6c 6c 79 20 6f 70 65 6e 65 64 20 69 6e  ically opened in
17e0: 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 6f 64 65 2e   read-only mode.
17f0: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
1800: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
1810: 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 7d 20 7b  AUTOINCREMENT} {
1820: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69  .  This option i
1830: 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74  s used to omit t
1840: 68 65 20 0a 20 20 5b 41 55 54 4f 49 4e 43 52 45  he .  [AUTOINCRE
1850: 4d 45 4e 54 5d 20 66 75 6e 63 74 69 6f 6e 61 6c  MENT] functional
1860: 69 74 79 2e 20 57 68 65 6e 20 74 68 69 73 20 0a  ity. When this .
1870: 20 20 69 73 20 6d 61 63 72 6f 20 69 73 20 64 65    is macro is de
1880: 66 69 6e 65 64 2c 20 63 6f 6c 75 6d 6e 73 20 64  fined, columns d
1890: 65 63 6c 61 72 65 64 20 61 73 20 0a 20 20 22 5b  eclared as .  "[
18a0: 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20  INTEGER PRIMARY 
18b0: 4b 45 59 5d 20 41 55 54 4f 49 4e 43 52 45 4d 45  KEY] AUTOINCREME
18c0: 4e 54 22 0a 20 20 62 65 68 61 76 65 20 69 6e 20  NT".  behave in 
18d0: 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 20  the same way as 
18e0: 63 6f 6c 75 6d 6e 73 20 64 65 63 6c 61 72 65 64  columns declared
18f0: 20 61 73 20 22 5b 49 4e 54 45 47 45 52 20 50 52   as "[INTEGER PR
1900: 49 4d 41 52 59 20 4b 45 59 5d 22 20 77 68 65 6e  IMARY KEY]" when
1910: 20 61 20 0a 20 20 4e 55 4c 4c 20 69 73 20 69 6e   a .  NULL is in
1920: 73 65 72 74 65 64 2e 20 54 68 65 20 73 71 6c 69  serted. The sqli
1930: 74 65 5f 73 65 71 75 65 6e 63 65 20 73 79 73 74  te_sequence syst
1940: 65 6d 20 74 61 62 6c 65 20 69 73 20 6e 65 69 74  em table is neit
1950: 68 65 72 20 63 72 65 61 74 65 64 2c 20 6e 6f 72  her created, nor
1960: 0a 20 20 72 65 73 70 65 63 74 65 64 20 69 66 20  .  respected if 
1970: 69 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 74  it already exist
1980: 73 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  s..}..COMPILE_OP
1990: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
19a0: 54 5f 42 4c 4f 42 5f 4c 49 54 45 52 41 4c 7d 20  T_BLOB_LITERAL} 
19b0: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 6f 70  {.  When this op
19c0: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c  tion is defined,
19d0: 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69   it is not possi
19e0: 62 6c 65 20 74 6f 20 73 70 65 63 69 66 79 20 61  ble to specify a
19f0: 20 62 6c 6f 62 20 69 6e 0a 20 20 61 6e 20 53 51   blob in.  an SQ
1a00: 4c 20 73 74 61 74 65 6d 65 6e 74 20 75 73 69 6e  L statement usin
1a10: 67 20 74 68 65 20 58 27 41 42 43 44 27 20 73 79  g the X'ABCD' sy
1a20: 6e 74 61 78 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  ntax..}..COMPILE
1a30: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
1a40: 4f 4d 49 54 5f 43 4f 4d 50 4c 45 54 45 7d 20 7b  OMIT_COMPLETE} {
1a50: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 63  .  This option c
1a60: 61 75 73 65 73 20 74 68 65 20 5b 73 71 6c 69 74  auses the [sqlit
1a70: 65 33 5f 63 6f 6d 70 6c 65 74 65 28 29 5d 20 61  e3_complete()] a
1a80: 6e 64 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6d 70  nd [sqlite3_comp
1a90: 6c 65 74 65 31 36 28 29 5d 0a 20 20 69 6e 74 65  lete16()].  inte
1aa0: 72 66 61 63 65 73 20 74 6f 20 62 65 20 6f 6d 69  rfaces to be omi
1ab0: 74 74 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  tted..}..COMPILE
1ac0: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
1ad0: 4f 4d 49 54 5f 43 4f 4d 50 4f 55 4e 44 5f 53 45  OMIT_COMPOUND_SE
1ae0: 4c 45 43 54 7d 20 7b 0a 20 20 54 68 69 73 20 6f  LECT} {.  This o
1af0: 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f  ption is used to
1b00: 20 6f 6d 69 74 20 74 68 65 20 63 6f 6d 70 6f 75   omit the compou
1b10: 6e 64 20 5b 53 45 4c 45 43 54 5d 20 66 75 6e 63  nd [SELECT] func
1b20: 74 69 6f 6e 61 6c 69 74 79 2e 20 0a 20 20 5b 53  tionality. .  [S
1b30: 45 4c 45 43 54 5d 20 73 74 61 74 65 6d 65 6e 74  ELECT] statement
1b40: 73 20 74 68 61 74 20 75 73 65 20 74 68 65 20 0a  s that use the .
1b50: 20 20 55 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41    UNION, UNION A
1b60: 4c 4c 2c 20 49 4e 54 45 52 53 45 43 54 20 6f 72  LL, INTERSECT or
1b70: 20 45 58 43 45 50 54 20 63 6f 6d 70 6f 75 6e 64   EXCEPT compound
1b80: 20 53 45 4c 45 43 54 20 6f 70 65 72 61 74 6f 72   SELECT operator
1b90: 73 20 77 69 6c 6c 20 0a 20 20 63 61 75 73 65 20  s will .  cause 
1ba0: 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d  a parse error..}
1bb0: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
1bc0: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f   {SQLITE_OMIT_CO
1bd0: 4e 46 4c 49 43 54 5f 43 4c 41 55 53 45 7d 20 7b  NFLICT_CLAUSE} {
1be0: 0a 20 20 49 6e 20 74 68 65 20 66 75 74 75 72 65  .  In the future
1bf0: 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 77 69  , this option wi
1c00: 6c 6c 20 62 65 20 75 73 65 64 20 74 6f 20 6f 6d  ll be used to om
1c10: 69 74 20 74 68 65 20 0a 20 20 5b 4f 4e 20 43 4f  it the .  [ON CO
1c20: 4e 46 4c 49 43 54 5d 20 63 6c 61 75 73 65 20 66  NFLICT] clause f
1c30: 72 6f 6d 20 74 68 65 20 6c 69 62 72 61 72 79 2e  rom the library.
1c40: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
1c50: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
1c60: 44 41 54 45 54 49 4d 45 5f 46 55 4e 43 53 7d 20  DATETIME_FUNCS} 
1c70: 7b 0a 20 20 49 66 20 74 68 69 73 20 6f 70 74 69  {.  If this opti
1c80: 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 2c 20 53  on is defined, S
1c90: 51 4c 69 74 65 27 73 20 62 75 69 6c 74 2d 69 6e  QLite's built-in
1ca0: 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 6d   date and time m
1cb0: 61 6e 69 70 75 6c 61 74 69 6f 6e 0a 20 20 66 75  anipulation.  fu
1cc0: 6e 63 74 69 6f 6e 73 20 61 72 65 20 6f 6d 69 74  nctions are omit
1cd0: 74 65 64 2e 20 53 70 65 63 69 66 69 63 61 6c 6c  ted. Specificall
1ce0: 79 2c 20 74 68 65 20 53 51 4c 20 66 75 6e 63 74  y, the SQL funct
1cf0: 69 6f 6e 73 20 6a 75 6c 69 61 6e 64 61 79 28 29  ions julianday()
1d00: 2c 20 64 61 74 65 28 29 2c 0a 20 20 74 69 6d 65  , date(),.  time
1d10: 28 29 2c 20 64 61 74 65 74 69 6d 65 28 29 20 61  (), datetime() a
1d20: 6e 64 20 73 74 72 66 74 69 6d 65 28 29 20 61 72  nd strftime() ar
1d30: 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e  e not available.
1d40: 20 54 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c   The default col
1d50: 75 6d 6e 0a 20 20 76 61 6c 75 65 73 20 43 55 52  umn.  values CUR
1d60: 52 45 4e 54 5f 54 49 4d 45 2c 20 43 55 52 52 45  RENT_TIME, CURRE
1d70: 4e 54 5f 44 41 54 45 20 61 6e 64 20 43 55 52 52  NT_DATE and CURR
1d80: 45 4e 54 5f 44 41 54 45 54 49 4d 45 20 61 72 65  ENT_DATETIME are
1d90: 20 73 74 69 6c 6c 20 61 76 61 69 6c 61 62 6c 65   still available
1da0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
1db0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
1dc0: 5f 45 58 50 4c 41 49 4e 7d 20 7b 0a 20 20 44 65  _EXPLAIN} {.  De
1dd0: 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69  fining this opti
1de0: 6f 6e 20 63 61 75 73 65 73 20 74 68 65 20 5b 45  on causes the [E
1df0: 58 50 4c 41 49 4e 5d 20 63 6f 6d 6d 61 6e 64 20  XPLAIN] command 
1e00: 74 6f 20 62 65 20 6f 6d 69 74 74 65 64 20 66 72  to be omitted fr
1e10: 6f 6d 20 74 68 65 0a 20 20 6c 69 62 72 61 72 79  om the.  library
1e20: 2e 20 41 74 74 65 6d 70 74 69 6e 67 20 74 6f 20  . Attempting to 
1e30: 65 78 65 63 75 74 65 20 61 6e 20 5b 45 58 50 4c  execute an [EXPL
1e40: 41 49 4e 5d 20 73 74 61 74 65 6d 65 6e 74 20 77  AIN] statement w
1e50: 69 6c 6c 20 63 61 75 73 65 20 61 20 70 61 72 73  ill cause a pars
1e60: 65 0a 20 20 65 72 72 6f 72 2e 0a 7d 0a 0a 43 4f  e.  error..}..CO
1e70: 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51  MPILE_OPTION {SQ
1e80: 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49  LITE_OMIT_FLOATI
1e90: 4e 47 5f 50 4f 49 4e 54 7d 20 7b 0a 20 20 54 68  NG_POINT} {.  Th
1ea0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65  is option is use
1eb0: 64 20 74 6f 20 6f 6d 69 74 20 66 6c 6f 61 74 69  d to omit floati
1ec0: 6e 67 2d 70 6f 69 6e 74 20 6e 75 6d 62 65 72 20  ng-point number 
1ed0: 73 75 70 70 6f 72 74 20 66 72 6f 6d 20 74 68 65  support from the
1ee0: 20 53 51 4c 69 74 65 0a 20 20 6c 69 62 72 61 72   SQLite.  librar
1ef0: 79 2e 20 57 68 65 6e 20 73 70 65 63 69 66 69 65  y. When specifie
1f00: 64 2c 20 73 70 65 63 69 66 79 69 6e 67 20 61 20  d, specifying a 
1f10: 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 6e  floating point n
1f20: 75 6d 62 65 72 20 61 73 20 61 20 6c 69 74 65 72  umber as a liter
1f30: 61 6c 20 0a 20 20 28 69 2e 65 2e 20 22 31 2e 30  al .  (i.e. "1.0
1f40: 31 22 29 20 72 65 73 75 6c 74 73 20 69 6e 20 61  1") results in a
1f50: 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20   parse error... 
1f60: 20 3c 70 3e 49 6e 20 74 68 65 20 66 75 74 75 72   <p>In the futur
1f70: 65 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 6d  e, this option m
1f80: 61 79 20 61 6c 73 6f 20 64 69 73 61 62 6c 65 20  ay also disable 
1f90: 6f 74 68 65 72 20 66 6c 6f 61 74 69 6e 67 20 70  other floating p
1fa0: 6f 69 6e 74 20 0a 20 20 66 75 6e 63 74 69 6f 6e  oint .  function
1fb0: 61 6c 69 74 79 2c 20 66 6f 72 20 65 78 61 6d 70  ality, for examp
1fc0: 6c 65 20 74 68 65 20 5b 73 71 6c 69 74 65 33 5f  le the [sqlite3_
1fd0: 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28 29 5d  result_double()]
1fe0: 2c 20 0a 20 20 5b 73 71 6c 69 74 65 33 5f 62 69  , .  [sqlite3_bi
1ff0: 6e 64 5f 64 6f 75 62 6c 65 28 29 5d 2c 20 5b 73  nd_double()], [s
2000: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75  qlite3_value_dou
2010: 62 6c 65 28 29 5d 20 61 6e 64 0a 20 20 5b 73 71  ble()] and.  [sq
2020: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75  lite3_column_dou
2030: 62 6c 65 28 29 5d 20 41 50 49 20 66 75 6e 63 74  ble()] API funct
2040: 69 6f 6e 73 2e 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a  ions..  </p>.}..
2050: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
2060: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45  SQLITE_OMIT_FORE
2070: 49 47 4e 5f 4b 45 59 7d 20 7b 0a 20 20 49 66 20  IGN_KEY} {.  If 
2080: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 64  this option is d
2090: 65 66 69 6e 65 64 2c 20 46 4f 52 45 49 47 4e 20  efined, FOREIGN 
20a0: 4b 45 59 20 63 6c 61 75 73 65 73 20 69 6e 20 63  KEY clauses in c
20b0: 6f 6c 75 6d 6e 20 64 65 63 6c 61 72 61 74 69 6f  olumn declaratio
20c0: 6e 73 20 61 72 65 0a 20 20 69 67 6e 6f 72 65 64  ns are.  ignored
20d0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
20e0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
20f0: 5f 49 4e 54 45 47 52 49 54 59 5f 43 48 45 43 4b  _INTEGRITY_CHECK
2100: 7d 20 7b 0a 20 20 54 68 69 73 20 6f 70 74 69 6f  } {.  This optio
2110: 6e 20 6d 61 79 20 62 65 20 75 73 65 64 20 74 6f  n may be used to
2120: 20 6f 6d 69 74 20 74 68 65 20 0a 20 20 5b 69 6e   omit the .  [in
2130: 74 65 67 72 69 74 79 5f 63 68 65 63 6b 5d 20 50  tegrity_check] P
2140: 52 41 47 4d 41 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c  RAGMA..}..COMPIL
2150: 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45  E_OPTION {SQLITE
2160: 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 7d 20  _OMIT_MEMORYDB} 
2170: 7b 0a 20 20 57 68 65 6e 20 74 68 69 73 20 69 73  {.  When this is
2180: 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20 6c 69   defined, the li
2190: 62 72 61 72 79 20 64 6f 65 73 20 6e 6f 74 20 72  brary does not r
21a0: 65 73 70 65 63 74 20 74 68 65 20 73 70 65 63 69  espect the speci
21b0: 61 6c 20 64 61 74 61 62 61 73 65 0a 20 20 6e 61  al database.  na
21c0: 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 28 6e  me ":memory:" (n
21d0: 6f 72 6d 61 6c 6c 79 20 75 73 65 64 20 74 6f 20  ormally used to 
21e0: 63 72 65 61 74 65 20 61 6e 20 69 6e 2d 6d 65 6d  create an in-mem
21f0: 6f 72 79 20 64 61 74 61 62 61 73 65 29 2e 20 49  ory database). I
2200: 66 20 0a 20 20 22 3a 6d 65 6d 6f 72 79 3a 22 20  f .  ":memory:" 
2210: 69 73 20 70 61 73 73 65 64 20 74 6f 20 5b 73 71  is passed to [sq
2220: 6c 69 74 65 33 5f 6f 70 65 6e 28 29 5d 2c 20 5b  lite3_open()], [
2230: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29  sqlite3_open16()
2240: 5d 2c 20 6f 72 0a 20 20 5b 73 71 6c 69 74 65 33  ], or.  [sqlite3
2250: 5f 6f 70 65 6e 5f 76 32 28 29 5d 2c 20 61 20 66  _open_v2()], a f
2260: 69 6c 65 20 77 69 74 68 20 74 68 69 73 20 6e 61  ile with this na
2270: 6d 65 20 77 69 6c 6c 20 62 65 20 0a 20 20 6f 70  me will be .  op
2280: 65 6e 65 64 20 6f 72 20 63 72 65 61 74 65 64 2e  ened or created.
2290: 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49  .}..COMPILE_OPTI
22a0: 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ON {SQLITE_OMIT_
22b0: 50 41 47 45 52 5f 50 52 41 47 4d 41 53 7d 20 7b  PAGER_PRAGMAS} {
22c0: 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73  .  Defining this
22d0: 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72   option omits pr
22e0: 61 67 6d 61 73 20 72 65 6c 61 74 65 64 20 74 6f  agmas related to
22f0: 20 74 68 65 20 70 61 67 65 72 20 73 75 62 73 79   the pager subsy
2300: 73 74 65 6d 20 66 72 6f 6d 20 0a 20 20 74 68 65  stem from .  the
2310: 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50 49   build..}..COMPI
2320: 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54  LE_OPTION {SQLIT
2330: 45 5f 4f 4d 49 54 5f 50 52 41 47 4d 41 7d 20 7b  E_OMIT_PRAGMA} {
2340: 0a 20 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69  .  This option i
2350: 73 20 75 73 65 64 20 74 6f 20 6f 6d 69 74 20 74  s used to omit t
2360: 68 65 20 5b 50 52 41 47 4d 41 5d 20 63 6f 6d 6d  he [PRAGMA] comm
2370: 61 6e 64 0a 20 20 66 72 6f 6d 20 74 68 65 20 6c  and.  from the l
2380: 69 62 72 61 72 79 2e 20 4e 6f 74 65 20 74 68 61  ibrary. Note tha
2390: 74 20 69 74 20 69 73 20 75 73 65 66 75 6c 20 74  t it is useful t
23a0: 6f 20 64 65 66 69 6e 65 20 74 68 65 20 6d 61 63  o define the mac
23b0: 72 6f 73 20 74 68 61 74 20 6f 6d 69 74 0a 20 20  ros that omit.  
23c0: 73 70 65 63 69 66 69 63 20 70 72 61 67 6d 61 73  specific pragmas
23d0: 20 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20   in addition to 
23e0: 74 68 69 73 2c 20 61 73 20 74 68 65 79 20 6d 61  this, as they ma
23f0: 79 20 61 6c 73 6f 20 72 65 6d 6f 76 65 20 73 75  y also remove su
2400: 70 70 6f 72 74 69 6e 67 20 63 6f 64 65 0a 20 20  pporting code.  
2410: 69 6e 20 6f 74 68 65 72 20 73 75 62 2d 73 79 73  in other sub-sys
2420: 74 65 6d 73 2e 20 54 68 69 73 20 6d 61 63 72 6f  tems. This macro
2430: 20 72 65 6d 6f 76 65 73 20 74 68 65 20 5b 50 52   removes the [PR
2440: 41 47 4d 41 5d 20 63 6f 6d 6d 61 6e 64 20 6f 6e  AGMA] command on
2450: 6c 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ly..}..COMPILE_O
2460: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
2470: 49 54 5f 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c  IT_PROGRESS_CALL
2480: 42 41 43 4b 7d 20 7b 0a 20 20 54 68 69 73 20 6f  BACK} {.  This o
2490: 70 74 69 6f 6e 20 6d 61 79 20 62 65 20 64 65 66  ption may be def
24a0: 69 6e 65 64 20 74 6f 20 6f 6d 69 74 20 74 68 65  ined to omit the
24b0: 20 63 61 70 61 62 69 6c 69 74 79 20 74 6f 20 69   capability to i
24c0: 73 73 75 65 20 22 70 72 6f 67 72 65 73 73 22 20  ssue "progress" 
24d0: 0a 20 20 63 61 6c 6c 62 61 63 6b 73 20 64 75 72  .  callbacks dur
24e0: 69 6e 67 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67  ing long-running
24f0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e   SQL statements.
2500: 20 54 68 65 20 0a 20 20 5b 73 71 6c 69 74 65 33   The .  [sqlite3
2510: 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c 65  _progress_handle
2520: 72 28 29 5d 0a 20 20 41 50 49 20 66 75 6e 63 74  r()].  API funct
2530: 69 6f 6e 20 69 73 20 6e 6f 74 20 70 72 65 73 65  ion is not prese
2540: 6e 74 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72  nt in the librar
2550: 79 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50  y..}..COMPILE_OP
2560: 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49  TION {SQLITE_OMI
2570: 54 5f 52 45 49 4e 44 45 58 7d 20 7b 0a 20 20 57  T_REINDEX} {.  W
2580: 68 65 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 20  hen this option 
2590: 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 65 20  is defined, the 
25a0: 5b 52 45 49 4e 44 45 58 5d 0a 20 20 63 6f 6d 6d  [REINDEX].  comm
25b0: 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e 63 6c 75  and is not inclu
25c0: 64 65 64 20 69 6e 20 74 68 65 20 6c 69 62 72 61  ded in the libra
25d0: 72 79 2e 0a 20 20 45 78 65 63 75 74 69 6e 67 20  ry..  Executing 
25e0: 61 20 5b 52 45 49 4e 44 45 58 5d 20 73 74 61 74  a [REINDEX] stat
25f0: 65 6d 65 6e 74 20 63 61 75 73 65 73 20 0a 20 20  ement causes .  
2600: 61 20 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 7d  a parse error..}
2610: 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e  ..COMPILE_OPTION
2620: 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 43   {SQLITE_OMIT_SC
2630: 48 45 4d 41 5f 50 52 41 47 4d 41 53 7d 20 7b 0a  HEMA_PRAGMAS} {.
2640: 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69 73 20    Defining this 
2650: 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70 72 61  option omits pra
2660: 67 6d 61 73 20 66 6f 72 20 71 75 65 72 79 69 6e  gmas for queryin
2670: 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73  g the database s
2680: 63 68 65 6d 61 20 66 72 6f 6d 20 0a 20 20 74 68  chema from .  th
2690: 65 20 62 75 69 6c 64 2e 0a 7d 0a 0a 43 4f 4d 50  e build..}..COMP
26a0: 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49  ILE_OPTION {SQLI
26b0: 54 45 5f 4f 4d 49 54 5f 53 43 48 45 4d 41 5f 56  TE_OMIT_SCHEMA_V
26c0: 45 52 53 49 4f 4e 5f 50 52 41 47 4d 41 53 7d 20  ERSION_PRAGMAS} 
26d0: 7b 0a 20 20 44 65 66 69 6e 69 6e 67 20 74 68 69  {.  Defining thi
26e0: 73 20 6f 70 74 69 6f 6e 20 6f 6d 69 74 73 20 70  s option omits p
26f0: 72 61 67 6d 61 73 20 66 6f 72 20 71 75 65 72 79  ragmas for query
2700: 69 6e 67 20 61 6e 64 20 6d 6f 64 69 66 79 69 6e  ing and modifyin
2710: 67 20 74 68 65 20 0a 20 20 64 61 74 61 62 61 73  g the .  databas
2720: 65 20 73 63 68 65 6d 61 20 76 65 72 73 69 6f 6e  e schema version
2730: 20 61 6e 64 20 75 73 65 72 20 76 65 72 73 69 6f   and user versio
2740: 6e 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64  n from the build
2750: 2e 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20  . Specifically, 
2760: 74 68 65 20 0a 20 20 5b 73 63 68 65 6d 61 5f 76  the .  [schema_v
2770: 65 72 73 69 6f 6e 5d 20 61 6e 64 20 5b 75 73 65  ersion] and [use
2780: 72 5f 76 65 72 73 69 6f 6e 5d 20 50 52 41 47 4d  r_version] PRAGM
2790: 41 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 0a  As are omitted..
27a0: 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f  }..COMPILE_OPTIO
27b0: 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53  N {SQLITE_OMIT_S
27c0: 55 42 51 55 45 52 59 7d 20 7b 0a 20 20 49 66 20  UBQUERY} {.  If 
27d0: 64 65 66 69 6e 65 64 2c 20 73 75 70 70 6f 72 74  defined, support
27e0: 20 66 6f 72 20 73 75 62 2d 73 65 6c 65 63 74 73   for sub-selects
27f0: 20 61 6e 64 20 74 68 65 20 49 4e 28 29 20 6f 70   and the IN() op
2800: 65 72 61 74 6f 72 20 61 72 65 20 6f 6d 69 74 74  erator are omitt
2810: 65 64 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f  ed..}..COMPILE_O
2820: 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d  PTION {SQLITE_OM
2830: 49 54 5f 54 43 4c 5f 56 41 52 49 41 42 4c 45 7d  IT_TCL_VARIABLE}
2840: 20 7b 0a 20 20 49 66 20 74 68 69 73 20 6d 61 63   {.  If this mac
2850: 72 6f 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74  ro is defined, t
2860: 68 65 6e 20 74 68 65 20 73 70 65 63 69 61 6c 20  hen the special 
2870: 22 24 3c 76 61 72 69 61 62 6c 65 2d 6e 61 6d 65  "$<variable-name
2880: 3e 22 20 73 79 6e 74 61 78 0a 20 20 75 73 65 64  >" syntax.  used
2890: 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   to automaticall
28a0: 79 20 62 69 6e 64 20 53 51 4c 20 76 61 72 69 61  y bind SQL varia
28b0: 62 6c 65 73 20 74 6f 20 54 43 4c 20 76 61 72 69  bles to TCL vari
28c0: 61 62 6c 65 73 20 69 73 20 6f 6d 69 74 74 65 64  ables is omitted
28d0: 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45 5f 4f 50 54  ..}..COMPILE_OPT
28e0: 49 4f 4e 20 7b 53 51 4c 49 54 45 5f 4f 4d 49 54  ION {SQLITE_OMIT
28f0: 5f 54 52 49 47 47 45 52 7d 20 7b 0a 20 20 44 65  _TRIGGER} {.  De
2900: 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74 69  fining this opti
2910: 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72 74  on omits support
2920: 20 66 6f 72 20 56 49 45 57 20 6f 62 6a 65 63 74   for VIEW object
2930: 73 2e 20 4e 65 69 74 68 65 72 20 74 68 65 20 0a  s. Neither the .
2940: 20 20 5b 43 52 45 41 54 45 20 54 52 49 47 47 45    [CREATE TRIGGE
2950: 52 5d 20 6f 72 20 5b 44 52 4f 50 20 54 52 49 47  R] or [DROP TRIG
2960: 47 45 52 5d 0a 20 20 63 6f 6d 6d 61 6e 64 73 20  GER].  commands 
2970: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69 6e  are available in
2980: 20 74 68 69 73 20 63 61 73 65 2c 20 61 6e 64 20   this case, and 
2990: 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 65 78  attempting to ex
29a0: 65 63 75 74 65 0a 20 20 65 69 74 68 65 72 20 77  ecute.  either w
29b0: 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 20  ill result in a 
29c0: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20 20  parse error...  
29d0: 3c 70 3e 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49  <p>.  WARNING: I
29e0: 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20  f this macro is 
29f0: 64 65 66 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c  defined, it will
2a00: 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65   not be possible
2a10: 20 74 6f 20 6f 70 65 6e 20 61 20 64 61 74 61 62   to open a datab
2a20: 61 73 65 0a 20 20 66 6f 72 20 77 68 69 63 68 20  ase.  for which 
2a30: 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6e 74 61  the schema conta
2a40: 69 6e 73 20 54 52 49 47 47 45 52 20 6f 62 6a 65  ins TRIGGER obje
2a50: 63 74 73 2e 20 0a 20 20 3c 2f 70 3e 0a 7d 0a 0a  cts. .  </p>.}..
2a60: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
2a70: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
2a80: 36 7d 20 7b 0a 20 20 54 68 69 73 20 6d 61 63 72  6} {.  This macr
2a90: 6f 20 69 73 20 75 73 65 64 20 74 6f 20 6f 6d 69  o is used to omi
2aa0: 74 20 73 75 70 70 6f 72 74 20 66 6f 72 20 55 54  t support for UT
2ab0: 46 31 36 20 74 65 78 74 20 65 6e 63 6f 64 69 6e  F16 text encodin
2ac0: 67 2e 20 57 68 65 6e 20 74 68 69 73 20 69 73 0a  g. When this is.
2ad0: 20 20 64 65 66 69 6e 65 64 20 61 6c 6c 20 41 50    defined all AP
2ae0: 49 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74  I functions that
2af0: 20 72 65 74 75 72 6e 20 6f 72 20 61 63 63 65 70   return or accep
2b00: 74 20 55 54 46 31 36 20 65 6e 63 6f 64 65 64 20  t UTF16 encoded 
2b10: 74 65 78 74 20 61 72 65 0a 20 20 75 6e 61 76 61  text are.  unava
2b20: 69 6c 61 62 6c 65 2e 20 54 68 65 73 65 20 66 75  ilable. These fu
2b30: 6e 63 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 69  nctions can be i
2b40: 64 65 6e 74 69 66 69 65 64 20 62 79 20 74 68 65  dentified by the
2b50: 20 66 61 63 74 20 74 68 61 74 20 74 68 65 79 20   fact that they 
2b60: 65 6e 64 0a 20 20 77 69 74 68 20 27 31 36 27 2c  end.  with '16',
2b70: 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 5b 73 71   for example [sq
2b80: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 31 36 28  lite3_prepare16(
2b90: 29 5d 2c 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6c  )], [sqlite3_col
2ba0: 75 6d 6e 5f 74 65 78 74 31 36 28 29 5d 20 61 6e  umn_text16()] an
2bb0: 64 0a 20 20 5b 73 71 6c 69 74 65 33 5f 62 69 6e  d.  [sqlite3_bin
2bc0: 64 5f 74 65 78 74 31 36 28 29 5d 2e 0a 7d 0a 0a  d_text16()]..}..
2bd0: 43 4f 4d 50 49 4c 45 5f 4f 50 54 49 4f 4e 20 7b  COMPILE_OPTION {
2be0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 43 55  SQLITE_OMIT_VACU
2bf0: 55 4d 7d 20 7b 0a 20 20 57 68 65 6e 20 74 68 69  UM} {.  When thi
2c00: 73 20 6f 70 74 69 6f 6e 20 69 73 20 64 65 66 69  s option is defi
2c10: 6e 65 64 2c 20 74 68 65 20 5b 56 41 43 55 55 4d  ned, the [VACUUM
2c20: 5d 0a 20 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e  ].  command is n
2c30: 6f 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74  ot included in t
2c40: 68 65 20 6c 69 62 72 61 72 79 2e 0a 20 20 45 78  he library..  Ex
2c50: 65 63 75 74 69 6e 67 20 61 20 5b 56 41 43 55 55  ecuting a [VACUU
2c60: 4d 5d 20 73 74 61 74 65 6d 65 6e 74 20 63 61 75  M] statement cau
2c70: 73 65 73 20 0a 20 20 61 20 70 61 72 73 65 20 65  ses .  a parse e
2c80: 72 72 6f 72 2e 0a 7d 0a 0a 43 4f 4d 50 49 4c 45  rror..}..COMPILE
2c90: 5f 4f 50 54 49 4f 4e 20 7b 53 51 4c 49 54 45 5f  _OPTION {SQLITE_
2ca0: 4f 4d 49 54 5f 56 49 45 57 7d 20 7b 0a 20 20 44  OMIT_VIEW} {.  D
2cb0: 65 66 69 6e 69 6e 67 20 74 68 69 73 20 6f 70 74  efining this opt
2cc0: 69 6f 6e 20 6f 6d 69 74 73 20 73 75 70 70 6f 72  ion omits suppor
2cd0: 74 20 66 6f 72 20 56 49 45 57 20 6f 62 6a 65 63  t for VIEW objec
2ce0: 74 73 2e 20 4e 65 69 74 68 65 72 20 74 68 65 20  ts. Neither the 
2cf0: 0a 20 20 5b 43 52 45 41 54 45 20 56 49 45 57 5d  .  [CREATE VIEW]
2d00: 20 6e 6f 72 20 74 68 65 20 5b 44 52 4f 50 20 56   nor the [DROP V
2d10: 49 45 57 5d 0a 20 20 63 6f 6d 6d 61 6e 64 73 20  IEW].  commands 
2d20: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 69 6e  are available in
2d30: 20 74 68 69 73 20 63 61 73 65 2c 20 61 6e 64 0a   this case, and.
2d40: 20 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20    attempting to 
2d50: 65 78 65 63 75 74 65 20 65 69 74 68 65 72 20 77  execute either w
2d60: 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 20  ill result in a 
2d70: 70 61 72 73 65 20 65 72 72 6f 72 2e 0a 0a 20 20  parse error...  
2d80: 3c 70 3e 0a 20 20 57 41 52 4e 49 4e 47 3a 20 49  <p>.  WARNING: I
2d90: 66 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20  f this macro is 
2da0: 64 65 66 69 6e 65 64 2c 20 69 74 20 77 69 6c 6c  defined, it will
2db0: 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65   not be possible
2dc0: 20 74 6f 20 6f 70 65 6e 20 61 20 64 61 74 61 62   to open a datab
2dd0: 61 73 65 0a 20 20 66 6f 72 20 77 68 69 63 68 20  ase.  for which 
2de0: 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6e 74 61  the schema conta
2df0: 69 6e 73 20 56 49 45 57 20 6f 62 6a 65 63 74 73  ins VIEW objects
2e00: 2e 20 0a 20 20 3c 2f 70 3e 0a 7d 0a 3c 2f 74 63  . .  </p>.}.</tc
2e10: 6c 3e 0a                                         l>.