Documentation Source Text

Hex Artifact Content
Login

Artifact 21798cdb09def756bba88a1ffd798ce634e6ed0295f787f9a73c00e62e02daa0:


0000: 3c 74 69 74 6c 65 3e 54 68 65 20 53 51 4c 49 54  <title>The SQLIT
0010: 45 5f 44 42 50 41 47 45 20 56 69 72 74 75 61 6c  E_DBPAGE Virtual
0020: 20 54 61 62 6c 65 3c 2f 74 69 74 6c 65 3e 0a 3c   Table</title>.<
0030: 74 63 6c 3e 68 64 5f 6b 65 79 77 6f 72 64 73 20  tcl>hd_keywords 
0040: 73 71 6c 69 74 65 5f 64 62 70 61 67 65 20 7b 53  sqlite_dbpage {S
0050: 51 4c 49 54 45 5f 44 42 50 41 47 45 20 76 69 72  QLITE_DBPAGE vir
0060: 74 75 61 6c 20 74 61 62 6c 65 7d 20 5c 0a 20 20  tual table} \.  
0070: 20 20 20 20 20 20 7b 74 68 65 20 53 51 4c 49 54        {the SQLIT
0080: 45 5f 44 42 50 41 47 45 20 65 78 74 65 6e 73 69  E_DBPAGE extensi
0090: 6f 6e 7d 3c 2f 74 63 6c 3e 0a 3c 66 61 6e 63 79  on}</tcl>.<fancy
00a0: 5f 66 6f 72 6d 61 74 3e 0a 0a 3c 68 31 3e 4f 76  _format>..<h1>Ov
00b0: 65 72 76 69 65 77 3c 2f 68 31 3e 0a 0a 3c 70 3e  erview</h1>..<p>
00c0: 0a 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50 41  .The SQLITE_DBPA
00d0: 47 45 20 65 78 74 65 6e 73 69 6f 6e 20 69 6d 70  GE extension imp
00e0: 6c 65 6d 65 6e 74 73 20 61 6e 20 5b 65 70 6f 6e  lements an [epon
00f0: 79 6d 6f 75 73 2d 6f 6e 6c 79 20 76 69 72 74 75  ymous-only virtu
0100: 61 6c 20 74 61 62 6c 65 5d 20 74 68 61 74 0a 70  al table] that.p
0110: 72 6f 76 69 64 65 73 20 64 69 72 65 63 74 20 61  rovides direct a
0120: 63 63 65 73 73 20 74 6f 20 74 68 65 20 75 6e 64  ccess to the und
0130: 65 72 6c 79 69 6e 67 20 64 61 74 61 62 61 73 65  erlying database
0140: 20 66 69 6c 65 20 62 79 20 69 6e 74 65 72 61 63   file by interac
0150: 74 69 6e 67 0a 77 69 74 68 20 74 68 65 20 70 61  ting.with the pa
0160: 67 65 72 2e 20 20 53 51 4c 49 54 45 5f 44 42 50  ger.  SQLITE_DBP
0170: 41 47 45 20 69 73 20 63 61 70 61 62 6c 65 20 6f  AGE is capable o
0180: 66 20 62 6f 74 68 20 72 65 61 64 69 6e 67 20 61  f both reading a
0190: 6e 64 20 77 72 69 74 69 6e 67 20 61 6e 79 0a 70  nd writing any.p
01a0: 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  age of the datab
01b0: 61 73 65 2e 20 20 42 65 63 61 75 73 65 20 69 6e  ase.  Because in
01c0: 74 65 72 61 63 74 69 6f 6e 20 69 73 20 74 68 72  teraction is thr
01d0: 6f 75 67 68 20 74 68 65 20 70 61 67 65 72 20 6c  ough the pager l
01e0: 61 79 65 72 2c 20 61 6c 6c 0a 63 68 61 6e 67 65  ayer, all.change
01f0: 73 20 61 72 65 20 74 72 61 6e 73 61 63 74 69 6f  s are transactio
0200: 6e 61 6c 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 3c  nal..</p>..<p>.<
0210: 62 3e 57 61 72 6e 69 6e 67 3a 3c 2f 62 3e 20 77  b>Warning:</b> w
0220: 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 53 51  riting to the SQ
0230: 4c 49 54 45 5f 44 42 50 41 47 45 20 76 69 72 74  LITE_DBPAGE virt
0240: 75 61 6c 20 74 61 62 6c 65 20 63 61 6e 20 76 65  ual table can ve
0250: 72 79 20 65 61 73 69 6c 79 0a 63 61 75 73 65 20  ry easily.cause 
0260: 75 6e 72 65 63 6f 76 65 72 61 62 6c 79 20 64 61  unrecoverably da
0270: 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f  tabase corruptio
0280: 6e 2e 20 20 44 6f 20 6e 6f 74 20 61 6c 6c 6f 77  n.  Do not allow
0290: 20 75 6e 74 72 75 73 74 65 64 20 63 6f 6d 70 6f   untrusted compo
02a0: 6e 65 6e 74 73 0a 74 6f 20 61 63 63 65 73 73 20  nents.to access 
02b0: 74 68 65 20 53 51 4c 49 54 45 5f 44 42 50 41 47  the SQLITE_DBPAG
02c0: 45 20 74 61 62 6c 65 2e 20 20 55 73 65 20 61 70  E table.  Use ap
02d0: 70 72 6f 70 72 69 61 74 65 20 63 61 72 65 20 77  propriate care w
02e0: 68 69 6c 65 20 75 73 69 6e 67 20 74 68 65 0a 53  hile using the.S
02f0: 51 4c 49 54 45 5f 44 42 50 41 47 45 20 74 61 62  QLITE_DBPAGE tab
0300: 6c 65 2e 20 20 42 61 63 6b 20 75 70 20 69 6d 70  le.  Back up imp
0310: 6f 72 74 61 6e 74 20 64 61 74 61 20 70 72 69 6f  ortant data prio
0320: 72 20 74 6f 20 65 78 70 65 72 69 6d 65 6e 74 69  r to experimenti
0330: 6e 67 20 77 69 74 68 20 74 68 65 0a 53 51 4c 49  ng with the.SQLI
0340: 54 45 5f 44 42 50 41 47 45 20 74 61 62 6c 65 2e  TE_DBPAGE table.
0350: 20 20 57 72 69 74 65 73 20 74 6f 20 74 68 65 20    Writes to the 
0360: 53 51 4c 49 54 45 5f 44 42 50 41 47 45 20 76 69  SQLITE_DBPAGE vi
0370: 72 74 75 61 6c 20 74 61 62 6c 65 20 61 72 65 0a  rtual table are.
0380: 64 69 73 61 62 6c 65 64 20 77 68 65 6e 20 74 68  disabled when th
0390: 65 20 5b 53 51 4c 49 54 45 5f 44 42 43 4f 4e 46  e [SQLITE_DBCONF
03a0: 49 47 5f 44 45 46 45 4e 53 49 56 45 5d 20 66 6c  IG_DEFENSIVE] fl
03b0: 61 67 20 69 73 20 73 65 74 2e 0a 0a 3c 70 3e 0a  ag is set...<p>.
03c0: 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50 41 47  The SQLITE_DBPAG
03d0: 45 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 69  E extension is i
03e0: 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 5b  ncluded in the [
03f0: 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20 74 68  amalgamation] th
0400: 6f 75 67 68 20 0a 69 74 20 69 73 20 64 69 73 61  ough .it is disa
0410: 62 6c 65 64 0a 62 79 20 64 65 66 61 75 6c 74 2e  bled.by default.
0420: 20 20 55 73 65 20 74 68 65 20 5b 53 51 4c 49 54    Use the [SQLIT
0430: 45 5f 45 4e 41 42 4c 45 5f 44 42 50 41 47 45 5f  E_ENABLE_DBPAGE_
0440: 56 54 41 42 5d 20 63 6f 6d 70 69 6c 65 2d 74 69  VTAB] compile-ti
0450: 6d 65 20 6f 70 74 69 6f 6e 20 74 6f 20 65 6e 61  me option to ena
0460: 62 6c 65 0a 74 68 65 20 53 51 4c 49 54 45 5f 44  ble.the SQLITE_D
0470: 42 50 41 47 45 20 65 78 74 65 6e 73 69 6f 6e 2e  BPAGE extension.
0480: 20 20 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50    The SQLITE_DBP
0490: 41 47 45 20 65 78 74 65 6e 73 69 6f 6e 20 6d 61  AGE extension ma
04a0: 6b 65 73 20 75 73 65 20 6f 66 0a 75 6e 70 75 62  kes use of.unpub
04b0: 6c 69 73 68 65 64 20 69 6e 74 65 72 6e 61 6c 20  lished internal 
04c0: 69 6e 74 65 72 66 61 63 65 73 20 61 6e 64 20 69  interfaces and i
04d0: 73 20 6e 6f 74 20 72 75 6e 2d 74 69 6d 65 20 6c  s not run-time l
04e0: 6f 61 64 61 62 6c 65 2e 20 20 54 68 65 20 6f 6e  oadable.  The on
04f0: 6c 79 20 77 61 79 0a 74 6f 20 61 64 64 20 53 51  ly way.to add SQ
0500: 4c 49 54 45 5f 44 42 50 41 47 45 20 74 6f 20 61  LITE_DBPAGE to a
0510: 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 73  n application is
0520: 20 74 6f 20 63 6f 6d 70 69 6c 65 20 69 74 20 69   to compile it i
0530: 6e 20 75 73 69 6e 67 20 74 68 65 0a 5b 53 51 4c  n using the.[SQL
0540: 49 54 45 5f 45 4e 41 42 4c 45 5f 44 42 50 41 47  ITE_ENABLE_DBPAG
0550: 45 5f 56 54 41 42 5d 20 63 6f 6d 70 69 6c 65 2d  E_VTAB] compile-
0560: 74 69 6d 65 20 6f 70 74 69 6f 6e 2e 0a 3c 2f 70  time option..</p
0570: 3e 0a 0a 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54  >..<p>.The SQLIT
0580: 45 5f 44 42 50 41 47 45 20 65 78 74 65 6e 73 69  E_DBPAGE extensi
0590: 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 20 69 6e  on is enabled in
05a0: 20 64 65 66 61 75 6c 74 20 62 75 69 6c 64 73 0a   default builds.
05b0: 6f 66 20 74 68 65 20 5b 63 6f 6d 6d 61 6e 64 2d  of the [command-
05c0: 6c 69 6e 65 20 73 68 65 6c 6c 5d 2e 0a 0a 3c 68  line shell]...<h
05d0: 31 3e 55 73 61 67 65 3c 2f 68 31 3e 0a 0a 3c 70  1>Usage</h1>..<p
05e0: 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50  >.The SQLITE_DBP
05f0: 41 47 45 20 76 69 72 74 75 61 6c 20 74 61 62 6c  AGE virtual tabl
0600: 65 20 72 65 61 64 2f 77 72 69 74 65 20 74 61 62  e read/write tab
0610: 6c 65 20 74 68 61 74 20 70 72 6f 76 69 64 65 73  le that provides
0620: 20 64 69 72 65 63 74 0a 61 63 63 65 73 73 20 74   direct.access t
0630: 6f 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67  o the underlying
0640: 20 64 69 73 6b 20 66 69 6c 65 20 6f 6e 20 61 20   disk file on a 
0650: 70 61 67 65 2d 62 79 2d 70 61 67 65 20 62 61 73  page-by-page bas
0660: 69 73 2e 20 20 54 68 65 0a 76 69 72 74 75 61 6c  is.  The.virtual
0670: 20 74 61 62 6c 65 20 61 70 70 65 61 72 73 20 74   table appears t
0680: 6f 20 68 61 76 65 20 61 20 73 63 68 65 6d 61 20  o have a schema 
0690: 6c 69 6b 65 20 74 68 69 73 3a 0a 0a 3c 63 6f 64  like this:..<cod
06a0: 65 62 6c 6f 63 6b 3e 0a 43 52 45 41 54 45 20 54  eblock>.CREATE T
06b0: 41 42 4c 45 20 73 71 6c 69 74 65 5f 64 62 70 61  ABLE sqlite_dbpa
06c0: 67 65 28 0a 20 20 70 67 6e 6f 20 49 4e 54 45 47  ge(.  pgno INTEG
06d0: 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a  ER PRIMARY KEY,.
06e0: 20 20 64 61 74 61 20 42 4c 4f 42 0a 29 3b 0a 3c    data BLOB.);.<
06f0: 2f 63 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c 70 3e  /codeblock>..<p>
0700: 0a 41 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62  .An SQLite datab
0710: 61 73 65 20 66 69 6c 65 20 69 73 20 64 69 76 69  ase file is divi
0720: 64 65 64 20 69 6e 74 6f 20 70 61 67 65 73 2e 0a  ded into pages..
0730: 54 68 65 20 66 69 72 73 74 20 70 61 67 65 20 69  The first page i
0740: 73 20 31 2c 20 74 68 65 20 73 65 63 6f 6e 64 20  s 1, the second 
0750: 70 61 67 65 20 69 73 20 32 2c 20 61 6e 64 20 73  page is 2, and s
0760: 6f 20 66 6f 72 74 68 2e 0a 54 68 65 72 65 20 69  o forth..There i
0770: 73 20 6e 6f 20 70 61 67 65 20 30 2e 0a 45 76 65  s no page 0..Eve
0780: 72 79 20 70 61 67 65 20 69 73 20 74 68 65 20 73  ry page is the s
0790: 61 6d 65 20 73 69 7a 65 2e 0a 54 68 65 20 73 69  ame size..The si
07a0: 7a 65 20 6f 66 20 65 76 65 72 79 20 70 61 67 65  ze of every page
07b0: 20 69 73 20 61 20 70 6f 77 65 72 20 6f 66 20 32   is a power of 2
07c0: 20 62 65 74 77 65 65 6e 20 35 31 32 20 61 6e 64   between 512 and
07d0: 20 36 35 35 33 36 2e 0a 53 65 65 20 74 68 65 20   65536..See the 
07e0: 5b 66 69 6c 65 20 66 6f 72 6d 61 74 5d 20 64 6f  [file format] do
07f0: 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20  cumentation for 
0800: 66 75 72 74 68 65 72 20 64 65 74 61 69 6c 73 2e  further details.
0810: 0a 0a 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54 45  ..<p>.The SQLITE
0820: 5f 44 42 50 41 47 45 20 74 61 62 6c 65 20 61 6c  _DBPAGE table al
0830: 6c 6f 77 73 20 61 6e 20 61 70 70 6c 69 63 61 74  lows an applicat
0840: 69 6f 6e 20 74 6f 20 76 69 65 77 20 6f 72 20 72  ion to view or r
0850: 65 70 6c 61 63 65 20 74 68 65 0a 72 61 77 20 62  eplace the.raw b
0860: 69 6e 61 72 79 20 63 6f 6e 74 65 6e 74 20 6f 66  inary content of
0870: 20 65 61 63 68 20 70 61 67 65 20 6f 66 20 74 68   each page of th
0880: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  e database file.
0890: 0a 4e 6f 20 61 74 74 65 6d 70 74 20 69 73 20 6d  .No attempt is m
08a0: 61 64 65 20 74 6f 20 69 6e 74 65 72 70 72 65 74  ade to interpret
08b0: 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20   the content of 
08c0: 74 68 65 20 70 61 67 65 2e 0a 43 6f 6e 74 65 6e  the page..Conten
08d0: 74 20 69 73 20 72 65 74 75 72 6e 65 64 20 62 79  t is returned by
08e0: 74 65 2d 66 6f 72 2d 62 79 74 65 20 61 73 20 69  te-for-byte as i
08f0: 74 20 61 70 70 65 61 72 73 20 6f 6e 20 64 69 73  t appears on dis
0900: 6b 2e 0a 0a 3c 70 3e 0a 54 68 65 20 53 51 4c 49  k...<p>.The SQLI
0910: 54 45 5f 44 42 50 41 47 45 20 74 61 62 6c 65 20  TE_DBPAGE table 
0920: 68 61 73 20 6f 6e 65 20 72 6f 77 20 66 6f 72 20  has one row for 
0930: 65 61 63 68 20 70 61 67 65 20 69 6e 20 74 68 65  each page in the
0940: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a   database file..
0950: 53 51 4c 49 54 45 5f 44 42 50 41 47 45 20 61 6c  SQLITE_DBPAGE al
0960: 6c 6f 77 73 20 70 61 67 65 73 20 74 6f 20 62 65  lows pages to be
0970: 20 72 65 61 64 20 6f 72 20 74 6f 20 62 65 20 6f   read or to be o
0980: 76 65 72 77 72 69 74 74 65 6e 2e 0a 48 6f 77 65  verwritten..Howe
0990: 76 65 72 20 74 68 65 20 73 69 7a 65 20 6f 66 20  ver the size of 
09a0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
09b0: 65 20 63 61 6e 6e 6f 74 20 62 65 20 63 68 61 6e  e cannot be chan
09c0: 67 65 64 2e 20 20 49 74 20 69 73 20 6e 6f 74 0a  ged.  It is not.
09d0: 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 68 61 6e  possible to chan
09e0: 67 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  ge the number of
09f0: 20 72 6f 77 73 20 69 6e 20 74 68 65 20 53 51 4c   rows in the SQL
0a00: 49 54 45 5f 44 42 50 41 47 45 20 74 61 62 6c 65  ITE_DBPAGE table
0a10: 20 62 79 0a 72 75 6e 6e 69 6e 67 20 44 45 4c 45   by.running DELE
0a20: 54 45 20 6f 72 20 49 4e 53 45 52 54 20 6f 70 65  TE or INSERT ope
0a30: 72 61 74 69 6f 6e 73 20 61 67 61 69 6e 73 74 20  rations against 
0a40: 74 68 61 74 20 74 61 62 6c 65 2e 0a 0a 3c 68 32  that table...<h2
0a50: 3e 55 73 69 6e 67 20 53 51 4c 49 54 45 5f 44 42  >Using SQLITE_DB
0a60: 50 41 47 45 20 4f 6e 20 41 54 54 41 43 48 2d 65  PAGE On ATTACH-e
0a70: 64 20 44 61 74 61 62 61 73 65 73 3c 2f 68 32 3e  d Databases</h2>
0a80: 0a 0a 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54 45  ..<p>.The SQLITE
0a90: 5f 44 42 50 41 47 45 20 74 61 62 6c 65 20 73 63  _DBPAGE table sc
0aa0: 68 65 6d 61 20 73 68 6f 77 6e 20 61 62 6f 76 65  hema shown above
0ab0: 20 69 73 20 69 6e 63 6f 6d 70 6c 65 74 65 2e 20   is incomplete. 
0ac0: 20 54 68 65 72 65 20 69 73 0a 61 20 74 68 69 72   There is.a thir
0ad0: 64 20 5b 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e  d [hidden column
0ae0: 5d 20 6e 61 6d 65 64 20 22 73 63 68 65 6d 61 22  ] named "schema"
0af0: 20 74 68 61 74 20 64 65 74 65 72 6d 69 6e 65 73   that determines
0b00: 20 77 68 69 63 68 0a 5b 41 54 54 41 43 48 7c 41   which.[ATTACH|A
0b10: 54 54 41 43 48 2d 65 64 20 64 61 74 61 62 61 73  TTACH-ed databas
0b20: 65 5d 20 73 68 6f 75 6c 64 20 62 65 20 72 65 61  e] should be rea
0b30: 64 20 6f 72 20 77 72 69 74 74 65 6e 2e 20 20 42  d or written.  B
0b40: 65 63 61 75 73 65 0a 74 68 65 20 22 73 63 68 65  ecause.the "sche
0b50: 6d 61 22 20 63 6f 6c 75 6d 6e 20 69 73 20 68 69  ma" column is hi
0b60: 64 64 65 6e 2c 20 69 74 20 63 61 6e 20 62 65 20  dden, it can be 
0b70: 75 73 65 64 20 61 73 20 61 20 70 61 72 61 6d 65  used as a parame
0b80: 74 65 72 20 77 68 65 6e 0a 53 51 4c 49 54 45 5f  ter when.SQLITE_
0b90: 44 42 50 41 47 45 20 69 73 20 69 6e 76 6f 6b 65  DBPAGE is invoke
0ba0: 64 20 61 73 20 61 20 5b 74 61 62 6c 65 2d 76 61  d as a [table-va
0bb0: 6c 75 65 64 20 66 75 6e 63 74 69 6f 6e 5d 2e 0a  lued function]..
0bc0: 0a 3c 70 3e 0a 46 6f 72 20 65 78 61 6d 70 6c 65  .<p>.For example
0bd0: 2c 20 73 75 70 70 6f 73 65 20 61 6e 20 61 64 64  , suppose an add
0be0: 69 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65  itional database
0bf0: 20 69 73 20 61 74 74 61 63 68 65 64 20 74 6f 20   is attached to 
0c00: 74 68 65 20 0a 64 61 74 61 62 61 73 65 20 63 6f  the .database co
0c10: 6e 6e 65 63 74 69 6f 6e 20 75 73 69 6e 67 20 61  nnection using a
0c20: 20 73 74 61 74 65 6d 65 6e 74 20 6c 69 6b 65 20   statement like 
0c30: 74 68 69 73 3a 0a 0a 3c 63 6f 64 65 62 6c 6f 63  this:..<codebloc
0c40: 6b 3e 0a 41 54 54 41 43 48 20 27 61 75 78 64 61  k>.ATTACH 'auxda
0c50: 74 61 31 2e 64 62 27 20 41 53 20 61 75 78 31 3b  ta1.db' AS aux1;
0c60: 0a 3c 2f 63 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c  .</codeblock>..<
0c70: 70 3e 0a 54 68 65 6e 20 74 6f 20 72 65 61 64 20  p>.Then to read 
0c80: 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f  the first page o
0c90: 66 20 74 68 61 74 20 64 61 74 61 62 61 73 65 20  f that database 
0ca0: 66 69 6c 65 2c 20 6f 6e 65 20 6d 65 72 65 6c 79  file, one merely
0cb0: 20 72 75 6e 73 3a 0a 0a 3c 63 6f 64 65 62 6c 6f   runs:..<codeblo
0cc0: 63 6b 3e 0a 53 45 4c 45 43 54 20 64 61 74 61 20  ck>.SELECT data 
0cd0: 46 52 4f 4d 20 73 71 6c 69 74 65 5f 64 62 70 61  FROM sqlite_dbpa
0ce0: 67 65 28 27 61 75 78 31 27 29 20 57 48 45 52 45  ge('aux1') WHERE
0cf0: 20 70 67 6e 6f 3d 31 3b 0a 3c 2f 63 6f 64 65 62   pgno=1;.</codeb
0d00: 6c 6f 63 6b 3e 0a 0a 3c 70 3e 0a 49 66 20 74 68  lock>..<p>.If th
0d10: 65 20 22 73 63 68 65 6d 61 22 20 69 73 20 6f 6d  e "schema" is om
0d20: 69 74 74 65 64 2c 20 69 74 20 64 65 66 61 75 6c  itted, it defaul
0d30: 74 73 20 74 6f 20 74 68 65 20 70 72 69 6d 61 72  ts to the primar
0d40: 79 20 64 61 74 61 62 61 73 65 0a 28 75 73 75 61  y database.(usua
0d50: 6c 6c 79 20 63 61 6c 6c 65 64 20 27 6d 61 69 6e  lly called 'main
0d60: 27 2c 20 75 6e 6c 65 73 73 20 72 65 6e 61 6d 65  ', unless rename
0d70: 64 20 75 73 69 6e 67 20 5b 53 51 4c 49 54 45 5f  d using [SQLITE_
0d80: 44 42 43 4f 4e 46 49 47 5f 4d 41 49 4e 44 42 4e  DBCONFIG_MAINDBN
0d90: 41 4d 45 5d 29 2e 0a 48 65 6e 63 65 2c 20 74 68  AME])..Hence, th
0da0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 77 6f 20  e following two 
0db0: 71 75 65 72 69 65 73 20 61 72 65 20 6e 6f 72 6d  queries are norm
0dc0: 61 6c 6c 79 20 65 71 75 69 76 61 6c 65 6e 74 3a  ally equivalent:
0dd0: 0a 0a 3c 63 6f 64 65 62 6c 6f 63 6b 3e 0a 53 45  ..<codeblock>.SE
0de0: 4c 45 43 54 20 64 61 74 61 20 46 52 4f 4d 20 73  LECT data FROM s
0df0: 71 6c 69 74 65 5f 64 62 70 61 67 65 28 27 6d 61  qlite_dbpage('ma
0e00: 69 6e 27 29 20 57 48 45 52 45 20 70 67 6e 6f 3d  in') WHERE pgno=
0e10: 31 3b 0a 53 45 4c 45 43 54 20 64 61 74 61 20 46  1;.SELECT data F
0e20: 52 4f 4d 20 73 71 6c 69 74 65 5f 64 62 70 61 67  ROM sqlite_dbpag
0e30: 65 20 57 48 45 52 45 20 70 67 6e 6f 3d 31 3b 0a  e WHERE pgno=1;.
0e40: 3c 2f 63 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c 70  </codeblock>..<p
0e50: 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50  >.The SQLITE_DBP
0e60: 41 47 45 20 74 61 62 6c 65 20 63 61 6e 20 70 61  AGE table can pa
0e70: 72 74 69 63 69 70 61 74 65 20 69 6e 20 61 20 6a  rticipate in a j
0e80: 6f 69 6e 20 6a 75 73 74 20 6c 69 6b 65 20 61 6e  oin just like an
0e90: 79 20 6f 74 68 65 72 0a 74 61 62 6c 65 2e 20 20  y other.table.  
0ea0: 48 65 6e 63 65 2c 20 74 6f 20 73 65 65 20 74 68  Hence, to see th
0eb0: 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65  e content of the
0ec0: 20 66 69 72 73 74 20 70 61 67 65 20 74 6f 20 61   first page to a
0ed0: 6c 6c 20 63 6f 6e 6e 65 63 74 65 64 0a 64 61 74  ll connected.dat
0ee0: 61 62 61 73 65 20 66 69 6c 65 73 2c 20 6f 6e 65  abase files, one
0ef0: 20 6d 69 67 68 74 20 72 75 6e 20 61 20 73 74 61   might run a sta
0f00: 74 65 6d 65 6e 74 20 6c 69 6b 65 20 74 68 69 73  tement like this
0f10: 3a 0a 0a 3c 63 6f 64 65 62 6c 6f 63 6b 3e 0a 53  :..<codeblock>.S
0f20: 45 4c 45 43 54 20 64 62 70 61 67 65 2e 64 61 74  ELECT dbpage.dat
0f30: 61 2c 20 64 62 6c 69 73 74 2e 6e 61 6d 65 0a 20  a, dblist.name. 
0f40: 20 46 52 4f 4d 20 70 72 61 67 6d 61 5f 64 61 74   FROM pragma_dat
0f50: 61 62 61 73 65 5f 6c 69 73 74 20 41 53 20 64 62  abase_list AS db
0f60: 6c 69 73 74 0a 20 20 4a 4f 49 4e 20 73 71 6c 69  list.  JOIN sqli
0f70: 74 65 5f 64 62 70 61 67 65 28 64 62 6c 69 73 74  te_dbpage(dblist
0f80: 2e 6e 61 6d 65 29 20 41 53 20 64 62 70 61 67 65  .name) AS dbpage
0f90: 0a 20 57 48 45 52 45 20 64 62 70 61 67 65 2e 70  . WHERE dbpage.p
0fa0: 67 6e 6f 3d 31 3b 0a 3c 2f 63 6f 64 65 62 6c 6f  gno=1;.</codeblo
0fb0: 63 6b 3e 0a                                      ck>.