/ Hex Artifact Content
Login

Artifact b91879d52bf77a1ff5382493284f429d32a63490:


0000: 23 20 52 75 6e 20 74 68 69 73 20 54 43 4c 20 73  # Run this TCL s
0010: 63 72 69 70 74 20 75 73 69 6e 67 20 22 74 65 73  cript using "tes
0020: 74 66 69 78 74 75 72 65 22 20 69 6e 20 6f 72 64  tfixture" in ord
0030: 65 72 20 67 65 74 20 61 20 72 65 70 6f 72 74 20  er get a report 
0040: 74 68 61 74 20 73 68 6f 77 73 0a 23 20 68 6f 77  that shows.# how
0050: 20 6d 75 63 68 20 64 69 73 6b 20 73 70 61 63 65   much disk space
0060: 20 69 73 20 75 73 65 64 20 62 79 20 61 20 70 61   is used by a pa
0070: 72 74 69 63 75 6c 61 72 20 64 61 74 61 20 74 6f  rticular data to
0080: 20 61 63 74 75 61 6c 6c 79 20 73 74 6f 72 65 20   actually store 
0090: 64 61 74 61 0a 23 20 76 65 72 73 75 73 20 68 6f  data.# versus ho
00a0: 77 20 6d 75 63 68 20 73 70 61 63 65 20 69 73 20  w much space is 
00b0: 75 6e 75 73 65 64 2e 0a 23 0a 0a 69 66 20 7b 5b  unused..#..if {[
00c0: 63 61 74 63 68 20 7b 0a 0a 23 20 47 65 74 20 74  catch {..# Get t
00d0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64  he name of the d
00e0: 61 74 61 62 61 73 65 20 74 6f 20 61 6e 61 6c 79  atabase to analy
00f0: 7a 65 0a 23 0a 23 73 65 74 20 61 72 67 76 20 24  ze.#.#set argv $
0100: 61 72 67 76 30 0a 69 66 20 7b 5b 6c 6c 65 6e 67  argv0.if {[lleng
0110: 74 68 20 24 61 72 67 76 5d 21 3d 31 7d 20 7b 0a  th $argv]!=1} {.
0120: 20 20 70 75 74 73 20 73 74 64 65 72 72 20 22 55    puts stderr "U
0130: 73 61 67 65 3a 20 24 61 72 67 76 30 20 64 61 74  sage: $argv0 dat
0140: 61 62 61 73 65 2d 6e 61 6d 65 22 0a 20 20 65 78  abase-name".  ex
0150: 69 74 20 31 0a 7d 0a 73 65 74 20 66 69 6c 65 5f  it 1.}.set file_
0160: 74 6f 5f 61 6e 61 6c 79 7a 65 20 5b 6c 69 6e 64  to_analyze [lind
0170: 65 78 20 24 61 72 67 76 20 30 5d 0a 69 66 20 7b  ex $argv 0].if {
0180: 21 5b 66 69 6c 65 20 65 78 69 73 74 73 20 24 66  ![file exists $f
0190: 69 6c 65 5f 74 6f 5f 61 6e 61 6c 79 7a 65 5d 7d  ile_to_analyze]}
01a0: 20 7b 0a 20 20 70 75 74 73 20 73 74 64 65 72 72   {.  puts stderr
01b0: 20 22 4e 6f 20 73 75 63 68 20 66 69 6c 65 3a 20   "No such file: 
01c0: 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c 79 7a 65  $file_to_analyze
01d0: 22 0a 20 20 65 78 69 74 20 31 0a 7d 0a 69 66 20  ".  exit 1.}.if 
01e0: 7b 21 5b 66 69 6c 65 20 72 65 61 64 61 62 6c 65  {![file readable
01f0: 20 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c 79 7a   $file_to_analyz
0200: 65 5d 7d 20 7b 0a 20 20 70 75 74 73 20 73 74 64  e]} {.  puts std
0210: 65 72 72 20 22 46 69 6c 65 20 69 73 20 6e 6f 74  err "File is not
0220: 20 72 65 61 64 61 62 6c 65 3a 20 24 66 69 6c 65   readable: $file
0230: 5f 74 6f 5f 61 6e 61 6c 79 7a 65 22 0a 20 20 65  _to_analyze".  e
0240: 78 69 74 20 31 0a 7d 0a 69 66 20 7b 5b 66 69 6c  xit 1.}.if {[fil
0250: 65 20 73 69 7a 65 20 24 66 69 6c 65 5f 74 6f 5f  e size $file_to_
0260: 61 6e 61 6c 79 7a 65 5d 3c 35 31 32 7d 20 7b 0a  analyze]<512} {.
0270: 20 20 70 75 74 73 20 73 74 64 65 72 72 20 22 45    puts stderr "E
0280: 6d 70 74 79 20 6f 72 20 6d 61 6c 66 6f 72 6d 65  mpty or malforme
0290: 64 20 64 61 74 61 62 61 73 65 3a 20 24 66 69 6c  d database: $fil
02a0: 65 5f 74 6f 5f 61 6e 61 6c 79 7a 65 22 0a 20 20  e_to_analyze".  
02b0: 65 78 69 74 20 31 0a 7d 0a 0a 23 20 4f 70 65 6e  exit 1.}..# Open
02c0: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 23 0a   the database.#.
02d0: 73 71 6c 69 74 65 33 20 64 62 20 5b 6c 69 6e 64  sqlite3 db [lind
02e0: 65 78 20 24 61 72 67 76 20 30 5d 0a 72 65 67 69  ex $argv 0].regi
02f0: 73 74 65 72 5f 64 62 73 74 61 74 5f 76 74 61 62  ster_dbstat_vtab
0300: 20 64 62 0a 0a 73 65 74 20 70 61 67 65 53 69 7a   db..set pageSiz
0310: 65 20 5b 64 62 20 6f 6e 65 20 7b 50 52 41 47 4d  e [db one {PRAGM
0320: 41 20 70 61 67 65 5f 73 69 7a 65 7d 5d 0a 0a 23  A page_size}]..#
0330: 73 65 74 20 44 42 20 5b 62 74 72 65 65 5f 6f 70  set DB [btree_op
0340: 65 6e 20 5b 6c 69 6e 64 65 78 20 24 61 72 67 76  en [lindex $argv
0350: 20 30 5d 20 31 30 30 30 20 30 5d 0a 0a 23 20 49   0] 1000 0]..# I
0360: 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73  n-memory databas
0370: 65 20 66 6f 72 20 63 6f 6c 6c 65 63 74 69 6e 67  e for collecting
0380: 20 73 74 61 74 69 73 74 69 63 73 2e 20 54 68 69   statistics. Thi
0390: 73 20 73 63 72 69 70 74 20 6c 6f 6f 70 73 20 74  s script loops t
03a0: 68 72 6f 75 67 68 0a 23 20 74 68 65 20 74 61 62  hrough.# the tab
03b0: 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 73 20  les and indices 
03c0: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  in the database 
03d0: 62 65 69 6e 67 20 61 6e 61 6c 79 7a 65 64 2c 20  being analyzed, 
03e0: 61 64 64 69 6e 67 20 61 20 72 6f 77 20 66 6f 72  adding a row for
03f0: 20 65 61 63 68 0a 23 20 74 6f 20 61 6e 20 69 6e   each.# to an in
0400: 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65  -memory database
0410: 20 28 66 6f 72 20 77 68 69 63 68 20 74 68 65 20   (for which the 
0420: 73 63 68 65 6d 61 20 69 73 20 73 68 6f 77 6e 20  schema is shown 
0430: 62 65 6c 6f 77 29 2e 20 49 74 20 74 68 65 6e 0a  below). It then.
0440: 23 20 71 75 65 72 69 65 73 20 74 68 65 20 69 6e  # queries the in
0450: 2d 6d 65 6d 6f 72 79 20 64 62 20 74 6f 20 70 72  -memory db to pr
0460: 6f 64 75 63 65 20 74 68 65 20 73 70 61 63 65 2d  oduce the space-
0470: 61 6e 61 6c 79 73 69 73 20 72 65 70 6f 72 74 2e  analysis report.
0480: 0a 23 0a 73 71 6c 69 74 65 33 20 6d 65 6d 20 3a  .#.sqlite3 mem :
0490: 6d 65 6d 6f 72 79 3a 0a 73 65 74 20 74 61 62 6c  memory:.set tabl
04a0: 65 64 65 66 5c 0a 7b 43 52 45 41 54 45 20 54 41  edef\.{CREATE TA
04b0: 42 4c 45 20 73 70 61 63 65 5f 75 73 65 64 28 0a  BLE space_used(.
04c0: 20 20 20 6e 61 6d 65 20 63 6c 6f 62 2c 20 20 20     name clob,   
04d0: 20 20 20 20 20 2d 2d 20 4e 61 6d 65 20 6f 66 20       -- Name of 
04e0: 61 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  a table or index
04f0: 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65   in the database
0500: 20 66 69 6c 65 0a 20 20 20 74 62 6c 6e 61 6d 65   file.   tblname
0510: 20 63 6c 6f 62 2c 20 20 20 20 20 2d 2d 20 4e 61   clob,     -- Na
0520: 6d 65 20 6f 66 20 61 73 73 6f 63 69 61 74 65 64  me of associated
0530: 20 74 61 62 6c 65 0a 20 20 20 69 73 5f 69 6e 64   table.   is_ind
0540: 65 78 20 62 6f 6f 6c 65 61 6e 2c 20 2d 2d 20 54  ex boolean, -- T
0550: 52 55 45 20 69 66 20 69 74 20 69 73 20 61 6e 20  RUE if it is an 
0560: 69 6e 64 65 78 2c 20 66 61 6c 73 65 20 66 6f 72  index, false for
0570: 20 61 20 74 61 62 6c 65 0a 20 20 20 6e 65 6e 74   a table.   nent
0580: 72 79 20 69 6e 74 2c 20 20 20 20 20 20 20 2d 2d  ry int,       --
0590: 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69   Number of entri
05a0: 65 73 20 69 6e 20 74 68 65 20 42 54 72 65 65 0a  es in the BTree.
05b0: 20 20 20 6c 65 61 66 5f 65 6e 74 72 69 65 73 20     leaf_entries 
05c0: 69 6e 74 2c 20 2d 2d 20 4e 75 6d 62 65 72 20 6f  int, -- Number o
05d0: 66 20 6c 65 61 66 20 65 6e 74 72 69 65 73 0a 20  f leaf entries. 
05e0: 20 20 70 61 79 6c 6f 61 64 20 69 6e 74 2c 20 20    payload int,  
05f0: 20 20 20 20 2d 2d 20 54 6f 74 61 6c 20 61 6d 6f      -- Total amo
0600: 75 6e 74 20 6f 66 20 64 61 74 61 20 73 74 6f 72  unt of data stor
0610: 65 64 20 69 6e 20 74 68 69 73 20 74 61 62 6c 65  ed in this table
0620: 20 6f 72 20 69 6e 64 65 78 0a 20 20 20 6f 76 66   or index.   ovf
0630: 6c 5f 70 61 79 6c 6f 61 64 20 69 6e 74 2c 20 2d  l_payload int, -
0640: 2d 20 54 6f 74 61 6c 20 61 6d 6f 75 6e 74 20 6f  - Total amount o
0650: 66 20 64 61 74 61 20 73 74 6f 72 65 64 20 6f 6e  f data stored on
0660: 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 0a   overflow pages.
0670: 20 20 20 6f 76 66 6c 5f 63 6e 74 20 69 6e 74 2c     ovfl_cnt int,
0680: 20 20 20 20 20 2d 2d 20 4e 75 6d 62 65 72 20 6f       -- Number o
0690: 66 20 65 6e 74 72 69 65 73 20 74 68 61 74 20 75  f entries that u
06a0: 73 65 20 6f 76 65 72 66 6c 6f 77 0a 20 20 20 6d  se overflow.   m
06b0: 78 5f 70 61 79 6c 6f 61 64 20 69 6e 74 2c 20 20  x_payload int,  
06c0: 20 2d 2d 20 4d 61 78 69 6d 75 6d 20 70 61 79 6c   -- Maximum payl
06d0: 6f 61 64 20 73 69 7a 65 0a 20 20 20 69 6e 74 5f  oad size.   int_
06e0: 70 61 67 65 73 20 69 6e 74 2c 20 20 20 20 2d 2d  pages int,    --
06f0: 20 4e 75 6d 62 65 72 20 6f 66 20 69 6e 74 65 72   Number of inter
0700: 69 6f 72 20 70 61 67 65 73 20 75 73 65 64 0a 20  ior pages used. 
0710: 20 20 6c 65 61 66 5f 70 61 67 65 73 20 69 6e 74    leaf_pages int
0720: 2c 20 20 20 2d 2d 20 4e 75 6d 62 65 72 20 6f 66  ,   -- Number of
0730: 20 6c 65 61 66 20 70 61 67 65 73 20 75 73 65 64   leaf pages used
0740: 0a 20 20 20 6f 76 66 6c 5f 70 61 67 65 73 20 69  .   ovfl_pages i
0750: 6e 74 2c 20 20 20 2d 2d 20 4e 75 6d 62 65 72 20  nt,   -- Number 
0760: 6f 66 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65  of overflow page
0770: 73 20 75 73 65 64 0a 20 20 20 69 6e 74 5f 75 6e  s used.   int_un
0780: 75 73 65 64 20 69 6e 74 2c 20 20 20 2d 2d 20 4e  used int,   -- N
0790: 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64 20  umber of unused 
07a0: 62 79 74 65 73 20 6f 6e 20 69 6e 74 65 72 69 6f  bytes on interio
07b0: 72 20 70 61 67 65 73 0a 20 20 20 6c 65 61 66 5f  r pages.   leaf_
07c0: 75 6e 75 73 65 64 20 69 6e 74 2c 20 20 2d 2d 20  unused int,  -- 
07d0: 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64  Number of unused
07e0: 20 62 79 74 65 73 20 6f 6e 20 70 72 69 6d 61 72   bytes on primar
07f0: 79 20 70 61 67 65 73 0a 20 20 20 6f 76 66 6c 5f  y pages.   ovfl_
0800: 75 6e 75 73 65 64 20 69 6e 74 2c 20 20 2d 2d 20  unused int,  -- 
0810: 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65 64  Number of unused
0820: 20 62 79 74 65 73 20 6f 6e 20 6f 76 65 72 66 6c   bytes on overfl
0830: 6f 77 20 70 61 67 65 73 0a 20 20 20 67 61 70 5f  ow pages.   gap_
0840: 63 6e 74 20 69 6e 74 20 20 20 20 20 20 20 2d 2d  cnt int       --
0850: 20 4e 75 6d 62 65 72 20 6f 66 20 67 61 70 73 20   Number of gaps 
0860: 69 6e 20 74 68 65 20 70 61 67 65 20 6c 61 79 6f  in the page layo
0870: 75 74 0a 29 3b 7d 0a 6d 65 6d 20 65 76 61 6c 20  ut.);}.mem eval 
0880: 24 74 61 62 6c 65 64 65 66 0a 0a 23 20 43 72 65  $tabledef..# Cre
0890: 61 74 65 20 61 20 74 65 6d 70 6f 72 61 72 79 20  ate a temporary 
08a0: 22 64 62 73 74 61 74 22 20 76 69 72 74 75 61 6c  "dbstat" virtual
08b0: 20 74 61 62 6c 65 2e 0a 23 0a 64 62 20 65 76 61   table..#.db eva
08c0: 6c 20 7b 20 0a 20 20 43 52 45 41 54 45 20 56 49  l { .  CREATE VI
08d0: 52 54 55 41 4c 20 54 41 42 4c 45 20 74 65 6d 70  RTUAL TABLE temp
08e0: 2e 73 74 61 74 20 55 53 49 4e 47 20 64 62 73 74  .stat USING dbst
08f0: 61 74 3b 0a 20 20 43 52 45 41 54 45 20 54 45 4d  at;.  CREATE TEM
0900: 50 20 54 41 42 4c 45 20 64 62 73 74 61 74 20 41  P TABLE dbstat A
0910: 53 20 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20  S SELECT * FROM 
0920: 74 65 6d 70 2e 73 74 61 74 20 4f 52 44 45 52 20  temp.stat ORDER 
0930: 42 59 20 6e 61 6d 65 2c 20 70 61 74 68 3b 0a 20  BY name, path;. 
0940: 20 44 52 4f 50 20 54 41 42 4c 45 20 74 65 6d 70   DROP TABLE temp
0950: 2e 73 74 61 74 3b 0a 7d 0a 0a 70 72 6f 63 20 69  .stat;.}..proc i
0960: 73 6c 65 61 66 20 7b 70 61 67 65 74 79 70 65 20  sleaf {pagetype 
0970: 69 73 5f 69 6e 64 65 78 7d 20 7b 0a 20 20 72 65  is_index} {.  re
0980: 74 75 72 6e 20 5b 65 78 70 72 20 7b 24 70 61 67  turn [expr {$pag
0990: 65 74 79 70 65 20 3d 3d 20 22 6c 65 61 66 22 20  etype == "leaf" 
09a0: 7c 7c 20 28 24 70 61 67 65 74 79 70 65 20 3d 3d  || ($pagetype ==
09b0: 20 22 69 6e 74 65 72 6e 61 6c 22 20 26 26 20 24   "internal" && $
09c0: 69 73 5f 69 6e 64 65 78 29 7d 5d 0a 7d 0a 70 72  is_index)}].}.pr
09d0: 6f 63 20 69 73 6f 76 65 72 66 6c 6f 77 20 7b 70  oc isoverflow {p
09e0: 61 67 65 74 79 70 65 20 69 73 5f 69 6e 64 65 78  agetype is_index
09f0: 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 5b 65 78  } {.  return [ex
0a00: 70 72 20 7b 24 70 61 67 65 74 79 70 65 20 3d 3d  pr {$pagetype ==
0a10: 20 22 6f 76 65 72 66 6c 6f 77 22 7d 5d 0a 7d 0a   "overflow"}].}.
0a20: 70 72 6f 63 20 69 73 69 6e 74 65 72 6e 61 6c 20  proc isinternal 
0a30: 7b 70 61 67 65 74 79 70 65 20 69 73 5f 69 6e 64  {pagetype is_ind
0a40: 65 78 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 5b  ex} {.  return [
0a50: 65 78 70 72 20 7b 24 70 61 67 65 74 79 70 65 20  expr {$pagetype 
0a60: 3d 3d 20 22 69 6e 74 65 72 6e 61 6c 22 20 26 26  == "internal" &&
0a70: 20 24 69 73 5f 69 6e 64 65 78 3d 3d 30 7d 5d 0a   $is_index==0}].
0a80: 7d 0a 0a 64 62 20 66 75 6e 63 20 69 73 6c 65 61  }..db func islea
0a90: 66 20 69 73 6c 65 61 66 0a 64 62 20 66 75 6e 63  f isleaf.db func
0aa0: 20 69 73 69 6e 74 65 72 6e 61 6c 20 69 73 69 6e   isinternal isin
0ab0: 74 65 72 6e 61 6c 0a 64 62 20 66 75 6e 63 20 69  ternal.db func i
0ac0: 73 6f 76 65 72 66 6c 6f 77 20 69 73 6f 76 65 72  soverflow isover
0ad0: 66 6c 6f 77 0a 0a 73 65 74 20 73 71 6c 20 7b 20  flow..set sql { 
0ae0: 53 45 4c 45 43 54 20 6e 61 6d 65 2c 20 74 62 6c  SELECT name, tbl
0af0: 5f 6e 61 6d 65 20 46 52 4f 4d 20 73 71 6c 69 74  _name FROM sqlit
0b00: 65 5f 6d 61 73 74 65 72 20 57 48 45 52 45 20 72  e_master WHERE r
0b10: 6f 6f 74 70 61 67 65 3e 30 20 7d 0a 66 6f 72 65  ootpage>0 }.fore
0b20: 61 63 68 20 7b 6e 61 6d 65 20 74 62 6c 6e 61 6d  ach {name tblnam
0b30: 65 7d 20 5b 63 6f 6e 63 61 74 20 73 71 6c 69 74  e} [concat sqlit
0b40: 65 5f 6d 61 73 74 65 72 20 73 71 6c 69 74 65 5f  e_master sqlite_
0b50: 6d 61 73 74 65 72 20 5b 64 62 20 65 76 61 6c 20  master [db eval 
0b60: 24 73 71 6c 5d 5d 20 7b 0a 0a 20 20 73 65 74 20  $sql]] {..  set 
0b70: 69 73 5f 69 6e 64 65 78 20 5b 65 78 70 72 20 7b  is_index [expr {
0b80: 24 6e 61 6d 65 21 3d 24 74 62 6c 6e 61 6d 65 7d  $name!=$tblname}
0b90: 5d 0a 20 20 64 62 20 65 76 61 6c 20 7b 0a 20 20  ].  db eval {.  
0ba0: 20 20 53 45 4c 45 43 54 20 0a 20 20 20 20 20 20    SELECT .      
0bb0: 73 75 6d 28 6e 63 65 6c 6c 29 20 41 53 20 6e 65  sum(ncell) AS ne
0bc0: 6e 74 72 79 2c 0a 20 20 20 20 20 20 73 75 6d 28  ntry,.      sum(
0bd0: 69 73 6c 65 61 66 28 70 61 67 65 74 79 70 65 2c  isleaf(pagetype,
0be0: 20 24 69 73 5f 69 6e 64 65 78 29 20 2a 20 6e 63   $is_index) * nc
0bf0: 65 6c 6c 29 20 41 53 20 6c 65 61 66 5f 65 6e 74  ell) AS leaf_ent
0c00: 72 69 65 73 2c 0a 20 20 20 20 20 20 73 75 6d 28  ries,.      sum(
0c10: 70 61 79 6c 6f 61 64 29 20 41 53 20 70 61 79 6c  payload) AS payl
0c20: 6f 61 64 2c 0a 20 20 20 20 20 20 73 75 6d 28 69  oad,.      sum(i
0c30: 73 6f 76 65 72 66 6c 6f 77 28 70 61 67 65 74 79  soverflow(pagety
0c40: 70 65 2c 20 24 69 73 5f 69 6e 64 65 78 29 20 2a  pe, $is_index) *
0c50: 20 70 61 79 6c 6f 61 64 29 20 41 53 20 6f 76 66   payload) AS ovf
0c60: 6c 5f 70 61 79 6c 6f 61 64 2c 0a 20 20 20 20 20  l_payload,.     
0c70: 20 73 75 6d 28 70 61 74 68 20 4c 49 4b 45 20 27   sum(path LIKE '
0c80: 25 2b 30 30 30 30 30 30 27 29 20 41 53 20 6f 76  %+000000') AS ov
0c90: 66 6c 5f 63 6e 74 2c 0a 20 20 20 20 20 20 6d 61  fl_cnt,.      ma
0ca0: 78 28 6d 78 5f 70 61 79 6c 6f 61 64 29 20 41 53  x(mx_payload) AS
0cb0: 20 6d 78 5f 70 61 79 6c 6f 61 64 2c 0a 20 20 20   mx_payload,.   
0cc0: 20 20 20 73 75 6d 28 69 73 69 6e 74 65 72 6e 61     sum(isinterna
0cd0: 6c 28 70 61 67 65 74 79 70 65 2c 20 24 69 73 5f  l(pagetype, $is_
0ce0: 69 6e 64 65 78 29 29 20 41 53 20 69 6e 74 5f 70  index)) AS int_p
0cf0: 61 67 65 73 2c 0a 20 20 20 20 20 20 73 75 6d 28  ages,.      sum(
0d00: 69 73 6c 65 61 66 28 70 61 67 65 74 79 70 65 2c  isleaf(pagetype,
0d10: 20 24 69 73 5f 69 6e 64 65 78 29 29 20 41 53 20   $is_index)) AS 
0d20: 6c 65 61 66 5f 70 61 67 65 73 2c 0a 20 20 20 20  leaf_pages,.    
0d30: 20 20 73 75 6d 28 69 73 6f 76 65 72 66 6c 6f 77    sum(isoverflow
0d40: 28 70 61 67 65 74 79 70 65 2c 20 24 69 73 5f 69  (pagetype, $is_i
0d50: 6e 64 65 78 29 29 20 41 53 20 6f 76 66 6c 5f 70  ndex)) AS ovfl_p
0d60: 61 67 65 73 2c 0a 20 20 20 20 20 20 73 75 6d 28  ages,.      sum(
0d70: 69 73 69 6e 74 65 72 6e 61 6c 28 70 61 67 65 74  isinternal(paget
0d80: 79 70 65 2c 20 24 69 73 5f 69 6e 64 65 78 29 20  ype, $is_index) 
0d90: 2a 20 75 6e 75 73 65 64 29 20 41 53 20 69 6e 74  * unused) AS int
0da0: 5f 75 6e 75 73 65 64 2c 0a 20 20 20 20 20 20 73  _unused,.      s
0db0: 75 6d 28 69 73 6c 65 61 66 28 70 61 67 65 74 79  um(isleaf(pagety
0dc0: 70 65 2c 20 24 69 73 5f 69 6e 64 65 78 29 20 2a  pe, $is_index) *
0dd0: 20 75 6e 75 73 65 64 29 20 41 53 20 6c 65 61 66   unused) AS leaf
0de0: 5f 75 6e 75 73 65 64 2c 0a 20 20 20 20 20 20 73  _unused,.      s
0df0: 75 6d 28 69 73 6f 76 65 72 66 6c 6f 77 28 70 61  um(isoverflow(pa
0e00: 67 65 74 79 70 65 2c 20 24 69 73 5f 69 6e 64 65  getype, $is_inde
0e10: 78 29 20 2a 20 75 6e 75 73 65 64 29 20 41 53 20  x) * unused) AS 
0e20: 6f 76 66 6c 5f 75 6e 75 73 65 64 0a 20 20 20 20  ovfl_unused.    
0e30: 46 52 4f 4d 20 74 65 6d 70 2e 64 62 73 74 61 74  FROM temp.dbstat
0e40: 20 57 48 45 52 45 20 6e 61 6d 65 20 3d 20 24 6e   WHERE name = $n
0e50: 61 6d 65 0a 20 20 7d 20 62 72 65 61 6b 0a 0a 20  ame.  } break.. 
0e60: 20 23 20 43 6f 6c 75 6d 6e 20 27 67 61 70 5f 63   # Column 'gap_c
0e70: 6e 74 27 20 69 73 20 73 65 74 20 74 6f 20 74 68  nt' is set to th
0e80: 65 20 6e 75 6d 62 65 72 20 6f 66 20 6e 6f 6e 2d  e number of non-
0e90: 63 6f 6e 74 69 67 75 6f 75 73 20 65 6e 74 72 69  contiguous entri
0ea0: 65 73 20 69 6e 20 74 68 65 0a 20 20 23 20 6c 69  es in the.  # li
0eb0: 73 74 20 6f 66 20 70 61 67 65 73 20 76 69 73 69  st of pages visi
0ec0: 74 65 64 20 69 66 20 74 68 65 20 62 2d 74 72 65  ted if the b-tre
0ed0: 65 20 73 74 72 75 63 74 75 72 65 20 69 73 20 74  e structure is t
0ee0: 72 61 76 65 72 73 65 64 20 69 6e 20 61 20 74 6f  raversed in a to
0ef0: 70 2d 64 6f 77 6e 0a 20 20 23 20 66 61 73 68 69  p-down.  # fashi
0f00: 6f 6e 20 28 65 61 63 68 20 6e 6f 64 65 20 76 69  on (each node vi
0f10: 73 69 74 65 64 20 62 65 66 6f 72 65 20 69 74 73  sited before its
0f20: 20 63 68 69 6c 64 2d 74 72 65 65 20 69 73 20 70   child-tree is p
0f30: 61 73 73 65 64 29 2e 20 41 6e 79 20 6f 76 65 72  assed). Any over
0f40: 66 6c 6f 77 0a 20 20 23 20 63 68 61 69 6e 73 20  flow.  # chains 
0f50: 70 72 65 73 65 6e 74 20 61 72 65 20 74 72 61 76  present are trav
0f60: 65 72 73 65 64 20 66 72 6f 6d 20 73 74 61 72 74  ersed from start
0f70: 20 74 6f 20 66 69 6e 69 73 68 20 62 65 66 6f 72   to finish befor
0f80: 65 20 61 6e 79 20 63 68 69 6c 64 2d 74 72 65 65  e any child-tree
0f90: 0a 20 20 23 20 69 73 2e 0a 20 20 23 0a 20 20 73  .  # is..  #.  s
0fa0: 65 74 20 67 61 70 5f 63 6e 74 20 30 0a 20 20 73  et gap_cnt 0.  s
0fb0: 65 74 20 70 67 6c 69 73 74 20 5b 64 62 20 65 76  et pglist [db ev
0fc0: 61 6c 20 7b 0a 20 20 20 20 53 45 4c 45 43 54 20  al {.    SELECT 
0fd0: 70 61 67 65 6e 6f 20 46 52 4f 4d 20 74 65 6d 70  pageno FROM temp
0fe0: 2e 64 62 73 74 61 74 20 57 48 45 52 45 20 6e 61  .dbstat WHERE na
0ff0: 6d 65 20 3d 20 24 6e 61 6d 65 20 4f 52 44 45 52  me = $name ORDER
1000: 20 42 59 20 72 6f 77 69 64 0a 20 20 7d 5d 0a 20   BY rowid.  }]. 
1010: 20 73 65 74 20 70 72 65 76 20 5b 6c 69 6e 64 65   set prev [linde
1020: 78 20 24 70 67 6c 69 73 74 20 30 5d 0a 20 20 66  x $pglist 0].  f
1030: 6f 72 65 61 63 68 20 70 67 6e 6f 20 5b 6c 72 61  oreach pgno [lra
1040: 6e 67 65 20 24 70 67 6c 69 73 74 20 31 20 65 6e  nge $pglist 1 en
1050: 64 5d 20 7b 0a 20 20 20 20 69 66 20 7b 24 70 67  d] {.    if {$pg
1060: 6e 6f 20 21 3d 20 24 70 72 65 76 2b 31 7d 20 7b  no != $prev+1} {
1070: 69 6e 63 72 20 67 61 70 5f 63 6e 74 7d 0a 20 20  incr gap_cnt}.  
1080: 20 20 73 65 74 20 70 72 65 76 20 24 70 67 6e 6f    set prev $pgno
1090: 0a 20 20 7d 0a 0a 20 20 6d 65 6d 20 65 76 61 6c  .  }..  mem eval
10a0: 20 7b 0a 20 20 20 20 49 4e 53 45 52 54 20 49 4e   {.    INSERT IN
10b0: 54 4f 20 73 70 61 63 65 5f 75 73 65 64 20 56 41  TO space_used VA
10c0: 4c 55 45 53 28 0a 20 20 20 20 20 20 24 6e 61 6d  LUES(.      $nam
10d0: 65 2c 0a 20 20 20 20 20 20 24 74 62 6c 6e 61 6d  e,.      $tblnam
10e0: 65 2c 0a 20 20 20 20 20 20 24 69 73 5f 69 6e 64  e,.      $is_ind
10f0: 65 78 2c 0a 20 20 20 20 20 20 24 6e 65 6e 74 72  ex,.      $nentr
1100: 79 2c 0a 20 20 20 20 20 20 24 6c 65 61 66 5f 65  y,.      $leaf_e
1110: 6e 74 72 69 65 73 2c 0a 20 20 20 20 20 20 24 70  ntries,.      $p
1120: 61 79 6c 6f 61 64 2c 20 20 20 20 20 0a 20 20 20  ayload,     .   
1130: 20 20 20 24 6f 76 66 6c 5f 70 61 79 6c 6f 61 64     $ovfl_payload
1140: 2c 0a 20 20 20 20 20 20 24 6f 76 66 6c 5f 63 6e  ,.      $ovfl_cn
1150: 74 2c 20 20 20 0a 20 20 20 20 20 20 24 6d 78 5f  t,   .      $mx_
1160: 70 61 79 6c 6f 61 64 2c 0a 20 20 20 20 20 20 24  payload,.      $
1170: 69 6e 74 5f 70 61 67 65 73 2c 0a 20 20 20 20 20  int_pages,.     
1180: 20 24 6c 65 61 66 5f 70 61 67 65 73 2c 20 20 0a   $leaf_pages,  .
1190: 20 20 20 20 20 20 24 6f 76 66 6c 5f 70 61 67 65        $ovfl_page
11a0: 73 2c 20 0a 20 20 20 20 20 20 24 69 6e 74 5f 75  s, .      $int_u
11b0: 6e 75 73 65 64 2c 20 0a 20 20 20 20 20 20 24 6c  nused, .      $l
11c0: 65 61 66 5f 75 6e 75 73 65 64 2c 0a 20 20 20 20  eaf_unused,.    
11d0: 20 20 24 6f 76 66 6c 5f 75 6e 75 73 65 64 2c 0a    $ovfl_unused,.
11e0: 20 20 20 20 20 20 24 67 61 70 5f 63 6e 74 0a 20        $gap_cnt. 
11f0: 20 20 20 29 3b 0a 20 20 7d 0a 7d 0a 0a 70 72 6f     );.  }.}..pro
1200: 63 20 69 6e 74 65 67 65 72 69 66 79 20 7b 72 65  c integerify {re
1210: 61 6c 7d 20 7b 0a 20 20 69 66 20 7b 5b 73 74 72  al} {.  if {[str
1220: 69 6e 67 20 69 73 20 64 6f 75 62 6c 65 20 2d 73  ing is double -s
1230: 74 72 69 63 74 20 24 72 65 61 6c 5d 7d 20 7b 0a  trict $real]} {.
1240: 20 20 20 20 72 65 74 75 72 6e 20 5b 65 78 70 72      return [expr
1250: 20 7b 69 6e 74 28 24 72 65 61 6c 29 7d 5d 0a 20   {int($real)}]. 
1260: 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 72 65   } else {.    re
1270: 74 75 72 6e 20 30 0a 20 20 7d 0a 7d 0a 6d 65 6d  turn 0.  }.}.mem
1280: 20 66 75 6e 63 74 69 6f 6e 20 69 6e 74 20 69 6e   function int in
1290: 74 65 67 65 72 69 66 79 0a 0a 23 20 51 75 6f 74  tegerify..# Quot
12a0: 65 20 61 20 73 74 72 69 6e 67 20 66 6f 72 20 75  e a string for u
12b0: 73 65 20 69 6e 20 61 6e 20 53 51 4c 20 71 75 65  se in an SQL que
12c0: 72 79 2e 20 45 78 61 6d 70 6c 65 73 3a 0a 23 0a  ry. Examples:.#.
12d0: 23 20 5b 71 75 6f 74 65 20 7b 68 65 6c 6c 6f 20  # [quote {hello 
12e0: 77 6f 72 6c 64 7d 5d 20 20 20 3d 3d 20 7b 27 68  world}]   == {'h
12f0: 65 6c 6c 6f 20 77 6f 72 6c 64 27 7d 0a 23 20 5b  ello world'}.# [
1300: 71 75 6f 74 65 20 7b 68 65 6c 6c 6f 20 77 6f 72  quote {hello wor
1310: 6c 64 27 73 7d 5d 20 3d 3d 20 7b 27 68 65 6c 6c  ld's}] == {'hell
1320: 6f 20 77 6f 72 6c 64 27 27 73 27 7d 0a 23 0a 70  o world''s'}.#.p
1330: 72 6f 63 20 71 75 6f 74 65 20 7b 74 78 74 7d 20  roc quote {txt} 
1340: 7b 0a 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20  {.  regsub -all 
1350: 27 20 24 74 78 74 20 27 27 20 71 0a 20 20 72 65  ' $txt '' q.  re
1360: 74 75 72 6e 20 27 24 71 27 0a 7d 0a 0a 23 20 47  turn '$q'.}..# G
1370: 65 6e 65 72 61 74 65 20 61 20 73 69 6e 67 6c 65  enerate a single
1380: 20 6c 69 6e 65 20 6f 66 20 6f 75 74 70 75 74 20   line of output 
1390: 69 6e 20 74 68 65 20 73 74 61 74 69 73 74 69 63  in the statistic
13a0: 73 20 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 65  s section of the
13b0: 0a 23 20 72 65 70 6f 72 74 2e 0a 23 0a 70 72 6f  .# report..#.pro
13c0: 63 20 73 74 61 74 6c 69 6e 65 20 7b 74 69 74 6c  c statline {titl
13d0: 65 20 76 61 6c 75 65 20 7b 65 78 74 72 61 20 7b  e value {extra {
13e0: 7d 7d 7d 20 7b 0a 20 20 73 65 74 20 6c 65 6e 20  }}} {.  set len 
13f0: 5b 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 24  [string length $
1400: 74 69 74 6c 65 5d 0a 20 20 73 65 74 20 64 6f 74  title].  set dot
1410: 73 20 5b 73 74 72 69 6e 67 20 72 61 6e 67 65 20  s [string range 
1420: 7b 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e  {...............
1430: 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e  ................
1440: 2e 2e 2e 2e 2e 2e 2e 7d 20 24 6c 65 6e 20 65 6e  .......} $len en
1450: 64 5d 0a 20 20 73 65 74 20 6c 65 6e 20 5b 73 74  d].  set len [st
1460: 72 69 6e 67 20 6c 65 6e 67 74 68 20 24 76 61 6c  ring length $val
1470: 75 65 5d 0a 20 20 73 65 74 20 73 70 32 20 5b 73  ue].  set sp2 [s
1480: 74 72 69 6e 67 20 72 61 6e 67 65 20 7b 20 20 20  tring range {   
1490: 20 20 20 20 20 20 20 7d 20 24 6c 65 6e 20 65 6e         } $len en
14a0: 64 5d 0a 20 20 69 66 20 7b 24 65 78 74 72 61 20  d].  if {$extra 
14b0: 6e 65 20 22 22 7d 20 7b 0a 20 20 20 20 73 65 74  ne ""} {.    set
14c0: 20 65 78 74 72 61 20 22 20 24 65 78 74 72 61 22   extra " $extra"
14d0: 0a 20 20 7d 0a 20 20 70 75 74 73 20 22 24 74 69  .  }.  puts "$ti
14e0: 74 6c 65 24 64 6f 74 73 20 24 76 61 6c 75 65 24  tle$dots $value$
14f0: 73 70 32 24 65 78 74 72 61 22 0a 7d 0a 0a 23 20  sp2$extra".}..# 
1500: 47 65 6e 65 72 61 74 65 20 61 20 66 6f 72 6d 61  Generate a forma
1510: 74 74 65 64 20 70 65 72 63 65 6e 74 61 67 65 20  tted percentage 
1520: 76 61 6c 75 65 20 66 6f 72 20 24 6e 75 6d 2f 24  value for $num/$
1530: 64 65 6e 6f 6d 0a 23 0a 70 72 6f 63 20 70 65 72  denom.#.proc per
1540: 63 65 6e 74 20 7b 6e 75 6d 20 64 65 6e 6f 6d 20  cent {num denom 
1550: 7b 6f 66 20 7b 7d 7d 7d 20 7b 0a 20 20 69 66 20  {of {}}} {.  if 
1560: 7b 24 64 65 6e 6f 6d 3d 3d 30 2e 30 7d 20 7b 72  {$denom==0.0} {r
1570: 65 74 75 72 6e 20 22 22 7d 0a 20 20 73 65 74 20  eturn ""}.  set 
1580: 76 20 5b 65 78 70 72 20 7b 24 6e 75 6d 2a 31 30  v [expr {$num*10
1590: 30 2e 30 2f 24 64 65 6e 6f 6d 7d 5d 0a 20 20 73  0.0/$denom}].  s
15a0: 65 74 20 6f 66 20 7b 7d 0a 20 20 69 66 20 7b 24  et of {}.  if {$
15b0: 76 3d 3d 31 30 30 2e 30 20 7c 7c 20 24 76 3c 30  v==100.0 || $v<0
15c0: 2e 30 30 31 20 7c 7c 20 28 24 76 3e 31 2e 30 20  .001 || ($v>1.0 
15d0: 26 26 20 24 76 3c 39 39 2e 30 29 7d 20 7b 0a 20  && $v<99.0)} {. 
15e0: 20 20 20 72 65 74 75 72 6e 20 5b 66 6f 72 6d 61     return [forma
15f0: 74 20 7b 25 35 2e 31 66 25 25 20 25 73 7d 20 24  t {%5.1f%% %s} $
1600: 76 20 24 6f 66 5d 0a 20 20 7d 20 65 6c 73 65 69  v $of].  } elsei
1610: 66 20 7b 24 76 3c 30 2e 31 20 7c 7c 20 24 76 3e  f {$v<0.1 || $v>
1620: 39 39 2e 39 7d 20 7b 0a 20 20 20 20 72 65 74 75  99.9} {.    retu
1630: 72 6e 20 5b 66 6f 72 6d 61 74 20 7b 25 37 2e 33  rn [format {%7.3
1640: 66 25 25 20 25 73 7d 20 24 76 20 24 6f 66 5d 0a  f%% %s} $v $of].
1650: 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 72    } else {.    r
1660: 65 74 75 72 6e 20 5b 66 6f 72 6d 61 74 20 7b 25  eturn [format {%
1670: 36 2e 32 66 25 25 20 25 73 7d 20 24 76 20 24 6f  6.2f%% %s} $v $o
1680: 66 5d 0a 20 20 7d 0a 7d 0a 0a 70 72 6f 63 20 64  f].  }.}..proc d
1690: 69 76 69 64 65 20 7b 6e 75 6d 20 64 65 6e 6f 6d  ivide {num denom
16a0: 7d 20 7b 0a 20 20 69 66 20 7b 24 64 65 6e 6f 6d  } {.  if {$denom
16b0: 3d 3d 30 7d 20 7b 72 65 74 75 72 6e 20 30 2e 30  ==0} {return 0.0
16c0: 7d 0a 20 20 72 65 74 75 72 6e 20 5b 66 6f 72 6d  }.  return [form
16d0: 61 74 20 25 2e 32 66 20 5b 65 78 70 72 20 64 6f  at %.2f [expr do
16e0: 75 62 6c 65 28 24 6e 75 6d 29 2f 64 6f 75 62 6c  uble($num)/doubl
16f0: 65 28 24 64 65 6e 6f 6d 29 5d 5d 0a 7d 0a 0a 23  e($denom)]].}..#
1700: 20 47 65 6e 65 72 61 74 65 20 61 20 73 75 62 72   Generate a subr
1710: 65 70 6f 72 74 20 74 68 61 74 20 63 6f 76 65 72  eport that cover
1720: 73 20 73 6f 6d 65 20 73 75 62 73 65 74 20 6f 66  s some subset of
1730: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 23   the database..#
1740: 20 74 68 65 20 24 77 68 65 72 65 20 63 6c 61 75   the $where clau
1750: 73 65 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68  se determines wh
1760: 69 63 68 20 73 75 62 73 65 74 20 74 6f 20 61 6e  ich subset to an
1770: 61 6c 79 7a 65 2e 0a 23 0a 70 72 6f 63 20 73 75  alyze..#.proc su
1780: 62 72 65 70 6f 72 74 20 7b 74 69 74 6c 65 20 77  breport {title w
1790: 68 65 72 65 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c  here} {.  global
17a0: 20 70 61 67 65 53 69 7a 65 20 66 69 6c 65 5f 70   pageSize file_p
17b0: 67 63 6e 74 0a 0a 20 20 23 20 51 75 65 72 79 20  gcnt..  # Query 
17c0: 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61  the in-memory da
17d0: 74 61 62 61 73 65 20 66 6f 72 20 74 68 65 20 73  tabase for the s
17e0: 75 6d 20 6f 66 20 76 61 72 69 6f 75 73 20 73 74  um of various st
17f0: 61 74 69 73 74 69 63 73 20 0a 20 20 23 20 66 6f  atistics .  # fo
1800: 72 20 74 68 65 20 73 75 62 73 65 74 20 6f 66 20  r the subset of 
1810: 74 61 62 6c 65 73 2f 69 6e 64 69 63 65 73 20 69  tables/indices i
1820: 64 65 6e 74 69 66 69 65 64 20 62 79 20 74 68 65  dentified by the
1830: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 69 6e   WHERE clause in
1840: 0a 20 20 23 20 24 77 68 65 72 65 2e 20 4e 6f 74  .  # $where. Not
1850: 65 20 74 68 61 74 20 65 76 65 6e 20 69 66 20 74  e that even if t
1860: 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20  he WHERE clause 
1870: 6d 61 74 63 68 65 73 20 6e 6f 20 72 6f 77 73 2c  matches no rows,
1880: 20 74 68 65 0a 20 20 23 20 66 6f 6c 6c 6f 77 69   the.  # followi
1890: 6e 67 20 71 75 65 72 79 20 72 65 74 75 72 6e 73  ng query returns
18a0: 20 65 78 61 63 74 6c 79 20 6f 6e 65 20 72 6f 77   exactly one row
18b0: 20 28 62 65 63 61 75 73 65 20 69 74 20 69 73 20   (because it is 
18c0: 61 6e 20 61 67 67 72 65 67 61 74 65 29 2e 0a 20  an aggregate).. 
18d0: 20 23 0a 20 20 23 20 54 68 65 20 72 65 73 75 6c   #.  # The resul
18e0: 74 73 20 6f 66 20 74 68 65 20 71 75 65 72 79 20  ts of the query 
18f0: 61 72 65 20 73 74 6f 72 65 64 20 64 69 72 65 63  are stored direc
1900: 74 6c 79 20 62 79 20 53 51 4c 69 74 65 20 69 6e  tly by SQLite in
1910: 74 6f 20 6c 6f 63 61 6c 20 0a 20 20 23 20 76 61  to local .  # va
1920: 72 69 61 62 6c 65 73 20 28 69 2e 65 2e 20 24 6e  riables (i.e. $n
1930: 65 6e 74 72 79 2c 20 24 6e 6c 65 61 66 20 65 74  entry, $nleaf et
1940: 63 2e 29 2e 0a 20 20 23 0a 20 20 6d 65 6d 20 65  c.)..  #.  mem e
1950: 76 61 6c 20 22 0a 20 20 20 20 53 45 4c 45 43 54  val ".    SELECT
1960: 0a 20 20 20 20 20 20 69 6e 74 28 73 75 6d 28 6e  .      int(sum(n
1970: 65 6e 74 72 79 29 29 20 41 53 20 6e 65 6e 74 72  entry)) AS nentr
1980: 79 2c 0a 20 20 20 20 20 20 69 6e 74 28 73 75 6d  y,.      int(sum
1990: 28 6c 65 61 66 5f 65 6e 74 72 69 65 73 29 29 20  (leaf_entries)) 
19a0: 41 53 20 6e 6c 65 61 66 2c 0a 20 20 20 20 20 20  AS nleaf,.      
19b0: 69 6e 74 28 73 75 6d 28 70 61 79 6c 6f 61 64 29  int(sum(payload)
19c0: 29 20 41 53 20 70 61 79 6c 6f 61 64 2c 0a 20 20  ) AS payload,.  
19d0: 20 20 20 20 69 6e 74 28 73 75 6d 28 6f 76 66 6c      int(sum(ovfl
19e0: 5f 70 61 79 6c 6f 61 64 29 29 20 41 53 20 6f 76  _payload)) AS ov
19f0: 66 6c 5f 70 61 79 6c 6f 61 64 2c 0a 20 20 20 20  fl_payload,.    
1a00: 20 20 6d 61 78 28 6d 78 5f 70 61 79 6c 6f 61 64    max(mx_payload
1a10: 29 20 41 53 20 6d 78 5f 70 61 79 6c 6f 61 64 2c  ) AS mx_payload,
1a20: 0a 20 20 20 20 20 20 69 6e 74 28 73 75 6d 28 6f  .      int(sum(o
1a30: 76 66 6c 5f 63 6e 74 29 29 20 61 73 20 6f 76 66  vfl_cnt)) as ovf
1a40: 6c 5f 63 6e 74 2c 0a 20 20 20 20 20 20 69 6e 74  l_cnt,.      int
1a50: 28 73 75 6d 28 6c 65 61 66 5f 70 61 67 65 73 29  (sum(leaf_pages)
1a60: 29 20 41 53 20 6c 65 61 66 5f 70 61 67 65 73 2c  ) AS leaf_pages,
1a70: 0a 20 20 20 20 20 20 69 6e 74 28 73 75 6d 28 69  .      int(sum(i
1a80: 6e 74 5f 70 61 67 65 73 29 29 20 41 53 20 69 6e  nt_pages)) AS in
1a90: 74 5f 70 61 67 65 73 2c 0a 20 20 20 20 20 20 69  t_pages,.      i
1aa0: 6e 74 28 73 75 6d 28 6f 76 66 6c 5f 70 61 67 65  nt(sum(ovfl_page
1ab0: 73 29 29 20 41 53 20 6f 76 66 6c 5f 70 61 67 65  s)) AS ovfl_page
1ac0: 73 2c 0a 20 20 20 20 20 20 69 6e 74 28 73 75 6d  s,.      int(sum
1ad0: 28 6c 65 61 66 5f 75 6e 75 73 65 64 29 29 20 41  (leaf_unused)) A
1ae0: 53 20 6c 65 61 66 5f 75 6e 75 73 65 64 2c 0a 20  S leaf_unused,. 
1af0: 20 20 20 20 20 69 6e 74 28 73 75 6d 28 69 6e 74       int(sum(int
1b00: 5f 75 6e 75 73 65 64 29 29 20 41 53 20 69 6e 74  _unused)) AS int
1b10: 5f 75 6e 75 73 65 64 2c 0a 20 20 20 20 20 20 69  _unused,.      i
1b20: 6e 74 28 73 75 6d 28 6f 76 66 6c 5f 75 6e 75 73  nt(sum(ovfl_unus
1b30: 65 64 29 29 20 41 53 20 6f 76 66 6c 5f 75 6e 75  ed)) AS ovfl_unu
1b40: 73 65 64 2c 0a 20 20 20 20 20 20 69 6e 74 28 73  sed,.      int(s
1b50: 75 6d 28 67 61 70 5f 63 6e 74 29 29 20 41 53 20  um(gap_cnt)) AS 
1b60: 67 61 70 5f 63 6e 74 0a 20 20 20 20 46 52 4f 4d  gap_cnt.    FROM
1b70: 20 73 70 61 63 65 5f 75 73 65 64 20 57 48 45 52   space_used WHER
1b80: 45 20 24 77 68 65 72 65 22 20 7b 7d 20 7b 7d 0a  E $where" {} {}.
1b90: 0a 20 20 23 20 4f 75 74 70 75 74 20 74 68 65 20  .  # Output the 
1ba0: 73 75 62 2d 72 65 70 6f 72 74 20 74 69 74 6c 65  sub-report title
1bb0: 2c 20 6e 69 63 65 6c 79 20 64 65 63 6f 72 61 74  , nicely decorat
1bc0: 65 64 20 77 69 74 68 20 2a 20 63 68 61 72 61 63  ed with * charac
1bd0: 74 65 72 73 2e 0a 20 20 23 0a 20 20 70 75 74 73  ters..  #.  puts
1be0: 20 22 22 0a 20 20 73 65 74 20 6c 65 6e 20 5b 73   "".  set len [s
1bf0: 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 24 74 69  tring length $ti
1c00: 74 6c 65 5d 0a 20 20 73 65 74 20 73 74 61 72 73  tle].  set stars
1c10: 20 5b 73 74 72 69 6e 67 20 72 65 70 65 61 74 20   [string repeat 
1c20: 2a 20 5b 65 78 70 72 20 36 35 2d 24 6c 65 6e 5d  * [expr 65-$len]
1c30: 5d 0a 20 20 70 75 74 73 20 22 2a 2a 2a 20 24 74  ].  puts "*** $t
1c40: 69 74 6c 65 20 24 73 74 61 72 73 22 0a 20 20 70  itle $stars".  p
1c50: 75 74 73 20 22 22 0a 0a 20 20 23 20 43 61 6c 63  uts ""..  # Calc
1c60: 75 6c 61 74 65 20 73 74 61 74 69 73 74 69 63 73  ulate statistics
1c70: 20 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 72   and store the r
1c80: 65 73 75 6c 74 73 20 69 6e 20 54 43 4c 20 76 61  esults in TCL va
1c90: 72 69 61 62 6c 65 73 2c 20 61 73 20 66 6f 6c 6c  riables, as foll
1ca0: 6f 77 73 3a 0a 20 20 23 0a 20 20 23 20 74 6f 74  ows:.  #.  # tot
1cb0: 61 6c 5f 70 61 67 65 73 3a 20 44 61 74 61 62 61  al_pages: Databa
1cc0: 73 65 20 70 61 67 65 73 20 63 6f 6e 73 75 6d 65  se pages consume
1cd0: 64 2e 0a 20 20 23 20 74 6f 74 61 6c 5f 70 61 67  d..  # total_pag
1ce0: 65 73 5f 70 65 72 63 65 6e 74 3a 20 50 61 67 65  es_percent: Page
1cf0: 73 20 63 6f 6e 73 75 6d 65 64 20 61 73 20 61 20  s consumed as a 
1d00: 70 65 72 63 65 6e 74 61 67 65 20 6f 66 20 74 68  percentage of th
1d10: 65 20 66 69 6c 65 2e 0a 20 20 23 20 73 74 6f 72  e file..  # stor
1d20: 61 67 65 3a 20 42 79 74 65 73 20 63 6f 6e 73 75  age: Bytes consu
1d30: 6d 65 64 2e 0a 20 20 23 20 70 61 79 6c 6f 61 64  med..  # payload
1d40: 5f 70 65 72 63 65 6e 74 3a 20 50 61 79 6c 6f 61  _percent: Payloa
1d50: 64 20 62 79 74 65 73 20 75 73 65 64 20 61 73 20  d bytes used as 
1d60: 61 20 70 65 72 63 65 6e 74 61 67 65 20 6f 66 20  a percentage of 
1d70: 24 73 74 6f 72 61 67 65 2e 0a 20 20 23 20 74 6f  $storage..  # to
1d80: 74 61 6c 5f 75 6e 75 73 65 64 3a 20 55 6e 75 73  tal_unused: Unus
1d90: 65 64 20 62 79 74 65 73 20 6f 6e 20 70 61 67 65  ed bytes on page
1da0: 73 2e 0a 20 20 23 20 61 76 67 5f 70 61 79 6c 6f  s..  # avg_paylo
1db0: 61 64 3a 20 41 76 65 72 61 67 65 20 70 61 79 6c  ad: Average payl
1dc0: 6f 61 64 20 70 65 72 20 62 74 72 65 65 20 65 6e  oad per btree en
1dd0: 74 72 79 2e 0a 20 20 23 20 61 76 67 5f 66 61 6e  try..  # avg_fan
1de0: 6f 75 74 3a 20 41 76 65 72 61 67 65 20 66 61 6e  out: Average fan
1df0: 6f 75 74 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c  out for internal
1e00: 20 70 61 67 65 73 2e 0a 20 20 23 20 61 76 67 5f   pages..  # avg_
1e10: 75 6e 75 73 65 64 3a 20 41 76 65 72 61 67 65 20  unused: Average 
1e20: 75 6e 75 73 65 64 20 62 79 74 65 73 20 70 65 72  unused bytes per
1e30: 20 62 74 72 65 65 20 65 6e 74 72 79 2e 0a 20 20   btree entry..  
1e40: 23 20 6f 76 66 6c 5f 63 6e 74 5f 70 65 72 63 65  # ovfl_cnt_perce
1e50: 6e 74 3a 20 50 65 72 63 65 6e 74 61 67 65 20 6f  nt: Percentage o
1e60: 66 20 62 74 72 65 65 20 65 6e 74 72 69 65 73 20  f btree entries 
1e70: 74 68 61 74 20 75 73 65 20 6f 76 65 72 66 6c 6f  that use overflo
1e80: 77 20 70 61 67 65 73 2e 0a 20 20 23 0a 20 20 73  w pages..  #.  s
1e90: 65 74 20 74 6f 74 61 6c 5f 70 61 67 65 73 20 5b  et total_pages [
1ea0: 65 78 70 72 20 7b 24 6c 65 61 66 5f 70 61 67 65  expr {$leaf_page
1eb0: 73 2b 24 69 6e 74 5f 70 61 67 65 73 2b 24 6f 76  s+$int_pages+$ov
1ec0: 66 6c 5f 70 61 67 65 73 7d 5d 0a 20 20 73 65 74  fl_pages}].  set
1ed0: 20 74 6f 74 61 6c 5f 70 61 67 65 73 5f 70 65 72   total_pages_per
1ee0: 63 65 6e 74 20 5b 70 65 72 63 65 6e 74 20 24 74  cent [percent $t
1ef0: 6f 74 61 6c 5f 70 61 67 65 73 20 24 66 69 6c 65  otal_pages $file
1f00: 5f 70 67 63 6e 74 5d 0a 20 20 73 65 74 20 73 74  _pgcnt].  set st
1f10: 6f 72 61 67 65 20 5b 65 78 70 72 20 7b 24 74 6f  orage [expr {$to
1f20: 74 61 6c 5f 70 61 67 65 73 2a 24 70 61 67 65 53  tal_pages*$pageS
1f30: 69 7a 65 7d 5d 0a 20 20 73 65 74 20 70 61 79 6c  ize}].  set payl
1f40: 6f 61 64 5f 70 65 72 63 65 6e 74 20 5b 70 65 72  oad_percent [per
1f50: 63 65 6e 74 20 24 70 61 79 6c 6f 61 64 20 24 73  cent $payload $s
1f60: 74 6f 72 61 67 65 20 7b 6f 66 20 73 74 6f 72 61  torage {of stora
1f70: 67 65 20 63 6f 6e 73 75 6d 65 64 7d 5d 0a 20 20  ge consumed}].  
1f80: 73 65 74 20 74 6f 74 61 6c 5f 75 6e 75 73 65 64  set total_unused
1f90: 20 5b 65 78 70 72 20 7b 24 6f 76 66 6c 5f 75 6e   [expr {$ovfl_un
1fa0: 75 73 65 64 2b 24 69 6e 74 5f 75 6e 75 73 65 64  used+$int_unused
1fb0: 2b 24 6c 65 61 66 5f 75 6e 75 73 65 64 7d 5d 0a  +$leaf_unused}].
1fc0: 20 20 73 65 74 20 61 76 67 5f 70 61 79 6c 6f 61    set avg_payloa
1fd0: 64 20 5b 64 69 76 69 64 65 20 24 70 61 79 6c 6f  d [divide $paylo
1fe0: 61 64 20 24 6e 6c 65 61 66 5d 0a 20 20 73 65 74  ad $nleaf].  set
1ff0: 20 61 76 67 5f 75 6e 75 73 65 64 20 5b 64 69 76   avg_unused [div
2000: 69 64 65 20 24 74 6f 74 61 6c 5f 75 6e 75 73 65  ide $total_unuse
2010: 64 20 24 6e 6c 65 61 66 5d 0a 20 20 69 66 20 7b  d $nleaf].  if {
2020: 24 69 6e 74 5f 70 61 67 65 73 3e 30 7d 20 7b 0a  $int_pages>0} {.
2030: 20 20 20 20 23 20 54 4f 44 4f 3a 20 49 73 20 74      # TODO: Is t
2040: 68 69 73 20 66 6f 72 6d 75 6c 61 20 63 6f 72 72  his formula corr
2050: 65 63 74 3f 0a 20 20 20 20 73 65 74 20 6e 54 61  ect?.    set nTa
2060: 62 20 5b 6d 65 6d 20 65 76 61 6c 20 22 0a 20 20  b [mem eval ".  
2070: 20 20 20 20 53 45 4c 45 43 54 20 63 6f 75 6e 74      SELECT count
2080: 28 2a 29 20 46 52 4f 4d 20 28 0a 20 20 20 20 20  (*) FROM (.     
2090: 20 20 20 20 20 53 45 4c 45 43 54 20 44 49 53 54       SELECT DIST
20a0: 49 4e 43 54 20 74 62 6c 6e 61 6d 65 20 46 52 4f  INCT tblname FRO
20b0: 4d 20 73 70 61 63 65 5f 75 73 65 64 20 57 48 45  M space_used WHE
20c0: 52 45 20 24 77 68 65 72 65 20 41 4e 44 20 69 73  RE $where AND is
20d0: 5f 69 6e 64 65 78 3d 30 0a 20 20 20 20 20 20 29  _index=0.      )
20e0: 0a 20 20 20 20 22 5d 0a 20 20 20 20 73 65 74 20  .    "].    set 
20f0: 61 76 67 5f 66 61 6e 6f 75 74 20 5b 6d 65 6d 20  avg_fanout [mem 
2100: 65 76 61 6c 20 22 0a 20 20 20 20 20 20 53 45 4c  eval ".      SEL
2110: 45 43 54 20 28 73 75 6d 28 6c 65 61 66 5f 70 61  ECT (sum(leaf_pa
2120: 67 65 73 2b 69 6e 74 5f 70 61 67 65 73 29 2d 24  ges+int_pages)-$
2130: 6e 54 61 62 29 2f 73 75 6d 28 69 6e 74 5f 70 61  nTab)/sum(int_pa
2140: 67 65 73 29 20 46 52 4f 4d 20 73 70 61 63 65 5f  ges) FROM space_
2150: 75 73 65 64 0a 20 20 20 20 20 20 20 20 20 20 57  used.          W
2160: 48 45 52 45 20 24 77 68 65 72 65 20 41 4e 44 20  HERE $where AND 
2170: 69 73 5f 69 6e 64 65 78 20 3d 20 30 0a 20 20 20  is_index = 0.   
2180: 20 22 5d 0a 20 20 20 20 73 65 74 20 61 76 67 5f   "].    set avg_
2190: 66 61 6e 6f 75 74 20 5b 66 6f 72 6d 61 74 20 25  fanout [format %
21a0: 2e 32 66 20 24 61 76 67 5f 66 61 6e 6f 75 74 5d  .2f $avg_fanout]
21b0: 0a 20 20 7d 0a 20 20 73 65 74 20 6f 76 66 6c 5f  .  }.  set ovfl_
21c0: 63 6e 74 5f 70 65 72 63 65 6e 74 20 5b 70 65 72  cnt_percent [per
21d0: 63 65 6e 74 20 24 6f 76 66 6c 5f 63 6e 74 20 24  cent $ovfl_cnt $
21e0: 6e 6c 65 61 66 20 7b 6f 66 20 61 6c 6c 20 65 6e  nleaf {of all en
21f0: 74 72 69 65 73 7d 5d 0a 0a 20 20 23 20 50 72 69  tries}]..  # Pri
2200: 6e 74 20 6f 75 74 20 74 68 65 20 73 75 62 2d 72  nt out the sub-r
2210: 65 70 6f 72 74 20 73 74 61 74 69 73 74 69 63 73  eport statistics
2220: 2e 0a 20 20 23 0a 20 20 73 74 61 74 6c 69 6e 65  ..  #.  statline
2230: 20 7b 50 65 72 63 65 6e 74 61 67 65 20 6f 66 20   {Percentage of 
2240: 74 6f 74 61 6c 20 64 61 74 61 62 61 73 65 7d 20  total database} 
2250: 24 74 6f 74 61 6c 5f 70 61 67 65 73 5f 70 65 72  $total_pages_per
2260: 63 65 6e 74 0a 20 20 73 74 61 74 6c 69 6e 65 20  cent.  statline 
2270: 7b 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69  {Number of entri
2280: 65 73 7d 20 24 6e 6c 65 61 66 0a 20 20 73 74 61  es} $nleaf.  sta
2290: 74 6c 69 6e 65 20 7b 42 79 74 65 73 20 6f 66 20  tline {Bytes of 
22a0: 73 74 6f 72 61 67 65 20 63 6f 6e 73 75 6d 65 64  storage consumed
22b0: 7d 20 24 73 74 6f 72 61 67 65 0a 20 20 73 74 61  } $storage.  sta
22c0: 74 6c 69 6e 65 20 7b 42 79 74 65 73 20 6f 66 20  tline {Bytes of 
22d0: 70 61 79 6c 6f 61 64 7d 20 24 70 61 79 6c 6f 61  payload} $payloa
22e0: 64 20 24 70 61 79 6c 6f 61 64 5f 70 65 72 63 65  d $payload_perce
22f0: 6e 74 0a 20 20 73 74 61 74 6c 69 6e 65 20 7b 41  nt.  statline {A
2300: 76 65 72 61 67 65 20 70 61 79 6c 6f 61 64 20 70  verage payload p
2310: 65 72 20 65 6e 74 72 79 7d 20 24 61 76 67 5f 70  er entry} $avg_p
2320: 61 79 6c 6f 61 64 0a 20 20 73 74 61 74 6c 69 6e  ayload.  statlin
2330: 65 20 7b 41 76 65 72 61 67 65 20 75 6e 75 73 65  e {Average unuse
2340: 64 20 62 79 74 65 73 20 70 65 72 20 65 6e 74 72  d bytes per entr
2350: 79 7d 20 24 61 76 67 5f 75 6e 75 73 65 64 0a 20  y} $avg_unused. 
2360: 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74   if {[info exist
2370: 73 20 61 76 67 5f 66 61 6e 6f 75 74 5d 7d 20 7b  s avg_fanout]} {
2380: 0a 20 20 20 20 73 74 61 74 6c 69 6e 65 20 7b 41  .    statline {A
2390: 76 65 72 61 67 65 20 66 61 6e 6f 75 74 7d 20 24  verage fanout} $
23a0: 61 76 67 5f 66 61 6e 6f 75 74 0a 20 20 7d 0a 20  avg_fanout.  }. 
23b0: 20 69 66 20 7b 24 74 6f 74 61 6c 5f 70 61 67 65   if {$total_page
23c0: 73 3e 31 7d 20 7b 0a 20 20 20 20 73 65 74 20 66  s>1} {.    set f
23d0: 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 5b 70 65  ragmentation [pe
23e0: 72 63 65 6e 74 20 24 67 61 70 5f 63 6e 74 20 5b  rcent $gap_cnt [
23f0: 65 78 70 72 20 7b 24 74 6f 74 61 6c 5f 70 61 67  expr {$total_pag
2400: 65 73 2d 31 7d 5d 20 7b 66 72 61 67 6d 65 6e 74  es-1}] {fragment
2410: 61 74 69 6f 6e 7d 5d 0a 20 20 20 20 73 74 61 74  ation}].    stat
2420: 6c 69 6e 65 20 7b 46 72 61 67 6d 65 6e 74 61 74  line {Fragmentat
2430: 69 6f 6e 7d 20 24 66 72 61 67 6d 65 6e 74 61 74  ion} $fragmentat
2440: 69 6f 6e 0a 20 20 7d 0a 20 20 73 74 61 74 6c 69  ion.  }.  statli
2450: 6e 65 20 7b 4d 61 78 69 6d 75 6d 20 70 61 79 6c  ne {Maximum payl
2460: 6f 61 64 20 70 65 72 20 65 6e 74 72 79 7d 20 24  oad per entry} $
2470: 6d 78 5f 70 61 79 6c 6f 61 64 0a 20 20 73 74 61  mx_payload.  sta
2480: 74 6c 69 6e 65 20 7b 45 6e 74 72 69 65 73 20 74  tline {Entries t
2490: 68 61 74 20 75 73 65 20 6f 76 65 72 66 6c 6f 77  hat use overflow
24a0: 7d 20 24 6f 76 66 6c 5f 63 6e 74 20 24 6f 76 66  } $ovfl_cnt $ovf
24b0: 6c 5f 63 6e 74 5f 70 65 72 63 65 6e 74 0a 20 20  l_cnt_percent.  
24c0: 69 66 20 7b 24 69 6e 74 5f 70 61 67 65 73 3e 30  if {$int_pages>0
24d0: 7d 20 7b 0a 20 20 20 20 73 74 61 74 6c 69 6e 65  } {.    statline
24e0: 20 7b 49 6e 64 65 78 20 70 61 67 65 73 20 75 73   {Index pages us
24f0: 65 64 7d 20 24 69 6e 74 5f 70 61 67 65 73 0a 20  ed} $int_pages. 
2500: 20 7d 0a 20 20 73 74 61 74 6c 69 6e 65 20 7b 50   }.  statline {P
2510: 72 69 6d 61 72 79 20 70 61 67 65 73 20 75 73 65  rimary pages use
2520: 64 7d 20 24 6c 65 61 66 5f 70 61 67 65 73 0a 20  d} $leaf_pages. 
2530: 20 73 74 61 74 6c 69 6e 65 20 7b 4f 76 65 72 66   statline {Overf
2540: 6c 6f 77 20 70 61 67 65 73 20 75 73 65 64 7d 20  low pages used} 
2550: 24 6f 76 66 6c 5f 70 61 67 65 73 0a 20 20 73 74  $ovfl_pages.  st
2560: 61 74 6c 69 6e 65 20 7b 54 6f 74 61 6c 20 70 61  atline {Total pa
2570: 67 65 73 20 75 73 65 64 7d 20 24 74 6f 74 61 6c  ges used} $total
2580: 5f 70 61 67 65 73 0a 20 20 69 66 20 7b 24 69 6e  _pages.  if {$in
2590: 74 5f 75 6e 75 73 65 64 3e 30 7d 20 7b 0a 20 20  t_unused>0} {.  
25a0: 20 20 73 65 74 20 69 6e 74 5f 75 6e 75 73 65 64    set int_unused
25b0: 5f 70 65 72 63 65 6e 74 20 5c 0a 20 20 20 20 20  _percent \.     
25c0: 20 20 20 20 5b 70 65 72 63 65 6e 74 20 24 69 6e      [percent $in
25d0: 74 5f 75 6e 75 73 65 64 20 5b 65 78 70 72 20 7b  t_unused [expr {
25e0: 24 69 6e 74 5f 70 61 67 65 73 2a 24 70 61 67 65  $int_pages*$page
25f0: 53 69 7a 65 7d 5d 20 7b 6f 66 20 69 6e 64 65 78  Size}] {of index
2600: 20 73 70 61 63 65 7d 5d 0a 20 20 20 20 73 74 61   space}].    sta
2610: 74 6c 69 6e 65 20 22 55 6e 75 73 65 64 20 62 79  tline "Unused by
2620: 74 65 73 20 6f 6e 20 69 6e 64 65 78 20 70 61 67  tes on index pag
2630: 65 73 22 20 24 69 6e 74 5f 75 6e 75 73 65 64 20  es" $int_unused 
2640: 24 69 6e 74 5f 75 6e 75 73 65 64 5f 70 65 72 63  $int_unused_perc
2650: 65 6e 74 0a 20 20 7d 0a 20 20 73 74 61 74 6c 69  ent.  }.  statli
2660: 6e 65 20 22 55 6e 75 73 65 64 20 62 79 74 65 73  ne "Unused bytes
2670: 20 6f 6e 20 70 72 69 6d 61 72 79 20 70 61 67 65   on primary page
2680: 73 22 20 24 6c 65 61 66 5f 75 6e 75 73 65 64 20  s" $leaf_unused 
2690: 5c 0a 20 20 20 20 20 5b 70 65 72 63 65 6e 74 20  \.     [percent 
26a0: 24 6c 65 61 66 5f 75 6e 75 73 65 64 20 5b 65 78  $leaf_unused [ex
26b0: 70 72 20 7b 24 6c 65 61 66 5f 70 61 67 65 73 2a  pr {$leaf_pages*
26c0: 24 70 61 67 65 53 69 7a 65 7d 5d 20 7b 6f 66 20  $pageSize}] {of 
26d0: 70 72 69 6d 61 72 79 20 73 70 61 63 65 7d 5d 0a  primary space}].
26e0: 20 20 73 74 61 74 6c 69 6e 65 20 22 55 6e 75 73    statline "Unus
26f0: 65 64 20 62 79 74 65 73 20 6f 6e 20 6f 76 65 72  ed bytes on over
2700: 66 6c 6f 77 20 70 61 67 65 73 22 20 24 6f 76 66  flow pages" $ovf
2710: 6c 5f 75 6e 75 73 65 64 20 5c 0a 20 20 20 20 20  l_unused \.     
2720: 5b 70 65 72 63 65 6e 74 20 24 6f 76 66 6c 5f 75  [percent $ovfl_u
2730: 6e 75 73 65 64 20 5b 65 78 70 72 20 7b 24 6f 76  nused [expr {$ov
2740: 66 6c 5f 70 61 67 65 73 2a 24 70 61 67 65 53 69  fl_pages*$pageSi
2750: 7a 65 7d 5d 20 7b 6f 66 20 6f 76 65 72 66 6c 6f  ze}] {of overflo
2760: 77 20 73 70 61 63 65 7d 5d 0a 20 20 73 74 61 74  w space}].  stat
2770: 6c 69 6e 65 20 22 55 6e 75 73 65 64 20 62 79 74  line "Unused byt
2780: 65 73 20 6f 6e 20 61 6c 6c 20 70 61 67 65 73 22  es on all pages"
2790: 20 24 74 6f 74 61 6c 5f 75 6e 75 73 65 64 20 5c   $total_unused \
27a0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
27b0: 5b 70 65 72 63 65 6e 74 20 24 74 6f 74 61 6c 5f  [percent $total_
27c0: 75 6e 75 73 65 64 20 24 73 74 6f 72 61 67 65 20  unused $storage 
27d0: 7b 6f 66 20 61 6c 6c 20 73 70 61 63 65 7d 5d 0a  {of all space}].
27e0: 20 20 72 65 74 75 72 6e 20 31 0a 7d 0a 0a 23 20    return 1.}..# 
27f0: 43 61 6c 63 75 6c 61 74 65 20 74 68 65 20 6f 76  Calculate the ov
2800: 65 72 68 65 61 64 20 69 6e 20 70 61 67 65 73 20  erhead in pages 
2810: 63 61 75 73 65 64 20 62 79 20 61 75 74 6f 2d 76  caused by auto-v
2820: 61 63 75 75 6d 2e 20 0a 23 0a 23 20 54 68 69 73  acuum. .#.# This
2830: 20 70 72 6f 63 65 64 75 72 65 20 63 61 6c 63 75   procedure calcu
2840: 6c 61 74 65 73 20 61 6e 64 20 72 65 74 75 72 6e  lates and return
2850: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
2860: 70 61 67 65 73 20 75 73 65 64 20 62 79 20 74 68  pages used by th
2870: 65 20 0a 23 20 61 75 74 6f 2d 76 61 63 75 75 6d  e .# auto-vacuum
2880: 20 27 70 6f 69 6e 74 65 72 2d 6d 61 70 27 2e 20   'pointer-map'. 
2890: 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  If the database 
28a0: 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74  does not support
28b0: 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c 0a 23 20   auto-vacuum,.# 
28c0: 74 68 65 6e 20 30 20 69 73 20 72 65 74 75 72 6e  then 0 is return
28d0: 65 64 2e 20 54 68 65 20 74 77 6f 20 61 72 67 75  ed. The two argu
28e0: 6d 65 6e 74 73 20 61 72 65 20 74 68 65 20 73 69  ments are the si
28f0: 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  ze of the databa
2900: 73 65 20 66 69 6c 65 20 69 6e 0a 23 20 70 61 67  se file in.# pag
2910: 65 73 20 61 6e 64 20 74 68 65 20 70 61 67 65 20  es and the page 
2920: 73 69 7a 65 20 75 73 65 64 20 62 79 20 74 68 65  size used by the
2930: 20 64 61 74 61 62 61 73 65 20 28 69 6e 20 62 79   database (in by
2940: 74 65 73 29 2e 0a 70 72 6f 63 20 61 75 74 6f 76  tes)..proc autov
2950: 61 63 75 75 6d 5f 6f 76 65 72 68 65 61 64 20 7b  acuum_overhead {
2960: 66 69 6c 65 50 61 67 65 73 20 70 61 67 65 53 69  filePages pageSi
2970: 7a 65 7d 20 7b 0a 0a 20 20 23 20 53 65 74 20 24  ze} {..  # Set $
2980: 61 75 74 6f 76 61 63 75 75 6d 20 74 6f 20 6e 6f  autovacuum to no
2990: 6e 2d 7a 65 72 6f 20 66 6f 72 20 64 61 74 61 62  n-zero for datab
29a0: 61 73 65 73 20 74 68 61 74 20 73 75 70 70 6f 72  ases that suppor
29b0: 74 20 61 75 74 6f 2d 76 61 63 75 75 6d 2e 0a 20  t auto-vacuum.. 
29c0: 20 73 65 74 20 61 75 74 6f 76 61 63 75 75 6d 20   set autovacuum 
29d0: 5b 64 62 20 6f 6e 65 20 7b 50 52 41 47 4d 41 20  [db one {PRAGMA 
29e0: 61 75 74 6f 5f 76 61 63 75 75 6d 7d 5d 0a 0a 20  auto_vacuum}].. 
29f0: 20 23 20 49 66 20 74 68 65 20 64 61 74 61 62 61   # If the databa
2a00: 73 65 20 69 73 20 6e 6f 74 20 61 6e 20 61 75 74  se is not an aut
2a10: 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73  o-vacuum databas
2a20: 65 20 6f 72 20 74 68 65 20 66 69 6c 65 20 63 6f  e or the file co
2a30: 6e 73 69 73 74 73 0a 20 20 23 20 6f 66 20 6f 6e  nsists.  # of on
2a40: 65 20 70 61 67 65 20 6f 6e 6c 79 20 74 68 65 6e  e page only then
2a50: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6f 76 65   there is no ove
2a60: 72 68 65 61 64 20 66 6f 72 20 61 75 74 6f 2d 76  rhead for auto-v
2a70: 61 63 75 75 6d 2e 20 52 65 74 75 72 6e 20 7a 65  acuum. Return ze
2a80: 72 6f 2e 0a 20 20 69 66 20 7b 30 3d 3d 24 61 75  ro..  if {0==$au
2a90: 74 6f 76 61 63 75 75 6d 20 7c 7c 20 24 66 69 6c  tovacuum || $fil
2aa0: 65 50 61 67 65 73 3d 3d 31 7d 20 7b 0a 20 20 20  ePages==1} {.   
2ab0: 20 72 65 74 75 72 6e 20 30 0a 20 20 7d 0a 0a 20   return 0.  }.. 
2ac0: 20 23 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66   # The number of
2ad0: 20 65 6e 74 72 69 65 73 20 6f 6e 20 65 61 63 68   entries on each
2ae0: 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67   pointer map pag
2af0: 65 2e 20 54 68 65 20 6c 61 79 6f 75 74 20 6f 66  e. The layout of
2b00: 20 74 68 65 0a 20 20 23 20 64 61 74 61 62 61 73   the.  # databas
2b10: 65 20 66 69 6c 65 20 69 73 20 6f 6e 65 20 70 6f  e file is one po
2b20: 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 2c 20  inter-map page, 
2b30: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 24 70 74 72  followed by $ptr
2b40: 73 50 65 72 50 61 67 65 20 6f 74 68 65 72 0a 20  sPerPage other. 
2b50: 20 23 20 70 61 67 65 73 2c 20 66 6f 6c 6c 6f 77   # pages, follow
2b60: 65 64 20 62 79 20 61 20 70 6f 69 6e 74 65 72 2d  ed by a pointer-
2b70: 6d 61 70 20 70 61 67 65 20 65 74 63 2e 20 54 68  map page etc. Th
2b80: 65 20 66 69 72 73 74 20 70 6f 69 6e 74 65 72 2d  e first pointer-
2b90: 6d 61 70 20 70 61 67 65 0a 20 20 23 20 69 73 20  map page.  # is 
2ba0: 74 68 65 20 73 65 63 6f 6e 64 20 70 61 67 65 20  the second page 
2bb0: 6f 66 20 74 68 65 20 66 69 6c 65 20 6f 76 65 72  of the file over
2bc0: 61 6c 6c 2e 0a 20 20 73 65 74 20 70 74 72 73 50  all..  set ptrsP
2bd0: 65 72 50 61 67 65 20 5b 65 78 70 72 20 64 6f 75  erPage [expr dou
2be0: 62 6c 65 28 24 70 61 67 65 53 69 7a 65 2f 35 29  ble($pageSize/5)
2bf0: 5d 0a 0a 20 20 23 20 52 65 74 75 72 6e 20 74 68  ]..  # Return th
2c00: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e  e number of poin
2c10: 74 65 72 20 6d 61 70 20 70 61 67 65 73 20 69 6e  ter map pages in
2c20: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 20   the database.. 
2c30: 20 72 65 74 75 72 6e 20 5b 65 78 70 72 20 69 6e   return [expr in
2c40: 74 28 63 65 69 6c 28 20 28 24 66 69 6c 65 50 61  t(ceil( ($filePa
2c50: 67 65 73 2d 31 2e 30 29 2f 28 24 70 74 72 73 50  ges-1.0)/($ptrsP
2c60: 65 72 50 61 67 65 2b 31 2e 30 29 20 29 29 5d 0a  erPage+1.0) ))].
2c70: 7d 0a 0a 0a 23 20 43 61 6c 63 75 6c 61 74 65 20  }...# Calculate 
2c80: 74 68 65 20 73 75 6d 6d 61 72 79 20 73 74 61 74  the summary stat
2c90: 69 73 74 69 63 73 20 66 6f 72 20 74 68 65 20 64  istics for the d
2ca0: 61 74 61 62 61 73 65 20 61 6e 64 20 73 74 6f 72  atabase and stor
2cb0: 65 20 74 68 65 20 72 65 73 75 6c 74 73 0a 23 20  e the results.# 
2cc0: 69 6e 20 54 43 4c 20 76 61 72 69 61 62 6c 65 73  in TCL variables
2cd0: 2e 20 54 68 65 79 20 61 72 65 20 6f 75 74 70 75  . They are outpu
2ce0: 74 20 62 65 6c 6f 77 2e 20 56 61 72 69 61 62 6c  t below. Variabl
2cf0: 65 73 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77  es are as follow
2d00: 73 3a 0a 23 0a 23 20 70 61 67 65 53 69 7a 65 3a  s:.#.# pageSize:
2d10: 20 20 20 20 20 20 53 69 7a 65 20 6f 66 20 65 61        Size of ea
2d20: 63 68 20 70 61 67 65 20 69 6e 20 62 79 74 65 73  ch page in bytes
2d30: 2e 0a 23 20 66 69 6c 65 5f 62 79 74 65 73 3a 20  ..# file_bytes: 
2d40: 20 20 20 46 69 6c 65 20 73 69 7a 65 20 69 6e 20     File size in 
2d50: 62 79 74 65 73 2e 0a 23 20 66 69 6c 65 5f 70 67  bytes..# file_pg
2d60: 63 6e 74 3a 20 20 20 20 4e 75 6d 62 65 72 20 6f  cnt:    Number o
2d70: 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 66  f pages in the f
2d80: 69 6c 65 2e 0a 23 20 66 69 6c 65 5f 70 67 63 6e  ile..# file_pgcn
2d90: 74 32 3a 20 20 20 4e 75 6d 62 65 72 20 6f 66 20  t2:   Number of 
2da0: 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 69 6c  pages in the fil
2db0: 65 20 28 63 61 6c 63 75 6c 61 74 65 64 29 2e 0a  e (calculated)..
2dc0: 23 20 61 76 5f 70 67 63 6e 74 3a 20 20 20 20 20  # av_pgcnt:     
2dd0: 20 50 61 67 65 73 20 63 6f 6e 73 75 6d 65 64 20   Pages consumed 
2de0: 62 79 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75  by the auto-vacu
2df0: 75 6d 20 70 6f 69 6e 74 65 72 2d 6d 61 70 2e 0a  um pointer-map..
2e00: 23 20 61 76 5f 70 65 72 63 65 6e 74 3a 20 20 20  # av_percent:   
2e10: 20 50 65 72 63 65 6e 74 61 67 65 20 6f 66 20 74   Percentage of t
2e20: 68 65 20 66 69 6c 65 20 63 6f 6e 73 75 6d 65 64  he file consumed
2e30: 20 62 79 20 61 75 74 6f 2d 76 61 63 75 75 6d 20   by auto-vacuum 
2e40: 70 6f 69 6e 74 65 72 2d 6d 61 70 2e 0a 23 20 69  pointer-map..# i
2e50: 6e 75 73 65 5f 70 67 63 6e 74 3a 20 20 20 44 61  nuse_pgcnt:   Da
2e60: 74 61 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  ta pages in the 
2e70: 66 69 6c 65 2e 0a 23 20 69 6e 75 73 65 5f 70 65  file..# inuse_pe
2e80: 72 63 65 6e 74 3a 20 50 65 72 63 65 6e 74 61 67  rcent: Percentag
2e90: 65 20 6f 66 20 70 61 67 65 73 20 75 73 65 64 20  e of pages used 
2ea0: 74 6f 20 73 74 6f 72 65 20 64 61 74 61 2e 0a 23  to store data..#
2eb0: 20 66 72 65 65 5f 70 67 63 6e 74 3a 20 20 20 20   free_pgcnt:    
2ec0: 46 72 65 65 20 70 61 67 65 73 20 63 61 6c 63 75  Free pages calcu
2ed0: 6c 61 74 65 64 20 61 73 20 28 3c 74 6f 74 61 6c  lated as (<total
2ee0: 20 70 61 67 65 73 3e 20 2d 20 3c 69 6e 2d 75 73   pages> - <in-us
2ef0: 65 20 70 61 67 65 73 3e 29 0a 23 20 66 72 65 65  e pages>).# free
2f00: 5f 70 67 63 6e 74 32 3a 20 20 20 46 72 65 65 20  _pgcnt2:   Free 
2f10: 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 69 6c  pages in the fil
2f20: 65 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74  e according to t
2f30: 68 65 20 66 69 6c 65 20 68 65 61 64 65 72 2e 0a  he file header..
2f40: 23 20 66 72 65 65 5f 70 65 72 63 65 6e 74 3a 20  # free_percent: 
2f50: 20 50 65 72 63 65 6e 74 61 67 65 20 6f 66 20 66   Percentage of f
2f60: 69 6c 65 20 63 6f 6e 73 75 6d 65 64 20 62 79 20  ile consumed by 
2f70: 66 72 65 65 20 70 61 67 65 73 20 28 63 61 6c 63  free pages (calc
2f80: 75 6c 61 74 65 64 29 2e 0a 23 20 66 72 65 65 5f  ulated)..# free_
2f90: 70 65 72 63 65 6e 74 32 3a 20 50 65 72 63 65 6e  percent2: Percen
2fa0: 74 61 67 65 20 6f 66 20 66 69 6c 65 20 63 6f 6e  tage of file con
2fb0: 73 75 6d 65 64 20 62 79 20 66 72 65 65 20 70 61  sumed by free pa
2fc0: 67 65 73 20 28 68 65 61 64 65 72 29 2e 0a 23 20  ges (header)..# 
2fd0: 6e 74 61 62 6c 65 3a 20 20 20 20 20 20 20 20 4e  ntable:        N
2fe0: 75 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 73 20  umber of tables 
2ff0: 69 6e 20 74 68 65 20 64 62 2e 0a 23 20 6e 69 6e  in the db..# nin
3000: 64 65 78 3a 20 20 20 20 20 20 20 20 4e 75 6d 62  dex:        Numb
3010: 65 72 20 6f 66 20 69 6e 64 69 63 65 73 20 69 6e  er of indices in
3020: 20 74 68 65 20 64 62 2e 0a 23 20 6e 61 75 74 6f   the db..# nauto
3030: 69 6e 64 65 78 3a 20 20 20 20 4e 75 6d 62 65 72  index:    Number
3040: 20 6f 66 20 69 6e 64 69 63 65 73 20 63 72 65 61   of indices crea
3050: 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  ted automaticall
3060: 79 2e 0a 23 20 6e 6d 61 6e 69 6e 64 65 78 3a 20  y..# nmanindex: 
3070: 20 20 20 20 4e 75 6d 62 65 72 20 6f 66 20 69 6e      Number of in
3080: 64 69 63 65 73 20 63 72 65 61 74 65 64 20 6d 61  dices created ma
3090: 6e 75 61 6c 6c 79 2e 0a 23 20 75 73 65 72 5f 70  nually..# user_p
30a0: 61 79 6c 6f 61 64 3a 20 20 4e 75 6d 62 65 72 20  ayload:  Number 
30b0: 6f 66 20 62 79 74 65 73 20 6f 66 20 70 61 79 6c  of bytes of payl
30c0: 6f 61 64 20 69 6e 20 74 61 62 6c 65 20 62 74 72  oad in table btr
30d0: 65 65 73 20 0a 23 20 20 20 20 20 20 20 20 20 20  ees .#          
30e0: 20 20 20 20 20 20 28 6e 6f 74 20 69 6e 63 6c 75        (not inclu
30f0: 64 69 6e 67 20 73 71 6c 69 74 65 5f 6d 61 73 74  ding sqlite_mast
3100: 65 72 29 0a 23 20 75 73 65 72 5f 70 65 72 63 65  er).# user_perce
3110: 6e 74 3a 20 20 24 75 73 65 72 5f 70 61 79 6c 6f  nt:  $user_paylo
3120: 61 64 20 61 73 20 61 20 70 65 72 63 65 6e 74 61  ad as a percenta
3130: 67 65 20 6f 66 20 74 6f 74 61 6c 20 66 69 6c 65  ge of total file
3140: 20 73 69 7a 65 2e 0a 0a 73 65 74 20 66 69 6c 65   size...set file
3150: 5f 62 79 74 65 73 20 20 5b 66 69 6c 65 20 73 69  _bytes  [file si
3160: 7a 65 20 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c  ze $file_to_anal
3170: 79 7a 65 5d 0a 73 65 74 20 66 69 6c 65 5f 70 67  yze].set file_pg
3180: 63 6e 74 20 20 5b 65 78 70 72 20 7b 24 66 69 6c  cnt  [expr {$fil
3190: 65 5f 62 79 74 65 73 2f 24 70 61 67 65 53 69 7a  e_bytes/$pageSiz
31a0: 65 7d 5d 0a 0a 73 65 74 20 61 76 5f 70 67 63 6e  e}]..set av_pgcn
31b0: 74 20 20 20 20 5b 61 75 74 6f 76 61 63 75 75 6d  t    [autovacuum
31c0: 5f 6f 76 65 72 68 65 61 64 20 24 66 69 6c 65 5f  _overhead $file_
31d0: 70 67 63 6e 74 20 24 70 61 67 65 53 69 7a 65 5d  pgcnt $pageSize]
31e0: 0a 73 65 74 20 61 76 5f 70 65 72 63 65 6e 74 20  .set av_percent 
31f0: 20 5b 70 65 72 63 65 6e 74 20 24 61 76 5f 70 67   [percent $av_pg
3200: 63 6e 74 20 24 66 69 6c 65 5f 70 67 63 6e 74 5d  cnt $file_pgcnt]
3210: 0a 0a 73 65 74 20 73 71 6c 20 7b 53 45 4c 45 43  ..set sql {SELEC
3220: 54 20 73 75 6d 28 6c 65 61 66 5f 70 61 67 65 73  T sum(leaf_pages
3230: 2b 69 6e 74 5f 70 61 67 65 73 2b 6f 76 66 6c 5f  +int_pages+ovfl_
3240: 70 61 67 65 73 29 20 46 52 4f 4d 20 73 70 61 63  pages) FROM spac
3250: 65 5f 75 73 65 64 7d 0a 73 65 74 20 69 6e 75 73  e_used}.set inus
3260: 65 5f 70 67 63 6e 74 20 20 20 5b 65 78 70 72 20  e_pgcnt   [expr 
3270: 69 6e 74 28 5b 6d 65 6d 20 65 76 61 6c 20 24 73  int([mem eval $s
3280: 71 6c 5d 29 5d 0a 73 65 74 20 69 6e 75 73 65 5f  ql])].set inuse_
3290: 70 65 72 63 65 6e 74 20 5b 70 65 72 63 65 6e 74  percent [percent
32a0: 20 24 69 6e 75 73 65 5f 70 67 63 6e 74 20 24 66   $inuse_pgcnt $f
32b0: 69 6c 65 5f 70 67 63 6e 74 5d 0a 0a 73 65 74 20  ile_pgcnt]..set 
32c0: 66 72 65 65 5f 70 67 63 6e 74 20 20 20 20 5b 65  free_pgcnt    [e
32d0: 78 70 72 20 24 66 69 6c 65 5f 70 67 63 6e 74 2d  xpr $file_pgcnt-
32e0: 24 69 6e 75 73 65 5f 70 67 63 6e 74 2d 24 61 76  $inuse_pgcnt-$av
32f0: 5f 70 67 63 6e 74 5d 0a 73 65 74 20 66 72 65 65  _pgcnt].set free
3300: 5f 70 65 72 63 65 6e 74 20 20 5b 70 65 72 63 65  _percent  [perce
3310: 6e 74 20 24 66 72 65 65 5f 70 67 63 6e 74 20 24  nt $free_pgcnt $
3320: 66 69 6c 65 5f 70 67 63 6e 74 5d 0a 73 65 74 20  file_pgcnt].set 
3330: 66 72 65 65 5f 70 67 63 6e 74 32 20 20 20 5b 64  free_pgcnt2   [d
3340: 62 20 6f 6e 65 20 7b 50 52 41 47 4d 41 20 66 72  b one {PRAGMA fr
3350: 65 65 6c 69 73 74 5f 63 6f 75 6e 74 7d 5d 0a 73  eelist_count}].s
3360: 65 74 20 66 72 65 65 5f 70 65 72 63 65 6e 74 32  et free_percent2
3370: 20 5b 70 65 72 63 65 6e 74 20 24 66 72 65 65 5f   [percent $free_
3380: 70 67 63 6e 74 32 20 24 66 69 6c 65 5f 70 67 63  pgcnt2 $file_pgc
3390: 6e 74 5d 0a 0a 73 65 74 20 66 69 6c 65 5f 70 67  nt]..set file_pg
33a0: 63 6e 74 32 20 5b 65 78 70 72 20 7b 24 69 6e 75  cnt2 [expr {$inu
33b0: 73 65 5f 70 67 63 6e 74 2b 24 66 72 65 65 5f 70  se_pgcnt+$free_p
33c0: 67 63 6e 74 32 2b 24 61 76 5f 70 67 63 6e 74 7d  gcnt2+$av_pgcnt}
33d0: 5d 0a 0a 73 65 74 20 6e 74 61 62 6c 65 20 5b 64  ]..set ntable [d
33e0: 62 20 65 76 61 6c 20 7b 53 45 4c 45 43 54 20 63  b eval {SELECT c
33f0: 6f 75 6e 74 28 2a 29 2b 31 20 46 52 4f 4d 20 73  ount(*)+1 FROM s
3400: 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 57 48 45  qlite_master WHE
3410: 52 45 20 74 79 70 65 3d 27 74 61 62 6c 65 27 7d  RE type='table'}
3420: 5d 0a 73 65 74 20 6e 69 6e 64 65 78 20 5b 64 62  ].set nindex [db
3430: 20 65 76 61 6c 20 7b 53 45 4c 45 43 54 20 63 6f   eval {SELECT co
3440: 75 6e 74 28 2a 29 20 46 52 4f 4d 20 73 71 6c 69  unt(*) FROM sqli
3450: 74 65 5f 6d 61 73 74 65 72 20 57 48 45 52 45 20  te_master WHERE 
3460: 74 79 70 65 3d 27 69 6e 64 65 78 27 7d 5d 0a 73  type='index'}].s
3470: 65 74 20 73 71 6c 20 7b 53 45 4c 45 43 54 20 63  et sql {SELECT c
3480: 6f 75 6e 74 28 2a 29 20 46 52 4f 4d 20 73 71 6c  ount(*) FROM sql
3490: 69 74 65 5f 6d 61 73 74 65 72 20 57 48 45 52 45  ite_master WHERE
34a0: 20 6e 61 6d 65 20 4c 49 4b 45 20 27 73 71 6c 69   name LIKE 'sqli
34b0: 74 65 5f 61 75 74 6f 69 6e 64 65 78 25 27 7d 0a  te_autoindex%'}.
34c0: 73 65 74 20 6e 61 75 74 6f 69 6e 64 65 78 20 5b  set nautoindex [
34d0: 64 62 20 65 76 61 6c 20 24 73 71 6c 5d 0a 73 65  db eval $sql].se
34e0: 74 20 6e 6d 61 6e 69 6e 64 65 78 20 5b 65 78 70  t nmanindex [exp
34f0: 72 20 7b 24 6e 69 6e 64 65 78 2d 24 6e 61 75 74  r {$nindex-$naut
3500: 6f 69 6e 64 65 78 7d 5d 0a 0a 23 20 73 65 74 20  oindex}]..# set 
3510: 74 6f 74 61 6c 5f 70 61 79 6c 6f 61 64 20 5b 6d  total_payload [m
3520: 65 6d 20 65 76 61 6c 20 22 53 45 4c 45 43 54 20  em eval "SELECT 
3530: 73 75 6d 28 70 61 79 6c 6f 61 64 29 20 46 52 4f  sum(payload) FRO
3540: 4d 20 73 70 61 63 65 5f 75 73 65 64 22 5d 0a 73  M space_used"].s
3550: 65 74 20 75 73 65 72 5f 70 61 79 6c 6f 61 64 20  et user_payload 
3560: 5b 6d 65 6d 20 6f 6e 65 20 7b 53 45 4c 45 43 54  [mem one {SELECT
3570: 20 69 6e 74 28 73 75 6d 28 70 61 79 6c 6f 61 64   int(sum(payload
3580: 29 29 20 46 52 4f 4d 20 73 70 61 63 65 5f 75 73  )) FROM space_us
3590: 65 64 0a 20 20 20 20 20 57 48 45 52 45 20 4e 4f  ed.     WHERE NO
35a0: 54 20 69 73 5f 69 6e 64 65 78 20 41 4e 44 20 6e  T is_index AND n
35b0: 61 6d 65 20 4e 4f 54 20 4c 49 4b 45 20 27 73 71  ame NOT LIKE 'sq
35c0: 6c 69 74 65 5f 6d 61 73 74 65 72 27 7d 5d 0a 73  lite_master'}].s
35d0: 65 74 20 75 73 65 72 5f 70 65 72 63 65 6e 74 20  et user_percent 
35e0: 5b 70 65 72 63 65 6e 74 20 24 75 73 65 72 5f 70  [percent $user_p
35f0: 61 79 6c 6f 61 64 20 24 66 69 6c 65 5f 62 79 74  ayload $file_byt
3600: 65 73 5d 0a 0a 23 20 4f 75 74 70 75 74 20 74 68  es]..# Output th
3610: 65 20 73 75 6d 6d 61 72 79 20 73 74 61 74 69 73  e summary statis
3620: 74 69 63 73 20 63 61 6c 63 75 6c 61 74 65 64 20  tics calculated 
3630: 61 62 6f 76 65 2e 0a 23 0a 70 75 74 73 20 22 2f  above..#.puts "/
3640: 2a 2a 20 44 69 73 6b 2d 53 70 61 63 65 20 55 74  ** Disk-Space Ut
3650: 69 6c 69 7a 61 74 69 6f 6e 20 52 65 70 6f 72 74  ilization Report
3660: 20 46 6f 72 20 24 66 69 6c 65 5f 74 6f 5f 61 6e   For $file_to_an
3670: 61 6c 79 7a 65 22 0a 63 61 74 63 68 20 7b 0a 20  alyze".catch {. 
3680: 20 70 75 74 73 20 22 2a 2a 2a 20 41 73 20 6f 66   puts "*** As of
3690: 20 5b 63 6c 6f 63 6b 20 66 6f 72 6d 61 74 20 5b   [clock format [
36a0: 63 6c 6f 63 6b 20 73 65 63 6f 6e 64 73 5d 20 2d  clock seconds] -
36b0: 66 6f 72 6d 61 74 20 7b 25 59 2d 25 62 2d 25 64  format {%Y-%b-%d
36c0: 20 25 48 3a 25 4d 3a 25 53 7d 5d 22 0a 7d 0a 70   %H:%M:%S}]".}.p
36d0: 75 74 73 20 22 22 0a 73 74 61 74 6c 69 6e 65 20  uts "".statline 
36e0: 7b 50 61 67 65 20 73 69 7a 65 20 69 6e 20 62 79  {Page size in by
36f0: 74 65 73 7d 20 24 70 61 67 65 53 69 7a 65 0a 73  tes} $pageSize.s
3700: 74 61 74 6c 69 6e 65 20 7b 50 61 67 65 73 20 69  tatline {Pages i
3710: 6e 20 74 68 65 20 77 68 6f 6c 65 20 66 69 6c 65  n the whole file
3720: 20 28 6d 65 61 73 75 72 65 64 29 7d 20 24 66 69   (measured)} $fi
3730: 6c 65 5f 70 67 63 6e 74 0a 73 74 61 74 6c 69 6e  le_pgcnt.statlin
3740: 65 20 7b 50 61 67 65 73 20 69 6e 20 74 68 65 20  e {Pages in the 
3750: 77 68 6f 6c 65 20 66 69 6c 65 20 28 63 61 6c 63  whole file (calc
3760: 75 6c 61 74 65 64 29 7d 20 24 66 69 6c 65 5f 70  ulated)} $file_p
3770: 67 63 6e 74 32 0a 73 74 61 74 6c 69 6e 65 20 7b  gcnt2.statline {
3780: 50 61 67 65 73 20 74 68 61 74 20 73 74 6f 72 65  Pages that store
3790: 20 64 61 74 61 7d 20 24 69 6e 75 73 65 5f 70 67   data} $inuse_pg
37a0: 63 6e 74 20 24 69 6e 75 73 65 5f 70 65 72 63 65  cnt $inuse_perce
37b0: 6e 74 0a 73 74 61 74 6c 69 6e 65 20 7b 50 61 67  nt.statline {Pag
37c0: 65 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69  es on the freeli
37d0: 73 74 20 28 70 65 72 20 68 65 61 64 65 72 29 7d  st (per header)}
37e0: 20 24 66 72 65 65 5f 70 67 63 6e 74 32 20 24 66   $free_pgcnt2 $f
37f0: 72 65 65 5f 70 65 72 63 65 6e 74 32 0a 73 74 61  ree_percent2.sta
3800: 74 6c 69 6e 65 20 7b 50 61 67 65 73 20 6f 6e 20  tline {Pages on 
3810: 74 68 65 20 66 72 65 65 6c 69 73 74 20 28 63 61  the freelist (ca
3820: 6c 63 75 6c 61 74 65 64 29 7d 20 24 66 72 65 65  lculated)} $free
3830: 5f 70 67 63 6e 74 20 24 66 72 65 65 5f 70 65 72  _pgcnt $free_per
3840: 63 65 6e 74 0a 73 74 61 74 6c 69 6e 65 20 7b 50  cent.statline {P
3850: 61 67 65 73 20 6f 66 20 61 75 74 6f 2d 76 61 63  ages of auto-vac
3860: 75 75 6d 20 6f 76 65 72 68 65 61 64 7d 20 24 61  uum overhead} $a
3870: 76 5f 70 67 63 6e 74 20 24 61 76 5f 70 65 72 63  v_pgcnt $av_perc
3880: 65 6e 74 0a 73 74 61 74 6c 69 6e 65 20 7b 4e 75  ent.statline {Nu
3890: 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 73 20 69  mber of tables i
38a0: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 7d 20  n the database} 
38b0: 24 6e 74 61 62 6c 65 0a 73 74 61 74 6c 69 6e 65  $ntable.statline
38c0: 20 7b 4e 75 6d 62 65 72 20 6f 66 20 69 6e 64 69   {Number of indi
38d0: 63 65 73 7d 20 24 6e 69 6e 64 65 78 0a 73 74 61  ces} $nindex.sta
38e0: 74 6c 69 6e 65 20 7b 4e 75 6d 62 65 72 20 6f 66  tline {Number of
38f0: 20 6e 61 6d 65 64 20 69 6e 64 69 63 65 73 7d 20   named indices} 
3900: 24 6e 6d 61 6e 69 6e 64 65 78 0a 73 74 61 74 6c  $nmanindex.statl
3910: 69 6e 65 20 7b 41 75 74 6f 6d 61 74 69 63 61 6c  ine {Automatical
3920: 6c 79 20 67 65 6e 65 72 61 74 65 64 20 69 6e 64  ly generated ind
3930: 69 63 65 73 7d 20 24 6e 61 75 74 6f 69 6e 64 65  ices} $nautoinde
3940: 78 0a 73 74 61 74 6c 69 6e 65 20 7b 53 69 7a 65  x.statline {Size
3950: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e 20   of the file in 
3960: 62 79 74 65 73 7d 20 24 66 69 6c 65 5f 62 79 74  bytes} $file_byt
3970: 65 73 0a 73 74 61 74 6c 69 6e 65 20 7b 42 79 74  es.statline {Byt
3980: 65 73 20 6f 66 20 75 73 65 72 20 70 61 79 6c 6f  es of user paylo
3990: 61 64 20 73 74 6f 72 65 64 7d 20 24 75 73 65 72  ad stored} $user
39a0: 5f 70 61 79 6c 6f 61 64 20 24 75 73 65 72 5f 70  _payload $user_p
39b0: 65 72 63 65 6e 74 0a 0a 23 20 4f 75 74 70 75 74  ercent..# Output
39c0: 20 74 61 62 6c 65 20 72 61 6e 6b 69 6e 67 73 0a   table rankings.
39d0: 23 0a 70 75 74 73 20 22 22 0a 70 75 74 73 20 22  #.puts "".puts "
39e0: 2a 2a 2a 20 50 61 67 65 20 63 6f 75 6e 74 73 20  *** Page counts 
39f0: 66 6f 72 20 61 6c 6c 20 74 61 62 6c 65 73 20 77  for all tables w
3a00: 69 74 68 20 74 68 65 69 72 20 69 6e 64 69 63 65  ith their indice
3a10: 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  s **************
3a20: 2a 2a 2a 2a 2a 2a 22 0a 70 75 74 73 20 22 22 0a  ******".puts "".
3a30: 6d 65 6d 20 65 76 61 6c 20 7b 53 45 4c 45 43 54  mem eval {SELECT
3a40: 20 74 62 6c 6e 61 6d 65 2c 20 63 6f 75 6e 74 28   tblname, count(
3a50: 2a 29 20 41 53 20 63 6e 74 2c 20 0a 20 20 20 20  *) AS cnt, .    
3a60: 20 20 20 20 20 20 20 20 20 20 69 6e 74 28 73 75            int(su
3a70: 6d 28 69 6e 74 5f 70 61 67 65 73 2b 6c 65 61 66  m(int_pages+leaf
3a80: 5f 70 61 67 65 73 2b 6f 76 66 6c 5f 70 61 67 65  _pages+ovfl_page
3a90: 73 29 29 20 41 53 20 73 69 7a 65 0a 20 20 20 20  s)) AS size.    
3aa0: 20 20 20 20 20 20 46 52 4f 4d 20 73 70 61 63 65        FROM space
3ab0: 5f 75 73 65 64 20 47 52 4f 55 50 20 42 59 20 74  _used GROUP BY t
3ac0: 62 6c 6e 61 6d 65 20 4f 52 44 45 52 20 42 59 20  blname ORDER BY 
3ad0: 73 69 7a 65 2b 30 20 44 45 53 43 2c 20 74 62 6c  size+0 DESC, tbl
3ae0: 6e 61 6d 65 7d 20 7b 7d 20 7b 0a 20 20 73 74 61  name} {} {.  sta
3af0: 74 6c 69 6e 65 20 5b 73 74 72 69 6e 67 20 74 6f  tline [string to
3b00: 75 70 70 65 72 20 24 74 62 6c 6e 61 6d 65 5d 20  upper $tblname] 
3b10: 24 73 69 7a 65 20 5b 70 65 72 63 65 6e 74 20 24  $size [percent $
3b20: 73 69 7a 65 20 24 66 69 6c 65 5f 70 67 63 6e 74  size $file_pgcnt
3b30: 5d 0a 7d 0a 0a 23 20 4f 75 74 70 75 74 20 73 75  ].}..# Output su
3b40: 62 72 65 70 6f 72 74 73 0a 23 0a 69 66 20 7b 24  breports.#.if {$
3b50: 6e 69 6e 64 65 78 3e 30 7d 20 7b 0a 20 20 73 75  nindex>0} {.  su
3b60: 62 72 65 70 6f 72 74 20 7b 41 6c 6c 20 74 61 62  breport {All tab
3b70: 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 73 7d  les and indices}
3b80: 20 31 0a 7d 0a 73 75 62 72 65 70 6f 72 74 20 7b   1.}.subreport {
3b90: 41 6c 6c 20 74 61 62 6c 65 73 7d 20 7b 4e 4f 54  All tables} {NOT
3ba0: 20 69 73 5f 69 6e 64 65 78 7d 0a 69 66 20 7b 24   is_index}.if {$
3bb0: 6e 69 6e 64 65 78 3e 30 7d 20 7b 0a 20 20 73 75  nindex>0} {.  su
3bc0: 62 72 65 70 6f 72 74 20 7b 41 6c 6c 20 69 6e 64  breport {All ind
3bd0: 69 63 65 73 7d 20 7b 69 73 5f 69 6e 64 65 78 7d  ices} {is_index}
3be0: 0a 7d 0a 66 6f 72 65 61 63 68 20 74 62 6c 20 5b  .}.foreach tbl [
3bf0: 6d 65 6d 20 65 76 61 6c 20 7b 53 45 4c 45 43 54  mem eval {SELECT
3c00: 20 6e 61 6d 65 20 46 52 4f 4d 20 73 70 61 63 65   name FROM space
3c10: 5f 75 73 65 64 20 57 48 45 52 45 20 4e 4f 54 20  _used WHERE NOT 
3c20: 69 73 5f 69 6e 64 65 78 0a 20 20 20 20 20 20 20  is_index.       
3c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3c40: 4f 52 44 45 52 20 42 59 20 6e 61 6d 65 7d 5d 20  ORDER BY name}] 
3c50: 7b 0a 20 20 72 65 67 73 75 62 20 27 20 24 74 62  {.  regsub ' $tb
3c60: 6c 20 27 27 20 71 6e 0a 20 20 73 65 74 20 6e 61  l '' qn.  set na
3c70: 6d 65 20 5b 73 74 72 69 6e 67 20 74 6f 75 70 70  me [string toupp
3c80: 65 72 20 24 74 62 6c 5d 0a 20 20 73 65 74 20 6e  er $tbl].  set n
3c90: 20 5b 6d 65 6d 20 65 76 61 6c 20 22 53 45 4c 45   [mem eval "SELE
3ca0: 43 54 20 63 6f 75 6e 74 28 2a 29 20 46 52 4f 4d  CT count(*) FROM
3cb0: 20 73 70 61 63 65 5f 75 73 65 64 20 57 48 45 52   space_used WHER
3cc0: 45 20 74 62 6c 6e 61 6d 65 3d 27 24 71 6e 27 22  E tblname='$qn'"
3cd0: 5d 0a 20 20 69 66 20 7b 24 6e 3e 31 7d 20 7b 0a  ].  if {$n>1} {.
3ce0: 20 20 20 20 73 75 62 72 65 70 6f 72 74 20 22 54      subreport "T
3cf0: 61 62 6c 65 20 24 6e 61 6d 65 20 61 6e 64 20 61  able $name and a
3d00: 6c 6c 20 69 74 73 20 69 6e 64 69 63 65 73 22 20  ll its indices" 
3d10: 22 74 62 6c 6e 61 6d 65 3d 27 24 71 6e 27 22 0a  "tblname='$qn'".
3d20: 20 20 20 20 73 75 62 72 65 70 6f 72 74 20 22 54      subreport "T
3d30: 61 62 6c 65 20 24 6e 61 6d 65 20 77 2f 6f 20 61  able $name w/o a
3d40: 6e 79 20 69 6e 64 69 63 65 73 22 20 22 6e 61 6d  ny indices" "nam
3d50: 65 3d 27 24 71 6e 27 22 0a 20 20 20 20 73 75 62  e='$qn'".    sub
3d60: 72 65 70 6f 72 74 20 22 49 6e 64 69 63 65 73 20  report "Indices 
3d70: 6f 66 20 74 61 62 6c 65 20 24 6e 61 6d 65 22 20  of table $name" 
3d80: 22 74 62 6c 6e 61 6d 65 3d 27 24 71 6e 27 20 41  "tblname='$qn' A
3d90: 4e 44 20 69 73 5f 69 6e 64 65 78 22 0a 20 20 7d  ND is_index".  }
3da0: 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 75 62 72   else {.    subr
3db0: 65 70 6f 72 74 20 22 54 61 62 6c 65 20 24 6e 61  eport "Table $na
3dc0: 6d 65 22 20 22 6e 61 6d 65 3d 27 24 71 6e 27 22  me" "name='$qn'"
3dd0: 0a 20 20 7d 0a 7d 0a 0a 23 20 4f 75 74 70 75 74  .  }.}..# Output
3de0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 6f 6e   instructions on
3df0: 20 77 68 61 74 20 74 68 65 20 6e 75 6d 62 65 72   what the number
3e00: 73 20 61 62 6f 76 65 20 6d 65 61 6e 2e 0a 23 0a  s above mean..#.
3e10: 70 75 74 73 20 7b 0a 2a 2a 2a 20 44 65 66 69 6e  puts {.*** Defin
3e20: 69 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  itions *********
3e30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3e40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3e50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 50  *************..P
3e60: 61 67 65 20 73 69 7a 65 20 69 6e 20 62 79 74 65  age size in byte
3e70: 73 0a 0a 20 20 20 20 54 68 65 20 6e 75 6d 62 65  s..    The numbe
3e80: 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 61 20  r of bytes in a 
3e90: 73 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74  single page of t
3ea0: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
3eb0: 2e 20 20 0a 20 20 20 20 55 73 75 61 6c 6c 79 20  .  .    Usually 
3ec0: 31 30 32 34 2e 0a 0a 4e 75 6d 62 65 72 20 6f 66  1024...Number of
3ed0: 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 77 68   pages in the wh
3ee0: 6f 6c 65 20 66 69 6c 65 0a 7d 0a 70 75 74 73 20  ole file.}.puts 
3ef0: 5c 0a 22 20 20 20 20 54 68 65 20 6e 75 6d 62 65  \."    The numbe
3f00: 72 20 6f 66 20 24 70 61 67 65 53 69 7a 65 2d 62  r of $pageSize-b
3f10: 79 74 65 20 70 61 67 65 73 20 74 68 61 74 20 67  yte pages that g
3f20: 6f 20 69 6e 74 6f 20 66 6f 72 6d 69 6e 67 20 74  o into forming t
3f30: 68 65 20 63 6f 6d 70 6c 65 74 65 0a 20 20 20 20  he complete.    
3f40: 64 61 74 61 62 61 73 65 22 0a 70 75 74 73 20 5c  database".puts \
3f50: 0a 7b 0a 50 61 67 65 73 20 74 68 61 74 20 73 74  .{.Pages that st
3f60: 6f 72 65 20 64 61 74 61 0a 0a 20 20 20 20 54 68  ore data..    Th
3f70: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  e number of page
3f80: 73 20 74 68 61 74 20 73 74 6f 72 65 20 64 61 74  s that store dat
3f90: 61 2c 20 65 69 74 68 65 72 20 61 73 20 70 72 69  a, either as pri
3fa0: 6d 61 72 79 20 42 2a 54 72 65 65 20 70 61 67 65  mary B*Tree page
3fb0: 73 20 6f 72 0a 20 20 20 20 61 73 20 6f 76 65 72  s or.    as over
3fc0: 66 6c 6f 77 20 70 61 67 65 73 2e 20 20 54 68 65  flow pages.  The
3fd0: 20 6e 75 6d 62 65 72 20 61 74 20 74 68 65 20 72   number at the r
3fe0: 69 67 68 74 20 69 73 20 74 68 65 20 64 61 74 61  ight is the data
3ff0: 20 70 61 67 65 73 20 64 69 76 69 64 65 64 20 62   pages divided b
4000: 79 0a 20 20 20 20 74 68 65 20 74 6f 74 61 6c 20  y.    the total 
4010: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
4020: 69 6e 20 74 68 65 20 66 69 6c 65 2e 0a 0a 50 61  in the file...Pa
4030: 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c  ges on the freel
4040: 69 73 74 0a 0a 20 20 20 20 54 68 65 20 6e 75 6d  ist..    The num
4050: 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 68 61  ber of pages tha
4060: 74 20 61 72 65 20 6e 6f 74 20 63 75 72 72 65 6e  t are not curren
4070: 74 6c 79 20 69 6e 20 75 73 65 20 62 75 74 20 61  tly in use but a
4080: 72 65 20 72 65 73 65 72 76 65 64 20 66 6f 72 0a  re reserved for.
4090: 20 20 20 20 66 75 74 75 72 65 20 75 73 65 2e 20      future use. 
40a0: 20 54 68 65 20 70 65 72 63 65 6e 74 61 67 65 20   The percentage 
40b0: 61 74 20 74 68 65 20 72 69 67 68 74 20 69 73 20  at the right is 
40c0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 72  the number of fr
40d0: 65 65 6c 69 73 74 20 70 61 67 65 73 0a 20 20 20  eelist pages.   
40e0: 20 64 69 76 69 64 65 64 20 62 79 20 74 68 65 20   divided by the 
40f0: 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20  total number of 
4100: 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 69 6c  pages in the fil
4110: 65 2e 0a 0a 50 61 67 65 73 20 6f 66 20 61 75 74  e...Pages of aut
4120: 6f 2d 76 61 63 75 75 6d 20 6f 76 65 72 68 65 61  o-vacuum overhea
4130: 64 0a 0a 20 20 20 20 54 68 65 20 6e 75 6d 62 65  d..    The numbe
4140: 72 20 6f 66 20 70 61 67 65 73 20 74 68 61 74 20  r of pages that 
4150: 73 74 6f 72 65 20 64 61 74 61 20 75 73 65 64 20  store data used 
4160: 62 79 20 74 68 65 20 64 61 74 61 62 61 73 65 20  by the database 
4170: 74 6f 20 66 61 63 69 6c 69 74 61 74 65 0a 20 20  to facilitate.  
4180: 20 20 61 75 74 6f 2d 76 61 63 75 75 6d 2e 20 54    auto-vacuum. T
4190: 68 69 73 20 69 73 20 7a 65 72 6f 20 66 6f 72 20  his is zero for 
41a0: 64 61 74 61 62 61 73 65 73 20 74 68 61 74 20 64  databases that d
41b0: 6f 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 75  o not support au
41c0: 74 6f 2d 76 61 63 75 75 6d 2e 0a 0a 4e 75 6d 62  to-vacuum...Numb
41d0: 65 72 20 6f 66 20 74 61 62 6c 65 73 20 69 6e 20  er of tables in 
41e0: 74 68 65 20 64 61 74 61 62 61 73 65 0a 0a 20 20  the database..  
41f0: 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20    The number of 
4200: 74 61 62 6c 65 73 20 69 6e 20 74 68 65 20 64 61  tables in the da
4210: 74 61 62 61 73 65 2c 20 69 6e 63 6c 75 64 69 6e  tabase, includin
4220: 67 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41 53  g the SQLITE_MAS
4230: 54 45 52 20 74 61 62 6c 65 0a 20 20 20 20 75 73  TER table.    us
4240: 65 64 20 74 6f 20 73 74 6f 72 65 20 73 63 68 65  ed to store sche
4250: 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a  ma information..
4260: 0a 4e 75 6d 62 65 72 20 6f 66 20 69 6e 64 69 63  .Number of indic
4270: 65 73 0a 0a 20 20 20 20 54 68 65 20 74 6f 74 61  es..    The tota
4280: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 64 69  l number of indi
4290: 63 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62  ces in the datab
42a0: 61 73 65 2e 0a 0a 4e 75 6d 62 65 72 20 6f 66 20  ase...Number of 
42b0: 6e 61 6d 65 64 20 69 6e 64 69 63 65 73 0a 0a 20  named indices.. 
42c0: 20 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66     The number of
42d0: 20 69 6e 64 69 63 65 73 20 63 72 65 61 74 65 64   indices created
42e0: 20 75 73 69 6e 67 20 61 6e 20 65 78 70 6c 69 63   using an explic
42f0: 69 74 20 43 52 45 41 54 45 20 49 4e 44 45 58 20  it CREATE INDEX 
4300: 73 74 61 74 65 6d 65 6e 74 2e 0a 0a 41 75 74 6f  statement...Auto
4310: 6d 61 74 69 63 61 6c 6c 79 20 67 65 6e 65 72 61  matically genera
4320: 74 65 64 20 69 6e 64 69 63 65 73 0a 0a 20 20 20  ted indices..   
4330: 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 69   The number of i
4340: 6e 64 69 63 65 73 20 75 73 65 64 20 74 6f 20 69  ndices used to i
4350: 6d 70 6c 65 6d 65 6e 74 20 50 52 49 4d 41 52 59  mplement PRIMARY
4360: 20 4b 45 59 20 6f 72 20 55 4e 49 51 55 45 20 63   KEY or UNIQUE c
4370: 6f 6e 73 74 72 61 69 6e 74 73 0a 20 20 20 20 6f  onstraints.    o
4380: 6e 20 74 61 62 6c 65 73 2e 0a 0a 53 69 7a 65 20  n tables...Size 
4390: 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e 20 62  of the file in b
43a0: 79 74 65 73 0a 0a 20 20 20 20 54 68 65 20 74 6f  ytes..    The to
43b0: 74 61 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 64 69  tal amount of di
43c0: 73 6b 20 73 70 61 63 65 20 75 73 65 64 20 62 79  sk space used by
43d0: 20 74 68 65 20 65 6e 74 69 72 65 20 64 61 74 61   the entire data
43e0: 62 61 73 65 20 66 69 6c 65 73 2e 0a 0a 42 79 74  base files...Byt
43f0: 65 73 20 6f 66 20 75 73 65 72 20 70 61 79 6c 6f  es of user paylo
4400: 61 64 20 73 74 6f 72 65 64 0a 0a 20 20 20 20 54  ad stored..    T
4410: 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20  he total number 
4420: 6f 66 20 62 79 74 65 73 20 6f 66 20 75 73 65 72  of bytes of user
4430: 20 70 61 79 6c 6f 61 64 20 73 74 6f 72 65 64 20   payload stored 
4440: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  in the database.
4450: 20 54 68 65 0a 20 20 20 20 73 63 68 65 6d 61 20   The.    schema 
4460: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74  information in t
4470: 68 65 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52  he SQLITE_MASTER
4480: 20 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 63 6f   table is not co
4490: 75 6e 74 65 64 20 77 68 65 6e 0a 20 20 20 20 63  unted when.    c
44a0: 6f 6d 70 75 74 69 6e 67 20 74 68 69 73 20 6e 75  omputing this nu
44b0: 6d 62 65 72 2e 20 20 54 68 65 20 70 65 72 63 65  mber.  The perce
44c0: 6e 74 61 67 65 20 61 74 20 74 68 65 20 72 69 67  ntage at the rig
44d0: 68 74 20 73 68 6f 77 73 20 74 68 65 20 70 61 79  ht shows the pay
44e0: 6c 6f 61 64 0a 20 20 20 20 64 69 76 69 64 65 64  load.    divided
44f0: 20 62 79 20 74 68 65 20 74 6f 74 61 6c 20 66 69   by the total fi
4500: 6c 65 20 73 69 7a 65 2e 0a 0a 50 65 72 63 65 6e  le size...Percen
4510: 74 61 67 65 20 6f 66 20 74 6f 74 61 6c 20 64 61  tage of total da
4520: 74 61 62 61 73 65 0a 0a 20 20 20 20 54 68 65 20  tabase..    The 
4530: 61 6d 6f 75 6e 74 20 6f 66 20 74 68 65 20 63 6f  amount of the co
4540: 6d 70 6c 65 74 65 20 64 61 74 61 62 61 73 65 20  mplete database 
4550: 66 69 6c 65 20 74 68 61 74 20 69 73 20 64 65 76  file that is dev
4560: 6f 74 65 64 20 74 6f 20 73 74 6f 72 69 6e 67 0a  oted to storing.
4570: 20 20 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20      information 
4580: 64 65 73 63 72 69 62 65 64 20 62 79 20 74 68 69  described by thi
4590: 73 20 63 61 74 65 67 6f 72 79 2e 0a 0a 4e 75 6d  s category...Num
45a0: 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 0a 0a  ber of entries..
45b0: 20 20 20 20 54 68 65 20 74 6f 74 61 6c 20 6e 75      The total nu
45c0: 6d 62 65 72 20 6f 66 20 42 2d 54 72 65 65 20 6b  mber of B-Tree k
45d0: 65 79 2f 76 61 6c 75 65 20 70 61 69 72 73 20 73  ey/value pairs s
45e0: 74 6f 72 65 64 20 75 6e 64 65 72 20 74 68 69 73  tored under this
45f0: 20 63 61 74 65 67 6f 72 79 2e 0a 0a 42 79 74 65   category...Byte
4600: 73 20 6f 66 20 73 74 6f 72 61 67 65 20 63 6f 6e  s of storage con
4610: 73 75 6d 65 64 0a 0a 20 20 20 20 54 68 65 20 74  sumed..    The t
4620: 6f 74 61 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 64  otal amount of d
4630: 69 73 6b 20 73 70 61 63 65 20 72 65 71 75 69 72  isk space requir
4640: 65 64 20 74 6f 20 73 74 6f 72 65 20 61 6c 6c 20  ed to store all 
4650: 42 2d 54 72 65 65 20 65 6e 74 72 69 65 73 0a 20  B-Tree entries. 
4660: 20 20 20 75 6e 64 65 72 20 74 68 69 73 20 63 61     under this ca
4670: 74 65 67 6f 72 79 2e 20 20 54 68 65 20 69 73 20  tegory.  The is 
4680: 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72  the total number
4690: 20 6f 66 20 70 61 67 65 73 20 75 73 65 64 20 74   of pages used t
46a0: 69 6d 65 73 0a 20 20 20 20 74 68 65 20 70 61 67  imes.    the pag
46b0: 65 73 20 73 69 7a 65 2e 0a 0a 42 79 74 65 73 20  es size...Bytes 
46c0: 6f 66 20 70 61 79 6c 6f 61 64 0a 0a 20 20 20 20  of payload..    
46d0: 54 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 70 61  The amount of pa
46e0: 79 6c 6f 61 64 20 73 74 6f 72 65 64 20 75 6e 64  yload stored und
46f0: 65 72 20 74 68 69 73 20 63 61 74 65 67 6f 72 79  er this category
4700: 2e 20 20 50 61 79 6c 6f 61 64 20 69 73 20 74 68  .  Payload is th
4710: 65 20 64 61 74 61 0a 20 20 20 20 70 61 72 74 20  e data.    part 
4720: 6f 66 20 74 61 62 6c 65 20 65 6e 74 72 69 65 73  of table entries
4730: 20 61 6e 64 20 74 68 65 20 6b 65 79 20 70 61 72   and the key par
4740: 74 20 6f 66 20 69 6e 64 65 78 20 65 6e 74 72 69  t of index entri
4750: 65 73 2e 20 20 54 68 65 20 70 65 72 63 65 6e 74  es.  The percent
4760: 61 67 65 0a 20 20 20 20 61 74 20 74 68 65 20 72  age.    at the r
4770: 69 67 68 74 20 69 73 20 74 68 65 20 62 79 74 65  ight is the byte
4780: 73 20 6f 66 20 70 61 79 6c 6f 61 64 20 64 69 76  s of payload div
4790: 69 64 65 64 20 62 79 20 74 68 65 20 62 79 74 65  ided by the byte
47a0: 73 20 6f 66 20 73 74 6f 72 61 67 65 20 0a 20 20  s of storage .  
47b0: 20 20 63 6f 6e 73 75 6d 65 64 2e 0a 0a 41 76 65    consumed...Ave
47c0: 72 61 67 65 20 70 61 79 6c 6f 61 64 20 70 65 72  rage payload per
47d0: 20 65 6e 74 72 79 0a 0a 20 20 20 20 54 68 65 20   entry..    The 
47e0: 61 76 65 72 61 67 65 20 61 6d 6f 75 6e 74 20 6f  average amount o
47f0: 66 20 70 61 79 6c 6f 61 64 20 6f 6e 20 65 61 63  f payload on eac
4800: 68 20 65 6e 74 72 79 2e 20 20 54 68 69 73 20 69  h entry.  This i
4810: 73 20 6a 75 73 74 20 74 68 65 20 62 79 74 65 73  s just the bytes
4820: 20 6f 66 0a 20 20 20 20 70 61 79 6c 6f 61 64 20   of.    payload 
4830: 64 69 76 69 64 65 64 20 62 79 20 74 68 65 20 6e  divided by the n
4840: 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73  umber of entries
4850: 2e 0a 0a 41 76 65 72 61 67 65 20 75 6e 75 73 65  ...Average unuse
4860: 64 20 62 79 74 65 73 20 70 65 72 20 65 6e 74 72  d bytes per entr
4870: 79 0a 0a 20 20 20 20 54 68 65 20 61 76 65 72 61  y..    The avera
4880: 67 65 20 61 6d 6f 75 6e 74 20 6f 66 20 66 72 65  ge amount of fre
4890: 65 20 73 70 61 63 65 20 72 65 6d 61 69 6e 69 6e  e space remainin
48a0: 67 20 6f 6e 20 61 6c 6c 20 70 61 67 65 73 20 75  g on all pages u
48b0: 6e 64 65 72 20 74 68 69 73 0a 20 20 20 20 63 61  nder this.    ca
48c0: 74 65 67 6f 72 79 20 6f 6e 20 61 20 70 65 72 2d  tegory on a per-
48d0: 65 6e 74 72 79 20 62 61 73 69 73 2e 20 20 54 68  entry basis.  Th
48e0: 69 73 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72  is is the number
48f0: 20 6f 66 20 75 6e 75 73 65 64 20 62 79 74 65 73   of unused bytes
4900: 20 6f 6e 0a 20 20 20 20 61 6c 6c 20 70 61 67 65   on.    all page
4910: 73 20 64 69 76 69 64 65 64 20 62 79 20 74 68 65  s divided by the
4920: 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69   number of entri
4930: 65 73 2e 0a 0a 46 72 61 67 6d 65 6e 74 61 74 69  es...Fragmentati
4940: 6f 6e 0a 0a 20 20 20 20 54 68 65 20 70 65 72 63  on..    The perc
4950: 65 6e 74 61 67 65 20 6f 66 20 70 61 67 65 73 20  entage of pages 
4960: 69 6e 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20  in the table or 
4970: 69 6e 64 65 78 20 74 68 61 74 20 61 72 65 20 6e  index that are n
4980: 6f 74 0a 20 20 20 20 63 6f 6e 73 65 63 75 74 69  ot.    consecuti
4990: 76 65 20 69 6e 20 74 68 65 20 64 69 73 6b 20 66  ve in the disk f
49a0: 69 6c 65 2e 20 20 4d 61 6e 79 20 66 69 6c 65 73  ile.  Many files
49b0: 79 73 74 65 6d 73 20 61 72 65 20 6f 70 74 69 6d  ystems are optim
49c0: 69 7a 65 64 0a 20 20 20 20 66 6f 72 20 73 65 71  ized.    for seq
49d0: 75 65 6e 74 69 61 6c 20 66 69 6c 65 20 61 63 63  uential file acc
49e0: 65 73 73 20 73 6f 20 73 6d 61 6c 6c 65 72 20 66  ess so smaller f
49f0: 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 6e 75 6d  ragmentation num
4a00: 62 65 72 73 20 0a 20 20 20 20 73 6f 6d 65 74 69  bers .    someti
4a10: 6d 65 73 20 72 65 73 75 6c 74 20 69 6e 20 66 61  mes result in fa
4a20: 73 74 65 72 20 71 75 65 72 69 65 73 2c 20 65 73  ster queries, es
4a30: 70 65 63 69 61 6c 6c 79 20 66 6f 72 20 6c 61 72  pecially for lar
4a40: 67 65 72 0a 20 20 20 20 64 61 74 61 62 61 73 65  ger.    database
4a50: 20 66 69 6c 65 73 20 74 68 61 74 20 64 6f 20 6e   files that do n
4a60: 6f 74 20 66 69 74 20 69 6e 20 74 68 65 20 64 69  ot fit in the di
4a70: 73 6b 20 63 61 63 68 65 2e 0a 0a 4d 61 78 69 6d  sk cache...Maxim
4a80: 75 6d 20 70 61 79 6c 6f 61 64 20 70 65 72 20 65  um payload per e
4a90: 6e 74 72 79 0a 0a 20 20 20 20 54 68 65 20 6c 61  ntry..    The la
4aa0: 72 67 65 73 74 20 70 61 79 6c 6f 61 64 20 73 69  rgest payload si
4ab0: 7a 65 20 6f 66 20 61 6e 79 20 65 6e 74 72 79 2e  ze of any entry.
4ac0: 0a 0a 45 6e 74 72 69 65 73 20 74 68 61 74 20 75  ..Entries that u
4ad0: 73 65 20 6f 76 65 72 66 6c 6f 77 0a 0a 20 20 20  se overflow..   
4ae0: 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 65   The number of e
4af0: 6e 74 72 69 65 73 20 74 68 61 74 20 75 73 65 72  ntries that user
4b00: 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 76 65   one or more ove
4b10: 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 0a 54 6f  rflow pages...To
4b20: 74 61 6c 20 70 61 67 65 73 20 75 73 65 64 0a 0a  tal pages used..
4b30: 20 20 20 20 54 68 69 73 20 69 73 20 74 68 65 20      This is the 
4b40: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
4b50: 75 73 65 64 20 74 6f 20 68 6f 6c 64 20 61 6c 6c  used to hold all
4b60: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20   information in 
4b70: 74 68 65 20 63 75 72 72 65 6e 74 0a 20 20 20 20  the current.    
4b80: 63 61 74 65 67 6f 72 79 2e 20 20 54 68 69 73 20  category.  This 
4b90: 69 73 20 74 68 65 20 73 75 6d 20 6f 66 20 69 6e  is the sum of in
4ba0: 64 65 78 2c 20 70 72 69 6d 61 72 79 2c 20 61 6e  dex, primary, an
4bb0: 64 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73  d overflow pages
4bc0: 2e 0a 0a 49 6e 64 65 78 20 70 61 67 65 73 20 75  ...Index pages u
4bd0: 73 65 64 0a 0a 20 20 20 20 54 68 69 73 20 69 73  sed..    This is
4be0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70   the number of p
4bf0: 61 67 65 73 20 69 6e 20 61 20 74 61 62 6c 65 20  ages in a table 
4c00: 42 2d 74 72 65 65 20 74 68 61 74 20 68 6f 6c 64  B-tree that hold
4c10: 20 6f 6e 6c 79 20 6b 65 79 20 28 72 6f 77 69 64   only key (rowid
4c20: 29 0a 20 20 20 20 69 6e 66 6f 72 6d 61 74 69 6f  ).    informatio
4c30: 6e 20 61 6e 64 20 6e 6f 20 64 61 74 61 2e 0a 0a  n and no data...
4c40: 50 72 69 6d 61 72 79 20 70 61 67 65 73 20 75 73  Primary pages us
4c50: 65 64 0a 0a 20 20 20 20 54 68 69 73 20 69 73 20  ed..    This is 
4c60: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 42 2d  the number of B-
4c70: 74 72 65 65 20 70 61 67 65 73 20 74 68 61 74 20  tree pages that 
4c80: 68 6f 6c 64 20 62 6f 74 68 20 6b 65 79 20 61 6e  hold both key an
4c90: 64 20 64 61 74 61 2e 0a 0a 4f 76 65 72 66 6c 6f  d data...Overflo
4ca0: 77 20 70 61 67 65 73 20 75 73 65 64 0a 0a 20 20  w pages used..  
4cb0: 20 20 54 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62    The total numb
4cc0: 65 72 20 6f 66 20 6f 76 65 72 66 6c 6f 77 20 70  er of overflow p
4cd0: 61 67 65 73 20 75 73 65 64 20 66 6f 72 20 74 68  ages used for th
4ce0: 69 73 20 63 61 74 65 67 6f 72 79 2e 0a 0a 55 6e  is category...Un
4cf0: 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 69 6e  used bytes on in
4d00: 64 65 78 20 70 61 67 65 73 0a 0a 20 20 20 20 54  dex pages..    T
4d10: 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20  he total number 
4d20: 6f 66 20 62 79 74 65 73 20 6f 66 20 75 6e 75 73  of bytes of unus
4d30: 65 64 20 73 70 61 63 65 20 6f 6e 20 61 6c 6c 20  ed space on all 
4d40: 69 6e 64 65 78 20 70 61 67 65 73 2e 20 20 54 68  index pages.  Th
4d50: 65 0a 20 20 20 20 70 65 72 63 65 6e 74 61 67 65  e.    percentage
4d60: 20 61 74 20 74 68 65 20 72 69 67 68 74 20 69 73   at the right is
4d70: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 75   the number of u
4d80: 6e 75 73 65 64 20 62 79 74 65 73 20 64 69 76 69  nused bytes divi
4d90: 64 65 64 20 62 79 20 74 68 65 0a 20 20 20 20 74  ded by the.    t
4da0: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62  otal number of b
4db0: 79 74 65 73 20 6f 6e 20 69 6e 64 65 78 20 70 61  ytes on index pa
4dc0: 67 65 73 2e 0a 0a 55 6e 75 73 65 64 20 62 79 74  ges...Unused byt
4dd0: 65 73 20 6f 6e 20 70 72 69 6d 61 72 79 20 70 61  es on primary pa
4de0: 67 65 73 0a 0a 20 20 20 20 54 68 65 20 74 6f 74  ges..    The tot
4df0: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74  al number of byt
4e00: 65 73 20 6f 66 20 75 6e 75 73 65 64 20 73 70 61  es of unused spa
4e10: 63 65 20 6f 6e 20 61 6c 6c 20 70 72 69 6d 61 72  ce on all primar
4e20: 79 20 70 61 67 65 73 2e 20 20 54 68 65 0a 20 20  y pages.  The.  
4e30: 20 20 70 65 72 63 65 6e 74 61 67 65 20 61 74 20    percentage at 
4e40: 74 68 65 20 72 69 67 68 74 20 69 73 20 74 68 65  the right is the
4e50: 20 6e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65   number of unuse
4e60: 64 20 62 79 74 65 73 20 64 69 76 69 64 65 64 20  d bytes divided 
4e70: 62 79 20 74 68 65 0a 20 20 20 20 74 6f 74 61 6c  by the.    total
4e80: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
4e90: 20 6f 6e 20 70 72 69 6d 61 72 79 20 70 61 67 65   on primary page
4ea0: 73 2e 0a 0a 55 6e 75 73 65 64 20 62 79 74 65 73  s...Unused bytes
4eb0: 20 6f 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67   on overflow pag
4ec0: 65 73 0a 0a 20 20 20 20 54 68 65 20 74 6f 74 61  es..    The tota
4ed0: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  l number of byte
4ee0: 73 20 6f 66 20 75 6e 75 73 65 64 20 73 70 61 63  s of unused spac
4ef0: 65 20 6f 6e 20 61 6c 6c 20 6f 76 65 72 66 6c 6f  e on all overflo
4f00: 77 20 70 61 67 65 73 2e 20 20 54 68 65 0a 20 20  w pages.  The.  
4f10: 20 20 70 65 72 63 65 6e 74 61 67 65 20 61 74 20    percentage at 
4f20: 74 68 65 20 72 69 67 68 74 20 69 73 20 74 68 65  the right is the
4f30: 20 6e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65   number of unuse
4f40: 64 20 62 79 74 65 73 20 64 69 76 69 64 65 64 20  d bytes divided 
4f50: 62 79 20 74 68 65 0a 20 20 20 20 74 6f 74 61 6c  by the.    total
4f60: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
4f70: 20 6f 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67   on overflow pag
4f80: 65 73 2e 0a 0a 55 6e 75 73 65 64 20 62 79 74 65  es...Unused byte
4f90: 73 20 6f 6e 20 61 6c 6c 20 70 61 67 65 73 0a 0a  s on all pages..
4fa0: 20 20 20 20 54 68 65 20 74 6f 74 61 6c 20 6e 75      The total nu
4fb0: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66  mber of bytes of
4fc0: 20 75 6e 75 73 65 64 20 73 70 61 63 65 20 6f 6e   unused space on
4fd0: 20 61 6c 6c 20 70 72 69 6d 61 72 79 20 61 6e 64   all primary and
4fe0: 20 6f 76 65 72 66 6c 6f 77 20 0a 20 20 20 20 70   overflow .    p
4ff0: 61 67 65 73 2e 20 20 54 68 65 20 70 65 72 63 65  ages.  The perce
5000: 6e 74 61 67 65 20 61 74 20 74 68 65 20 72 69 67  ntage at the rig
5010: 68 74 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72  ht is the number
5020: 20 6f 66 20 75 6e 75 73 65 64 20 62 79 74 65 73   of unused bytes
5030: 20 0a 20 20 20 20 64 69 76 69 64 65 64 20 62 79   .    divided by
5040: 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65   the total numbe
5050: 72 20 6f 66 20 62 79 74 65 73 2e 0a 7d 0a 0a 23  r of bytes..}..#
5060: 20 4f 75 74 70 75 74 20 61 20 64 75 6d 70 20 6f   Output a dump o
5070: 66 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20  f the in-memory 
5080: 64 61 74 61 62 61 73 65 2e 20 54 68 69 73 20 63  database. This c
5090: 61 6e 20 62 65 20 75 73 65 64 20 66 6f 72 20 6d  an be used for m
50a0: 6f 72 65 0a 23 20 63 6f 6d 70 6c 65 78 20 6f 66  ore.# complex of
50b0: 66 6c 69 6e 65 20 61 6e 61 6c 79 73 69 73 2e 0a  fline analysis..
50c0: 23 0a 70 75 74 73 20 22 2a 2a 2a 2a 2a 2a 2a 2a  #.puts "********
50d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
50e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
50f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5100: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 22 0a  **************".
5110: 70 75 74 73 20 22 54 68 65 20 65 6e 74 69 72 65  puts "The entire
5120: 20 74 65 78 74 20 6f 66 20 74 68 69 73 20 72 65   text of this re
5130: 70 6f 72 74 20 63 61 6e 20 62 65 20 73 6f 75 72  port can be sour
5140: 63 65 64 20 69 6e 74 6f 20 61 6e 79 20 53 51 4c  ced into any SQL
5150: 20 64 61 74 61 62 61 73 65 22 0a 70 75 74 73 20   database".puts 
5160: 22 65 6e 67 69 6e 65 20 66 6f 72 20 66 75 72 74  "engine for furt
5170: 68 65 72 20 61 6e 61 6c 79 73 69 73 2e 20 20 41  her analysis.  A
5180: 6c 6c 20 6f 66 20 74 68 65 20 74 65 78 74 20 61  ll of the text a
5190: 62 6f 76 65 20 69 73 20 61 6e 20 53 51 4c 20 63  bove is an SQL c
51a0: 6f 6d 6d 65 6e 74 2e 22 0a 70 75 74 73 20 22 54  omment.".puts "T
51b0: 68 65 20 64 61 74 61 20 75 73 65 64 20 74 6f 20  he data used to 
51c0: 67 65 6e 65 72 61 74 65 20 74 68 69 73 20 72 65  generate this re
51d0: 70 6f 72 74 20 66 6f 6c 6c 6f 77 73 3a 22 0a 70  port follows:".p
51e0: 75 74 73 20 22 2a 2f 22 0a 70 75 74 73 20 22 42  uts "*/".puts "B
51f0: 45 47 49 4e 3b 22 0a 70 75 74 73 20 24 74 61 62  EGIN;".puts $tab
5200: 6c 65 64 65 66 0a 75 6e 73 65 74 20 2d 6e 6f 63  ledef.unset -noc
5210: 6f 6d 70 6c 61 69 6e 20 78 0a 6d 65 6d 20 65 76  omplain x.mem ev
5220: 61 6c 20 7b 53 45 4c 45 43 54 20 2a 20 46 52 4f  al {SELECT * FRO
5230: 4d 20 73 70 61 63 65 5f 75 73 65 64 7d 20 78 20  M space_used} x 
5240: 7b 0a 20 20 70 75 74 73 20 2d 6e 6f 6e 65 77 6c  {.  puts -nonewl
5250: 69 6e 65 20 22 49 4e 53 45 52 54 20 49 4e 54 4f  ine "INSERT INTO
5260: 20 73 70 61 63 65 5f 75 73 65 64 20 56 41 4c 55   space_used VALU
5270: 45 53 22 0a 20 20 73 65 74 20 73 65 70 20 28 0a  ES".  set sep (.
5280: 20 20 66 6f 72 65 61 63 68 20 63 6f 6c 20 24 78    foreach col $x
5290: 28 2a 29 20 7b 0a 20 20 20 20 73 65 74 20 76 20  (*) {.    set v 
52a0: 24 78 28 24 63 6f 6c 29 0a 20 20 20 20 69 66 20  $x($col).    if 
52b0: 7b 24 76 3d 3d 22 22 20 7c 7c 20 21 5b 73 74 72  {$v=="" || ![str
52c0: 69 6e 67 20 69 73 20 64 6f 75 62 6c 65 20 24 76  ing is double $v
52d0: 5d 7d 20 7b 73 65 74 20 76 20 5b 71 75 6f 74 65  ]} {set v [quote
52e0: 20 24 76 5d 7d 0a 20 20 20 20 70 75 74 73 20 2d   $v]}.    puts -
52f0: 6e 6f 6e 65 77 6c 69 6e 65 20 24 73 65 70 24 76  nonewline $sep$v
5300: 0a 20 20 20 20 73 65 74 20 73 65 70 20 2c 0a 20  .    set sep ,. 
5310: 20 7d 0a 20 20 70 75 74 73 20 22 29 3b 22 0a 7d   }.  puts ");".}
5320: 0a 70 75 74 73 20 22 43 4f 4d 4d 49 54 3b 22 0a  .puts "COMMIT;".
5330: 0a 7d 20 65 72 72 5d 7d 20 7b 0a 20 20 70 75 74  .} err]} {.  put
5340: 73 20 22 45 52 52 4f 52 3a 20 24 65 72 72 22 0a  s "ERROR: $err".
5350: 20 20 70 75 74 73 20 24 65 72 72 6f 72 49 6e 66    puts $errorInf
5360: 6f 0a 20 20 65 78 69 74 20 31 0a 7d 0a           o.  exit 1.}.