Documentation Source Text

Hex Artifact Content
Login

Artifact d34434c992ccd91c6f2389f8829a01717fecea528d5683eb649a5f425aac3b0c:


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 20 64 69 72 65 63 74 6c 79 0a 77 69  ting directly.wi
0160: 74 68 20 74 68 65 20 70 61 67 65 2e 20 20 53 51  th the page.  SQ
0170: 4c 49 54 45 5f 44 42 50 41 47 45 20 69 73 20 63  LITE_DBPAGE is c
0180: 61 70 61 62 6c 65 20 6f 66 20 62 6f 74 68 20 72  apable of both r
0190: 65 61 64 69 6e 67 20 61 6e 64 20 77 72 69 74 69  eading and writi
01a0: 6e 67 20 61 6e 79 0a 70 61 67 65 20 6f 66 20 74  ng any.page of t
01b0: 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 42 65  he database.  Be
01c0: 63 61 75 73 65 20 69 6e 74 65 72 61 63 74 69 6f  cause interactio
01d0: 6e 20 69 73 20 74 68 72 6f 75 67 68 20 74 68 65  n is through the
01e0: 20 70 61 67 65 72 20 6c 61 79 65 72 2c 20 61 6c   pager layer, al
01f0: 6c 0a 63 68 61 6e 67 65 73 20 61 72 65 20 74 72  l.changes are tr
0200: 61 6e 73 61 63 74 69 6f 6e 61 6c 2e 0a 3c 2f 70  ansactional..</p
0210: 3e 0a 0a 3c 70 3e 0a 3c 62 3e 57 61 72 6e 69 6e  >..<p>.<b>Warnin
0220: 67 3a 3c 2f 62 3e 20 77 72 69 74 69 6e 67 20 74  g:</b> writing t
0230: 6f 20 74 68 65 20 53 51 4c 49 54 45 5f 44 42 50  o the SQLITE_DBP
0240: 41 47 45 20 76 69 72 74 75 61 6c 20 74 61 62 6c  AGE virtual tabl
0250: 65 20 63 61 6e 20 76 65 72 79 20 65 61 73 69 6c  e can very easil
0260: 79 0a 63 61 75 73 65 20 75 6e 72 65 63 6f 76 65  y.cause unrecove
0270: 72 61 62 6c 79 20 64 61 74 61 62 61 73 65 20 63  rably database c
0280: 6f 72 72 75 70 74 69 6f 6e 2e 20 20 44 6f 20 6e  orruption.  Do n
0290: 6f 74 20 61 6c 6c 6f 77 20 75 6e 74 72 75 73 74  ot allow untrust
02a0: 65 64 20 63 6f 6d 70 6f 6e 65 6e 74 73 0a 74 6f  ed components.to
02b0: 20 61 63 63 65 73 73 20 74 68 65 20 53 51 4c 49   access the SQLI
02c0: 54 45 5f 44 42 50 41 47 45 20 74 61 62 6c 65 2e  TE_DBPAGE table.
02d0: 20 20 55 73 65 20 61 70 70 72 6f 70 72 69 61 74    Use appropriat
02e0: 65 20 63 61 72 65 20 77 68 69 6c 65 20 75 73 69  e care while usi
02f0: 6e 67 20 74 68 65 0a 53 51 4c 49 54 45 5f 44 42  ng the.SQLITE_DB
0300: 50 41 47 45 20 74 61 62 6c 65 2e 20 20 42 61 63  PAGE table.  Bac
0310: 6b 20 75 70 20 69 6d 70 6f 72 74 61 6e 74 20 64  k up important d
0320: 61 74 61 20 70 72 69 6f 72 20 74 6f 20 65 78 70  ata prior to exp
0330: 65 72 69 6d 65 6e 74 69 6e 67 20 77 69 74 68 20  erimenting with 
0340: 74 68 65 0a 53 51 4c 49 54 45 5f 44 42 50 41 47  the.SQLITE_DBPAG
0350: 45 20 74 61 62 6c 65 2e 0a 0a 3c 70 3e 0a 54 68  E table...<p>.Th
0360: 65 20 53 51 4c 49 54 45 5f 44 42 50 41 47 45 20  e SQLITE_DBPAGE 
0370: 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 69 6e 63  extension is inc
0380: 6c 75 64 65 64 20 69 6e 20 74 68 65 20 5b 61 6d  luded in the [am
0390: 61 6c 67 61 6d 61 74 69 6f 6e 5d 20 74 68 6f 75  algamation] thou
03a0: 67 68 20 0a 69 74 20 69 73 20 64 69 73 61 62 6c  gh .it is disabl
03b0: 65 64 0a 62 79 20 64 65 66 61 75 6c 74 2e 20 20  ed.by default.  
03c0: 55 73 65 20 74 68 65 20 5b 53 51 4c 49 54 45 5f  Use the [SQLITE_
03d0: 45 4e 41 42 4c 45 5f 44 42 50 41 47 45 5f 56 54  ENABLE_DBPAGE_VT
03e0: 41 42 5d 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  AB] compile-time
03f0: 20 6f 70 74 69 6f 6e 20 74 6f 20 65 6e 61 62 6c   option to enabl
0400: 65 0a 74 68 65 20 53 51 4c 49 54 45 5f 44 42 50  e.the SQLITE_DBP
0410: 41 47 45 20 65 78 74 65 6e 73 69 6f 6e 2e 20 20  AGE extension.  
0420: 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50 41 47  The SQLITE_DBPAG
0430: 45 20 65 78 74 65 6e 73 69 6f 6e 20 6d 61 6b 65  E extension make
0440: 73 20 75 73 65 20 6f 66 0a 75 6e 70 75 62 6c 69  s use of.unpubli
0450: 73 68 65 64 20 69 6e 74 65 72 6e 61 6c 20 69 6e  shed internal in
0460: 74 65 72 66 61 63 65 73 20 61 6e 64 20 69 73 20  terfaces and is 
0470: 6e 6f 74 20 72 75 6e 2d 74 69 6d 65 20 6c 6f 61  not run-time loa
0480: 64 61 62 6c 65 2e 20 20 54 68 65 20 6f 6e 6c 79  dable.  The only
0490: 20 77 61 79 0a 74 6f 20 61 64 64 20 53 51 4c 49   way.to add SQLI
04a0: 54 45 5f 44 42 50 41 47 45 20 74 6f 20 61 6e 20  TE_DBPAGE to an 
04b0: 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 73 20 74  application is t
04c0: 6f 20 63 6f 6d 70 69 6c 65 20 69 74 20 69 6e 20  o compile it in 
04d0: 75 73 69 6e 67 20 74 68 65 0a 5b 53 51 4c 49 54  using the.[SQLIT
04e0: 45 5f 45 4e 41 42 4c 45 5f 44 42 50 41 47 45 5f  E_ENABLE_DBPAGE_
04f0: 56 54 41 42 5d 20 63 6f 6d 70 69 6c 65 2d 74 69  VTAB] compile-ti
0500: 6d 65 20 6f 70 74 69 6f 6e 2e 0a 3c 2f 70 3e 0a  me option..</p>.
0510: 0a 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f  .<p>.The SQLITE_
0520: 44 42 50 41 47 45 20 65 78 74 65 6e 73 69 6f 6e  DBPAGE extension
0530: 20 69 73 20 65 6e 61 62 6c 65 64 20 69 6e 20 64   is enabled in d
0540: 65 66 61 75 6c 74 20 62 75 69 6c 64 73 0a 6f 66  efault builds.of
0550: 20 74 68 65 20 5b 63 6f 6d 6d 61 6e 64 2d 6c 69   the [command-li
0560: 6e 65 20 73 68 65 6c 6c 5d 2e 0a 0a 3c 68 31 3e  ne shell]...<h1>
0570: 55 73 61 67 65 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a  Usage</h1>..<p>.
0580: 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50 41 47  The SQLITE_DBPAG
0590: 45 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20  E virtual table 
05a0: 72 65 61 64 2f 77 72 69 74 65 20 74 61 62 6c 65  read/write table
05b0: 20 74 68 61 74 20 70 72 6f 76 69 64 65 73 20 64   that provides d
05c0: 69 72 65 63 74 0a 61 63 63 65 73 73 20 74 6f 20  irect.access to 
05d0: 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 64  the underlying d
05e0: 69 73 6b 20 66 69 6c 65 20 6f 6e 20 61 20 70 61  isk file on a pa
05f0: 67 65 2d 62 79 2d 70 61 67 65 20 62 61 73 69 73  ge-by-page basis
0600: 2e 20 20 54 68 65 0a 76 69 72 74 75 61 6c 20 74  .  The.virtual t
0610: 61 62 6c 65 20 61 70 70 65 61 72 73 20 74 6f 20  able appears to 
0620: 68 61 76 65 20 61 20 73 63 68 65 6d 61 20 6c 69  have a schema li
0630: 6b 65 20 74 68 69 73 3a 0a 0a 3c 63 6f 64 65 62  ke this:..<codeb
0640: 6c 6f 63 6b 3e 0a 43 52 45 41 54 45 20 54 41 42  lock>.CREATE TAB
0650: 4c 45 20 73 71 6c 69 74 65 5f 64 62 70 61 67 65  LE sqlite_dbpage
0660: 28 0a 20 20 70 67 6e 6f 20 49 4e 54 45 47 45 52  (.  pgno INTEGER
0670: 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a 20 20   PRIMARY KEY,.  
0680: 64 61 74 61 20 42 4c 4f 42 0a 29 3b 0a 3c 2f 63  data BLOB.);.</c
0690: 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c 70 3e 0a 41  odeblock>..<p>.A
06a0: 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  n SQLite databas
06b0: 65 20 66 69 6c 65 20 69 73 20 64 69 76 69 64 65  e file is divide
06c0: 64 20 69 6e 74 6f 20 70 61 67 65 73 2e 0a 54 68  d into pages..Th
06d0: 65 20 66 69 72 73 74 20 70 61 67 65 20 69 73 20  e first page is 
06e0: 31 2c 20 74 68 65 20 73 65 63 6f 6e 64 20 70 61  1, the second pa
06f0: 67 65 20 69 73 20 32 2c 20 61 6e 64 20 73 6f 20  ge is 2, and so 
0700: 66 6f 72 74 68 2e 0a 54 68 65 72 65 20 69 73 20  forth..There is 
0710: 6e 6f 20 70 61 67 65 20 30 2e 0a 45 76 65 72 79  no page 0..Every
0720: 20 70 61 67 65 20 69 73 20 74 68 65 20 73 61 6d   page is the sam
0730: 65 20 73 69 7a 65 2e 0a 54 68 65 20 73 69 7a 65  e size..The size
0740: 20 6f 66 20 65 76 65 72 79 20 70 61 67 65 20 69   of every page i
0750: 73 20 61 20 70 6f 77 65 72 20 6f 66 20 32 20 62  s a power of 2 b
0760: 65 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36  etween 512 and 6
0770: 35 35 33 36 2e 0a 53 65 65 20 74 68 65 20 5b 66  5536..See the [f
0780: 69 6c 65 20 66 6f 72 6d 61 74 5d 20 64 6f 63 75  ile format] docu
0790: 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 66 75  mentation for fu
07a0: 72 74 68 65 72 20 64 65 74 61 69 6c 73 2e 0a 0a  rther details...
07b0: 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f 44  <p>.The SQLITE_D
07c0: 42 50 41 47 45 20 74 61 62 6c 65 20 61 6c 6c 6f  BPAGE table allo
07d0: 77 73 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f  ws an applicatio
07e0: 6e 20 74 6f 20 76 69 65 77 20 6f 72 20 72 65 70  n to view or rep
07f0: 6c 61 63 65 20 74 68 65 0a 72 61 77 20 62 69 6e  lace the.raw bin
0800: 61 72 79 20 63 6f 6e 74 65 6e 74 20 6f 66 20 65  ary content of e
0810: 61 63 68 20 70 61 67 65 20 6f 66 20 74 68 65 20  ach page of the 
0820: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 4e  database file..N
0830: 6f 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64  o attempt is mad
0840: 65 20 74 6f 20 69 6e 74 65 72 70 72 65 74 20 74  e to interpret t
0850: 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68  he content of th
0860: 65 20 70 61 67 65 2e 0a 43 6f 6e 74 65 6e 74 20  e page..Content 
0870: 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 74 65  is returned byte
0880: 2d 66 6f 72 2d 62 79 74 65 20 61 73 20 69 74 20  -for-byte as it 
0890: 61 70 70 65 61 72 73 20 6f 6e 20 64 69 73 6b 2e  appears on disk.
08a0: 0a 0a 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54 45  ..<p>.The SQLITE
08b0: 5f 44 42 50 41 47 45 20 74 61 62 6c 65 20 68 61  _DBPAGE table ha
08c0: 73 20 6f 6e 65 20 72 6f 77 20 66 6f 72 20 65 61  s one row for ea
08d0: 63 68 20 70 61 67 65 20 69 6e 20 74 68 65 20 64  ch page in the d
08e0: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 53 51  atabase file..SQ
08f0: 4c 49 54 45 5f 44 42 50 41 47 45 20 61 6c 6c 6f  LITE_DBPAGE allo
0900: 77 73 20 70 61 67 65 73 20 74 6f 20 62 65 20 72  ws pages to be r
0910: 65 61 64 20 6f 72 20 74 6f 20 62 65 20 6f 76 65  ead or to be ove
0920: 72 77 72 69 74 74 65 6e 2e 0a 48 6f 77 65 76 65  rwritten..Howeve
0930: 72 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68  r the size of th
0940: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
0950: 63 61 6e 6e 6f 74 20 62 65 20 63 68 61 6e 67 65  cannot be change
0960: 64 2e 20 20 49 74 20 69 73 20 6e 6f 74 0a 70 6f  d.  It is not.po
0970: 73 73 69 62 6c 65 20 74 6f 20 63 68 61 6e 67 65  ssible to change
0980: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72   the number of r
0990: 6f 77 73 20 69 6e 20 74 68 65 20 53 51 4c 49 54  ows in the SQLIT
09a0: 45 5f 44 42 50 41 47 45 20 74 61 62 6c 65 20 62  E_DBPAGE table b
09b0: 79 0a 72 75 6e 6e 69 6e 67 20 44 45 4c 45 54 45  y.running DELETE
09c0: 20 6f 72 20 49 4e 53 45 52 54 20 6f 70 65 72 61   or INSERT opera
09d0: 74 69 6f 6e 73 20 61 67 61 69 6e 73 74 20 74 68  tions against th
09e0: 61 74 20 74 61 62 6c 65 2e 0a 0a 3c 68 32 3e 55  at table...<h2>U
09f0: 73 69 6e 67 20 53 51 4c 49 54 45 5f 44 42 50 41  sing SQLITE_DBPA
0a00: 47 45 20 4f 6e 20 41 54 54 41 43 48 2d 65 64 20  GE On ATTACH-ed 
0a10: 44 61 74 61 62 61 73 65 73 3c 2f 68 32 3e 0a 0a  Databases</h2>..
0a20: 3c 70 3e 0a 54 68 65 20 53 51 4c 49 54 45 5f 44  <p>.The SQLITE_D
0a30: 42 50 41 47 45 20 74 61 62 6c 65 20 73 63 68 65  BPAGE table sche
0a40: 6d 61 20 73 68 6f 77 6e 20 61 62 6f 76 65 20 69  ma shown above i
0a50: 73 20 69 6e 63 6f 6d 70 6c 65 74 65 2e 20 20 54  s incomplete.  T
0a60: 68 65 72 65 20 69 73 0a 61 20 74 68 69 72 64 20  here is.a third 
0a70: 5b 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 5d 20  [hidden column] 
0a80: 6e 61 6d 65 64 20 22 73 63 68 65 6d 61 22 20 74  named "schema" t
0a90: 68 61 74 20 64 65 74 65 72 6d 69 6e 65 73 20 77  hat determines w
0aa0: 68 69 63 68 0a 5b 41 54 54 41 43 48 7c 41 54 54  hich.[ATTACH|ATT
0ab0: 41 43 48 2d 65 64 20 64 61 74 61 62 61 73 65 5d  ACH-ed database]
0ac0: 20 73 68 6f 75 6c 64 20 62 65 20 72 65 61 64 20   should be read 
0ad0: 6f 72 20 77 72 69 74 74 65 6e 2e 20 20 42 65 63  or written.  Bec
0ae0: 61 75 73 65 0a 74 68 65 20 22 73 63 68 65 6d 61  ause.the "schema
0af0: 22 20 63 6f 6c 75 6d 6e 20 69 73 20 68 69 64 64  " column is hidd
0b00: 65 6e 2c 20 69 74 20 63 61 6e 20 62 65 20 75 73  en, it can be us
0b10: 65 64 20 61 73 20 61 20 70 61 72 61 6d 65 74 65  ed as a paramete
0b20: 72 20 77 68 65 6e 0a 53 51 4c 49 54 45 5f 44 42  r when.SQLITE_DB
0b30: 50 41 47 45 20 69 73 20 69 6e 76 6f 6b 65 64 20  PAGE is invoked 
0b40: 61 73 20 61 20 5b 74 61 62 6c 65 2d 76 61 6c 75  as a [table-valu
0b50: 65 64 20 66 75 6e 63 74 69 6f 6e 5d 2e 0a 0a 3c  ed function]...<
0b60: 70 3e 0a 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20  p>.For example, 
0b70: 73 75 70 70 6f 73 65 20 61 6e 20 61 64 64 69 74  suppose an addit
0b80: 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 20 69  ional database i
0b90: 73 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 68  s attached to th
0ba0: 65 20 0a 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  e .database conn
0bb0: 65 63 74 69 6f 6e 20 75 73 69 6e 67 20 61 20 73  ection using a s
0bc0: 74 61 74 65 6d 65 6e 74 20 6c 69 6b 65 20 74 68  tatement like th
0bd0: 69 73 3a 0a 0a 3c 63 6f 64 65 62 6c 6f 63 6b 3e  is:..<codeblock>
0be0: 0a 41 54 54 41 43 48 20 27 61 75 78 64 61 74 61  .ATTACH 'auxdata
0bf0: 31 2e 64 62 27 20 41 53 20 61 75 78 31 3b 0a 3c  1.db' AS aux1;.<
0c00: 2f 63 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c 70 3e  /codeblock>..<p>
0c10: 0a 54 68 65 6e 20 74 6f 20 72 65 61 64 20 74 68  .Then to read th
0c20: 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 20  e first page of 
0c30: 74 68 61 74 20 64 61 74 61 62 61 73 65 20 66 69  that database fi
0c40: 6c 65 2c 20 6f 6e 65 20 6d 65 72 65 6c 79 20 72  le, one merely r
0c50: 75 6e 73 3a 0a 0a 3c 63 6f 64 65 62 6c 6f 63 6b  uns:..<codeblock
0c60: 3e 0a 53 45 4c 45 43 54 20 64 61 74 61 20 46 52  >.SELECT data FR
0c70: 4f 4d 20 73 71 6c 69 74 65 5f 64 62 70 61 67 65  OM sqlite_dbpage
0c80: 28 27 61 75 78 31 27 29 20 57 48 45 52 45 20 70  ('aux1') WHERE p
0c90: 67 6e 6f 3d 31 3b 0a 3c 2f 63 6f 64 65 62 6c 6f  gno=1;.</codeblo
0ca0: 63 6b 3e 0a 0a 3c 70 3e 0a 49 66 20 74 68 65 20  ck>..<p>.If the 
0cb0: 22 73 63 68 65 6d 61 22 20 69 73 20 6f 6d 69 74  "schema" is omit
0cc0: 74 65 64 2c 20 69 74 20 64 65 66 61 75 6c 74 73  ted, it defaults
0cd0: 20 74 6f 20 74 68 65 20 70 72 69 6d 61 72 79 20   to the primary 
0ce0: 64 61 74 61 62 61 73 65 0a 28 75 73 75 61 6c 6c  database.(usuall
0cf0: 79 20 63 61 6c 6c 65 64 20 27 6d 61 69 6e 27 2c  y called 'main',
0d00: 20 75 6e 6c 65 73 73 20 72 65 6e 61 6d 65 64 20   unless renamed 
0d10: 75 73 69 6e 67 20 5b 53 51 4c 49 54 45 5f 44 42  using [SQLITE_DB
0d20: 43 4f 4e 46 49 47 5f 4d 41 49 4e 44 42 4e 41 4d  CONFIG_MAINDBNAM
0d30: 45 5d 29 2e 0a 48 65 6e 63 65 2c 20 74 68 65 20  E])..Hence, the 
0d40: 66 6f 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 71 75  following two qu
0d50: 65 72 69 65 73 20 61 72 65 20 6e 6f 72 6d 61 6c  eries are normal
0d60: 6c 79 20 65 71 75 69 76 61 6c 65 6e 74 3a 0a 0a  ly equivalent:..
0d70: 3c 63 6f 64 65 62 6c 6f 63 6b 3e 0a 53 45 4c 45  <codeblock>.SELE
0d80: 43 54 20 64 61 74 61 20 46 52 4f 4d 20 73 71 6c  CT data FROM sql
0d90: 69 74 65 5f 64 62 70 61 67 65 28 27 6d 61 69 6e  ite_dbpage('main
0da0: 27 29 20 57 48 45 52 45 20 70 67 6e 6f 3d 31 3b  ') WHERE pgno=1;
0db0: 0a 53 45 4c 45 43 54 20 64 61 74 61 20 46 52 4f  .SELECT data FRO
0dc0: 4d 20 73 71 6c 69 74 65 5f 64 62 70 61 67 65 20  M sqlite_dbpage 
0dd0: 57 48 45 52 45 20 70 67 6e 6f 3d 31 3b 0a 3c 2f  WHERE pgno=1;.</
0de0: 63 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c 70 3e 0a  codeblock>..<p>.
0df0: 54 68 65 20 53 51 4c 49 54 45 5f 44 42 50 41 47  The SQLITE_DBPAG
0e00: 45 20 74 61 62 6c 65 20 63 61 6e 20 70 61 72 74  E table can part
0e10: 69 63 69 70 61 74 65 20 69 6e 20 61 20 6a 6f 69  icipate in a joi
0e20: 6e 20 6a 75 73 74 20 6c 69 6b 65 20 61 6e 79 20  n just like any 
0e30: 6f 74 68 65 72 0a 74 61 62 6c 65 2e 20 20 48 65  other.table.  He
0e40: 6e 63 65 2c 20 74 6f 20 73 65 65 20 74 68 65 20  nce, to see the 
0e50: 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 66  content of the f
0e60: 69 72 73 74 20 70 61 67 65 20 74 6f 20 61 6c 6c  irst page to all
0e70: 20 63 6f 6e 6e 65 63 74 65 64 0a 64 61 74 61 62   connected.datab
0e80: 61 73 65 20 66 69 6c 65 73 2c 20 6f 6e 65 20 6d  ase files, one m
0e90: 69 67 68 74 20 72 75 6e 20 61 20 73 74 61 74 65  ight run a state
0ea0: 6d 65 6e 74 20 6c 69 6b 65 20 74 68 69 73 3a 0a  ment like this:.
0eb0: 0a 3c 63 6f 64 65 62 6c 6f 63 6b 3e 0a 53 45 4c  .<codeblock>.SEL
0ec0: 45 43 54 20 64 62 70 61 67 65 2e 64 61 74 61 2c  ECT dbpage.data,
0ed0: 20 64 62 6c 69 73 74 2e 6e 61 6d 65 0a 20 20 46   dblist.name.  F
0ee0: 52 4f 4d 20 70 72 61 67 6d 61 5f 64 61 74 61 62  ROM pragma_datab
0ef0: 61 73 65 5f 6c 69 73 74 20 41 53 20 64 62 6c 69  ase_list AS dbli
0f00: 73 74 0a 20 20 4a 4f 49 4e 20 73 71 6c 69 74 65  st.  JOIN sqlite
0f10: 5f 64 62 70 61 67 65 28 64 62 6c 69 73 74 2e 6e  _dbpage(dblist.n
0f20: 61 6d 65 29 20 41 53 20 64 62 70 61 67 65 0a 20  ame) AS dbpage. 
0f30: 57 48 45 52 45 20 64 62 70 61 67 65 2e 70 67 6e  WHERE dbpage.pgn
0f40: 6f 3d 31 3b 0a 3c 2f 63 6f 64 65 62 6c 6f 63 6b  o=1;.</codeblock
0f50: 3e 0a                                            >.