Documentation Source Text

Hex Artifact Content
Login

Artifact 3c33fc2757762b5a98e7097020fa27f12361a4a9:


0000: 3c 74 69 74 6c 65 3e 55 6e 69 66 6f 72 6d 20 52  <title>Uniform R
0010: 65 73 6f 75 72 63 65 20 49 64 65 6e 74 69 66 69  esource Identifi
0020: 65 72 73 3c 2f 74 69 74 6c 65 3e 0a 3c 74 63 6c  ers</title>.<tcl
0030: 3e 0a 68 64 5f 6b 65 79 77 6f 72 64 73 20 7b 55  >.hd_keywords {U
0040: 52 49 7d 20 7b 55 6e 69 66 6f 72 6d 20 52 65 73  RI} {Uniform Res
0050: 6f 75 72 63 65 20 49 64 65 6e 74 69 66 69 65 72  ource Identifier
0060: 7d 20 7b 55 52 49 20 66 69 6c 65 6e 61 6d 65 7d  } {URI filename}
0070: 20 7b 55 52 49 20 66 69 6c 65 6e 61 6d 65 73 7d   {URI filenames}
0080: 0a 3c 2f 74 63 6c 3e 0a 0a 3c 68 31 3e 31 2e 30  .</tcl>..<h1>1.0
0090: 20 55 52 49 20 46 69 6c 65 6e 61 6d 65 73 20 49   URI Filenames I
00a0: 6e 20 53 51 4c 69 74 65 3c 2f 68 31 3e 0a 0a 3c  n SQLite</h1>..<
00b0: 70 3e 0a 42 65 67 69 6e 6e 69 6e 67 20 77 69 74  p>.Beginning wit
00c0: 68 20 5b 76 65 72 73 69 6f 6e 20 33 2e 37 2e 37  h [version 3.7.7
00d0: 5d 2c 20 74 68 65 20 53 51 4c 69 74 65 20 64 61  ], the SQLite da
00e0: 74 61 62 61 73 65 20 66 69 6c 65 20 61 72 67 75  tabase file argu
00f0: 6d 65 6e 74 20 74 6f 20 74 68 65 0a 5b 73 71 6c  ment to the.[sql
0100: 69 74 65 33 5f 6f 70 65 6e 28 29 5d 2c 20 5b 73  ite3_open()], [s
0110: 71 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 5d  qlite3_open16()]
0120: 2c 20 61 6e 64 20 5b 73 71 6c 69 74 65 33 5f 6f  , and [sqlite3_o
0130: 70 65 6e 5f 76 32 28 29 5d 20 69 6e 74 65 72 66  pen_v2()] interf
0140: 61 63 65 73 0a 61 6e 64 20 74 6f 20 74 68 65 20  aces.and to the 
0150: 5b 41 54 54 41 43 48 5d 20 63 6f 6d 6d 61 6e 64  [ATTACH] command
0160: 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 65   can be specifie
0170: 64 0a 65 69 74 68 65 72 20 61 73 20 61 6e 20 6f  d.either as an o
0180: 72 64 69 6e 61 72 79 20 66 69 6c 65 6e 61 6d 65  rdinary filename
0190: 20 6f 72 20 61 73 20 61 20 55 6e 69 66 6f 72 6d   or as a Uniform
01a0: 20 52 65 73 6f 75 72 63 65 20 49 64 65 6e 74 69   Resource Identi
01b0: 66 69 65 72 20 6f 72 20 55 52 49 2e 0a 54 68 65  fier or URI..The
01c0: 20 61 64 76 61 6e 74 61 67 65 20 6f 66 20 75 73   advantage of us
01d0: 69 6e 67 20 61 20 55 52 49 20 66 69 6c 65 6e 61  ing a URI filena
01e0: 6d 65 20 69 73 20 74 68 61 74 20 71 75 65 72 79  me is that query
01f0: 20 70 61 72 61 6d 65 74 65 72 73 20 6f 6e 20 74   parameters on t
0200: 68 65 20 55 52 49 20 63 61 6e 0a 62 65 20 75 73  he URI can.be us
0210: 65 64 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 64 65  ed to control de
0220: 74 61 69 6c 73 20 6f 66 20 74 68 65 20 6e 65 77  tails of the new
0230: 6c 79 20 63 72 65 61 74 65 64 20 64 61 74 61 62  ly created datab
0240: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a  ase connection..
0250: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 61 6e 20  For example, an 
0260: 61 6c 74 65 72 6e 61 74 69 76 65 20 5b 56 46 53  alternative [VFS
0270: 5d 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69  ] can be specifi
0280: 65 64 20 75 73 69 6e 67 20 61 20 0a 22 76 66 73  ed using a ."vfs
0290: 3d 22 20 71 75 65 72 79 20 70 61 72 61 6d 65 74  =" query paramet
02a0: 65 72 2e 0a 4f 72 20 74 68 65 20 64 61 74 61 62  er..Or the datab
02b0: 61 73 65 20 63 61 6e 20 62 65 20 6f 70 65 6e 65  ase can be opene
02c0: 64 20 72 65 61 64 2d 6f 6e 6c 79 20 62 79 20 75  d read-only by u
02d0: 73 69 6e 67 20 22 6d 6f 64 65 3d 72 6f 22 20 61  sing "mode=ro" a
02e0: 73 20 61 20 71 75 65 72 79 0a 70 61 72 61 6d 65  s a query.parame
02f0: 74 65 72 2e 0a 3c 2f 70 3e 0a 0a 3c 68 31 3e 32  ter..</p>..<h1>2
0300: 2e 30 20 42 61 63 6b 77 61 72 64 73 20 43 6f 6d  .0 Backwards Com
0310: 70 61 74 69 62 69 6c 69 74 79 3c 2f 68 31 3e 0a  patibility</h1>.
0320: 0a 3c 70 3e 0a 49 6e 20 6f 72 64 65 72 20 74 6f  .<p>.In order to
0330: 20 6d 61 69 6e 74 61 69 6e 20 66 75 6c 6c 20 62   maintain full b
0340: 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69  ackwards compati
0350: 62 69 6c 69 74 79 20 66 6f 72 20 6c 65 67 61 63  bility for legac
0360: 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 2c 0a  y applications,.
0370: 74 68 65 20 55 52 49 20 66 69 6c 65 6e 61 6d 65  the URI filename
0380: 20 63 61 70 61 62 69 6c 69 74 79 20 69 73 20 64   capability is d
0390: 69 73 61 62 6c 65 64 20 62 79 20 64 65 66 61 75  isabled by defau
03a0: 6c 74 2e 20 20 0a 5e 28 49 6e 20 6f 72 64 65 72  lt.  .^(In order
03b0: 20 66 6f 72 20 55 52 49 20 66 69 6c 65 6e 61 6d   for URI filenam
03c0: 65 73 0a 74 6f 20 77 6f 72 6b 2c 20 6f 6e 65 20  es.to work, one 
03d0: 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20 66  or more of the f
03e0: 6f 6c 6c 6f 77 69 6e 67 20 6d 75 73 74 20 62 65  ollowing must be
03f0: 20 74 72 75 65 3a 0a 3c 2f 70 3e 0a 0a 3c 6f 6c   true:.</p>..<ol
0400: 3e 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 53 51 4c  >.<li><p>The SQL
0410: 69 74 65 20 6c 69 62 72 61 72 79 20 69 73 20 63  ite library is c
0420: 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 65  ompiled with the
0430: 20 5b 53 51 4c 49 54 45 5f 55 53 45 5f 55 52 49   [SQLITE_USE_URI
0440: 5d 20 0a 20 20 20 20 20 20 20 63 6f 6d 70 69 6c  ] .       compil
0450: 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e 2e 3c 2f  e-time option.</
0460: 70 3e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 3c 70 3e 54  p></li>.<li><p>T
0470: 68 65 20 5b 73 71 6c 69 74 65 33 5f 63 6f 6e 66  he [sqlite3_conf
0480: 69 67 5d 28 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  ig]([SQLITE_CONF
0490: 49 47 5f 55 52 49 5d 2c 20 31 29 3b 20 63 6f 6e  IG_URI], 1); con
04a0: 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f  figuration optio
04b0: 6e 0a 20 20 20 20 20 20 20 69 73 20 73 65 74 20  n.       is set 
04c0: 61 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 73  at application s
04d0: 74 61 72 74 2d 74 69 6d 65 2e 3c 2f 70 3e 3c 2f  tart-time.</p></
04e0: 6c 69 3e 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 5b  li>.<li><p>The [
04f0: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 5d  SQLITE_OPEN_URI]
0500: 20 62 69 74 20 69 73 20 4f 52 2d 65 64 20 69 6e   bit is OR-ed in
0510: 20 77 69 74 68 20 74 68 65 20 73 65 74 20 62 69   with the set bi
0520: 74 73 20 70 61 73 73 65 64 20 69 6e 0a 20 20 20  ts passed in.   
0530: 20 20 20 20 61 73 20 74 68 65 20 33 72 64 20 70      as the 3rd p
0540: 61 72 61 6d 65 74 65 72 20 74 6f 20 74 68 65 20  arameter to the 
0550: 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32  [sqlite3_open_v2
0560: 28 29 5d 20 69 6e 74 65 72 66 61 63 65 2e 3c 2f  ()] interface.</
0570: 70 3e 3c 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 29 5e 0a  p></li>.</ol>)^.
0580: 0a 3c 70 3e 0a 5e 49 66 20 55 52 49 20 66 69 6c  .<p>.^If URI fil
0590: 65 6e 61 6d 65 73 20 61 72 65 20 72 65 63 6f 67  enames are recog
05a0: 6e 69 7a 65 64 20 77 68 65 6e 20 74 68 65 20 64  nized when the d
05b0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
05c0: 6f 6e 20 69 73 20 6f 72 69 67 69 6e 61 6c 6c 79  on is originally
05d0: 0a 6f 70 65 6e 65 64 2c 20 74 68 65 6e 20 55 52  .opened, then UR
05e0: 49 20 66 69 6c 65 6e 61 6d 65 73 20 77 69 6c 6c  I filenames will
05f0: 20 61 6c 73 6f 20 62 65 20 72 65 63 6f 67 6e 69   also be recogni
0600: 7a 65 64 20 6f 6e 20 5b 41 54 54 41 43 48 5d 20  zed on [ATTACH] 
0610: 73 74 61 74 65 6d 65 6e 74 73 2e 0a 5e 53 69 6d  statements..^Sim
0620: 69 6c 61 72 6c 79 2c 20 69 66 20 55 52 49 20 66  ilarly, if URI f
0630: 69 6c 65 6e 61 6d 65 73 20 61 72 65 20 6e 6f 74  ilenames are not
0640: 20 72 65 63 6f 67 6e 69 7a 65 64 20 77 68 65 6e   recognized when
0650: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63 6f   the database co
0660: 6e 6e 65 63 74 69 6f 6e 0a 69 73 20 66 69 72 73  nnection.is firs
0670: 74 20 6f 70 65 6e 65 64 2c 20 74 68 65 79 20 77  t opened, they w
0680: 69 6c 6c 20 6e 6f 74 20 62 65 20 72 65 63 6f 67  ill not be recog
0690: 6e 69 7a 65 64 20 62 79 20 5b 41 54 54 41 43 48  nized by [ATTACH
06a0: 5d 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 53 69 6e  ]..</p>..<p>.Sin
06b0: 63 65 20 53 51 4c 69 74 65 20 61 6c 77 61 79 73  ce SQLite always
06c0: 20 69 6e 74 65 72 70 72 65 74 73 20 61 6e 79 20   interprets any 
06d0: 66 69 6c 65 6e 61 6d 65 20 74 68 61 74 20 64 6f  filename that do
06e0: 65 73 20 6e 6f 74 20 62 65 67 69 6e 0a 77 69 74  es not begin.wit
06f0: 68 20 22 3c 74 74 3e 66 69 6c 65 3a 3c 2f 74 74  h "<tt>file:</tt
0700: 3e 22 0a 61 73 20 61 6e 20 6f 72 64 69 6e 61 72  >".as an ordinar
0710: 79 20 66 69 6c 65 6e 61 6d 65 20 72 65 67 61 72  y filename regar
0720: 64 6c 65 73 73 20 6f 66 20 74 68 65 20 55 52 49  dless of the URI
0730: 20 73 65 74 74 69 6e 67 2c 20 61 6e 64 20 62 65   setting, and be
0740: 63 61 75 73 65 20 69 74 20 69 73 0a 76 65 72 79  cause it is.very
0750: 20 75 6e 75 73 75 61 6c 20 74 6f 20 68 61 76 65   unusual to have
0760: 20 61 6e 20 61 63 74 75 61 6c 20 66 69 6c 65 20   an actual file 
0770: 62 65 67 69 6e 20 77 69 74 68 20 22 3c 74 74 3e  begin with "<tt>
0780: 66 69 6c 65 3a 3c 2f 74 74 3e 22 2c 20 0a 69 74  file:</tt>", .it
0790: 20 69 73 20 73 61 66 65 20 66 6f 72 20 6d 6f 73   is safe for mos
07a0: 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 74  t applications t
07b0: 6f 20 65 6e 61 62 6c 65 20 55 52 49 20 70 72 6f  o enable URI pro
07c0: 63 65 73 73 69 6e 67 20 65 76 65 6e 20 69 66 20  cessing even if 
07d0: 55 52 49 20 0a 66 69 6c 65 6e 61 6d 65 73 20 61  URI .filenames a
07e0: 72 65 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79  re not currently
07f0: 20 62 65 69 6e 67 20 75 73 65 64 2e 0a 3c 2f 70   being used..</p
0800: 3e 0a 0a 3c 68 31 3e 33 2e 30 20 55 52 49 20 46  >..<h1>3.0 URI F
0810: 6f 72 6d 61 74 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a  ormat</h1>..<p>.
0820: 41 63 63 6f 72 64 69 6e 67 20 74 6f 20 5b 68 74  According to [ht
0830: 74 70 3a 2f 2f 74 6f 6f 6c 73 2e 69 65 74 66 2e  tp://tools.ietf.
0840: 6f 72 67 2f 68 74 6d 6c 2f 72 66 63 33 39 38 36  org/html/rfc3986
0850: 20 7c 20 52 46 43 20 33 39 38 36 5d 2c 20 61 20   | RFC 3986], a 
0860: 55 52 49 20 63 6f 6e 73 69 73 74 73 0a 6f 66 20  URI consists.of 
0870: 61 20 73 63 68 65 6d 65 2c 20 61 6e 20 61 75 74  a scheme, an aut
0880: 68 6f 72 69 74 79 2c 20 61 20 70 61 74 68 2c 20  hority, a path, 
0890: 61 20 71 75 65 72 79 20 73 74 72 69 6e 67 2c 20  a query string, 
08a0: 61 6e 64 20 61 20 66 72 61 67 6d 65 6e 74 2e 20  and a fragment. 
08b0: 20 54 68 65 0a 73 63 68 65 6d 65 20 69 73 20 61   The.scheme is a
08c0: 6c 77 61 79 73 20 72 65 71 75 69 72 65 64 2e 20  lways required. 
08d0: 20 4f 6e 65 20 6f 66 20 65 69 74 68 65 72 20 74   One of either t
08e0: 68 65 20 61 75 74 68 6f 72 69 74 79 20 6f 72 20  he authority or 
08f0: 74 68 65 20 70 61 74 68 20 69 73 20 61 6c 73 6f  the path is also
0900: 0a 61 6c 77 61 79 73 20 72 65 71 75 69 72 65 64  .always required
0910: 2e 20 20 54 68 65 20 71 75 65 72 79 20 73 74 72  .  The query str
0920: 69 6e 67 20 61 6e 64 20 66 72 61 67 6d 65 6e 74  ing and fragment
0930: 20 61 72 65 20 6f 70 74 69 6f 6e 61 6c 2e 0a 3c   are optional..<
0940: 2f 70 3e 0a 0a 3c 70 3e 0a 53 51 4c 69 74 65 20  /p>..<p>.SQLite 
0950: 75 73 65 73 20 74 68 65 20 22 3c 74 74 3e 66 69  uses the "<tt>fi
0960: 6c 65 3a 3c 2f 74 74 3e 22 20 55 52 49 20 73 79  le:</tt>" URI sy
0970: 6e 74 61 78 20 74 6f 20 69 64 65 6e 74 69 66 79  ntax to identify
0980: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2e   database files.
0990: 0a 53 51 4c 69 74 65 20 73 74 72 69 76 65 73 20  .SQLite strives 
09a0: 74 6f 20 69 6e 74 65 72 70 72 65 74 20 66 69 6c  to interpret fil
09b0: 65 3a 20 55 52 49 73 20 69 6e 20 65 78 61 63 74  e: URIs in exact
09c0: 6c 79 20 74 68 65 20 73 61 6d 65 20 77 61 79 20  ly the same way 
09d0: 61 73 0a 70 6f 70 75 6c 61 72 20 77 65 62 2d 62  as.popular web-b
09e0: 72 6f 77 73 65 72 73 20 73 75 63 68 20 61 73 20  rowsers such as 
09f0: 0a 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 6d 6f 7a  .[http://www.moz
0a00: 69 6c 6c 61 2e 63 6f 6d 2f 65 6e 2d 55 53 2f 66  illa.com/en-US/f
0a10: 69 72 65 66 6f 78 2f 6e 65 77 2f 20 7c 20 46 69  irefox/new/ | Fi
0a20: 72 65 66 6f 78 5d 2c 20 0a 5b 68 74 74 70 3a 2f  refox], .[http:/
0a30: 2f 77 77 77 2e 67 6f 6f 67 6c 65 2e 63 6f 6d 2f  /www.google.com/
0a40: 63 68 72 6f 6d 65 2f 20 7c 20 43 68 72 6f 6d 65  chrome/ | Chrome
0a50: 5d 2c 20 0a 5b 68 74 74 70 3a 2f 2f 77 77 77 2e  ], .[http://www.
0a60: 61 70 70 6c 65 2e 63 6f 6d 2f 73 61 66 61 72 69  apple.com/safari
0a70: 2f 20 7c 20 53 61 66 61 72 69 5d 2c 20 0a 5b 68  / | Safari], .[h
0a80: 74 74 70 3a 2f 2f 77 69 6e 64 6f 77 73 2e 6d 69  ttp://windows.mi
0a90: 63 72 6f 73 6f 66 74 2e 63 6f 6d 2f 65 6e 2d 55  crosoft.com/en-U
0aa0: 53 2f 69 6e 74 65 72 6e 65 74 2d 65 78 70 6c 6f  S/internet-explo
0ab0: 72 65 72 2f 70 72 6f 64 75 63 74 73 2f 69 65 2f  rer/products/ie/
0ac0: 68 6f 6d 65 20 7c 20 49 6e 74 65 72 6e 65 74 20  home | Internet 
0ad0: 45 78 70 6c 6f 72 65 72 5d 2c 20 61 6e 64 0a 5b  Explorer], and.[
0ae0: 68 74 74 70 3a 2f 2f 77 77 77 2e 6f 70 65 72 61  http://www.opera
0af0: 2e 63 6f 6d 2f 20 7c 20 4f 70 65 72 61 5d 2c 0a  .com/ | Opera],.
0b00: 61 6e 64 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65  and command-line
0b10: 20 70 72 6f 67 72 61 6d 73 20 73 75 63 68 20 61   programs such a
0b20: 73 20 0a 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 6d  s .[http://www.m
0b30: 69 63 72 6f 73 6f 66 74 2e 63 6f 6d 2f 72 65 73  icrosoft.com/res
0b40: 6f 75 72 63 65 73 2f 64 6f 63 75 6d 65 6e 74 61  ources/documenta
0b50: 74 69 6f 6e 2f 77 69 6e 64 6f 77 73 2f 78 70 2f  tion/windows/xp/
0b60: 61 6c 6c 2f 70 72 6f 64 64 6f 63 73 2f 65 6e 2d  all/proddocs/en-
0b70: 75 73 2f 73 74 61 72 74 2e 6d 73 70 78 20 7c 20  us/start.mspx | 
0b80: 57 69 6e 64 6f 77 73 20 22 73 74 61 72 74 22 5d  Windows "start"]
0b90: 20 61 6e 64 20 74 68 65 20 4d 61 63 20 4f 53 2d   and the Mac OS-
0ba0: 58 0a 5b 68 74 74 70 3a 2f 2f 64 65 76 65 6c 6f  X.[http://develo
0bb0: 70 65 72 2e 61 70 70 6c 65 2e 63 6f 6d 2f 6c 69  per.apple.com/li
0bc0: 62 72 61 72 79 2f 6d 61 63 2f 23 64 6f 63 75 6d  brary/mac/#docum
0bd0: 65 6e 74 61 74 69 6f 6e 2f 44 61 72 77 69 6e 2f  entation/Darwin/
0be0: 52 65 66 65 72 65 6e 63 65 2f 4d 61 6e 50 61 67  Reference/ManPag
0bf0: 65 73 2f 6d 61 6e 31 2f 6f 70 65 6e 2e 31 2e 68  es/man1/open.1.h
0c00: 74 6d 6c 20 7c 20 22 6f 70 65 6e 22 5d 20 63 6f  tml | "open"] co
0c10: 6d 6d 61 6e 64 2e 0a 41 20 73 75 63 63 69 6e 63  mmand..A succinc
0c20: 74 20 73 75 6d 6d 61 72 79 20 6f 66 20 74 68 65  t summary of the
0c30: 20 55 52 49 20 70 61 72 73 69 6e 67 20 72 75 6c   URI parsing rul
0c40: 65 73 20 66 6f 6c 6c 6f 77 73 3a 0a 3c 2f 70 3e  es follows:.</p>
0c50: 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 20 5e 28 54 68  ..<ul>.<li> ^(Th
0c60: 65 20 73 63 68 65 6d 65 20 6f 66 20 74 68 65 20  e scheme of the 
0c70: 55 52 49 20 6d 75 73 74 20 62 65 20 22 3c 74 74  URI must be "<tt
0c80: 3e 66 69 6c 65 3a 3c 2f 74 74 3e 22 2e 20 20 41  >file:</tt>".  A
0c90: 6e 79 20 6f 74 68 65 72 20 73 63 68 65 6d 65 0a  ny other scheme.
0ca0: 20 20 20 20 20 72 65 73 75 6c 74 73 20 69 6e 20       results in 
0cb0: 74 68 65 20 69 6e 70 75 74 20 62 65 69 6e 67 20  the input being 
0cc0: 74 72 65 61 74 65 64 20 61 73 20 61 6e 20 6f 72  treated as an or
0cd0: 64 69 6e 61 72 79 20 66 69 6c 65 6e 61 6d 65 2e  dinary filename.
0ce0: 29 5e 0a 3c 6c 69 3e 20 5e 28 54 68 65 20 61 75  )^.<li> ^(The au
0cf0: 74 68 6f 72 69 74 79 20 6d 61 79 20 62 65 20 6f  thority may be o
0d00: 6d 69 74 74 65 64 2c 20 6d 61 79 20 62 65 20 62  mitted, may be b
0d10: 6c 61 6e 6b 2c 20 6f 72 20 6d 61 79 20 62 65 0a  lank, or may be.
0d20: 20 20 20 20 20 20 22 3c 74 74 3e 6c 6f 63 61 6c        "<tt>local
0d30: 68 6f 73 74 3c 2f 74 74 3e 22 2e 20 20 41 6e 79  host</tt>".  Any
0d40: 20 6f 74 68 65 72 20 61 75 74 68 6f 72 69 74 79   other authority
0d50: 20 72 65 73 75 6c 74 73 20 69 6e 20 61 6e 20 65   results in an e
0d60: 72 72 6f 72 2e 29 5e 0a 20 20 20 20 20 20 45 78  rror.)^.      Ex
0d70: 63 65 70 74 69 6f 6e 3a 20 49 66 20 53 51 4c 69  ception: If SQLi
0d80: 74 65 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77  te is compiled w
0d90: 69 74 68 20 5b 53 51 4c 49 54 45 5f 41 4c 4c 4f  ith [SQLITE_ALLO
0da0: 57 5f 55 52 49 5f 41 55 54 48 4f 52 49 54 59 5d  W_URI_AUTHORITY]
0db0: 0a 20 20 20 20 20 20 74 68 65 6e 20 61 6e 79 20  .      then any 
0dc0: 61 75 74 68 6f 72 69 74 79 20 76 61 6c 75 65 20  authority value 
0dd0: 6f 74 68 65 72 20 74 68 61 6e 20 22 6c 6f 63 61  other than "loca
0de0: 6c 68 6f 73 74 22 20 69 73 20 70 61 73 73 65 64  lhost" is passed
0df0: 20 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65 20   through to the 
0e00: 0a 20 20 20 20 20 20 75 6e 64 65 72 6c 79 69 6e  .      underlyin
0e10: 67 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74  g operating syst
0e20: 65 6d 20 61 73 20 61 20 55 4e 43 20 66 69 6c 65  em as a UNC file
0e30: 6e 61 6d 65 2e 0a 3c 6c 69 3e 20 5e 54 68 65 20  name..<li> ^The 
0e40: 70 61 74 68 20 69 73 20 6f 70 74 69 6f 6e 61 6c  path is optional
0e50: 20 69 66 20 74 68 65 20 61 75 74 68 6f 72 69 74   if the authorit
0e60: 79 20 69 73 20 70 72 65 73 65 6e 74 2e 20 20 5e  y is present.  ^
0e70: 49 66 20 74 68 65 20 61 75 74 68 6f 72 69 74 79  If the authority
0e80: 0a 20 20 20 20 20 69 73 20 6f 6d 69 74 74 65 64  .     is omitted
0e90: 20 74 68 65 6e 20 74 68 65 20 70 61 74 68 20 69   then the path i
0ea0: 73 20 72 65 71 75 69 72 65 64 2e 20 0a 3c 6c 69  s required. .<li
0eb0: 3e 20 5e 54 68 65 20 71 75 65 72 79 20 73 74 72  > ^The query str
0ec0: 69 6e 67 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e  ing is optional.
0ed0: 20 20 5e 49 66 20 74 68 65 20 71 75 65 72 79 20    ^If the query 
0ee0: 73 74 72 69 6e 67 20 69 73 20 70 72 65 73 65 6e  string is presen
0ef0: 74 2c 20 74 68 65 6e 0a 20 20 20 20 20 20 61 6c  t, then.      al
0f00: 6c 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65  l query paramete
0f10: 72 73 20 61 72 65 20 70 61 73 73 65 64 20 74 68  rs are passed th
0f20: 72 6f 75 67 68 20 69 6e 74 6f 20 74 68 65 20 78  rough into the x
0f30: 4f 70 65 6e 20 6d 65 74 68 6f 64 20 6f 66 0a 20  Open method of. 
0f40: 20 20 20 20 20 74 68 65 20 75 6e 64 65 72 6c 79       the underly
0f50: 69 6e 67 20 5b 56 46 53 5d 2e 20 20 0a 3c 6c 69  ing [VFS].  .<li
0f60: 3e 20 5e 28 54 68 65 20 66 72 61 67 6d 65 6e 74  > ^(The fragment
0f70: 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 49   is optional.  I
0f80: 66 20 70 72 65 73 65 6e 74 2c 20 69 74 20 69 73  f present, it is
0f90: 20 69 67 6e 6f 72 65 64 2e 29 5e 0a 3c 2f 75 6c   ignored.)^.</ul
0fa0: 3e 0a 0a 3c 70 3e 5e 5a 65 72 6f 20 6f 72 20 6d  >..<p>^Zero or m
0fb0: 6f 72 65 20 65 73 63 61 70 65 20 73 65 71 75 65  ore escape seque
0fc0: 6e 63 65 73 20 6f 66 20 74 68 65 20 66 6f 72 6d  nces of the form
0fd0: 20 20 22 3c 62 3e 25 3c 69 3e 48 48 3c 2f 69 3e    "<b>%<i>HH</i>
0fe0: 3c 2f 62 3e 22 20 0a 28 77 68 65 72 65 20 3c 62  </b>" .(where <b
0ff0: 3e 3c 69 3e 48 3c 2f 69 3e 3c 2f 62 3e 20 72 65  ><i>H</i></b> re
1000: 70 72 65 73 65 6e 74 73 20 61 6e 79 20 68 65 78  presents any hex
1010: 61 64 65 63 69 6d 61 6c 20 64 69 67 69 74 29 20  adecimal digit) 
1020: 63 61 6e 20 6f 63 63 75 72 20 0a 69 6e 20 74 68  can occur .in th
1030: 65 20 70 61 74 68 2c 20 71 75 65 72 79 20 73 74  e path, query st
1040: 72 69 6e 67 2c 20 6f 72 20 66 72 61 67 6d 65 6e  ring, or fragmen
1050: 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 5e 41 20 66 69  t.</p>..<p>^A fi
1060: 6c 65 6e 61 6d 65 20 74 68 61 74 20 69 73 20 6e  lename that is n
1070: 6f 74 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64  ot a well-formed
1080: 20 55 52 49 20 69 73 20 69 6e 74 65 72 70 72 65   URI is interpre
1090: 74 65 64 20 61 73 20 61 6e 0a 6f 72 64 69 6e 61  ted as an.ordina
10a0: 72 79 20 66 69 6c 65 6e 61 6d 65 2e 3c 2f 70 3e  ry filename.</p>
10b0: 0a 0a 3c 70 3e 5e 55 52 49 73 20 61 72 65 20 70  ..<p>^URIs are p
10c0: 72 6f 63 65 73 73 65 64 20 61 73 20 55 54 46 38  rocessed as UTF8
10d0: 20 74 65 78 74 2e 0a 5e 54 68 65 20 66 69 6c 65   text..^The file
10e0: 6e 61 6d 65 20 61 72 67 75 6d 65 6e 74 20 73 71  name argument sq
10f0: 6c 69 74 65 33 5f 6f 70 65 6e 31 36 28 29 20 69  lite3_open16() i
1100: 73 20 63 6f 6e 76 65 72 74 65 64 20 66 72 6f 6d  s converted from
1110: 20 55 54 46 31 36 20 0a 6e 61 74 69 76 65 20 62   UTF16 .native b
1120: 79 74 65 20 6f 72 64 65 72 20 69 6e 74 6f 20 55  yte order into U
1130: 54 46 38 20 70 72 69 6f 72 20 74 6f 20 70 72 6f  TF8 prior to pro
1140: 63 65 73 73 69 6e 67 2e 0a 0a 3c 68 32 3e 33 2e  cessing...<h2>3.
1150: 31 20 54 68 65 20 55 52 49 20 50 61 74 68 3c 2f  1 The URI Path</
1160: 68 32 3e 0a 0a 3c 70 3e 5e 54 68 65 20 70 61 74  h2>..<p>^The pat
1170: 68 20 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 74  h component of t
1180: 68 65 20 55 52 49 20 73 70 65 63 69 66 69 65 73  he URI specifies
1190: 20 74 68 65 20 64 69 73 6b 20 66 69 6c 65 20 74   the disk file t
11a0: 68 61 74 20 69 73 20 74 68 65 0a 53 51 4c 69 74  hat is the.SQLit
11b0: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 62 65  e database to be
11c0: 20 6f 70 65 6e 65 64 2e 20 20 5e 28 49 66 20 74   opened.  ^(If t
11d0: 68 65 20 70 61 74 68 20 63 6f 6d 70 6f 6e 65 6e  he path componen
11e0: 74 20 69 73 20 6f 6d 69 74 74 65 64 2c 20 74 68  t is omitted, th
11f0: 65 6e 0a 74 68 65 20 64 61 74 61 62 61 73 65 20  en.the database 
1200: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 74  is stored in a t
1210: 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 74 68  emporary file th
1220: 61 74 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d  at will be autom
1230: 61 74 69 63 61 6c 6c 79 0a 64 65 6c 65 74 65 64  atically.deleted
1240: 20 77 68 65 6e 20 74 68 65 20 64 61 74 61 62 61   when the databa
1250: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 63 6c  se connection cl
1260: 6f 73 65 73 2e 29 5e 20 20 5e 49 66 20 74 68 65  oses.)^  ^If the
1270: 20 61 75 74 68 6f 72 69 74 79 20 73 65 63 74 69   authority secti
1280: 6f 6e 0a 69 73 20 70 72 65 73 65 6e 74 2c 20 74  on.is present, t
1290: 68 65 6e 20 74 68 65 20 70 61 74 68 20 69 73 20  hen the path is 
12a0: 61 6c 77 61 79 73 20 61 6e 20 61 62 73 6f 6c 75  always an absolu
12b0: 74 65 20 70 61 74 68 6e 61 6d 65 2e 20 20 5e 49  te pathname.  ^I
12c0: 66 20 74 68 65 20 0a 61 75 74 68 6f 72 69 74 79  f the .authority
12d0: 20 73 65 63 74 69 6f 6e 20 69 73 20 6f 6d 69 74   section is omit
12e0: 74 65 64 2c 20 74 68 65 6e 20 74 68 65 20 70 61  ted, then the pa
12f0: 74 68 20 69 73 20 61 6e 20 61 62 73 6f 6c 75 74  th is an absolut
1300: 65 20 70 61 74 68 6e 61 6d 65 20 69 66 20 69 74  e pathname if it
1310: 0a 62 65 67 69 6e 73 20 77 69 74 68 20 74 68 65  .begins with the
1320: 20 22 2f 22 20 63 68 61 72 61 63 74 65 72 20 28   "/" character (
1330: 41 53 43 49 49 20 63 6f 64 65 20 30 78 32 66 29  ASCII code 0x2f)
1340: 20 61 6e 64 20 69 73 20 61 20 72 65 6c 61 74 69   and is a relati
1350: 76 65 0a 70 61 74 68 6e 61 6d 65 20 6f 74 68 65  ve.pathname othe
1360: 72 77 69 73 65 2e 20 20 5e 28 4f 6e 20 77 69 6e  rwise.  ^(On win
1370: 64 6f 77 73 2c 20 69 66 20 74 68 65 20 61 62 73  dows, if the abs
1380: 6f 6c 75 74 65 20 70 61 74 68 20 62 65 67 69 6e  olute path begin
1390: 73 20 77 69 74 68 0a 22 3c 62 3e 2f 3c 69 3e 58  s with."<b>/<i>X
13a0: 3c 2f 69 3e 3a 2f 3c 2f 62 3e 22 20 77 68 65 72  </i>:/</b>" wher
13b0: 65 20 3c 62 3e 3c 69 3e 58 3c 2f 69 3e 3c 2f 62  e <b><i>X</i></b
13c0: 3e 20 69 73 20 61 6e 79 20 73 69 6e 67 6c 65 20  > is any single 
13d0: 41 53 43 49 49 20 61 6c 70 68 61 62 65 74 69 63  ASCII alphabetic
13e0: 0a 63 68 61 72 61 63 74 65 72 20 28 22 61 22 20  .character ("a" 
13f0: 74 68 72 6f 75 67 68 20 22 7a 22 20 6f 72 20 22  through "z" or "
1400: 41 22 20 74 68 72 6f 75 67 68 20 22 5a 22 29 20  A" through "Z") 
1410: 74 68 65 6e 20 74 68 65 20 22 3c 62 3e 3c 69 3e  then the "<b><i>
1420: 58 3a 3c 2f 69 3e 3c 2f 62 3e 22 0a 69 73 20 75  X:</i></b>".is u
1430: 6e 64 65 72 73 74 6f 6f 64 20 74 6f 20 62 65 20  nderstood to be 
1440: 74 68 65 20 64 72 69 76 65 20 6c 65 74 74 65 72  the drive letter
1450: 20 6f 66 20 74 68 65 20 76 6f 6c 75 6d 65 20 63   of the volume c
1460: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 66 69  ontaining the fi
1470: 6c 65 2c 0a 6e 6f 74 20 74 68 65 20 74 6f 70 6c  le,.not the topl
1480: 65 76 65 6c 20 64 69 72 65 63 74 6f 72 79 2e 29  evel directory.)
1490: 5e 0a 0a 3c 70 3e 41 6e 20 6f 72 64 69 6e 61 72  ^..<p>An ordinar
14a0: 79 20 66 69 6c 65 6e 61 6d 65 20 63 61 6e 20 75  y filename can u
14b0: 73 75 61 6c 6c 79 20 62 65 20 63 6f 6e 76 65 72  sually be conver
14c0: 74 65 64 20 69 6e 74 6f 20 61 6e 20 65 71 75 69  ted into an equi
14d0: 76 61 6c 65 6e 74 20 55 52 49 20 0a 62 79 20 74  valent URI .by t
14e0: 68 65 20 73 74 65 70 73 20 73 68 6f 77 6e 20 62  he steps shown b
14f0: 65 6c 6f 77 2e 20 20 54 68 65 20 6f 6e 65 20 65  elow.  The one e
1500: 78 63 65 70 74 69 6f 6e 20 69 73 20 74 68 61 74  xception is that
1510: 20 61 20 72 65 6c 61 74 69 76 65 20 77 69 6e 64   a relative wind
1520: 6f 77 73 0a 70 61 74 68 6e 61 6d 65 20 77 69 74  ows.pathname wit
1530: 68 20 61 20 64 72 69 76 65 20 6c 65 74 74 65 72  h a drive letter
1540: 20 63 61 6e 6e 6f 74 20 62 65 20 63 6f 6e 76 65   cannot be conve
1550: 72 74 65 64 20 64 69 72 65 63 74 6c 79 20 69 6e  rted directly in
1560: 74 6f 20 61 20 55 52 49 3b 20 69 74 20 6d 75 73  to a URI; it mus
1570: 74 0a 62 65 20 63 68 61 6e 67 65 64 20 69 6e 74  t.be changed int
1580: 6f 20 61 6e 20 61 62 73 6f 6c 75 74 65 20 70 61  o an absolute pa
1590: 74 68 6e 61 6d 65 20 66 69 72 73 74 2e 3c 2f 70  thname first.</p
15a0: 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 43 6f 6e 76  >..<ol>.<li>Conv
15b0: 65 72 74 20 61 6c 6c 20 22 3c 74 74 3e 3f 3c 2f  ert all "<tt>?</
15c0: 74 74 3e 22 20 63 68 61 72 61 63 74 65 72 73 20  tt>" characters 
15d0: 69 6e 74 6f 20 22 3c 74 74 3e 25 33 66 3c 2f 74  into "<tt>%3f</t
15e0: 74 3e 22 2e 0a 3c 6c 69 3e 43 6f 6e 76 65 72 74  t>"..<li>Convert
15f0: 20 61 6c 6c 20 22 3c 74 74 3e 23 3c 2f 74 74 3e   all "<tt>#</tt>
1600: 22 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 74  " characters int
1610: 6f 20 22 3c 74 74 3e 25 32 33 3c 2f 74 74 3e 22  o "<tt>%23</tt>"
1620: 2e 0a 3c 6c 69 3e 4f 6e 20 77 69 6e 64 6f 77 73  ..<li>On windows
1630: 20 6f 6e 6c 79 2c 20 63 6f 6e 76 65 72 74 20 61   only, convert a
1640: 6c 6c 20 22 3c 74 74 3e 5c 3c 2f 74 74 3e 22 20  ll "<tt>\</tt>" 
1650: 63 68 61 72 61 63 74 65 72 73 20 69 6e 74 6f 20  characters into 
1660: 22 3c 74 74 3e 2f 3c 2f 74 74 3e 22 2e 0a 3c 6c  "<tt>/</tt>"..<l
1670: 69 3e 43 6f 6e 76 65 72 74 20 61 6c 6c 20 73 65  i>Convert all se
1680: 71 75 65 6e 63 65 73 20 6f 66 20 74 77 6f 20 6f  quences of two o
1690: 72 20 6d 6f 72 65 20 22 3c 74 74 3e 2f 3c 2f 74  r more "<tt>/</t
16a0: 74 3e 22 20 63 68 61 72 61 63 74 65 72 73 20 69  t>" characters i
16b0: 6e 74 6f 20 61 0a 20 20 20 20 73 69 6e 67 6c 65  nto a.    single
16c0: 20 22 3c 74 74 3e 2f 3c 2f 74 74 3e 22 20 63 68   "<tt>/</tt>" ch
16d0: 61 72 61 63 74 65 72 2e 0a 3c 6c 69 3e 4f 6e 20  aracter..<li>On 
16e0: 77 69 6e 64 6f 77 73 20 6f 6e 6c 79 2c 20 69 66  windows only, if
16f0: 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 62 65   the filename be
1700: 67 69 6e 73 20 77 69 74 68 20 61 20 64 72 69 76  gins with a driv
1710: 65 20 6c 65 74 74 65 72 2c 20 70 72 65 70 65 6e  e letter, prepen
1720: 64 0a 20 20 20 20 61 20 73 69 6e 67 6c 65 20 22  d.    a single "
1730: 3c 74 74 3e 2f 3c 2f 74 74 3e 22 20 63 68 61 72  <tt>/</tt>" char
1740: 61 63 74 65 72 2e 0a 3c 6c 69 3e 50 72 65 70 65  acter..<li>Prepe
1750: 6e 64 20 74 68 65 20 22 3c 74 74 3e 66 69 6c 65  nd the "<tt>file
1760: 3a 3c 2f 74 74 3e 22 20 73 63 68 65 6d 65 2e 0a  :</tt>" scheme..
1770: 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 33 2e 32 20 51  </ol>..<h2>3.2 Q
1780: 75 65 72 79 20 53 74 72 69 6e 67 3c 2f 68 32 3e  uery String</h2>
1790: 0a 0a 3c 70 3e 5e 41 20 55 52 49 20 66 69 6c 65  ..<p>^A URI file
17a0: 6e 61 6d 65 20 63 61 6e 20 6f 70 74 69 6f 6e 61  name can optiona
17b0: 6c 6c 79 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20  lly be followed 
17c0: 62 79 20 61 20 71 75 65 72 79 20 73 74 72 69 6e  by a query strin
17d0: 67 2e 0a 5e 54 68 65 20 71 75 65 72 79 20 73 74  g..^The query st
17e0: 72 69 6e 67 20 63 6f 6e 73 69 73 74 73 20 6f 66  ring consists of
17f0: 20 74 65 78 74 20 66 6f 6c 6c 6f 77 69 6e 67 20   text following 
1800: 74 68 65 20 66 69 72 73 74 20 22 3c 74 74 3e 3f  the first "<tt>?
1810: 3c 2f 74 74 3e 22 0a 63 68 61 72 61 63 74 65 72  </tt>".character
1820: 20 62 75 74 20 65 78 63 6c 75 64 69 6e 67 20 74   but excluding t
1830: 68 65 20 6f 70 74 69 6f 6e 61 6c 20 66 72 61 67  he optional frag
1840: 6d 65 6e 74 20 74 68 61 74 20 62 65 67 69 6e 73  ment that begins
1850: 20 77 69 74 68 0a 22 3c 74 74 3e 23 3c 2f 74 74   with."<tt>#</tt
1860: 3e 22 2e 20 20 5e 54 68 65 20 71 75 65 72 79 20  >".  ^The query 
1870: 73 74 72 69 6e 67 20 69 73 20 64 69 76 69 64 65  string is divide
1880: 64 20 69 6e 74 6f 20 6b 65 79 2f 76 61 6c 75 65  d into key/value
1890: 20 70 61 69 72 73 2e 0a 57 65 20 75 73 75 61 6c   pairs..We usual
18a0: 6c 79 20 72 65 66 65 72 20 74 6f 20 74 68 65 73  ly refer to thes
18b0: 65 20 6b 65 79 2f 76 61 6c 75 65 20 70 61 69 72  e key/value pair
18c0: 73 20 61 73 20 22 71 75 65 72 79 20 70 61 72 61  s as "query para
18d0: 6d 65 74 65 72 73 22 2e 0a 5e 4b 65 79 2f 76 61  meters"..^Key/va
18e0: 6c 75 65 20 70 61 69 72 73 20 61 72 65 20 73 65  lue pairs are se
18f0: 70 61 72 61 74 65 64 20 62 79 20 61 20 73 69 6e  parated by a sin
1900: 67 6c 65 20 22 3c 74 74 3e 26 61 6d 70 3b 3c 2f  gle "<tt>&amp;</
1910: 74 74 3e 22 20 63 68 61 72 61 63 74 65 72 2e 0a  tt>" character..
1920: 5e 54 68 65 20 6b 65 79 20 63 6f 6d 65 73 20 66  ^The key comes f
1930: 69 72 73 74 20 61 6e 64 20 69 73 20 73 65 70 61  irst and is sepa
1940: 72 61 74 65 64 20 66 72 6f 6d 20 74 68 65 20 76  rated from the v
1950: 61 6c 75 65 20 62 79 20 61 20 73 69 6e 67 6c 65  alue by a single
1960: 0a 22 3c 74 74 3e 3d 3c 2f 74 74 3e 22 20 63 68  ."<tt>=</tt>" ch
1970: 61 72 61 63 74 65 72 2e 0a 5e 42 6f 74 68 20 6b  aracter..^Both k
1980: 65 79 20 61 6e 64 20 76 61 6c 75 65 20 6d 61 79  ey and value may
1990: 20 63 6f 6e 74 61 69 6e 20 3c 62 3e 25 48 48 3c   contain <b>%HH<
19a0: 2f 62 3e 20 65 73 63 61 70 65 20 73 65 71 75 65  /b> escape seque
19b0: 6e 63 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 5e  nces.</p>..<p>.^
19c0: 54 68 65 20 74 65 78 74 20 6f 66 20 71 75 65 72  The text of quer
19d0: 79 20 70 61 72 61 6d 65 74 65 72 73 20 69 73 20  y parameters is 
19e0: 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20  appended to the 
19f0: 66 69 6c 65 6e 61 6d 65 20 61 72 67 75 6d 65 6e  filename argumen
1a00: 74 20 6f 66 0a 74 68 65 20 78 4f 70 65 6e 20 6d  t of.the xOpen m
1a10: 65 74 68 6f 64 20 6f 66 20 74 68 65 20 5b 56 46  ethod of the [VF
1a20: 53 5d 2e 0a 5e 41 6e 79 20 25 48 48 20 65 73 63  S]..^Any %HH esc
1a30: 61 70 65 20 73 65 71 75 65 6e 63 65 73 20 69 6e  ape sequences in
1a40: 20 74 68 65 20 71 75 65 72 79 20 70 61 72 61 6d   the query param
1a50: 65 74 65 72 73 20 61 72 65 20 72 65 73 6f 6c 76  eters are resolv
1a60: 65 64 20 70 72 69 6f 72 20 74 6f 0a 62 65 69 6e  ed prior to.bein
1a70: 67 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68  g appended to th
1a80: 65 20 78 4f 70 65 6e 20 66 69 6c 65 6e 61 6d 65  e xOpen filename
1a90: 2e 0a 5e 41 20 73 69 6e 67 6c 65 20 7a 65 72 6f  ..^A single zero
1aa0: 2d 62 79 74 65 20 73 65 70 61 72 61 74 65 73 20  -byte separates 
1ab0: 74 68 65 20 78 4f 70 65 6e 20 66 69 6c 65 6e 61  the xOpen filena
1ac0: 6d 65 20 61 72 67 75 6d 65 6e 74 20 66 72 6f 6d  me argument from
1ad0: 20 74 68 65 20 6b 65 79 20 6f 66 0a 74 68 65 20   the key of.the 
1ae0: 66 69 72 73 74 20 71 75 65 72 79 20 70 61 72 61  first query para
1af0: 6d 65 74 65 72 73 2c 20 65 61 63 68 20 6b 65 79  meters, each key
1b00: 20 61 6e 64 20 76 61 6c 75 65 2c 20 61 6e 64 20   and value, and 
1b10: 65 61 63 68 20 73 75 62 73 65 71 75 65 6e 74 20  each subsequent 
1b20: 6b 65 79 0a 66 72 6f 6d 20 74 68 65 20 70 72 69  key.from the pri
1b30: 6f 72 20 76 61 6c 75 65 2e 0a 5e 54 68 65 20 6c  or value..^The l
1b40: 69 73 74 20 6f 66 20 71 75 65 72 79 20 70 61 72  ist of query par
1b50: 61 6d 65 74 65 72 73 20 61 70 70 65 6e 64 65 64  ameters appended
1b60: 20 74 6f 20 74 68 65 20 78 4f 70 65 6e 20 66 69   to the xOpen fi
1b70: 6c 65 6e 61 6d 65 0a 69 73 20 74 65 72 6d 69 6e  lename.is termin
1b80: 61 74 65 64 20 62 79 20 61 20 73 69 6e 67 6c 65  ated by a single
1b90: 20 7a 65 72 6f 2d 6c 65 6e 67 74 68 20 6b 65 79   zero-length key
1ba0: 2e 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20  ..Note that the 
1bb0: 76 61 6c 75 65 20 6f 66 20 61 20 71 75 65 72 79  value of a query
1bc0: 20 70 61 72 61 6d 65 74 65 72 20 63 61 6e 20 62   parameter can b
1bd0: 65 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69 6e  e an empty strin
1be0: 67 2e 0a 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 68 64  g..</p>..<tcl>hd
1bf0: 5f 66 72 61 67 6d 65 6e 74 20 63 6f 72 65 71 70  _fragment coreqp
1c00: 20 2a 63 6f 72 65 71 70 20 7b 73 74 61 6e 64 61   *coreqp {standa
1c10: 72 64 20 71 75 65 72 79 20 70 61 72 61 6d 65 74  rd query paramet
1c20: 65 72 73 7d 20 7b 55 52 49 20 71 75 65 72 79 20  ers} {URI query 
1c30: 70 61 72 61 6d 65 74 65 72 73 7d 20 5c 0a 20 20  parameters} \.  
1c40: 20 20 7b 71 75 65 72 79 20 70 61 72 61 6d 65 74    {query paramet
1c50: 65 72 73 20 77 69 74 68 20 73 70 65 63 69 61 6c  ers with special
1c60: 20 6d 65 61 6e 69 6e 67 20 74 6f 20 53 51 4c 69   meaning to SQLi
1c70: 74 65 7d 3c 2f 74 63 6c 3e 0a 3c 68 32 3e 33 2e  te}</tcl>.<h2>3.
1c80: 33 20 52 65 63 6f 67 6e 69 7a 65 64 20 51 75 65  3 Recognized Que
1c90: 72 79 20 50 61 72 61 6d 65 74 65 72 73 3c 2f 68  ry Parameters</h
1ca0: 32 3e 0a 0a 3c 70 3e 0a 53 6f 6d 65 20 71 75 65  2>..<p>.Some que
1cb0: 72 79 20 70 61 72 61 6d 65 74 65 72 73 20 61 72  ry parameters ar
1cc0: 65 20 69 6e 74 65 72 70 72 65 74 65 64 20 62 79  e interpreted by
1cd0: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65   the SQLite core
1ce0: 20 61 6e 64 20 75 73 65 64 20 74 6f 20 0a 6d 6f   and used to .mo
1cf0: 64 69 66 79 20 74 68 65 20 63 68 61 72 61 63 74  dify the charact
1d00: 65 72 69 73 74 69 63 73 20 6f 66 20 74 68 65 20  eristics of the 
1d10: 6e 65 77 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20  new connection. 
1d20: 20 5e 41 6c 6c 20 71 75 65 72 79 20 70 61 72 61   ^All query para
1d30: 6d 65 74 65 72 73 0a 61 72 65 20 61 6c 77 61 79  meters.are alway
1d40: 73 20 70 61 73 73 65 64 20 74 68 72 6f 75 67 68  s passed through
1d50: 20 69 6e 74 6f 20 74 68 65 20 78 4f 70 65 6e 20   into the xOpen 
1d60: 6d 65 74 68 6f 64 20 6f 66 20 74 68 65 20 5b 56  method of the [V
1d70: 46 53 5d 20 65 76 65 6e 20 69 66 0a 74 68 65 79  FS] even if.they
1d80: 20 61 72 65 20 70 72 65 76 69 6f 75 73 6c 79 20   are previously 
1d90: 72 65 61 64 20 61 6e 64 20 69 6e 74 65 72 70 72  read and interpr
1da0: 65 74 65 64 20 62 79 20 74 68 65 20 53 51 4c 69  eted by the SQLi
1db0: 74 65 20 63 6f 72 65 2e 0a 3c 2f 70 3e 0a 0a 3c  te core..</p>..<
1dc0: 70 3e 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  p>.The following
1dd0: 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72   query parameter
1de0: 73 20 61 72 65 20 72 65 63 6f 67 6e 69 7a 65 64  s are recognized
1df0: 20 62 79 20 53 51 4c 69 74 65 20 61 73 20 6f 66   by SQLite as of
1e00: 20 76 65 72 73 69 6f 6e 20 33 2e 38 2e 30 2e 0a   version 3.8.0..
1e10: 4f 74 68 65 72 20 71 75 65 72 79 20 70 61 72 61  Other query para
1e20: 6d 65 74 65 72 73 20 6d 69 67 68 74 20 62 65 20  meters might be 
1e30: 61 64 64 65 64 20 74 6f 20 74 68 69 73 20 73 65  added to this se
1e40: 74 20 69 6e 20 66 75 74 75 72 65 20 72 65 6c 65  t in future rele
1e50: 61 73 65 73 2e 0a 3c 2f 70 3e 0a 0a 3c 64 6c 3e  ases..</p>..<dl>
1e60: 0a 3c 74 63 6c 3e 68 64 5f 66 72 61 67 6d 65 6e  .<tcl>hd_fragmen
1e70: 74 20 75 72 69 76 66 73 20 7b 22 76 66 73 22 20  t urivfs {"vfs" 
1e80: 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 7d  query parameter}
1e90: 3c 2f 74 63 6c 3e 0a 3c 64 74 3e 3c 62 3e 76 66  </tcl>.<dt><b>vf
1ea0: 73 3d 3c 2f 62 3e 3c 69 3e 4e 41 4d 45 3c 2f 69  s=</b><i>NAME</i
1eb0: 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70 3e 5e 54  ></dt>.<dd><p>^T
1ec0: 68 65 20 76 66 73 20 71 75 65 72 79 20 70 61 72  he vfs query par
1ed0: 61 6d 65 74 65 72 20 63 61 75 73 65 73 20 74 68  ameter causes th
1ee0: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  e database conne
1ef0: 63 74 69 6f 6e 20 74 6f 20 62 65 20 6f 70 65 6e  ction to be open
1f00: 65 64 0a 75 73 69 6e 67 20 74 68 65 20 5b 56 46  ed.using the [VF
1f10: 53 5d 20 63 61 6c 6c 65 64 20 3c 69 3e 4e 41 4d  S] called <i>NAM
1f20: 45 3c 2f 69 3e 2e 0a 5e 54 68 65 20 6f 70 65 6e  E</i>..^The open
1f30: 20 61 74 74 65 6d 70 74 20 66 61 69 6c 73 20 69   attempt fails i
1f40: 66 20 3c 69 3e 4e 41 4d 45 3c 2f 69 3e 20 69 73  f <i>NAME</i> is
1f50: 20 6e 6f 74 20 74 68 65 20 6e 61 6d 65 20 6f 66   not the name of
1f60: 20 61 20 5b 56 46 53 5d 20 74 68 61 74 0a 69 73   a [VFS] that.is
1f70: 20 62 75 69 6c 74 20 69 6e 74 6f 20 53 51 4c 69   built into SQLi
1f80: 74 65 20 6f 72 20 74 68 61 74 20 68 61 73 20 62  te or that has b
1f90: 65 65 6e 20 70 72 65 76 69 6f 75 73 6c 79 20 72  een previously r
1fa0: 65 67 69 73 74 65 72 65 64 20 75 73 69 6e 67 0a  egistered using.
1fb0: 5b 73 71 6c 69 74 65 33 5f 76 66 73 5f 72 65 67  [sqlite3_vfs_reg
1fc0: 69 73 74 65 72 28 29 5d 2e 3c 2f 64 64 3e 0a 0a  ister()].</dd>..
1fd0: 3c 74 63 6c 3e 68 64 5f 66 72 61 67 6d 65 6e 74  <tcl>hd_fragment
1fe0: 20 75 72 69 6d 6f 64 65 20 7b 22 6d 6f 64 65 22   urimode {"mode"
1ff0: 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72   query parameter
2000: 7d 3c 2f 74 63 6c 3e 0a 3c 64 74 3e 3c 62 3e 6d  }</tcl>.<dt><b>m
2010: 6f 64 65 3d 72 6f 3c 62 72 3e 6d 6f 64 65 3d 72  ode=ro<br>mode=r
2020: 77 3c 62 72 3e 6d 6f 64 65 3d 72 77 63 3c 62 72  w<br>mode=rwc<br
2030: 3e 6d 6f 64 65 3d 6d 65 6d 6f 72 79 3c 2f 62 3e  >mode=memory</b>
2040: 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70 3e 5e 54 68  </dt>.<dd><p>^Th
2050: 65 20 6d 6f 64 65 20 71 75 65 72 79 20 70 61 72  e mode query par
2060: 61 6d 65 74 65 72 20 64 65 74 65 72 6d 69 6e 65  ameter determine
2070: 73 20 69 66 20 74 68 65 20 6e 65 77 20 64 61 74  s if the new dat
2080: 61 62 61 73 65 20 69 73 20 6f 70 65 6e 65 64 0a  abase is opened.
2090: 72 65 61 64 2d 6f 6e 6c 79 2c 20 72 65 61 64 2d  read-only, read-
20a0: 77 72 69 74 65 2c 20 72 65 61 64 2d 77 72 69 74  write, read-writ
20b0: 65 20 61 6e 64 20 63 72 65 61 74 65 64 20 69 66  e and created if
20c0: 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 69   it does not exi
20d0: 73 74 2c 20 6f 72 0a 74 68 61 74 20 74 68 65 20  st, or.that the 
20e0: 64 61 74 61 62 61 73 65 20 69 73 20 61 20 70 75  database is a pu
20f0: 72 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74  re in-memory dat
2100: 61 62 61 73 65 20 74 68 61 74 20 6e 65 76 65 72  abase that never
2110: 20 69 6e 74 65 72 61 63 74 73 20 77 69 74 68 0a   interacts with.
2120: 64 69 73 6b 2c 20 72 65 73 70 65 63 74 69 76 65  disk, respective
2130: 6c 79 2e 0a 3c 2f 64 64 3e 0a 0a 3c 74 63 6c 3e  ly..</dd>..<tcl>
2140: 68 64 5f 66 72 61 67 6d 65 6e 74 20 75 72 69 63  hd_fragment uric
2150: 61 63 68 65 20 7b 22 63 61 63 68 65 22 20 71 75  ache {"cache" qu
2160: 65 72 79 20 70 61 72 61 6d 65 74 65 72 7d 3c 2f  ery parameter}</
2170: 74 63 6c 3e 0a 3c 64 74 3e 3c 62 3e 63 61 63 68  tcl>.<dt><b>cach
2180: 65 3d 73 68 61 72 65 64 3c 62 72 3e 63 61 63 68  e=shared<br>cach
2190: 65 3d 70 72 69 76 61 74 65 3c 2f 62 3e 3c 2f 64  e=private</b></d
21a0: 74 3e 0a 3c 64 64 3e 3c 70 3e 5e 54 68 65 20 63  t>.<dd><p>^The c
21b0: 61 63 68 65 20 71 75 65 72 79 20 70 61 72 61 6d  ache query param
21c0: 65 74 65 72 20 64 65 74 65 72 6d 69 6e 65 73 20  eter determines 
21d0: 69 66 20 74 68 65 20 6e 65 77 20 64 61 74 61 62  if the new datab
21e0: 61 73 65 20 69 73 20 6f 70 65 6e 65 64 0a 75 73  ase is opened.us
21f0: 69 6e 67 20 5b 73 68 61 72 65 64 20 63 61 63 68  ing [shared cach
2200: 65 20 6d 6f 64 65 5d 20 6f 72 20 77 69 74 68 20  e mode] or with 
2210: 61 20 70 72 69 76 61 74 65 20 63 61 63 68 65 2e  a private cache.
2220: 0a 3c 2f 64 64 3e 0a 0a 3c 74 63 6c 3e 68 64 5f  .</dd>..<tcl>hd_
2230: 66 72 61 67 6d 65 6e 74 20 75 72 69 70 73 6f 77  fragment uripsow
2240: 20 7b 22 70 73 6f 77 22 20 71 75 65 72 79 20 70   {"psow" query p
2250: 61 72 61 6d 65 74 65 72 7d 3c 2f 74 63 6c 3e 0a  arameter}</tcl>.
2260: 3c 64 74 3e 3c 62 3e 70 73 6f 77 3d 30 3c 62 72  <dt><b>psow=0<br
2270: 3e 70 73 6f 77 3d 31 3c 2f 62 3e 3c 2f 64 74 3e  >psow=1</b></dt>
2280: 0a 3c 64 64 3e 3c 70 3e 5e 54 68 65 20 70 73 6f  .<dd><p>^The pso
2290: 77 20 71 75 65 72 79 20 70 61 72 61 6d 65 74 65  w query paramete
22a0: 72 20 6f 76 65 72 72 69 64 65 73 20 74 68 65 20  r overrides the 
22b0: 5b 70 6f 77 65 72 73 61 66 65 20 6f 76 65 72 77  [powersafe overw
22c0: 72 69 74 65 5d 0a 70 72 6f 70 65 72 74 79 20 6f  rite].property o
22d0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  f the database f
22e0: 69 6c 65 20 62 65 69 6e 67 20 6f 70 65 6e 65 64  ile being opened
22f0: 2e 20 20 5e 54 68 65 20 70 73 6f 77 20 71 75 65  .  ^The psow que
2300: 72 79 20 70 61 72 61 6d 65 74 65 72 0a 77 6f 72  ry parameter.wor
2310: 6b 73 20 77 69 74 68 20 74 68 65 20 64 65 66 61  ks with the defa
2320: 75 6c 74 20 77 69 6e 64 6f 77 73 20 61 6e 64 20  ult windows and 
2330: 75 6e 69 78 20 5b 56 46 53 65 73 5d 20 62 75 74  unix [VFSes] but
2340: 20 6d 69 67 68 74 20 62 65 20 61 20 6e 6f 2d 6f   might be a no-o
2350: 70 20 66 6f 72 0a 6f 74 68 65 72 20 70 72 6f 70  p for.other prop
2360: 72 69 65 74 61 72 79 20 6f 72 20 6e 6f 6e 2d 73  rietary or non-s
2370: 74 61 6e 64 61 72 64 20 56 46 53 65 73 2e 0a 3c  tandard VFSes..<
2380: 2f 64 64 3e 0a 0a 3c 74 63 6c 3e 68 64 5f 66 72  /dd>..<tcl>hd_fr
2390: 61 67 6d 65 6e 74 20 75 72 69 6e 6f 6c 6f 63 6b  agment urinolock
23a0: 20 7b 22 6e 6f 6c 6f 63 6b 22 20 71 75 65 72 79   {"nolock" query
23b0: 20 70 61 72 61 6d 65 74 65 72 7d 3c 2f 74 63 6c   parameter}</tcl
23c0: 3e 0a 3c 64 74 3e 3c 62 3e 6e 6f 6c 6f 63 6b 3d  >.<dt><b>nolock=
23d0: 31 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c  1</b></dt>.<dd><
23e0: 70 3e 5e 54 68 65 20 6e 6f 6c 6f 63 6b 20 71 75  p>^The nolock qu
23f0: 65 72 79 20 70 61 72 61 6d 65 74 65 72 20 69 73  ery parameter is
2400: 20 61 20 62 6f 6f 6c 65 61 6e 20 74 68 61 74 20   a boolean that 
2410: 64 69 73 61 62 6c 65 73 20 61 6c 6c 20 63 61 6c  disables all cal
2420: 6c 73 0a 74 6f 20 74 68 65 20 78 4c 6f 63 6b 2c  ls.to the xLock,
2430: 20 78 55 6e 6c 6f 63 6b 2c 20 61 6e 64 20 78 43   xUnlock, and xC
2440: 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b  heckReservedLock
2450: 20 6d 65 74 68 6f 64 73 20 6f 66 20 74 68 65 20   methods of the 
2460: 56 46 53 20 77 68 65 6e 20 74 72 75 65 2e 0a 54  VFS when true..T
2470: 68 65 20 6e 6f 6c 6f 63 6b 20 71 75 65 72 79 20  he nolock query 
2480: 70 61 72 61 6d 65 74 65 72 20 6d 69 67 68 74 20  parameter might 
2490: 62 65 20 75 73 65 64 2c 20 66 6f 72 20 65 78 61  be used, for exa
24a0: 6d 70 6c 65 2c 20 77 68 65 6e 20 74 72 79 69 6e  mple, when tryin
24b0: 67 20 74 6f 0a 61 63 63 65 73 73 20 61 20 66 69  g to.access a fi
24c0: 6c 65 20 6f 6e 20 61 20 66 69 6c 65 73 79 73 74  le on a filesyst
24d0: 65 6d 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74  em that does not
24e0: 20 73 75 70 70 6f 72 74 20 66 69 6c 65 20 6c 6f   support file lo
24f0: 63 6b 69 6e 67 2e 0a 43 61 75 74 69 6f 6e 3a 20  cking..Caution: 
2500: 20 49 66 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20   If two or more 
2510: 5b 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63  [database connec
2520: 74 69 6f 6e 73 5d 20 74 72 79 20 74 6f 20 69 6e  tions] try to in
2530: 74 65 72 61 63 74 20 77 69 74 68 20 0a 74 68 65  teract with .the
2540: 20 73 61 6d 65 20 53 51 4c 69 74 65 20 64 61 74   same SQLite dat
2550: 61 62 61 73 65 20 61 6e 64 20 6f 6e 65 20 6f 72  abase and one or
2560: 20 6d 6f 72 65 20 6f 66 20 74 68 6f 73 65 20 63   more of those c
2570: 6f 6e 6e 65 63 74 69 6f 6e 73 20 68 61 73 0a 65  onnections has.e
2580: 6e 61 62 6c 65 64 20 22 6e 6f 6c 6f 63 6b 22 2c  nabled "nolock",
2590: 20 74 68 65 6e 20 64 61 74 61 62 61 73 65 20 63   then database c
25a0: 6f 72 72 75 70 74 69 6f 6e 20 63 61 6e 20 72 65  orruption can re
25b0: 73 75 6c 74 2e 20 20 54 68 65 20 22 6e 6f 6c 6f  sult.  The "nolo
25c0: 63 6b 22 0a 71 75 65 72 79 20 70 61 72 61 6d 65  ck".query parame
25d0: 74 65 72 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20  ter should only 
25e0: 62 65 20 75 73 65 64 20 69 66 20 74 68 65 20 61  be used if the a
25f0: 70 70 6c 69 63 61 74 69 6f 6e 20 63 61 6e 20 67  pplication can g
2600: 75 61 72 61 6e 74 65 65 0a 74 68 61 74 20 77 72  uarantee.that wr
2610: 69 74 65 73 20 74 6f 20 74 68 65 20 64 61 74 61  ites to the data
2620: 62 61 73 65 20 61 72 65 20 73 65 72 69 61 6c 69  base are seriali
2630: 7a 65 64 2e 0a 3c 2f 64 64 3e 0a 0a 3c 74 63 6c  zed..</dd>..<tcl
2640: 3e 68 64 5f 66 72 61 67 6d 65 6e 74 20 75 72 69  >hd_fragment uri
2650: 69 6d 6d 75 74 61 62 6c 65 20 7b 22 69 6d 6d 75  immutable {"immu
2660: 74 61 62 6c 65 22 20 71 75 65 72 79 20 70 61 72  table" query par
2670: 61 6d 65 74 65 72 7d 3c 2f 74 63 6c 3e 0a 3c 64  ameter}</tcl>.<d
2680: 74 3e 3c 62 3e 69 6d 6d 75 74 61 62 6c 65 3d 31  t><b>immutable=1
2690: 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70  </b></dt>.<dd><p
26a0: 3e 5e 54 68 65 20 69 6d 6d 75 74 61 62 6c 65 20  >^The immutable 
26b0: 71 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 20  query parameter 
26c0: 69 73 20 61 20 62 6f 6f 6c 65 61 6e 20 74 68 61  is a boolean tha
26d0: 74 20 73 69 67 6e 61 6c 73 20 74 6f 0a 53 51 4c  t signals to.SQL
26e0: 69 74 65 20 74 68 61 74 20 74 68 65 20 75 6e 64  ite that the und
26f0: 65 72 6c 79 69 6e 67 20 64 61 74 61 62 61 73 65  erlying database
2700: 20 66 69 6c 65 20 69 73 20 68 65 6c 64 20 6f 6e   file is held on
2710: 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 69 61   read-only media
2720: 0a 61 6e 64 20 63 61 6e 6e 6f 74 20 62 65 20 6d  .and cannot be m
2730: 6f 64 69 66 69 65 64 2c 20 65 76 65 6e 20 62 79  odified, even by
2740: 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73 73   another process
2750: 20 77 69 74 68 20 65 6c 65 76 61 74 65 64 20 0a   with elevated .
2760: 70 72 69 76 69 6c 65 67 65 73 2e 20 20 5e 53 51  privileges.  ^SQ
2770: 4c 69 74 65 20 61 6c 77 61 79 73 20 6f 70 65 6e  Lite always open
2780: 73 20 69 6d 6d 75 74 61 62 6c 65 20 64 61 74 61  s immutable data
2790: 62 61 73 65 20 66 69 6c 65 73 0a 72 65 61 64 2d  base files.read-
27a0: 6f 6e 6c 79 20 61 6e 64 20 69 74 20 73 6b 69 70  only and it skip
27b0: 73 20 61 6c 6c 20 66 69 6c 65 20 6c 6f 63 6b 69  s all file locki
27c0: 6e 67 20 61 6e 64 20 63 68 61 6e 67 65 20 64 65  ng and change de
27d0: 74 65 63 74 69 6f 6e 0a 6f 6e 20 69 6d 6d 75 74  tection.on immut
27e0: 61 62 6c 65 20 64 61 74 61 62 61 73 65 20 66 69  able database fi
27f0: 6c 65 73 2e 20 20 49 66 20 74 68 65 73 65 20 71  les.  If these q
2800: 75 65 72 79 20 70 61 72 61 6d 65 74 65 72 20 28  uery parameter (
2810: 6f 72 0a 74 68 65 20 5b 53 51 4c 49 54 45 5f 49  or.the [SQLITE_I
2820: 4f 43 41 50 5f 49 4d 4d 55 54 41 42 4c 45 5d 20  OCAP_IMMUTABLE] 
2830: 62 69 74 20 69 6e 20 78 44 65 76 69 63 65 43 68  bit in xDeviceCh
2840: 61 72 61 63 74 65 72 69 73 74 69 63 73 29 0a 61  aracteristics).a
2850: 73 73 65 72 74 73 20 74 68 61 74 20 61 20 64 61  sserts that a da
2860: 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 69  tabase file is i
2870: 6d 6d 75 74 61 62 6c 65 20 61 6e 64 20 74 68 61  mmutable and tha
2880: 74 20 66 69 6c 65 20 0a 63 68 61 6e 67 65 73 20  t file .changes 
2890: 61 6e 79 68 6f 77 2c 20 74 68 65 6e 20 53 51 4c  anyhow, then SQL
28a0: 69 74 65 20 6d 69 67 68 74 20 72 65 74 75 72 6e  ite might return
28b0: 20 69 6e 63 6f 72 72 65 63 74 20 71 75 65 72 79   incorrect query
28c0: 20 0a 72 65 73 75 6c 74 73 20 61 6e 64 2f 6f 72   .results and/or
28d0: 20 5b 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54   [SQLITE_CORRUPT
28e0: 5d 20 65 72 72 6f 72 73 2e 0a 3c 2f 64 64 3e 0a  ] errors..</dd>.
28f0: 3c 2f 64 6c 3e 0a 0a 3c 68 31 3e 34 2e 30 20 53  </dl>..<h1>4.0 S
2900: 65 65 20 41 6c 73 6f 3c 2f 68 31 3e 0a 0a 3c 75  ee Also</h1>..<u
2910: 6c 3e 0a 3c 6c 69 3e 20 5b 55 52 49 20 66 69 6c  l>.<li> [URI fil
2920: 65 6e 61 6d 65 73 20 69 6e 20 73 71 6c 69 74 65  enames in sqlite
2930: 33 5f 6f 70 65 6e 28 29 5d 0a 3c 6c 69 3e 20 5b  3_open()].<li> [
2940: 55 52 49 20 66 69 6c 65 6e 61 6d 65 20 65 78 61  URI filename exa
2950: 6d 70 6c 65 73 5d 0a 3c 2f 75 6c 3e 0a           mples].</ul>.