/ Hex Artifact Content
Login

Artifact fe02dede3d29ef0fefcf80a685644fdf4d9a768e:


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 69 66 20 7b 21 5b 69 6e  catch {.if {![in
00d0: 66 6f 20 65 78 69 73 74 73 20 61 72 67 76 30 5d  fo exists argv0]
00e0: 7d 20 7b 0a 20 20 73 65 74 20 61 72 67 76 30 20  } {.  set argv0 
00f0: 5b 66 69 6c 65 20 72 6f 6f 74 6e 61 6d 65 20 5b  [file rootname [
0100: 66 69 6c 65 20 74 61 69 6c 20 5b 69 6e 66 6f 20  file tail [info 
0110: 6e 61 6d 65 6f 66 65 78 65 63 75 74 61 62 6c 65  nameofexecutable
0120: 5d 5d 5d 0a 7d 0a 0a 23 20 47 65 74 20 74 68 65  ]]].}..# Get the
0130: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74   name of the dat
0140: 61 62 61 73 65 20 74 6f 20 61 6e 61 6c 79 7a 65  abase to analyze
0150: 0a 23 0a 23 73 65 74 20 61 72 67 76 20 24 61 72  .#.#set argv $ar
0160: 67 76 30 0a 69 66 20 7b 21 5b 69 6e 66 6f 20 65  gv0.if {![info e
0170: 78 69 73 74 73 20 61 72 67 76 5d 20 7c 7c 20 5b  xists argv] || [
0180: 6c 6c 65 6e 67 74 68 20 24 61 72 67 76 5d 21 3d  llength $argv]!=
0190: 31 7d 20 7b 0a 20 20 70 75 74 73 20 73 74 64 65  1} {.  puts stde
01a0: 72 72 20 22 55 73 61 67 65 3a 20 24 61 72 67 76  rr "Usage: $argv
01b0: 30 20 64 61 74 61 62 61 73 65 2d 6e 61 6d 65 22  0 database-name"
01c0: 0a 20 20 65 78 69 74 20 31 0a 7d 0a 73 65 74 20  .  exit 1.}.set 
01d0: 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c 79 7a 65 20  file_to_analyze 
01e0: 5b 6c 69 6e 64 65 78 20 24 61 72 67 76 20 30 5d  [lindex $argv 0]
01f0: 0a 69 66 20 7b 21 5b 66 69 6c 65 20 65 78 69 73  .if {![file exis
0200: 74 73 20 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c  ts $file_to_anal
0210: 79 7a 65 5d 7d 20 7b 0a 20 20 70 75 74 73 20 73  yze]} {.  puts s
0220: 74 64 65 72 72 20 22 4e 6f 20 73 75 63 68 20 66  tderr "No such f
0230: 69 6c 65 3a 20 24 66 69 6c 65 5f 74 6f 5f 61 6e  ile: $file_to_an
0240: 61 6c 79 7a 65 22 0a 20 20 65 78 69 74 20 31 0a  alyze".  exit 1.
0250: 7d 0a 69 66 20 7b 21 5b 66 69 6c 65 20 72 65 61  }.if {![file rea
0260: 64 61 62 6c 65 20 24 66 69 6c 65 5f 74 6f 5f 61  dable $file_to_a
0270: 6e 61 6c 79 7a 65 5d 7d 20 7b 0a 20 20 70 75 74  nalyze]} {.  put
0280: 73 20 73 74 64 65 72 72 20 22 46 69 6c 65 20 69  s stderr "File i
0290: 73 20 6e 6f 74 20 72 65 61 64 61 62 6c 65 3a 20  s not readable: 
02a0: 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c 79 7a 65  $file_to_analyze
02b0: 22 0a 20 20 65 78 69 74 20 31 0a 7d 0a 69 66 20  ".  exit 1.}.if 
02c0: 7b 5b 66 69 6c 65 20 73 69 7a 65 20 24 66 69 6c  {[file size $fil
02d0: 65 5f 74 6f 5f 61 6e 61 6c 79 7a 65 5d 3c 35 31  e_to_analyze]<51
02e0: 32 7d 20 7b 0a 20 20 70 75 74 73 20 73 74 64 65  2} {.  puts stde
02f0: 72 72 20 22 45 6d 70 74 79 20 6f 72 20 6d 61 6c  rr "Empty or mal
0300: 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 3a  formed database:
0310: 20 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c 79 7a   $file_to_analyz
0320: 65 22 0a 20 20 65 78 69 74 20 31 0a 7d 0a 0a 23  e".  exit 1.}..#
0330: 20 4f 70 65 6e 20 74 68 65 20 64 61 74 61 62 61   Open the databa
0340: 73 65 0a 23 0a 73 71 6c 69 74 65 33 20 64 62 20  se.#.sqlite3 db 
0350: 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c 79 7a 65  $file_to_analyze
0360: 0a 72 65 67 69 73 74 65 72 5f 64 62 73 74 61 74  .register_dbstat
0370: 5f 76 74 61 62 20 64 62 0a 0a 73 65 74 20 70 61  _vtab db..set pa
0380: 67 65 53 69 7a 65 20 5b 64 62 20 6f 6e 65 20 7b  geSize [db one {
0390: 50 52 41 47 4d 41 20 70 61 67 65 5f 73 69 7a 65  PRAGMA page_size
03a0: 7d 5d 0a 0a 23 73 65 74 20 44 42 20 5b 62 74 72  }]..#set DB [btr
03b0: 65 65 5f 6f 70 65 6e 20 24 66 69 6c 65 5f 74 6f  ee_open $file_to
03c0: 5f 61 6e 61 6c 79 7a 65 20 31 30 30 30 20 30 5d  _analyze 1000 0]
03d0: 0a 0a 23 20 49 6e 2d 6d 65 6d 6f 72 79 20 64 61  ..# In-memory da
03e0: 74 61 62 61 73 65 20 66 6f 72 20 63 6f 6c 6c 65  tabase for colle
03f0: 63 74 69 6e 67 20 73 74 61 74 69 73 74 69 63 73  cting statistics
0400: 2e 20 54 68 69 73 20 73 63 72 69 70 74 20 6c 6f  . This script lo
0410: 6f 70 73 20 74 68 72 6f 75 67 68 0a 23 20 74 68  ops through.# th
0420: 65 20 74 61 62 6c 65 73 20 61 6e 64 20 69 6e 64  e tables and ind
0430: 69 63 65 73 20 69 6e 20 74 68 65 20 64 61 74 61  ices in the data
0440: 62 61 73 65 20 62 65 69 6e 67 20 61 6e 61 6c 79  base being analy
0450: 7a 65 64 2c 20 61 64 64 69 6e 67 20 61 20 72 6f  zed, adding a ro
0460: 77 20 66 6f 72 20 65 61 63 68 0a 23 20 74 6f 20  w for each.# to 
0470: 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74  an in-memory dat
0480: 61 62 61 73 65 20 28 66 6f 72 20 77 68 69 63 68  abase (for which
0490: 20 74 68 65 20 73 63 68 65 6d 61 20 69 73 20 73   the schema is s
04a0: 68 6f 77 6e 20 62 65 6c 6f 77 29 2e 20 49 74 20  hown below). It 
04b0: 74 68 65 6e 0a 23 20 71 75 65 72 69 65 73 20 74  then.# queries t
04c0: 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 62 20  he in-memory db 
04d0: 74 6f 20 70 72 6f 64 75 63 65 20 74 68 65 20 73  to produce the s
04e0: 70 61 63 65 2d 61 6e 61 6c 79 73 69 73 20 72 65  pace-analysis re
04f0: 70 6f 72 74 2e 0a 23 0a 73 71 6c 69 74 65 33 20  port..#.sqlite3 
0500: 6d 65 6d 20 3a 6d 65 6d 6f 72 79 3a 0a 73 65 74  mem :memory:.set
0510: 20 74 61 62 6c 65 64 65 66 20 7b 43 52 45 41 54   tabledef {CREAT
0520: 45 20 54 41 42 4c 45 20 73 70 61 63 65 5f 75 73  E TABLE space_us
0530: 65 64 28 0a 20 20 20 6e 61 6d 65 20 63 6c 6f 62  ed(.   name clob
0540: 2c 20 20 20 20 20 20 20 20 2d 2d 20 4e 61 6d 65  ,        -- Name
0550: 20 6f 66 20 61 20 74 61 62 6c 65 20 6f 72 20 69   of a table or i
0560: 6e 64 65 78 20 69 6e 20 74 68 65 20 64 61 74 61  ndex in the data
0570: 62 61 73 65 20 66 69 6c 65 0a 20 20 20 74 62 6c  base file.   tbl
0580: 6e 61 6d 65 20 63 6c 6f 62 2c 20 20 20 20 20 2d  name clob,     -
0590: 2d 20 4e 61 6d 65 20 6f 66 20 61 73 73 6f 63 69  - Name of associ
05a0: 61 74 65 64 20 74 61 62 6c 65 0a 20 20 20 69 73  ated table.   is
05b0: 5f 69 6e 64 65 78 20 62 6f 6f 6c 65 61 6e 2c 20  _index boolean, 
05c0: 2d 2d 20 54 52 55 45 20 69 66 20 69 74 20 69 73  -- TRUE if it is
05d0: 20 61 6e 20 69 6e 64 65 78 2c 20 66 61 6c 73 65   an index, false
05e0: 20 66 6f 72 20 61 20 74 61 62 6c 65 0a 20 20 20   for a table.   
05f0: 6e 65 6e 74 72 79 20 69 6e 74 2c 20 20 20 20 20  nentry int,     
0600: 20 20 2d 2d 20 4e 75 6d 62 65 72 20 6f 66 20 65    -- Number of e
0610: 6e 74 72 69 65 73 20 69 6e 20 74 68 65 20 42 54  ntries in the BT
0620: 72 65 65 0a 20 20 20 6c 65 61 66 5f 65 6e 74 72  ree.   leaf_entr
0630: 69 65 73 20 69 6e 74 2c 20 2d 2d 20 4e 75 6d 62  ies int, -- Numb
0640: 65 72 20 6f 66 20 6c 65 61 66 20 65 6e 74 72 69  er of leaf entri
0650: 65 73 0a 20 20 20 70 61 79 6c 6f 61 64 20 69 6e  es.   payload in
0660: 74 2c 20 20 20 20 20 20 2d 2d 20 54 6f 74 61 6c  t,      -- Total
0670: 20 61 6d 6f 75 6e 74 20 6f 66 20 64 61 74 61 20   amount of data 
0680: 73 74 6f 72 65 64 20 69 6e 20 74 68 69 73 20 74  stored in this t
0690: 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 0a 20 20  able or index.  
06a0: 20 6f 76 66 6c 5f 70 61 79 6c 6f 61 64 20 69 6e   ovfl_payload in
06b0: 74 2c 20 2d 2d 20 54 6f 74 61 6c 20 61 6d 6f 75  t, -- Total amou
06c0: 6e 74 20 6f 66 20 64 61 74 61 20 73 74 6f 72 65  nt of data store
06d0: 64 20 6f 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61  d on overflow pa
06e0: 67 65 73 0a 20 20 20 6f 76 66 6c 5f 63 6e 74 20  ges.   ovfl_cnt 
06f0: 69 6e 74 2c 20 20 20 20 20 2d 2d 20 4e 75 6d 62  int,     -- Numb
0700: 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 74 68  er of entries th
0710: 61 74 20 75 73 65 20 6f 76 65 72 66 6c 6f 77 0a  at use overflow.
0720: 20 20 20 6d 78 5f 70 61 79 6c 6f 61 64 20 69 6e     mx_payload in
0730: 74 2c 20 20 20 2d 2d 20 4d 61 78 69 6d 75 6d 20  t,   -- Maximum 
0740: 70 61 79 6c 6f 61 64 20 73 69 7a 65 0a 20 20 20  payload size.   
0750: 69 6e 74 5f 70 61 67 65 73 20 69 6e 74 2c 20 20  int_pages int,  
0760: 20 20 2d 2d 20 4e 75 6d 62 65 72 20 6f 66 20 69    -- Number of i
0770: 6e 74 65 72 69 6f 72 20 70 61 67 65 73 20 75 73  nterior pages us
0780: 65 64 0a 20 20 20 6c 65 61 66 5f 70 61 67 65 73  ed.   leaf_pages
0790: 20 69 6e 74 2c 20 20 20 2d 2d 20 4e 75 6d 62 65   int,   -- Numbe
07a0: 72 20 6f 66 20 6c 65 61 66 20 70 61 67 65 73 20  r of leaf pages 
07b0: 75 73 65 64 0a 20 20 20 6f 76 66 6c 5f 70 61 67  used.   ovfl_pag
07c0: 65 73 20 69 6e 74 2c 20 20 20 2d 2d 20 4e 75 6d  es int,   -- Num
07d0: 62 65 72 20 6f 66 20 6f 76 65 72 66 6c 6f 77 20  ber of overflow 
07e0: 70 61 67 65 73 20 75 73 65 64 0a 20 20 20 69 6e  pages used.   in
07f0: 74 5f 75 6e 75 73 65 64 20 69 6e 74 2c 20 20 20  t_unused int,   
0800: 2d 2d 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e 75  -- Number of unu
0810: 73 65 64 20 62 79 74 65 73 20 6f 6e 20 69 6e 74  sed bytes on int
0820: 65 72 69 6f 72 20 70 61 67 65 73 0a 20 20 20 6c  erior pages.   l
0830: 65 61 66 5f 75 6e 75 73 65 64 20 69 6e 74 2c 20  eaf_unused int, 
0840: 20 2d 2d 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e   -- Number of un
0850: 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 70 72  used bytes on pr
0860: 69 6d 61 72 79 20 70 61 67 65 73 0a 20 20 20 6f  imary pages.   o
0870: 76 66 6c 5f 75 6e 75 73 65 64 20 69 6e 74 2c 20  vfl_unused int, 
0880: 20 2d 2d 20 4e 75 6d 62 65 72 20 6f 66 20 75 6e   -- Number of un
0890: 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 6f 76  used bytes on ov
08a0: 65 72 66 6c 6f 77 20 70 61 67 65 73 0a 20 20 20  erflow pages.   
08b0: 67 61 70 5f 63 6e 74 20 69 6e 74 20 20 20 20 20  gap_cnt int     
08c0: 20 20 2d 2d 20 4e 75 6d 62 65 72 20 6f 66 20 67    -- Number of g
08d0: 61 70 73 20 69 6e 20 74 68 65 20 70 61 67 65 20  aps in the page 
08e0: 6c 61 79 6f 75 74 0a 29 3b 7d 0a 6d 65 6d 20 65  layout.);}.mem e
08f0: 76 61 6c 20 24 74 61 62 6c 65 64 65 66 0a 0a 23  val $tabledef..#
0900: 20 43 72 65 61 74 65 20 61 20 74 65 6d 70 6f 72   Create a tempor
0910: 61 72 79 20 22 64 62 73 74 61 74 22 20 76 69 72  ary "dbstat" vir
0920: 74 75 61 6c 20 74 61 62 6c 65 2e 0a 23 0a 64 62  tual table..#.db
0930: 20 65 76 61 6c 20 7b 20 0a 20 20 43 52 45 41 54   eval { .  CREAT
0940: 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20  E VIRTUAL TABLE 
0950: 74 65 6d 70 2e 73 74 61 74 20 55 53 49 4e 47 20  temp.stat USING 
0960: 64 62 73 74 61 74 3b 0a 20 20 43 52 45 41 54 45  dbstat;.  CREATE
0970: 20 54 45 4d 50 20 54 41 42 4c 45 20 64 62 73 74   TEMP TABLE dbst
0980: 61 74 20 41 53 20 53 45 4c 45 43 54 20 2a 20 46  at AS SELECT * F
0990: 52 4f 4d 20 74 65 6d 70 2e 73 74 61 74 20 4f 52  ROM temp.stat OR
09a0: 44 45 52 20 42 59 20 6e 61 6d 65 2c 20 70 61 74  DER BY name, pat
09b0: 68 3b 0a 20 20 44 52 4f 50 20 54 41 42 4c 45 20  h;.  DROP TABLE 
09c0: 74 65 6d 70 2e 73 74 61 74 3b 0a 7d 0a 0a 70 72  temp.stat;.}..pr
09d0: 6f 63 20 69 73 6c 65 61 66 20 7b 70 61 67 65 74  oc isleaf {paget
09e0: 79 70 65 20 69 73 5f 69 6e 64 65 78 7d 20 7b 0a  ype is_index} {.
09f0: 20 20 72 65 74 75 72 6e 20 5b 65 78 70 72 20 7b    return [expr {
0a00: 24 70 61 67 65 74 79 70 65 20 3d 3d 20 22 6c 65  $pagetype == "le
0a10: 61 66 22 20 7c 7c 20 28 24 70 61 67 65 74 79 70  af" || ($pagetyp
0a20: 65 20 3d 3d 20 22 69 6e 74 65 72 6e 61 6c 22 20  e == "internal" 
0a30: 26 26 20 24 69 73 5f 69 6e 64 65 78 29 7d 5d 0a  && $is_index)}].
0a40: 7d 0a 70 72 6f 63 20 69 73 6f 76 65 72 66 6c 6f  }.proc isoverflo
0a50: 77 20 7b 70 61 67 65 74 79 70 65 20 69 73 5f 69  w {pagetype is_i
0a60: 6e 64 65 78 7d 20 7b 0a 20 20 72 65 74 75 72 6e  ndex} {.  return
0a70: 20 5b 65 78 70 72 20 7b 24 70 61 67 65 74 79 70   [expr {$pagetyp
0a80: 65 20 3d 3d 20 22 6f 76 65 72 66 6c 6f 77 22 7d  e == "overflow"}
0a90: 5d 0a 7d 0a 70 72 6f 63 20 69 73 69 6e 74 65 72  ].}.proc isinter
0aa0: 6e 61 6c 20 7b 70 61 67 65 74 79 70 65 20 69 73  nal {pagetype is
0ab0: 5f 69 6e 64 65 78 7d 20 7b 0a 20 20 72 65 74 75  _index} {.  retu
0ac0: 72 6e 20 5b 65 78 70 72 20 7b 24 70 61 67 65 74  rn [expr {$paget
0ad0: 79 70 65 20 3d 3d 20 22 69 6e 74 65 72 6e 61 6c  ype == "internal
0ae0: 22 20 26 26 20 24 69 73 5f 69 6e 64 65 78 3d 3d  " && $is_index==
0af0: 30 7d 5d 0a 7d 0a 0a 64 62 20 66 75 6e 63 20 69  0}].}..db func i
0b00: 73 6c 65 61 66 20 69 73 6c 65 61 66 0a 64 62 20  sleaf isleaf.db 
0b10: 66 75 6e 63 20 69 73 69 6e 74 65 72 6e 61 6c 20  func isinternal 
0b20: 69 73 69 6e 74 65 72 6e 61 6c 0a 64 62 20 66 75  isinternal.db fu
0b30: 6e 63 20 69 73 6f 76 65 72 66 6c 6f 77 20 69 73  nc isoverflow is
0b40: 6f 76 65 72 66 6c 6f 77 0a 0a 73 65 74 20 73 71  overflow..set sq
0b50: 6c 20 7b 20 53 45 4c 45 43 54 20 6e 61 6d 65 2c  l { SELECT name,
0b60: 20 74 62 6c 5f 6e 61 6d 65 20 46 52 4f 4d 20 73   tbl_name FROM s
0b70: 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 57 48 45  qlite_master WHE
0b80: 52 45 20 72 6f 6f 74 70 61 67 65 3e 30 20 7d 0a  RE rootpage>0 }.
0b90: 66 6f 72 65 61 63 68 20 7b 6e 61 6d 65 20 74 62  foreach {name tb
0ba0: 6c 6e 61 6d 65 7d 20 5b 63 6f 6e 63 61 74 20 73  lname} [concat s
0bb0: 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 73 71 6c  qlite_master sql
0bc0: 69 74 65 5f 6d 61 73 74 65 72 20 5b 64 62 20 65  ite_master [db e
0bd0: 76 61 6c 20 24 73 71 6c 5d 5d 20 7b 0a 0a 20 20  val $sql]] {..  
0be0: 73 65 74 20 69 73 5f 69 6e 64 65 78 20 5b 65 78  set is_index [ex
0bf0: 70 72 20 7b 24 6e 61 6d 65 21 3d 24 74 62 6c 6e  pr {$name!=$tbln
0c00: 61 6d 65 7d 5d 0a 20 20 64 62 20 65 76 61 6c 20  ame}].  db eval 
0c10: 7b 0a 20 20 20 20 53 45 4c 45 43 54 20 0a 20 20  {.    SELECT .  
0c20: 20 20 20 20 73 75 6d 28 6e 63 65 6c 6c 29 20 41      sum(ncell) A
0c30: 53 20 6e 65 6e 74 72 79 2c 0a 20 20 20 20 20 20  S nentry,.      
0c40: 73 75 6d 28 69 73 6c 65 61 66 28 70 61 67 65 74  sum(isleaf(paget
0c50: 79 70 65 2c 20 24 69 73 5f 69 6e 64 65 78 29 20  ype, $is_index) 
0c60: 2a 20 6e 63 65 6c 6c 29 20 41 53 20 6c 65 61 66  * ncell) AS leaf
0c70: 5f 65 6e 74 72 69 65 73 2c 0a 20 20 20 20 20 20  _entries,.      
0c80: 73 75 6d 28 70 61 79 6c 6f 61 64 29 20 41 53 20  sum(payload) AS 
0c90: 70 61 79 6c 6f 61 64 2c 0a 20 20 20 20 20 20 73  payload,.      s
0ca0: 75 6d 28 69 73 6f 76 65 72 66 6c 6f 77 28 70 61  um(isoverflow(pa
0cb0: 67 65 74 79 70 65 2c 20 24 69 73 5f 69 6e 64 65  getype, $is_inde
0cc0: 78 29 20 2a 20 70 61 79 6c 6f 61 64 29 20 41 53  x) * payload) AS
0cd0: 20 6f 76 66 6c 5f 70 61 79 6c 6f 61 64 2c 0a 20   ovfl_payload,. 
0ce0: 20 20 20 20 20 73 75 6d 28 70 61 74 68 20 4c 49       sum(path LI
0cf0: 4b 45 20 27 25 2b 30 30 30 30 30 30 27 29 20 41  KE '%+000000') A
0d00: 53 20 6f 76 66 6c 5f 63 6e 74 2c 0a 20 20 20 20  S ovfl_cnt,.    
0d10: 20 20 6d 61 78 28 6d 78 5f 70 61 79 6c 6f 61 64    max(mx_payload
0d20: 29 20 41 53 20 6d 78 5f 70 61 79 6c 6f 61 64 2c  ) AS mx_payload,
0d30: 0a 20 20 20 20 20 20 73 75 6d 28 69 73 69 6e 74  .      sum(isint
0d40: 65 72 6e 61 6c 28 70 61 67 65 74 79 70 65 2c 20  ernal(pagetype, 
0d50: 24 69 73 5f 69 6e 64 65 78 29 29 20 41 53 20 69  $is_index)) AS i
0d60: 6e 74 5f 70 61 67 65 73 2c 0a 20 20 20 20 20 20  nt_pages,.      
0d70: 73 75 6d 28 69 73 6c 65 61 66 28 70 61 67 65 74  sum(isleaf(paget
0d80: 79 70 65 2c 20 24 69 73 5f 69 6e 64 65 78 29 29  ype, $is_index))
0d90: 20 41 53 20 6c 65 61 66 5f 70 61 67 65 73 2c 0a   AS leaf_pages,.
0da0: 20 20 20 20 20 20 73 75 6d 28 69 73 6f 76 65 72        sum(isover
0db0: 66 6c 6f 77 28 70 61 67 65 74 79 70 65 2c 20 24  flow(pagetype, $
0dc0: 69 73 5f 69 6e 64 65 78 29 29 20 41 53 20 6f 76  is_index)) AS ov
0dd0: 66 6c 5f 70 61 67 65 73 2c 0a 20 20 20 20 20 20  fl_pages,.      
0de0: 73 75 6d 28 69 73 69 6e 74 65 72 6e 61 6c 28 70  sum(isinternal(p
0df0: 61 67 65 74 79 70 65 2c 20 24 69 73 5f 69 6e 64  agetype, $is_ind
0e00: 65 78 29 20 2a 20 75 6e 75 73 65 64 29 20 41 53  ex) * unused) AS
0e10: 20 69 6e 74 5f 75 6e 75 73 65 64 2c 0a 20 20 20   int_unused,.   
0e20: 20 20 20 73 75 6d 28 69 73 6c 65 61 66 28 70 61     sum(isleaf(pa
0e30: 67 65 74 79 70 65 2c 20 24 69 73 5f 69 6e 64 65  getype, $is_inde
0e40: 78 29 20 2a 20 75 6e 75 73 65 64 29 20 41 53 20  x) * unused) AS 
0e50: 6c 65 61 66 5f 75 6e 75 73 65 64 2c 0a 20 20 20  leaf_unused,.   
0e60: 20 20 20 73 75 6d 28 69 73 6f 76 65 72 66 6c 6f     sum(isoverflo
0e70: 77 28 70 61 67 65 74 79 70 65 2c 20 24 69 73 5f  w(pagetype, $is_
0e80: 69 6e 64 65 78 29 20 2a 20 75 6e 75 73 65 64 29  index) * unused)
0e90: 20 41 53 20 6f 76 66 6c 5f 75 6e 75 73 65 64 0a   AS ovfl_unused.
0ea0: 20 20 20 20 46 52 4f 4d 20 74 65 6d 70 2e 64 62      FROM temp.db
0eb0: 73 74 61 74 20 57 48 45 52 45 20 6e 61 6d 65 20  stat WHERE name 
0ec0: 3d 20 24 6e 61 6d 65 0a 20 20 7d 20 62 72 65 61  = $name.  } brea
0ed0: 6b 0a 0a 20 20 23 20 43 6f 6c 75 6d 6e 20 27 67  k..  # Column 'g
0ee0: 61 70 5f 63 6e 74 27 20 69 73 20 73 65 74 20 74  ap_cnt' is set t
0ef0: 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  o the number of 
0f00: 6e 6f 6e 2d 63 6f 6e 74 69 67 75 6f 75 73 20 65  non-contiguous e
0f10: 6e 74 72 69 65 73 20 69 6e 20 74 68 65 0a 20 20  ntries in the.  
0f20: 23 20 6c 69 73 74 20 6f 66 20 70 61 67 65 73 20  # list of pages 
0f30: 76 69 73 69 74 65 64 20 69 66 20 74 68 65 20 62  visited if the b
0f40: 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20  -tree structure 
0f50: 69 73 20 74 72 61 76 65 72 73 65 64 20 69 6e 20  is traversed in 
0f60: 61 20 74 6f 70 2d 64 6f 77 6e 0a 20 20 23 20 66  a top-down.  # f
0f70: 61 73 68 69 6f 6e 20 28 65 61 63 68 20 6e 6f 64  ashion (each nod
0f80: 65 20 76 69 73 69 74 65 64 20 62 65 66 6f 72 65  e visited before
0f90: 20 69 74 73 20 63 68 69 6c 64 2d 74 72 65 65 20   its child-tree 
0fa0: 69 73 20 70 61 73 73 65 64 29 2e 20 41 6e 79 20  is passed). Any 
0fb0: 6f 76 65 72 66 6c 6f 77 0a 20 20 23 20 63 68 61  overflow.  # cha
0fc0: 69 6e 73 20 70 72 65 73 65 6e 74 20 61 72 65 20  ins present are 
0fd0: 74 72 61 76 65 72 73 65 64 20 66 72 6f 6d 20 73  traversed from s
0fe0: 74 61 72 74 20 74 6f 20 66 69 6e 69 73 68 20 62  tart to finish b
0ff0: 65 66 6f 72 65 20 61 6e 79 20 63 68 69 6c 64 2d  efore any child-
1000: 74 72 65 65 0a 20 20 23 20 69 73 2e 0a 20 20 23  tree.  # is..  #
1010: 0a 20 20 73 65 74 20 67 61 70 5f 63 6e 74 20 30  .  set gap_cnt 0
1020: 0a 20 20 73 65 74 20 70 67 6c 69 73 74 20 5b 64  .  set pglist [d
1030: 62 20 65 76 61 6c 20 7b 0a 20 20 20 20 53 45 4c  b eval {.    SEL
1040: 45 43 54 20 70 61 67 65 6e 6f 20 46 52 4f 4d 20  ECT pageno FROM 
1050: 74 65 6d 70 2e 64 62 73 74 61 74 20 57 48 45 52  temp.dbstat WHER
1060: 45 20 6e 61 6d 65 20 3d 20 24 6e 61 6d 65 20 4f  E name = $name O
1070: 52 44 45 52 20 42 59 20 72 6f 77 69 64 0a 20 20  RDER BY rowid.  
1080: 7d 5d 0a 20 20 73 65 74 20 70 72 65 76 20 5b 6c  }].  set prev [l
1090: 69 6e 64 65 78 20 24 70 67 6c 69 73 74 20 30 5d  index $pglist 0]
10a0: 0a 20 20 66 6f 72 65 61 63 68 20 70 67 6e 6f 20  .  foreach pgno 
10b0: 5b 6c 72 61 6e 67 65 20 24 70 67 6c 69 73 74 20  [lrange $pglist 
10c0: 31 20 65 6e 64 5d 20 7b 0a 20 20 20 20 69 66 20  1 end] {.    if 
10d0: 7b 24 70 67 6e 6f 20 21 3d 20 24 70 72 65 76 2b  {$pgno != $prev+
10e0: 31 7d 20 7b 69 6e 63 72 20 67 61 70 5f 63 6e 74  1} {incr gap_cnt
10f0: 7d 0a 20 20 20 20 73 65 74 20 70 72 65 76 20 24  }.    set prev $
1100: 70 67 6e 6f 0a 20 20 7d 0a 0a 20 20 6d 65 6d 20  pgno.  }..  mem 
1110: 65 76 61 6c 20 7b 0a 20 20 20 20 49 4e 53 45 52  eval {.    INSER
1120: 54 20 49 4e 54 4f 20 73 70 61 63 65 5f 75 73 65  T INTO space_use
1130: 64 20 56 41 4c 55 45 53 28 0a 20 20 20 20 20 20  d VALUES(.      
1140: 24 6e 61 6d 65 2c 0a 20 20 20 20 20 20 24 74 62  $name,.      $tb
1150: 6c 6e 61 6d 65 2c 0a 20 20 20 20 20 20 24 69 73  lname,.      $is
1160: 5f 69 6e 64 65 78 2c 0a 20 20 20 20 20 20 24 6e  _index,.      $n
1170: 65 6e 74 72 79 2c 0a 20 20 20 20 20 20 24 6c 65  entry,.      $le
1180: 61 66 5f 65 6e 74 72 69 65 73 2c 0a 20 20 20 20  af_entries,.    
1190: 20 20 24 70 61 79 6c 6f 61 64 2c 20 20 20 20 20    $payload,     
11a0: 0a 20 20 20 20 20 20 24 6f 76 66 6c 5f 70 61 79  .      $ovfl_pay
11b0: 6c 6f 61 64 2c 0a 20 20 20 20 20 20 24 6f 76 66  load,.      $ovf
11c0: 6c 5f 63 6e 74 2c 20 20 20 0a 20 20 20 20 20 20  l_cnt,   .      
11d0: 24 6d 78 5f 70 61 79 6c 6f 61 64 2c 0a 20 20 20  $mx_payload,.   
11e0: 20 20 20 24 69 6e 74 5f 70 61 67 65 73 2c 0a 20     $int_pages,. 
11f0: 20 20 20 20 20 24 6c 65 61 66 5f 70 61 67 65 73       $leaf_pages
1200: 2c 20 20 0a 20 20 20 20 20 20 24 6f 76 66 6c 5f  ,  .      $ovfl_
1210: 70 61 67 65 73 2c 20 0a 20 20 20 20 20 20 24 69  pages, .      $i
1220: 6e 74 5f 75 6e 75 73 65 64 2c 20 0a 20 20 20 20  nt_unused, .    
1230: 20 20 24 6c 65 61 66 5f 75 6e 75 73 65 64 2c 0a    $leaf_unused,.
1240: 20 20 20 20 20 20 24 6f 76 66 6c 5f 75 6e 75 73        $ovfl_unus
1250: 65 64 2c 0a 20 20 20 20 20 20 24 67 61 70 5f 63  ed,.      $gap_c
1260: 6e 74 0a 20 20 20 20 29 3b 0a 20 20 7d 0a 7d 0a  nt.    );.  }.}.
1270: 0a 70 72 6f 63 20 69 6e 74 65 67 65 72 69 66 79  .proc integerify
1280: 20 7b 72 65 61 6c 7d 20 7b 0a 20 20 69 66 20 7b   {real} {.  if {
1290: 5b 73 74 72 69 6e 67 20 69 73 20 64 6f 75 62 6c  [string is doubl
12a0: 65 20 2d 73 74 72 69 63 74 20 24 72 65 61 6c 5d  e -strict $real]
12b0: 7d 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 5b  } {.    return [
12c0: 65 78 70 72 20 7b 69 6e 74 28 24 72 65 61 6c 29  expr {int($real)
12d0: 7d 5d 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20  }].  } else {.  
12e0: 20 20 72 65 74 75 72 6e 20 30 0a 20 20 7d 0a 7d    return 0.  }.}
12f0: 0a 6d 65 6d 20 66 75 6e 63 74 69 6f 6e 20 69 6e  .mem function in
1300: 74 20 69 6e 74 65 67 65 72 69 66 79 0a 0a 23 20  t integerify..# 
1310: 51 75 6f 74 65 20 61 20 73 74 72 69 6e 67 20 66  Quote a string f
1320: 6f 72 20 75 73 65 20 69 6e 20 61 6e 20 53 51 4c  or use in an SQL
1330: 20 71 75 65 72 79 2e 20 45 78 61 6d 70 6c 65 73   query. Examples
1340: 3a 0a 23 0a 23 20 5b 71 75 6f 74 65 20 7b 68 65  :.#.# [quote {he
1350: 6c 6c 6f 20 77 6f 72 6c 64 7d 5d 20 20 20 3d 3d  llo world}]   ==
1360: 20 7b 27 68 65 6c 6c 6f 20 77 6f 72 6c 64 27 7d   {'hello world'}
1370: 0a 23 20 5b 71 75 6f 74 65 20 7b 68 65 6c 6c 6f  .# [quote {hello
1380: 20 77 6f 72 6c 64 27 73 7d 5d 20 3d 3d 20 7b 27   world's}] == {'
1390: 68 65 6c 6c 6f 20 77 6f 72 6c 64 27 27 73 27 7d  hello world''s'}
13a0: 0a 23 0a 70 72 6f 63 20 71 75 6f 74 65 20 7b 74  .#.proc quote {t
13b0: 78 74 7d 20 7b 0a 20 20 72 65 67 73 75 62 20 2d  xt} {.  regsub -
13c0: 61 6c 6c 20 27 20 24 74 78 74 20 27 27 20 71 0a  all ' $txt '' q.
13d0: 20 20 72 65 74 75 72 6e 20 27 24 71 27 0a 7d 0a    return '$q'.}.
13e0: 0a 23 20 47 65 6e 65 72 61 74 65 20 61 20 73 69  .# Generate a si
13f0: 6e 67 6c 65 20 6c 69 6e 65 20 6f 66 20 6f 75 74  ngle line of out
1400: 70 75 74 20 69 6e 20 74 68 65 20 73 74 61 74 69  put in the stati
1410: 73 74 69 63 73 20 73 65 63 74 69 6f 6e 20 6f 66  stics section of
1420: 20 74 68 65 0a 23 20 72 65 70 6f 72 74 2e 0a 23   the.# report..#
1430: 0a 70 72 6f 63 20 73 74 61 74 6c 69 6e 65 20 7b  .proc statline {
1440: 74 69 74 6c 65 20 76 61 6c 75 65 20 7b 65 78 74  title value {ext
1450: 72 61 20 7b 7d 7d 7d 20 7b 0a 20 20 73 65 74 20  ra {}}} {.  set 
1460: 6c 65 6e 20 5b 73 74 72 69 6e 67 20 6c 65 6e 67  len [string leng
1470: 74 68 20 24 74 69 74 6c 65 5d 0a 20 20 73 65 74  th $title].  set
1480: 20 64 6f 74 73 20 5b 73 74 72 69 6e 67 20 72 61   dots [string ra
1490: 6e 67 65 20 7b 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e  nge {...........
14a0: 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e  ................
14b0: 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 2e 7d 20 24 6c 65  ...........} $le
14c0: 6e 20 65 6e 64 5d 0a 20 20 73 65 74 20 6c 65 6e  n end].  set len
14d0: 20 5b 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 20   [string length 
14e0: 24 76 61 6c 75 65 5d 0a 20 20 73 65 74 20 73 70  $value].  set sp
14f0: 32 20 5b 73 74 72 69 6e 67 20 72 61 6e 67 65 20  2 [string range 
1500: 7b 20 20 20 20 20 20 20 20 20 20 7d 20 24 6c 65  {          } $le
1510: 6e 20 65 6e 64 5d 0a 20 20 69 66 20 7b 24 65 78  n end].  if {$ex
1520: 74 72 61 20 6e 65 20 22 22 7d 20 7b 0a 20 20 20  tra ne ""} {.   
1530: 20 73 65 74 20 65 78 74 72 61 20 22 20 24 65 78   set extra " $ex
1540: 74 72 61 22 0a 20 20 7d 0a 20 20 70 75 74 73 20  tra".  }.  puts 
1550: 22 24 74 69 74 6c 65 24 64 6f 74 73 20 24 76 61  "$title$dots $va
1560: 6c 75 65 24 73 70 32 24 65 78 74 72 61 22 0a 7d  lue$sp2$extra".}
1570: 0a 0a 23 20 47 65 6e 65 72 61 74 65 20 61 20 66  ..# Generate a f
1580: 6f 72 6d 61 74 74 65 64 20 70 65 72 63 65 6e 74  ormatted percent
1590: 61 67 65 20 76 61 6c 75 65 20 66 6f 72 20 24 6e  age value for $n
15a0: 75 6d 2f 24 64 65 6e 6f 6d 0a 23 0a 70 72 6f 63  um/$denom.#.proc
15b0: 20 70 65 72 63 65 6e 74 20 7b 6e 75 6d 20 64 65   percent {num de
15c0: 6e 6f 6d 20 7b 6f 66 20 7b 7d 7d 7d 20 7b 0a 20  nom {of {}}} {. 
15d0: 20 69 66 20 7b 24 64 65 6e 6f 6d 3d 3d 30 2e 30   if {$denom==0.0
15e0: 7d 20 7b 72 65 74 75 72 6e 20 22 22 7d 0a 20 20  } {return ""}.  
15f0: 73 65 74 20 76 20 5b 65 78 70 72 20 7b 24 6e 75  set v [expr {$nu
1600: 6d 2a 31 30 30 2e 30 2f 24 64 65 6e 6f 6d 7d 5d  m*100.0/$denom}]
1610: 0a 20 20 73 65 74 20 6f 66 20 7b 7d 0a 20 20 69  .  set of {}.  i
1620: 66 20 7b 24 76 3d 3d 31 30 30 2e 30 20 7c 7c 20  f {$v==100.0 || 
1630: 24 76 3c 30 2e 30 30 31 20 7c 7c 20 28 24 76 3e  $v<0.001 || ($v>
1640: 31 2e 30 20 26 26 20 24 76 3c 39 39 2e 30 29 7d  1.0 && $v<99.0)}
1650: 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 5b 66   {.    return [f
1660: 6f 72 6d 61 74 20 7b 25 35 2e 31 66 25 25 20 25  ormat {%5.1f%% %
1670: 73 7d 20 24 76 20 24 6f 66 5d 0a 20 20 7d 20 65  s} $v $of].  } e
1680: 6c 73 65 69 66 20 7b 24 76 3c 30 2e 31 20 7c 7c  lseif {$v<0.1 ||
1690: 20 24 76 3e 39 39 2e 39 7d 20 7b 0a 20 20 20 20   $v>99.9} {.    
16a0: 72 65 74 75 72 6e 20 5b 66 6f 72 6d 61 74 20 7b  return [format {
16b0: 25 37 2e 33 66 25 25 20 25 73 7d 20 24 76 20 24  %7.3f%% %s} $v $
16c0: 6f 66 5d 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20  of].  } else {. 
16d0: 20 20 20 72 65 74 75 72 6e 20 5b 66 6f 72 6d 61     return [forma
16e0: 74 20 7b 25 36 2e 32 66 25 25 20 25 73 7d 20 24  t {%6.2f%% %s} $
16f0: 76 20 24 6f 66 5d 0a 20 20 7d 0a 7d 0a 0a 70 72  v $of].  }.}..pr
1700: 6f 63 20 64 69 76 69 64 65 20 7b 6e 75 6d 20 64  oc divide {num d
1710: 65 6e 6f 6d 7d 20 7b 0a 20 20 69 66 20 7b 24 64  enom} {.  if {$d
1720: 65 6e 6f 6d 3d 3d 30 7d 20 7b 72 65 74 75 72 6e  enom==0} {return
1730: 20 30 2e 30 7d 0a 20 20 72 65 74 75 72 6e 20 5b   0.0}.  return [
1740: 66 6f 72 6d 61 74 20 25 2e 32 66 20 5b 65 78 70  format %.2f [exp
1750: 72 20 64 6f 75 62 6c 65 28 24 6e 75 6d 29 2f 64  r double($num)/d
1760: 6f 75 62 6c 65 28 24 64 65 6e 6f 6d 29 5d 5d 0a  ouble($denom)]].
1770: 7d 0a 0a 23 20 47 65 6e 65 72 61 74 65 20 61 20  }..# Generate a 
1780: 73 75 62 72 65 70 6f 72 74 20 74 68 61 74 20 63  subreport that c
1790: 6f 76 65 72 73 20 73 6f 6d 65 20 73 75 62 73 65  overs some subse
17a0: 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73  t of the databas
17b0: 65 2e 0a 23 20 74 68 65 20 24 77 68 65 72 65 20  e..# the $where 
17c0: 63 6c 61 75 73 65 20 64 65 74 65 72 6d 69 6e 65  clause determine
17d0: 73 20 77 68 69 63 68 20 73 75 62 73 65 74 20 74  s which subset t
17e0: 6f 20 61 6e 61 6c 79 7a 65 2e 0a 23 0a 70 72 6f  o analyze..#.pro
17f0: 63 20 73 75 62 72 65 70 6f 72 74 20 7b 74 69 74  c subreport {tit
1800: 6c 65 20 77 68 65 72 65 7d 20 7b 0a 20 20 67 6c  le where} {.  gl
1810: 6f 62 61 6c 20 70 61 67 65 53 69 7a 65 20 66 69  obal pageSize fi
1820: 6c 65 5f 70 67 63 6e 74 0a 0a 20 20 23 20 51 75  le_pgcnt..  # Qu
1830: 65 72 79 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72  ery the in-memor
1840: 79 20 64 61 74 61 62 61 73 65 20 66 6f 72 20 74  y database for t
1850: 68 65 20 73 75 6d 20 6f 66 20 76 61 72 69 6f 75  he sum of variou
1860: 73 20 73 74 61 74 69 73 74 69 63 73 20 0a 20 20  s statistics .  
1870: 23 20 66 6f 72 20 74 68 65 20 73 75 62 73 65 74  # for the subset
1880: 20 6f 66 20 74 61 62 6c 65 73 2f 69 6e 64 69 63   of tables/indic
1890: 65 73 20 69 64 65 6e 74 69 66 69 65 64 20 62 79  es identified by
18a0: 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 73   the WHERE claus
18b0: 65 20 69 6e 0a 20 20 23 20 24 77 68 65 72 65 2e  e in.  # $where.
18c0: 20 4e 6f 74 65 20 74 68 61 74 20 65 76 65 6e 20   Note that even 
18d0: 69 66 20 74 68 65 20 57 48 45 52 45 20 63 6c 61  if the WHERE cla
18e0: 75 73 65 20 6d 61 74 63 68 65 73 20 6e 6f 20 72  use matches no r
18f0: 6f 77 73 2c 20 74 68 65 0a 20 20 23 20 66 6f 6c  ows, the.  # fol
1900: 6c 6f 77 69 6e 67 20 71 75 65 72 79 20 72 65 74  lowing query ret
1910: 75 72 6e 73 20 65 78 61 63 74 6c 79 20 6f 6e 65  urns exactly one
1920: 20 72 6f 77 20 28 62 65 63 61 75 73 65 20 69 74   row (because it
1930: 20 69 73 20 61 6e 20 61 67 67 72 65 67 61 74 65   is an aggregate
1940: 29 2e 0a 20 20 23 0a 20 20 23 20 54 68 65 20 72  )..  #.  # The r
1950: 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20 71 75  esults of the qu
1960: 65 72 79 20 61 72 65 20 73 74 6f 72 65 64 20 64  ery are stored d
1970: 69 72 65 63 74 6c 79 20 62 79 20 53 51 4c 69 74  irectly by SQLit
1980: 65 20 69 6e 74 6f 20 6c 6f 63 61 6c 20 0a 20 20  e into local .  
1990: 23 20 76 61 72 69 61 62 6c 65 73 20 28 69 2e 65  # variables (i.e
19a0: 2e 20 24 6e 65 6e 74 72 79 2c 20 24 6e 6c 65 61  . $nentry, $nlea
19b0: 66 20 65 74 63 2e 29 2e 0a 20 20 23 0a 20 20 6d  f etc.)..  #.  m
19c0: 65 6d 20 65 76 61 6c 20 22 0a 20 20 20 20 53 45  em eval ".    SE
19d0: 4c 45 43 54 0a 20 20 20 20 20 20 69 6e 74 28 73  LECT.      int(s
19e0: 75 6d 28 6e 65 6e 74 72 79 29 29 20 41 53 20 6e  um(nentry)) AS n
19f0: 65 6e 74 72 79 2c 0a 20 20 20 20 20 20 69 6e 74  entry,.      int
1a00: 28 73 75 6d 28 6c 65 61 66 5f 65 6e 74 72 69 65  (sum(leaf_entrie
1a10: 73 29 29 20 41 53 20 6e 6c 65 61 66 2c 0a 20 20  s)) AS nleaf,.  
1a20: 20 20 20 20 69 6e 74 28 73 75 6d 28 70 61 79 6c      int(sum(payl
1a30: 6f 61 64 29 29 20 41 53 20 70 61 79 6c 6f 61 64  oad)) AS payload
1a40: 2c 0a 20 20 20 20 20 20 69 6e 74 28 73 75 6d 28  ,.      int(sum(
1a50: 6f 76 66 6c 5f 70 61 79 6c 6f 61 64 29 29 20 41  ovfl_payload)) A
1a60: 53 20 6f 76 66 6c 5f 70 61 79 6c 6f 61 64 2c 0a  S ovfl_payload,.
1a70: 20 20 20 20 20 20 6d 61 78 28 6d 78 5f 70 61 79        max(mx_pay
1a80: 6c 6f 61 64 29 20 41 53 20 6d 78 5f 70 61 79 6c  load) AS mx_payl
1a90: 6f 61 64 2c 0a 20 20 20 20 20 20 69 6e 74 28 73  oad,.      int(s
1aa0: 75 6d 28 6f 76 66 6c 5f 63 6e 74 29 29 20 61 73  um(ovfl_cnt)) as
1ab0: 20 6f 76 66 6c 5f 63 6e 74 2c 0a 20 20 20 20 20   ovfl_cnt,.     
1ac0: 20 69 6e 74 28 73 75 6d 28 6c 65 61 66 5f 70 61   int(sum(leaf_pa
1ad0: 67 65 73 29 29 20 41 53 20 6c 65 61 66 5f 70 61  ges)) AS leaf_pa
1ae0: 67 65 73 2c 0a 20 20 20 20 20 20 69 6e 74 28 73  ges,.      int(s
1af0: 75 6d 28 69 6e 74 5f 70 61 67 65 73 29 29 20 41  um(int_pages)) A
1b00: 53 20 69 6e 74 5f 70 61 67 65 73 2c 0a 20 20 20  S int_pages,.   
1b10: 20 20 20 69 6e 74 28 73 75 6d 28 6f 76 66 6c 5f     int(sum(ovfl_
1b20: 70 61 67 65 73 29 29 20 41 53 20 6f 76 66 6c 5f  pages)) AS ovfl_
1b30: 70 61 67 65 73 2c 0a 20 20 20 20 20 20 69 6e 74  pages,.      int
1b40: 28 73 75 6d 28 6c 65 61 66 5f 75 6e 75 73 65 64  (sum(leaf_unused
1b50: 29 29 20 41 53 20 6c 65 61 66 5f 75 6e 75 73 65  )) AS leaf_unuse
1b60: 64 2c 0a 20 20 20 20 20 20 69 6e 74 28 73 75 6d  d,.      int(sum
1b70: 28 69 6e 74 5f 75 6e 75 73 65 64 29 29 20 41 53  (int_unused)) AS
1b80: 20 69 6e 74 5f 75 6e 75 73 65 64 2c 0a 20 20 20   int_unused,.   
1b90: 20 20 20 69 6e 74 28 73 75 6d 28 6f 76 66 6c 5f     int(sum(ovfl_
1ba0: 75 6e 75 73 65 64 29 29 20 41 53 20 6f 76 66 6c  unused)) AS ovfl
1bb0: 5f 75 6e 75 73 65 64 2c 0a 20 20 20 20 20 20 69  _unused,.      i
1bc0: 6e 74 28 73 75 6d 28 67 61 70 5f 63 6e 74 29 29  nt(sum(gap_cnt))
1bd0: 20 41 53 20 67 61 70 5f 63 6e 74 0a 20 20 20 20   AS gap_cnt.    
1be0: 46 52 4f 4d 20 73 70 61 63 65 5f 75 73 65 64 20  FROM space_used 
1bf0: 57 48 45 52 45 20 24 77 68 65 72 65 22 20 7b 7d  WHERE $where" {}
1c00: 20 7b 7d 0a 0a 20 20 23 20 4f 75 74 70 75 74 20   {}..  # Output 
1c10: 74 68 65 20 73 75 62 2d 72 65 70 6f 72 74 20 74  the sub-report t
1c20: 69 74 6c 65 2c 20 6e 69 63 65 6c 79 20 64 65 63  itle, nicely dec
1c30: 6f 72 61 74 65 64 20 77 69 74 68 20 2a 20 63 68  orated with * ch
1c40: 61 72 61 63 74 65 72 73 2e 0a 20 20 23 0a 20 20  aracters..  #.  
1c50: 70 75 74 73 20 22 22 0a 20 20 73 65 74 20 6c 65  puts "".  set le
1c60: 6e 20 5b 73 74 72 69 6e 67 20 6c 65 6e 67 74 68  n [string length
1c70: 20 24 74 69 74 6c 65 5d 0a 20 20 73 65 74 20 73   $title].  set s
1c80: 74 61 72 73 20 5b 73 74 72 69 6e 67 20 72 65 70  tars [string rep
1c90: 65 61 74 20 2a 20 5b 65 78 70 72 20 36 35 2d 24  eat * [expr 65-$
1ca0: 6c 65 6e 5d 5d 0a 20 20 70 75 74 73 20 22 2a 2a  len]].  puts "**
1cb0: 2a 20 24 74 69 74 6c 65 20 24 73 74 61 72 73 22  * $title $stars"
1cc0: 0a 20 20 70 75 74 73 20 22 22 0a 0a 20 20 23 20  .  puts ""..  # 
1cd0: 43 61 6c 63 75 6c 61 74 65 20 73 74 61 74 69 73  Calculate statis
1ce0: 74 69 63 73 20 61 6e 64 20 73 74 6f 72 65 20 74  tics and store t
1cf0: 68 65 20 72 65 73 75 6c 74 73 20 69 6e 20 54 43  he results in TC
1d00: 4c 20 76 61 72 69 61 62 6c 65 73 2c 20 61 73 20  L variables, as 
1d10: 66 6f 6c 6c 6f 77 73 3a 0a 20 20 23 0a 20 20 23  follows:.  #.  #
1d20: 20 74 6f 74 61 6c 5f 70 61 67 65 73 3a 20 44 61   total_pages: Da
1d30: 74 61 62 61 73 65 20 70 61 67 65 73 20 63 6f 6e  tabase pages con
1d40: 73 75 6d 65 64 2e 0a 20 20 23 20 74 6f 74 61 6c  sumed..  # total
1d50: 5f 70 61 67 65 73 5f 70 65 72 63 65 6e 74 3a 20  _pages_percent: 
1d60: 50 61 67 65 73 20 63 6f 6e 73 75 6d 65 64 20 61  Pages consumed a
1d70: 73 20 61 20 70 65 72 63 65 6e 74 61 67 65 20 6f  s a percentage o
1d80: 66 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 23 20  f the file..  # 
1d90: 73 74 6f 72 61 67 65 3a 20 42 79 74 65 73 20 63  storage: Bytes c
1da0: 6f 6e 73 75 6d 65 64 2e 0a 20 20 23 20 70 61 79  onsumed..  # pay
1db0: 6c 6f 61 64 5f 70 65 72 63 65 6e 74 3a 20 50 61  load_percent: Pa
1dc0: 79 6c 6f 61 64 20 62 79 74 65 73 20 75 73 65 64  yload bytes used
1dd0: 20 61 73 20 61 20 70 65 72 63 65 6e 74 61 67 65   as a percentage
1de0: 20 6f 66 20 24 73 74 6f 72 61 67 65 2e 0a 20 20   of $storage..  
1df0: 23 20 74 6f 74 61 6c 5f 75 6e 75 73 65 64 3a 20  # total_unused: 
1e00: 55 6e 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20  Unused bytes on 
1e10: 70 61 67 65 73 2e 0a 20 20 23 20 61 76 67 5f 70  pages..  # avg_p
1e20: 61 79 6c 6f 61 64 3a 20 41 76 65 72 61 67 65 20  ayload: Average 
1e30: 70 61 79 6c 6f 61 64 20 70 65 72 20 62 74 72 65  payload per btre
1e40: 65 20 65 6e 74 72 79 2e 0a 20 20 23 20 61 76 67  e entry..  # avg
1e50: 5f 66 61 6e 6f 75 74 3a 20 41 76 65 72 61 67 65  _fanout: Average
1e60: 20 66 61 6e 6f 75 74 20 66 6f 72 20 69 6e 74 65   fanout for inte
1e70: 72 6e 61 6c 20 70 61 67 65 73 2e 0a 20 20 23 20  rnal pages..  # 
1e80: 61 76 67 5f 75 6e 75 73 65 64 3a 20 41 76 65 72  avg_unused: Aver
1e90: 61 67 65 20 75 6e 75 73 65 64 20 62 79 74 65 73  age unused bytes
1ea0: 20 70 65 72 20 62 74 72 65 65 20 65 6e 74 72 79   per btree entry
1eb0: 2e 0a 20 20 23 20 6f 76 66 6c 5f 63 6e 74 5f 70  ..  # ovfl_cnt_p
1ec0: 65 72 63 65 6e 74 3a 20 50 65 72 63 65 6e 74 61  ercent: Percenta
1ed0: 67 65 20 6f 66 20 62 74 72 65 65 20 65 6e 74 72  ge of btree entr
1ee0: 69 65 73 20 74 68 61 74 20 75 73 65 20 6f 76 65  ies that use ove
1ef0: 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 20 20 23  rflow pages..  #
1f00: 0a 20 20 73 65 74 20 74 6f 74 61 6c 5f 70 61 67  .  set total_pag
1f10: 65 73 20 5b 65 78 70 72 20 7b 24 6c 65 61 66 5f  es [expr {$leaf_
1f20: 70 61 67 65 73 2b 24 69 6e 74 5f 70 61 67 65 73  pages+$int_pages
1f30: 2b 24 6f 76 66 6c 5f 70 61 67 65 73 7d 5d 0a 20  +$ovfl_pages}]. 
1f40: 20 73 65 74 20 74 6f 74 61 6c 5f 70 61 67 65 73   set total_pages
1f50: 5f 70 65 72 63 65 6e 74 20 5b 70 65 72 63 65 6e  _percent [percen
1f60: 74 20 24 74 6f 74 61 6c 5f 70 61 67 65 73 20 24  t $total_pages $
1f70: 66 69 6c 65 5f 70 67 63 6e 74 5d 0a 20 20 73 65  file_pgcnt].  se
1f80: 74 20 73 74 6f 72 61 67 65 20 5b 65 78 70 72 20  t storage [expr 
1f90: 7b 24 74 6f 74 61 6c 5f 70 61 67 65 73 2a 24 70  {$total_pages*$p
1fa0: 61 67 65 53 69 7a 65 7d 5d 0a 20 20 73 65 74 20  ageSize}].  set 
1fb0: 70 61 79 6c 6f 61 64 5f 70 65 72 63 65 6e 74 20  payload_percent 
1fc0: 5b 70 65 72 63 65 6e 74 20 24 70 61 79 6c 6f 61  [percent $payloa
1fd0: 64 20 24 73 74 6f 72 61 67 65 20 7b 6f 66 20 73  d $storage {of s
1fe0: 74 6f 72 61 67 65 20 63 6f 6e 73 75 6d 65 64 7d  torage consumed}
1ff0: 5d 0a 20 20 73 65 74 20 74 6f 74 61 6c 5f 75 6e  ].  set total_un
2000: 75 73 65 64 20 5b 65 78 70 72 20 7b 24 6f 76 66  used [expr {$ovf
2010: 6c 5f 75 6e 75 73 65 64 2b 24 69 6e 74 5f 75 6e  l_unused+$int_un
2020: 75 73 65 64 2b 24 6c 65 61 66 5f 75 6e 75 73 65  used+$leaf_unuse
2030: 64 7d 5d 0a 20 20 73 65 74 20 61 76 67 5f 70 61  d}].  set avg_pa
2040: 79 6c 6f 61 64 20 5b 64 69 76 69 64 65 20 24 70  yload [divide $p
2050: 61 79 6c 6f 61 64 20 24 6e 6c 65 61 66 5d 0a 20  ayload $nleaf]. 
2060: 20 73 65 74 20 61 76 67 5f 75 6e 75 73 65 64 20   set avg_unused 
2070: 5b 64 69 76 69 64 65 20 24 74 6f 74 61 6c 5f 75  [divide $total_u
2080: 6e 75 73 65 64 20 24 6e 6c 65 61 66 5d 0a 20 20  nused $nleaf].  
2090: 69 66 20 7b 24 69 6e 74 5f 70 61 67 65 73 3e 30  if {$int_pages>0
20a0: 7d 20 7b 0a 20 20 20 20 23 20 54 4f 44 4f 3a 20  } {.    # TODO: 
20b0: 49 73 20 74 68 69 73 20 66 6f 72 6d 75 6c 61 20  Is this formula 
20c0: 63 6f 72 72 65 63 74 3f 0a 20 20 20 20 73 65 74  correct?.    set
20d0: 20 6e 54 61 62 20 5b 6d 65 6d 20 65 76 61 6c 20   nTab [mem eval 
20e0: 22 0a 20 20 20 20 20 20 53 45 4c 45 43 54 20 63  ".      SELECT c
20f0: 6f 75 6e 74 28 2a 29 20 46 52 4f 4d 20 28 0a 20  ount(*) FROM (. 
2100: 20 20 20 20 20 20 20 20 20 53 45 4c 45 43 54 20           SELECT 
2110: 44 49 53 54 49 4e 43 54 20 74 62 6c 6e 61 6d 65  DISTINCT tblname
2120: 20 46 52 4f 4d 20 73 70 61 63 65 5f 75 73 65 64   FROM space_used
2130: 20 57 48 45 52 45 20 24 77 68 65 72 65 20 41 4e   WHERE $where AN
2140: 44 20 69 73 5f 69 6e 64 65 78 3d 30 0a 20 20 20  D is_index=0.   
2150: 20 20 20 29 0a 20 20 20 20 22 5d 0a 20 20 20 20     ).    "].    
2160: 73 65 74 20 61 76 67 5f 66 61 6e 6f 75 74 20 5b  set avg_fanout [
2170: 6d 65 6d 20 65 76 61 6c 20 22 0a 20 20 20 20 20  mem eval ".     
2180: 20 53 45 4c 45 43 54 20 28 73 75 6d 28 6c 65 61   SELECT (sum(lea
2190: 66 5f 70 61 67 65 73 2b 69 6e 74 5f 70 61 67 65  f_pages+int_page
21a0: 73 29 2d 24 6e 54 61 62 29 2f 73 75 6d 28 69 6e  s)-$nTab)/sum(in
21b0: 74 5f 70 61 67 65 73 29 20 46 52 4f 4d 20 73 70  t_pages) FROM sp
21c0: 61 63 65 5f 75 73 65 64 0a 20 20 20 20 20 20 20  ace_used.       
21d0: 20 20 20 57 48 45 52 45 20 24 77 68 65 72 65 20     WHERE $where 
21e0: 41 4e 44 20 69 73 5f 69 6e 64 65 78 20 3d 20 30  AND is_index = 0
21f0: 0a 20 20 20 20 22 5d 0a 20 20 20 20 73 65 74 20  .    "].    set 
2200: 61 76 67 5f 66 61 6e 6f 75 74 20 5b 66 6f 72 6d  avg_fanout [form
2210: 61 74 20 25 2e 32 66 20 24 61 76 67 5f 66 61 6e  at %.2f $avg_fan
2220: 6f 75 74 5d 0a 20 20 7d 0a 20 20 73 65 74 20 6f  out].  }.  set o
2230: 76 66 6c 5f 63 6e 74 5f 70 65 72 63 65 6e 74 20  vfl_cnt_percent 
2240: 5b 70 65 72 63 65 6e 74 20 24 6f 76 66 6c 5f 63  [percent $ovfl_c
2250: 6e 74 20 24 6e 6c 65 61 66 20 7b 6f 66 20 61 6c  nt $nleaf {of al
2260: 6c 20 65 6e 74 72 69 65 73 7d 5d 0a 0a 20 20 23  l entries}]..  #
2270: 20 50 72 69 6e 74 20 6f 75 74 20 74 68 65 20 73   Print out the s
2280: 75 62 2d 72 65 70 6f 72 74 20 73 74 61 74 69 73  ub-report statis
2290: 74 69 63 73 2e 0a 20 20 23 0a 20 20 73 74 61 74  tics..  #.  stat
22a0: 6c 69 6e 65 20 7b 50 65 72 63 65 6e 74 61 67 65  line {Percentage
22b0: 20 6f 66 20 74 6f 74 61 6c 20 64 61 74 61 62 61   of total databa
22c0: 73 65 7d 20 24 74 6f 74 61 6c 5f 70 61 67 65 73  se} $total_pages
22d0: 5f 70 65 72 63 65 6e 74 0a 20 20 73 74 61 74 6c  _percent.  statl
22e0: 69 6e 65 20 7b 4e 75 6d 62 65 72 20 6f 66 20 65  ine {Number of e
22f0: 6e 74 72 69 65 73 7d 20 24 6e 6c 65 61 66 0a 20  ntries} $nleaf. 
2300: 20 73 74 61 74 6c 69 6e 65 20 7b 42 79 74 65 73   statline {Bytes
2310: 20 6f 66 20 73 74 6f 72 61 67 65 20 63 6f 6e 73   of storage cons
2320: 75 6d 65 64 7d 20 24 73 74 6f 72 61 67 65 0a 20  umed} $storage. 
2330: 20 73 74 61 74 6c 69 6e 65 20 7b 42 79 74 65 73   statline {Bytes
2340: 20 6f 66 20 70 61 79 6c 6f 61 64 7d 20 24 70 61   of payload} $pa
2350: 79 6c 6f 61 64 20 24 70 61 79 6c 6f 61 64 5f 70  yload $payload_p
2360: 65 72 63 65 6e 74 0a 20 20 73 74 61 74 6c 69 6e  ercent.  statlin
2370: 65 20 7b 41 76 65 72 61 67 65 20 70 61 79 6c 6f  e {Average paylo
2380: 61 64 20 70 65 72 20 65 6e 74 72 79 7d 20 24 61  ad per entry} $a
2390: 76 67 5f 70 61 79 6c 6f 61 64 0a 20 20 73 74 61  vg_payload.  sta
23a0: 74 6c 69 6e 65 20 7b 41 76 65 72 61 67 65 20 75  tline {Average u
23b0: 6e 75 73 65 64 20 62 79 74 65 73 20 70 65 72 20  nused bytes per 
23c0: 65 6e 74 72 79 7d 20 24 61 76 67 5f 75 6e 75 73  entry} $avg_unus
23d0: 65 64 0a 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65  ed.  if {[info e
23e0: 78 69 73 74 73 20 61 76 67 5f 66 61 6e 6f 75 74  xists avg_fanout
23f0: 5d 7d 20 7b 0a 20 20 20 20 73 74 61 74 6c 69 6e  ]} {.    statlin
2400: 65 20 7b 41 76 65 72 61 67 65 20 66 61 6e 6f 75  e {Average fanou
2410: 74 7d 20 24 61 76 67 5f 66 61 6e 6f 75 74 0a 20  t} $avg_fanout. 
2420: 20 7d 0a 20 20 69 66 20 7b 24 74 6f 74 61 6c 5f   }.  if {$total_
2430: 70 61 67 65 73 3e 31 7d 20 7b 0a 20 20 20 20 73  pages>1} {.    s
2440: 65 74 20 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e  et fragmentation
2450: 20 5b 70 65 72 63 65 6e 74 20 24 67 61 70 5f 63   [percent $gap_c
2460: 6e 74 20 5b 65 78 70 72 20 7b 24 74 6f 74 61 6c  nt [expr {$total
2470: 5f 70 61 67 65 73 2d 31 7d 5d 20 7b 66 72 61 67  _pages-1}] {frag
2480: 6d 65 6e 74 61 74 69 6f 6e 7d 5d 0a 20 20 20 20  mentation}].    
2490: 73 74 61 74 6c 69 6e 65 20 7b 46 72 61 67 6d 65  statline {Fragme
24a0: 6e 74 61 74 69 6f 6e 7d 20 24 66 72 61 67 6d 65  ntation} $fragme
24b0: 6e 74 61 74 69 6f 6e 0a 20 20 7d 0a 20 20 73 74  ntation.  }.  st
24c0: 61 74 6c 69 6e 65 20 7b 4d 61 78 69 6d 75 6d 20  atline {Maximum 
24d0: 70 61 79 6c 6f 61 64 20 70 65 72 20 65 6e 74 72  payload per entr
24e0: 79 7d 20 24 6d 78 5f 70 61 79 6c 6f 61 64 0a 20  y} $mx_payload. 
24f0: 20 73 74 61 74 6c 69 6e 65 20 7b 45 6e 74 72 69   statline {Entri
2500: 65 73 20 74 68 61 74 20 75 73 65 20 6f 76 65 72  es that use over
2510: 66 6c 6f 77 7d 20 24 6f 76 66 6c 5f 63 6e 74 20  flow} $ovfl_cnt 
2520: 24 6f 76 66 6c 5f 63 6e 74 5f 70 65 72 63 65 6e  $ovfl_cnt_percen
2530: 74 0a 20 20 69 66 20 7b 24 69 6e 74 5f 70 61 67  t.  if {$int_pag
2540: 65 73 3e 30 7d 20 7b 0a 20 20 20 20 73 74 61 74  es>0} {.    stat
2550: 6c 69 6e 65 20 7b 49 6e 64 65 78 20 70 61 67 65  line {Index page
2560: 73 20 75 73 65 64 7d 20 24 69 6e 74 5f 70 61 67  s used} $int_pag
2570: 65 73 0a 20 20 7d 0a 20 20 73 74 61 74 6c 69 6e  es.  }.  statlin
2580: 65 20 7b 50 72 69 6d 61 72 79 20 70 61 67 65 73  e {Primary pages
2590: 20 75 73 65 64 7d 20 24 6c 65 61 66 5f 70 61 67   used} $leaf_pag
25a0: 65 73 0a 20 20 73 74 61 74 6c 69 6e 65 20 7b 4f  es.  statline {O
25b0: 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 75 73  verflow pages us
25c0: 65 64 7d 20 24 6f 76 66 6c 5f 70 61 67 65 73 0a  ed} $ovfl_pages.
25d0: 20 20 73 74 61 74 6c 69 6e 65 20 7b 54 6f 74 61    statline {Tota
25e0: 6c 20 70 61 67 65 73 20 75 73 65 64 7d 20 24 74  l pages used} $t
25f0: 6f 74 61 6c 5f 70 61 67 65 73 0a 20 20 69 66 20  otal_pages.  if 
2600: 7b 24 69 6e 74 5f 75 6e 75 73 65 64 3e 30 7d 20  {$int_unused>0} 
2610: 7b 0a 20 20 20 20 73 65 74 20 69 6e 74 5f 75 6e  {.    set int_un
2620: 75 73 65 64 5f 70 65 72 63 65 6e 74 20 5b 0a 20  used_percent [. 
2630: 20 20 20 20 20 20 20 20 70 65 72 63 65 6e 74 20          percent 
2640: 24 69 6e 74 5f 75 6e 75 73 65 64 20 5b 65 78 70  $int_unused [exp
2650: 72 20 7b 24 69 6e 74 5f 70 61 67 65 73 2a 24 70  r {$int_pages*$p
2660: 61 67 65 53 69 7a 65 7d 5d 20 7b 6f 66 20 69 6e  ageSize}] {of in
2670: 64 65 78 20 73 70 61 63 65 7d 5d 0a 20 20 20 20  dex space}].    
2680: 73 74 61 74 6c 69 6e 65 20 22 55 6e 75 73 65 64  statline "Unused
2690: 20 62 79 74 65 73 20 6f 6e 20 69 6e 64 65 78 20   bytes on index 
26a0: 70 61 67 65 73 22 20 24 69 6e 74 5f 75 6e 75 73  pages" $int_unus
26b0: 65 64 20 24 69 6e 74 5f 75 6e 75 73 65 64 5f 70  ed $int_unused_p
26c0: 65 72 63 65 6e 74 0a 20 20 7d 0a 20 20 73 74 61  ercent.  }.  sta
26d0: 74 6c 69 6e 65 20 22 55 6e 75 73 65 64 20 62 79  tline "Unused by
26e0: 74 65 73 20 6f 6e 20 70 72 69 6d 61 72 79 20 70  tes on primary p
26f0: 61 67 65 73 22 20 24 6c 65 61 66 5f 75 6e 75 73  ages" $leaf_unus
2700: 65 64 20 5b 0a 20 20 20 20 20 70 65 72 63 65 6e  ed [.     percen
2710: 74 20 24 6c 65 61 66 5f 75 6e 75 73 65 64 20 5b  t $leaf_unused [
2720: 65 78 70 72 20 7b 24 6c 65 61 66 5f 70 61 67 65  expr {$leaf_page
2730: 73 2a 24 70 61 67 65 53 69 7a 65 7d 5d 20 7b 6f  s*$pageSize}] {o
2740: 66 20 70 72 69 6d 61 72 79 20 73 70 61 63 65 7d  f primary space}
2750: 5d 0a 20 20 73 74 61 74 6c 69 6e 65 20 22 55 6e  ].  statline "Un
2760: 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20 6f 76  used bytes on ov
2770: 65 72 66 6c 6f 77 20 70 61 67 65 73 22 20 24 6f  erflow pages" $o
2780: 76 66 6c 5f 75 6e 75 73 65 64 20 5b 0a 20 20 20  vfl_unused [.   
2790: 20 20 70 65 72 63 65 6e 74 20 24 6f 76 66 6c 5f    percent $ovfl_
27a0: 75 6e 75 73 65 64 20 5b 65 78 70 72 20 7b 24 6f  unused [expr {$o
27b0: 76 66 6c 5f 70 61 67 65 73 2a 24 70 61 67 65 53  vfl_pages*$pageS
27c0: 69 7a 65 7d 5d 20 7b 6f 66 20 6f 76 65 72 66 6c  ize}] {of overfl
27d0: 6f 77 20 73 70 61 63 65 7d 5d 0a 20 20 73 74 61  ow space}].  sta
27e0: 74 6c 69 6e 65 20 22 55 6e 75 73 65 64 20 62 79  tline "Unused by
27f0: 74 65 73 20 6f 6e 20 61 6c 6c 20 70 61 67 65 73  tes on all pages
2800: 22 20 24 74 6f 74 61 6c 5f 75 6e 75 73 65 64 20  " $total_unused 
2810: 5b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  [.              
2820: 20 70 65 72 63 65 6e 74 20 24 74 6f 74 61 6c 5f   percent $total_
2830: 75 6e 75 73 65 64 20 24 73 74 6f 72 61 67 65 20  unused $storage 
2840: 7b 6f 66 20 61 6c 6c 20 73 70 61 63 65 7d 5d 0a  {of all space}].
2850: 20 20 72 65 74 75 72 6e 20 31 0a 7d 0a 0a 23 20    return 1.}..# 
2860: 43 61 6c 63 75 6c 61 74 65 20 74 68 65 20 6f 76  Calculate the ov
2870: 65 72 68 65 61 64 20 69 6e 20 70 61 67 65 73 20  erhead in pages 
2880: 63 61 75 73 65 64 20 62 79 20 61 75 74 6f 2d 76  caused by auto-v
2890: 61 63 75 75 6d 2e 20 0a 23 0a 23 20 54 68 69 73  acuum. .#.# This
28a0: 20 70 72 6f 63 65 64 75 72 65 20 63 61 6c 63 75   procedure calcu
28b0: 6c 61 74 65 73 20 61 6e 64 20 72 65 74 75 72 6e  lates and return
28c0: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
28d0: 70 61 67 65 73 20 75 73 65 64 20 62 79 20 74 68  pages used by th
28e0: 65 20 0a 23 20 61 75 74 6f 2d 76 61 63 75 75 6d  e .# auto-vacuum
28f0: 20 27 70 6f 69 6e 74 65 72 2d 6d 61 70 27 2e 20   'pointer-map'. 
2900: 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  If the database 
2910: 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74  does not support
2920: 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c 0a 23 20   auto-vacuum,.# 
2930: 74 68 65 6e 20 30 20 69 73 20 72 65 74 75 72 6e  then 0 is return
2940: 65 64 2e 20 54 68 65 20 74 77 6f 20 61 72 67 75  ed. The two argu
2950: 6d 65 6e 74 73 20 61 72 65 20 74 68 65 20 73 69  ments are the si
2960: 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  ze of the databa
2970: 73 65 20 66 69 6c 65 20 69 6e 0a 23 20 70 61 67  se file in.# pag
2980: 65 73 20 61 6e 64 20 74 68 65 20 70 61 67 65 20  es and the page 
2990: 73 69 7a 65 20 75 73 65 64 20 62 79 20 74 68 65  size used by the
29a0: 20 64 61 74 61 62 61 73 65 20 28 69 6e 20 62 79   database (in by
29b0: 74 65 73 29 2e 0a 70 72 6f 63 20 61 75 74 6f 76  tes)..proc autov
29c0: 61 63 75 75 6d 5f 6f 76 65 72 68 65 61 64 20 7b  acuum_overhead {
29d0: 66 69 6c 65 50 61 67 65 73 20 70 61 67 65 53 69  filePages pageSi
29e0: 7a 65 7d 20 7b 0a 0a 20 20 23 20 53 65 74 20 24  ze} {..  # Set $
29f0: 61 75 74 6f 76 61 63 75 75 6d 20 74 6f 20 6e 6f  autovacuum to no
2a00: 6e 2d 7a 65 72 6f 20 66 6f 72 20 64 61 74 61 62  n-zero for datab
2a10: 61 73 65 73 20 74 68 61 74 20 73 75 70 70 6f 72  ases that suppor
2a20: 74 20 61 75 74 6f 2d 76 61 63 75 75 6d 2e 0a 20  t auto-vacuum.. 
2a30: 20 73 65 74 20 61 75 74 6f 76 61 63 75 75 6d 20   set autovacuum 
2a40: 5b 64 62 20 6f 6e 65 20 7b 50 52 41 47 4d 41 20  [db one {PRAGMA 
2a50: 61 75 74 6f 5f 76 61 63 75 75 6d 7d 5d 0a 0a 20  auto_vacuum}].. 
2a60: 20 23 20 49 66 20 74 68 65 20 64 61 74 61 62 61   # If the databa
2a70: 73 65 20 69 73 20 6e 6f 74 20 61 6e 20 61 75 74  se is not an aut
2a80: 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73  o-vacuum databas
2a90: 65 20 6f 72 20 74 68 65 20 66 69 6c 65 20 63 6f  e or the file co
2aa0: 6e 73 69 73 74 73 0a 20 20 23 20 6f 66 20 6f 6e  nsists.  # of on
2ab0: 65 20 70 61 67 65 20 6f 6e 6c 79 20 74 68 65 6e  e page only then
2ac0: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6f 76 65   there is no ove
2ad0: 72 68 65 61 64 20 66 6f 72 20 61 75 74 6f 2d 76  rhead for auto-v
2ae0: 61 63 75 75 6d 2e 20 52 65 74 75 72 6e 20 7a 65  acuum. Return ze
2af0: 72 6f 2e 0a 20 20 69 66 20 7b 30 3d 3d 24 61 75  ro..  if {0==$au
2b00: 74 6f 76 61 63 75 75 6d 20 7c 7c 20 24 66 69 6c  tovacuum || $fil
2b10: 65 50 61 67 65 73 3d 3d 31 7d 20 7b 0a 20 20 20  ePages==1} {.   
2b20: 20 72 65 74 75 72 6e 20 30 0a 20 20 7d 0a 0a 20   return 0.  }.. 
2b30: 20 23 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66   # The number of
2b40: 20 65 6e 74 72 69 65 73 20 6f 6e 20 65 61 63 68   entries on each
2b50: 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67   pointer map pag
2b60: 65 2e 20 54 68 65 20 6c 61 79 6f 75 74 20 6f 66  e. The layout of
2b70: 20 74 68 65 0a 20 20 23 20 64 61 74 61 62 61 73   the.  # databas
2b80: 65 20 66 69 6c 65 20 69 73 20 6f 6e 65 20 70 6f  e file is one po
2b90: 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 2c 20  inter-map page, 
2ba0: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 24 70 74 72  followed by $ptr
2bb0: 73 50 65 72 50 61 67 65 20 6f 74 68 65 72 0a 20  sPerPage other. 
2bc0: 20 23 20 70 61 67 65 73 2c 20 66 6f 6c 6c 6f 77   # pages, follow
2bd0: 65 64 20 62 79 20 61 20 70 6f 69 6e 74 65 72 2d  ed by a pointer-
2be0: 6d 61 70 20 70 61 67 65 20 65 74 63 2e 20 54 68  map page etc. Th
2bf0: 65 20 66 69 72 73 74 20 70 6f 69 6e 74 65 72 2d  e first pointer-
2c00: 6d 61 70 20 70 61 67 65 0a 20 20 23 20 69 73 20  map page.  # is 
2c10: 74 68 65 20 73 65 63 6f 6e 64 20 70 61 67 65 20  the second page 
2c20: 6f 66 20 74 68 65 20 66 69 6c 65 20 6f 76 65 72  of the file over
2c30: 61 6c 6c 2e 0a 20 20 73 65 74 20 70 74 72 73 50  all..  set ptrsP
2c40: 65 72 50 61 67 65 20 5b 65 78 70 72 20 64 6f 75  erPage [expr dou
2c50: 62 6c 65 28 24 70 61 67 65 53 69 7a 65 2f 35 29  ble($pageSize/5)
2c60: 5d 0a 0a 20 20 23 20 52 65 74 75 72 6e 20 74 68  ]..  # Return th
2c70: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e  e number of poin
2c80: 74 65 72 20 6d 61 70 20 70 61 67 65 73 20 69 6e  ter map pages in
2c90: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 20   the database.. 
2ca0: 20 72 65 74 75 72 6e 20 5b 65 78 70 72 20 69 6e   return [expr in
2cb0: 74 28 63 65 69 6c 28 20 28 24 66 69 6c 65 50 61  t(ceil( ($filePa
2cc0: 67 65 73 2d 31 2e 30 29 2f 28 24 70 74 72 73 50  ges-1.0)/($ptrsP
2cd0: 65 72 50 61 67 65 2b 31 2e 30 29 20 29 29 5d 0a  erPage+1.0) ))].
2ce0: 7d 0a 0a 0a 23 20 43 61 6c 63 75 6c 61 74 65 20  }...# Calculate 
2cf0: 74 68 65 20 73 75 6d 6d 61 72 79 20 73 74 61 74  the summary stat
2d00: 69 73 74 69 63 73 20 66 6f 72 20 74 68 65 20 64  istics for the d
2d10: 61 74 61 62 61 73 65 20 61 6e 64 20 73 74 6f 72  atabase and stor
2d20: 65 20 74 68 65 20 72 65 73 75 6c 74 73 0a 23 20  e the results.# 
2d30: 69 6e 20 54 43 4c 20 76 61 72 69 61 62 6c 65 73  in TCL variables
2d40: 2e 20 54 68 65 79 20 61 72 65 20 6f 75 74 70 75  . They are outpu
2d50: 74 20 62 65 6c 6f 77 2e 20 56 61 72 69 61 62 6c  t below. Variabl
2d60: 65 73 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77  es are as follow
2d70: 73 3a 0a 23 0a 23 20 70 61 67 65 53 69 7a 65 3a  s:.#.# pageSize:
2d80: 20 20 20 20 20 20 53 69 7a 65 20 6f 66 20 65 61        Size of ea
2d90: 63 68 20 70 61 67 65 20 69 6e 20 62 79 74 65 73  ch page in bytes
2da0: 2e 0a 23 20 66 69 6c 65 5f 62 79 74 65 73 3a 20  ..# file_bytes: 
2db0: 20 20 20 46 69 6c 65 20 73 69 7a 65 20 69 6e 20     File size in 
2dc0: 62 79 74 65 73 2e 0a 23 20 66 69 6c 65 5f 70 67  bytes..# file_pg
2dd0: 63 6e 74 3a 20 20 20 20 4e 75 6d 62 65 72 20 6f  cnt:    Number o
2de0: 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 66  f pages in the f
2df0: 69 6c 65 2e 0a 23 20 66 69 6c 65 5f 70 67 63 6e  ile..# file_pgcn
2e00: 74 32 3a 20 20 20 4e 75 6d 62 65 72 20 6f 66 20  t2:   Number of 
2e10: 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 69 6c  pages in the fil
2e20: 65 20 28 63 61 6c 63 75 6c 61 74 65 64 29 2e 0a  e (calculated)..
2e30: 23 20 61 76 5f 70 67 63 6e 74 3a 20 20 20 20 20  # av_pgcnt:     
2e40: 20 50 61 67 65 73 20 63 6f 6e 73 75 6d 65 64 20   Pages consumed 
2e50: 62 79 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75  by the auto-vacu
2e60: 75 6d 20 70 6f 69 6e 74 65 72 2d 6d 61 70 2e 0a  um pointer-map..
2e70: 23 20 61 76 5f 70 65 72 63 65 6e 74 3a 20 20 20  # av_percent:   
2e80: 20 50 65 72 63 65 6e 74 61 67 65 20 6f 66 20 74   Percentage of t
2e90: 68 65 20 66 69 6c 65 20 63 6f 6e 73 75 6d 65 64  he file consumed
2ea0: 20 62 79 20 61 75 74 6f 2d 76 61 63 75 75 6d 20   by auto-vacuum 
2eb0: 70 6f 69 6e 74 65 72 2d 6d 61 70 2e 0a 23 20 69  pointer-map..# i
2ec0: 6e 75 73 65 5f 70 67 63 6e 74 3a 20 20 20 44 61  nuse_pgcnt:   Da
2ed0: 74 61 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  ta pages in the 
2ee0: 66 69 6c 65 2e 0a 23 20 69 6e 75 73 65 5f 70 65  file..# inuse_pe
2ef0: 72 63 65 6e 74 3a 20 50 65 72 63 65 6e 74 61 67  rcent: Percentag
2f00: 65 20 6f 66 20 70 61 67 65 73 20 75 73 65 64 20  e of pages used 
2f10: 74 6f 20 73 74 6f 72 65 20 64 61 74 61 2e 0a 23  to store data..#
2f20: 20 66 72 65 65 5f 70 67 63 6e 74 3a 20 20 20 20   free_pgcnt:    
2f30: 46 72 65 65 20 70 61 67 65 73 20 63 61 6c 63 75  Free pages calcu
2f40: 6c 61 74 65 64 20 61 73 20 28 3c 74 6f 74 61 6c  lated as (<total
2f50: 20 70 61 67 65 73 3e 20 2d 20 3c 69 6e 2d 75 73   pages> - <in-us
2f60: 65 20 70 61 67 65 73 3e 29 0a 23 20 66 72 65 65  e pages>).# free
2f70: 5f 70 67 63 6e 74 32 3a 20 20 20 46 72 65 65 20  _pgcnt2:   Free 
2f80: 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 69 6c  pages in the fil
2f90: 65 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74  e according to t
2fa0: 68 65 20 66 69 6c 65 20 68 65 61 64 65 72 2e 0a  he file header..
2fb0: 23 20 66 72 65 65 5f 70 65 72 63 65 6e 74 3a 20  # free_percent: 
2fc0: 20 50 65 72 63 65 6e 74 61 67 65 20 6f 66 20 66   Percentage of f
2fd0: 69 6c 65 20 63 6f 6e 73 75 6d 65 64 20 62 79 20  ile consumed by 
2fe0: 66 72 65 65 20 70 61 67 65 73 20 28 63 61 6c 63  free pages (calc
2ff0: 75 6c 61 74 65 64 29 2e 0a 23 20 66 72 65 65 5f  ulated)..# free_
3000: 70 65 72 63 65 6e 74 32 3a 20 50 65 72 63 65 6e  percent2: Percen
3010: 74 61 67 65 20 6f 66 20 66 69 6c 65 20 63 6f 6e  tage of file con
3020: 73 75 6d 65 64 20 62 79 20 66 72 65 65 20 70 61  sumed by free pa
3030: 67 65 73 20 28 68 65 61 64 65 72 29 2e 0a 23 20  ges (header)..# 
3040: 6e 74 61 62 6c 65 3a 20 20 20 20 20 20 20 20 4e  ntable:        N
3050: 75 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 73 20  umber of tables 
3060: 69 6e 20 74 68 65 20 64 62 2e 0a 23 20 6e 69 6e  in the db..# nin
3070: 64 65 78 3a 20 20 20 20 20 20 20 20 4e 75 6d 62  dex:        Numb
3080: 65 72 20 6f 66 20 69 6e 64 69 63 65 73 20 69 6e  er of indices in
3090: 20 74 68 65 20 64 62 2e 0a 23 20 6e 61 75 74 6f   the db..# nauto
30a0: 69 6e 64 65 78 3a 20 20 20 20 4e 75 6d 62 65 72  index:    Number
30b0: 20 6f 66 20 69 6e 64 69 63 65 73 20 63 72 65 61   of indices crea
30c0: 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  ted automaticall
30d0: 79 2e 0a 23 20 6e 6d 61 6e 69 6e 64 65 78 3a 20  y..# nmanindex: 
30e0: 20 20 20 20 4e 75 6d 62 65 72 20 6f 66 20 69 6e      Number of in
30f0: 64 69 63 65 73 20 63 72 65 61 74 65 64 20 6d 61  dices created ma
3100: 6e 75 61 6c 6c 79 2e 0a 23 20 75 73 65 72 5f 70  nually..# user_p
3110: 61 79 6c 6f 61 64 3a 20 20 4e 75 6d 62 65 72 20  ayload:  Number 
3120: 6f 66 20 62 79 74 65 73 20 6f 66 20 70 61 79 6c  of bytes of payl
3130: 6f 61 64 20 69 6e 20 74 61 62 6c 65 20 62 74 72  oad in table btr
3140: 65 65 73 20 0a 23 20 20 20 20 20 20 20 20 20 20  ees .#          
3150: 20 20 20 20 20 20 28 6e 6f 74 20 69 6e 63 6c 75        (not inclu
3160: 64 69 6e 67 20 73 71 6c 69 74 65 5f 6d 61 73 74  ding sqlite_mast
3170: 65 72 29 0a 23 20 75 73 65 72 5f 70 65 72 63 65  er).# user_perce
3180: 6e 74 3a 20 20 24 75 73 65 72 5f 70 61 79 6c 6f  nt:  $user_paylo
3190: 61 64 20 61 73 20 61 20 70 65 72 63 65 6e 74 61  ad as a percenta
31a0: 67 65 20 6f 66 20 74 6f 74 61 6c 20 66 69 6c 65  ge of total file
31b0: 20 73 69 7a 65 2e 0a 0a 73 65 74 20 66 69 6c 65   size...set file
31c0: 5f 62 79 74 65 73 20 20 5b 66 69 6c 65 20 73 69  _bytes  [file si
31d0: 7a 65 20 24 66 69 6c 65 5f 74 6f 5f 61 6e 61 6c  ze $file_to_anal
31e0: 79 7a 65 5d 0a 73 65 74 20 66 69 6c 65 5f 70 67  yze].set file_pg
31f0: 63 6e 74 20 20 5b 65 78 70 72 20 7b 24 66 69 6c  cnt  [expr {$fil
3200: 65 5f 62 79 74 65 73 2f 24 70 61 67 65 53 69 7a  e_bytes/$pageSiz
3210: 65 7d 5d 0a 0a 73 65 74 20 61 76 5f 70 67 63 6e  e}]..set av_pgcn
3220: 74 20 20 20 20 5b 61 75 74 6f 76 61 63 75 75 6d  t    [autovacuum
3230: 5f 6f 76 65 72 68 65 61 64 20 24 66 69 6c 65 5f  _overhead $file_
3240: 70 67 63 6e 74 20 24 70 61 67 65 53 69 7a 65 5d  pgcnt $pageSize]
3250: 0a 73 65 74 20 61 76 5f 70 65 72 63 65 6e 74 20  .set av_percent 
3260: 20 5b 70 65 72 63 65 6e 74 20 24 61 76 5f 70 67   [percent $av_pg
3270: 63 6e 74 20 24 66 69 6c 65 5f 70 67 63 6e 74 5d  cnt $file_pgcnt]
3280: 0a 0a 73 65 74 20 73 71 6c 20 7b 53 45 4c 45 43  ..set sql {SELEC
3290: 54 20 73 75 6d 28 6c 65 61 66 5f 70 61 67 65 73  T sum(leaf_pages
32a0: 2b 69 6e 74 5f 70 61 67 65 73 2b 6f 76 66 6c 5f  +int_pages+ovfl_
32b0: 70 61 67 65 73 29 20 46 52 4f 4d 20 73 70 61 63  pages) FROM spac
32c0: 65 5f 75 73 65 64 7d 0a 73 65 74 20 69 6e 75 73  e_used}.set inus
32d0: 65 5f 70 67 63 6e 74 20 20 20 5b 65 78 70 72 20  e_pgcnt   [expr 
32e0: 69 6e 74 28 5b 6d 65 6d 20 65 76 61 6c 20 24 73  int([mem eval $s
32f0: 71 6c 5d 29 5d 0a 73 65 74 20 69 6e 75 73 65 5f  ql])].set inuse_
3300: 70 65 72 63 65 6e 74 20 5b 70 65 72 63 65 6e 74  percent [percent
3310: 20 24 69 6e 75 73 65 5f 70 67 63 6e 74 20 24 66   $inuse_pgcnt $f
3320: 69 6c 65 5f 70 67 63 6e 74 5d 0a 0a 73 65 74 20  ile_pgcnt]..set 
3330: 66 72 65 65 5f 70 67 63 6e 74 20 20 20 20 5b 65  free_pgcnt    [e
3340: 78 70 72 20 24 66 69 6c 65 5f 70 67 63 6e 74 2d  xpr $file_pgcnt-
3350: 24 69 6e 75 73 65 5f 70 67 63 6e 74 2d 24 61 76  $inuse_pgcnt-$av
3360: 5f 70 67 63 6e 74 5d 0a 73 65 74 20 66 72 65 65  _pgcnt].set free
3370: 5f 70 65 72 63 65 6e 74 20 20 5b 70 65 72 63 65  _percent  [perce
3380: 6e 74 20 24 66 72 65 65 5f 70 67 63 6e 74 20 24  nt $free_pgcnt $
3390: 66 69 6c 65 5f 70 67 63 6e 74 5d 0a 73 65 74 20  file_pgcnt].set 
33a0: 66 72 65 65 5f 70 67 63 6e 74 32 20 20 20 5b 64  free_pgcnt2   [d
33b0: 62 20 6f 6e 65 20 7b 50 52 41 47 4d 41 20 66 72  b one {PRAGMA fr
33c0: 65 65 6c 69 73 74 5f 63 6f 75 6e 74 7d 5d 0a 73  eelist_count}].s
33d0: 65 74 20 66 72 65 65 5f 70 65 72 63 65 6e 74 32  et free_percent2
33e0: 20 5b 70 65 72 63 65 6e 74 20 24 66 72 65 65 5f   [percent $free_
33f0: 70 67 63 6e 74 32 20 24 66 69 6c 65 5f 70 67 63  pgcnt2 $file_pgc
3400: 6e 74 5d 0a 0a 73 65 74 20 66 69 6c 65 5f 70 67  nt]..set file_pg
3410: 63 6e 74 32 20 5b 65 78 70 72 20 7b 24 69 6e 75  cnt2 [expr {$inu
3420: 73 65 5f 70 67 63 6e 74 2b 24 66 72 65 65 5f 70  se_pgcnt+$free_p
3430: 67 63 6e 74 32 2b 24 61 76 5f 70 67 63 6e 74 7d  gcnt2+$av_pgcnt}
3440: 5d 0a 0a 73 65 74 20 6e 74 61 62 6c 65 20 5b 64  ]..set ntable [d
3450: 62 20 65 76 61 6c 20 7b 53 45 4c 45 43 54 20 63  b eval {SELECT c
3460: 6f 75 6e 74 28 2a 29 2b 31 20 46 52 4f 4d 20 73  ount(*)+1 FROM s
3470: 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 57 48 45  qlite_master WHE
3480: 52 45 20 74 79 70 65 3d 27 74 61 62 6c 65 27 7d  RE type='table'}
3490: 5d 0a 73 65 74 20 6e 69 6e 64 65 78 20 5b 64 62  ].set nindex [db
34a0: 20 65 76 61 6c 20 7b 53 45 4c 45 43 54 20 63 6f   eval {SELECT co
34b0: 75 6e 74 28 2a 29 20 46 52 4f 4d 20 73 71 6c 69  unt(*) FROM sqli
34c0: 74 65 5f 6d 61 73 74 65 72 20 57 48 45 52 45 20  te_master WHERE 
34d0: 74 79 70 65 3d 27 69 6e 64 65 78 27 7d 5d 0a 73  type='index'}].s
34e0: 65 74 20 73 71 6c 20 7b 53 45 4c 45 43 54 20 63  et sql {SELECT c
34f0: 6f 75 6e 74 28 2a 29 20 46 52 4f 4d 20 73 71 6c  ount(*) FROM sql
3500: 69 74 65 5f 6d 61 73 74 65 72 20 57 48 45 52 45  ite_master WHERE
3510: 20 6e 61 6d 65 20 4c 49 4b 45 20 27 73 71 6c 69   name LIKE 'sqli
3520: 74 65 5f 61 75 74 6f 69 6e 64 65 78 25 27 7d 0a  te_autoindex%'}.
3530: 73 65 74 20 6e 61 75 74 6f 69 6e 64 65 78 20 5b  set nautoindex [
3540: 64 62 20 65 76 61 6c 20 24 73 71 6c 5d 0a 73 65  db eval $sql].se
3550: 74 20 6e 6d 61 6e 69 6e 64 65 78 20 5b 65 78 70  t nmanindex [exp
3560: 72 20 7b 24 6e 69 6e 64 65 78 2d 24 6e 61 75 74  r {$nindex-$naut
3570: 6f 69 6e 64 65 78 7d 5d 0a 0a 23 20 73 65 74 20  oindex}]..# set 
3580: 74 6f 74 61 6c 5f 70 61 79 6c 6f 61 64 20 5b 6d  total_payload [m
3590: 65 6d 20 65 76 61 6c 20 22 53 45 4c 45 43 54 20  em eval "SELECT 
35a0: 73 75 6d 28 70 61 79 6c 6f 61 64 29 20 46 52 4f  sum(payload) FRO
35b0: 4d 20 73 70 61 63 65 5f 75 73 65 64 22 5d 0a 73  M space_used"].s
35c0: 65 74 20 75 73 65 72 5f 70 61 79 6c 6f 61 64 20  et user_payload 
35d0: 5b 6d 65 6d 20 6f 6e 65 20 7b 53 45 4c 45 43 54  [mem one {SELECT
35e0: 20 69 6e 74 28 73 75 6d 28 70 61 79 6c 6f 61 64   int(sum(payload
35f0: 29 29 20 46 52 4f 4d 20 73 70 61 63 65 5f 75 73  )) FROM space_us
3600: 65 64 0a 20 20 20 20 20 57 48 45 52 45 20 4e 4f  ed.     WHERE NO
3610: 54 20 69 73 5f 69 6e 64 65 78 20 41 4e 44 20 6e  T is_index AND n
3620: 61 6d 65 20 4e 4f 54 20 4c 49 4b 45 20 27 73 71  ame NOT LIKE 'sq
3630: 6c 69 74 65 5f 6d 61 73 74 65 72 27 7d 5d 0a 73  lite_master'}].s
3640: 65 74 20 75 73 65 72 5f 70 65 72 63 65 6e 74 20  et user_percent 
3650: 5b 70 65 72 63 65 6e 74 20 24 75 73 65 72 5f 70  [percent $user_p
3660: 61 79 6c 6f 61 64 20 24 66 69 6c 65 5f 62 79 74  ayload $file_byt
3670: 65 73 5d 0a 0a 23 20 4f 75 74 70 75 74 20 74 68  es]..# Output th
3680: 65 20 73 75 6d 6d 61 72 79 20 73 74 61 74 69 73  e summary statis
3690: 74 69 63 73 20 63 61 6c 63 75 6c 61 74 65 64 20  tics calculated 
36a0: 61 62 6f 76 65 2e 0a 23 0a 70 75 74 73 20 22 2f  above..#.puts "/
36b0: 2a 2a 20 44 69 73 6b 2d 53 70 61 63 65 20 55 74  ** Disk-Space Ut
36c0: 69 6c 69 7a 61 74 69 6f 6e 20 52 65 70 6f 72 74  ilization Report
36d0: 20 46 6f 72 20 24 66 69 6c 65 5f 74 6f 5f 61 6e   For $file_to_an
36e0: 61 6c 79 7a 65 22 0a 63 61 74 63 68 20 7b 0a 20  alyze".catch {. 
36f0: 20 70 75 74 73 20 22 2a 2a 2a 20 41 73 20 6f 66   puts "*** As of
3700: 20 5b 63 6c 6f 63 6b 20 66 6f 72 6d 61 74 20 5b   [clock format [
3710: 63 6c 6f 63 6b 20 73 65 63 6f 6e 64 73 5d 20 2d  clock seconds] -
3720: 66 6f 72 6d 61 74 20 7b 25 59 2d 25 62 2d 25 64  format {%Y-%b-%d
3730: 20 25 48 3a 25 4d 3a 25 53 7d 5d 22 0a 7d 0a 70   %H:%M:%S}]".}.p
3740: 75 74 73 20 22 22 0a 73 74 61 74 6c 69 6e 65 20  uts "".statline 
3750: 7b 50 61 67 65 20 73 69 7a 65 20 69 6e 20 62 79  {Page size in by
3760: 74 65 73 7d 20 24 70 61 67 65 53 69 7a 65 0a 73  tes} $pageSize.s
3770: 74 61 74 6c 69 6e 65 20 7b 50 61 67 65 73 20 69  tatline {Pages i
3780: 6e 20 74 68 65 20 77 68 6f 6c 65 20 66 69 6c 65  n the whole file
3790: 20 28 6d 65 61 73 75 72 65 64 29 7d 20 24 66 69   (measured)} $fi
37a0: 6c 65 5f 70 67 63 6e 74 0a 73 74 61 74 6c 69 6e  le_pgcnt.statlin
37b0: 65 20 7b 50 61 67 65 73 20 69 6e 20 74 68 65 20  e {Pages in the 
37c0: 77 68 6f 6c 65 20 66 69 6c 65 20 28 63 61 6c 63  whole file (calc
37d0: 75 6c 61 74 65 64 29 7d 20 24 66 69 6c 65 5f 70  ulated)} $file_p
37e0: 67 63 6e 74 32 0a 73 74 61 74 6c 69 6e 65 20 7b  gcnt2.statline {
37f0: 50 61 67 65 73 20 74 68 61 74 20 73 74 6f 72 65  Pages that store
3800: 20 64 61 74 61 7d 20 24 69 6e 75 73 65 5f 70 67   data} $inuse_pg
3810: 63 6e 74 20 24 69 6e 75 73 65 5f 70 65 72 63 65  cnt $inuse_perce
3820: 6e 74 0a 73 74 61 74 6c 69 6e 65 20 7b 50 61 67  nt.statline {Pag
3830: 65 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69  es on the freeli
3840: 73 74 20 28 70 65 72 20 68 65 61 64 65 72 29 7d  st (per header)}
3850: 20 24 66 72 65 65 5f 70 67 63 6e 74 32 20 24 66   $free_pgcnt2 $f
3860: 72 65 65 5f 70 65 72 63 65 6e 74 32 0a 73 74 61  ree_percent2.sta
3870: 74 6c 69 6e 65 20 7b 50 61 67 65 73 20 6f 6e 20  tline {Pages on 
3880: 74 68 65 20 66 72 65 65 6c 69 73 74 20 28 63 61  the freelist (ca
3890: 6c 63 75 6c 61 74 65 64 29 7d 20 24 66 72 65 65  lculated)} $free
38a0: 5f 70 67 63 6e 74 20 24 66 72 65 65 5f 70 65 72  _pgcnt $free_per
38b0: 63 65 6e 74 0a 73 74 61 74 6c 69 6e 65 20 7b 50  cent.statline {P
38c0: 61 67 65 73 20 6f 66 20 61 75 74 6f 2d 76 61 63  ages of auto-vac
38d0: 75 75 6d 20 6f 76 65 72 68 65 61 64 7d 20 24 61  uum overhead} $a
38e0: 76 5f 70 67 63 6e 74 20 24 61 76 5f 70 65 72 63  v_pgcnt $av_perc
38f0: 65 6e 74 0a 73 74 61 74 6c 69 6e 65 20 7b 4e 75  ent.statline {Nu
3900: 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 73 20 69  mber of tables i
3910: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 7d 20  n the database} 
3920: 24 6e 74 61 62 6c 65 0a 73 74 61 74 6c 69 6e 65  $ntable.statline
3930: 20 7b 4e 75 6d 62 65 72 20 6f 66 20 69 6e 64 69   {Number of indi
3940: 63 65 73 7d 20 24 6e 69 6e 64 65 78 0a 73 74 61  ces} $nindex.sta
3950: 74 6c 69 6e 65 20 7b 4e 75 6d 62 65 72 20 6f 66  tline {Number of
3960: 20 6e 61 6d 65 64 20 69 6e 64 69 63 65 73 7d 20   named indices} 
3970: 24 6e 6d 61 6e 69 6e 64 65 78 0a 73 74 61 74 6c  $nmanindex.statl
3980: 69 6e 65 20 7b 41 75 74 6f 6d 61 74 69 63 61 6c  ine {Automatical
3990: 6c 79 20 67 65 6e 65 72 61 74 65 64 20 69 6e 64  ly generated ind
39a0: 69 63 65 73 7d 20 24 6e 61 75 74 6f 69 6e 64 65  ices} $nautoinde
39b0: 78 0a 73 74 61 74 6c 69 6e 65 20 7b 53 69 7a 65  x.statline {Size
39c0: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e 20   of the file in 
39d0: 62 79 74 65 73 7d 20 24 66 69 6c 65 5f 62 79 74  bytes} $file_byt
39e0: 65 73 0a 73 74 61 74 6c 69 6e 65 20 7b 42 79 74  es.statline {Byt
39f0: 65 73 20 6f 66 20 75 73 65 72 20 70 61 79 6c 6f  es of user paylo
3a00: 61 64 20 73 74 6f 72 65 64 7d 20 24 75 73 65 72  ad stored} $user
3a10: 5f 70 61 79 6c 6f 61 64 20 24 75 73 65 72 5f 70  _payload $user_p
3a20: 65 72 63 65 6e 74 0a 0a 23 20 4f 75 74 70 75 74  ercent..# Output
3a30: 20 74 61 62 6c 65 20 72 61 6e 6b 69 6e 67 73 0a   table rankings.
3a40: 23 0a 70 75 74 73 20 22 22 0a 70 75 74 73 20 22  #.puts "".puts "
3a50: 2a 2a 2a 20 50 61 67 65 20 63 6f 75 6e 74 73 20  *** Page counts 
3a60: 66 6f 72 20 61 6c 6c 20 74 61 62 6c 65 73 20 77  for all tables w
3a70: 69 74 68 20 74 68 65 69 72 20 69 6e 64 69 63 65  ith their indice
3a80: 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  s **************
3a90: 2a 2a 2a 2a 2a 2a 22 0a 70 75 74 73 20 22 22 0a  ******".puts "".
3aa0: 6d 65 6d 20 65 76 61 6c 20 7b 53 45 4c 45 43 54  mem eval {SELECT
3ab0: 20 74 62 6c 6e 61 6d 65 2c 20 63 6f 75 6e 74 28   tblname, count(
3ac0: 2a 29 20 41 53 20 63 6e 74 2c 20 0a 20 20 20 20  *) AS cnt, .    
3ad0: 20 20 20 20 20 20 20 20 20 20 69 6e 74 28 73 75            int(su
3ae0: 6d 28 69 6e 74 5f 70 61 67 65 73 2b 6c 65 61 66  m(int_pages+leaf
3af0: 5f 70 61 67 65 73 2b 6f 76 66 6c 5f 70 61 67 65  _pages+ovfl_page
3b00: 73 29 29 20 41 53 20 73 69 7a 65 0a 20 20 20 20  s)) AS size.    
3b10: 20 20 20 20 20 20 46 52 4f 4d 20 73 70 61 63 65        FROM space
3b20: 5f 75 73 65 64 20 47 52 4f 55 50 20 42 59 20 74  _used GROUP BY t
3b30: 62 6c 6e 61 6d 65 20 4f 52 44 45 52 20 42 59 20  blname ORDER BY 
3b40: 73 69 7a 65 2b 30 20 44 45 53 43 2c 20 74 62 6c  size+0 DESC, tbl
3b50: 6e 61 6d 65 7d 20 7b 7d 20 7b 0a 20 20 73 74 61  name} {} {.  sta
3b60: 74 6c 69 6e 65 20 5b 73 74 72 69 6e 67 20 74 6f  tline [string to
3b70: 75 70 70 65 72 20 24 74 62 6c 6e 61 6d 65 5d 20  upper $tblname] 
3b80: 24 73 69 7a 65 20 5b 70 65 72 63 65 6e 74 20 24  $size [percent $
3b90: 73 69 7a 65 20 24 66 69 6c 65 5f 70 67 63 6e 74  size $file_pgcnt
3ba0: 5d 0a 7d 0a 0a 23 20 4f 75 74 70 75 74 20 73 75  ].}..# Output su
3bb0: 62 72 65 70 6f 72 74 73 0a 23 0a 69 66 20 7b 24  breports.#.if {$
3bc0: 6e 69 6e 64 65 78 3e 30 7d 20 7b 0a 20 20 73 75  nindex>0} {.  su
3bd0: 62 72 65 70 6f 72 74 20 7b 41 6c 6c 20 74 61 62  breport {All tab
3be0: 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 73 7d  les and indices}
3bf0: 20 31 0a 7d 0a 73 75 62 72 65 70 6f 72 74 20 7b   1.}.subreport {
3c00: 41 6c 6c 20 74 61 62 6c 65 73 7d 20 7b 4e 4f 54  All tables} {NOT
3c10: 20 69 73 5f 69 6e 64 65 78 7d 0a 69 66 20 7b 24   is_index}.if {$
3c20: 6e 69 6e 64 65 78 3e 30 7d 20 7b 0a 20 20 73 75  nindex>0} {.  su
3c30: 62 72 65 70 6f 72 74 20 7b 41 6c 6c 20 69 6e 64  breport {All ind
3c40: 69 63 65 73 7d 20 7b 69 73 5f 69 6e 64 65 78 7d  ices} {is_index}
3c50: 0a 7d 0a 66 6f 72 65 61 63 68 20 74 62 6c 20 5b  .}.foreach tbl [
3c60: 6d 65 6d 20 65 76 61 6c 20 7b 53 45 4c 45 43 54  mem eval {SELECT
3c70: 20 6e 61 6d 65 20 46 52 4f 4d 20 73 70 61 63 65   name FROM space
3c80: 5f 75 73 65 64 20 57 48 45 52 45 20 4e 4f 54 20  _used WHERE NOT 
3c90: 69 73 5f 69 6e 64 65 78 0a 20 20 20 20 20 20 20  is_index.       
3ca0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3cb0: 4f 52 44 45 52 20 42 59 20 6e 61 6d 65 7d 5d 20  ORDER BY name}] 
3cc0: 7b 0a 20 20 72 65 67 73 75 62 20 27 20 24 74 62  {.  regsub ' $tb
3cd0: 6c 20 27 27 20 71 6e 0a 20 20 73 65 74 20 6e 61  l '' qn.  set na
3ce0: 6d 65 20 5b 73 74 72 69 6e 67 20 74 6f 75 70 70  me [string toupp
3cf0: 65 72 20 24 74 62 6c 5d 0a 20 20 73 65 74 20 6e  er $tbl].  set n
3d00: 20 5b 6d 65 6d 20 65 76 61 6c 20 22 53 45 4c 45   [mem eval "SELE
3d10: 43 54 20 63 6f 75 6e 74 28 2a 29 20 46 52 4f 4d  CT count(*) FROM
3d20: 20 73 70 61 63 65 5f 75 73 65 64 20 57 48 45 52   space_used WHER
3d30: 45 20 74 62 6c 6e 61 6d 65 3d 27 24 71 6e 27 22  E tblname='$qn'"
3d40: 5d 0a 20 20 69 66 20 7b 24 6e 3e 31 7d 20 7b 0a  ].  if {$n>1} {.
3d50: 20 20 20 20 73 75 62 72 65 70 6f 72 74 20 22 54      subreport "T
3d60: 61 62 6c 65 20 24 6e 61 6d 65 20 61 6e 64 20 61  able $name and a
3d70: 6c 6c 20 69 74 73 20 69 6e 64 69 63 65 73 22 20  ll its indices" 
3d80: 22 74 62 6c 6e 61 6d 65 3d 27 24 71 6e 27 22 0a  "tblname='$qn'".
3d90: 20 20 20 20 73 75 62 72 65 70 6f 72 74 20 22 54      subreport "T
3da0: 61 62 6c 65 20 24 6e 61 6d 65 20 77 2f 6f 20 61  able $name w/o a
3db0: 6e 79 20 69 6e 64 69 63 65 73 22 20 22 6e 61 6d  ny indices" "nam
3dc0: 65 3d 27 24 71 6e 27 22 0a 20 20 20 20 73 75 62  e='$qn'".    sub
3dd0: 72 65 70 6f 72 74 20 22 49 6e 64 69 63 65 73 20  report "Indices 
3de0: 6f 66 20 74 61 62 6c 65 20 24 6e 61 6d 65 22 20  of table $name" 
3df0: 22 74 62 6c 6e 61 6d 65 3d 27 24 71 6e 27 20 41  "tblname='$qn' A
3e00: 4e 44 20 69 73 5f 69 6e 64 65 78 22 0a 20 20 7d  ND is_index".  }
3e10: 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 75 62 72   else {.    subr
3e20: 65 70 6f 72 74 20 22 54 61 62 6c 65 20 24 6e 61  eport "Table $na
3e30: 6d 65 22 20 22 6e 61 6d 65 3d 27 24 71 6e 27 22  me" "name='$qn'"
3e40: 0a 20 20 7d 0a 7d 0a 0a 23 20 4f 75 74 70 75 74  .  }.}..# Output
3e50: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 6f 6e   instructions on
3e60: 20 77 68 61 74 20 74 68 65 20 6e 75 6d 62 65 72   what the number
3e70: 73 20 61 62 6f 76 65 20 6d 65 61 6e 2e 0a 23 0a  s above mean..#.
3e80: 70 75 74 73 20 7b 0a 2a 2a 2a 20 44 65 66 69 6e  puts {.*** Defin
3e90: 69 74 69 6f 6e 73 20 2a 2a 2a 2a 2a 2a 2a 2a 2a  itions *********
3ea0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3eb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3ec0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 50  *************..P
3ed0: 61 67 65 20 73 69 7a 65 20 69 6e 20 62 79 74 65  age size in byte
3ee0: 73 0a 0a 20 20 20 20 54 68 65 20 6e 75 6d 62 65  s..    The numbe
3ef0: 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 61 20  r of bytes in a 
3f00: 73 69 6e 67 6c 65 20 70 61 67 65 20 6f 66 20 74  single page of t
3f10: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
3f20: 2e 20 20 0a 20 20 20 20 55 73 75 61 6c 6c 79 20  .  .    Usually 
3f30: 31 30 32 34 2e 0a 0a 4e 75 6d 62 65 72 20 6f 66  1024...Number of
3f40: 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 77 68   pages in the wh
3f50: 6f 6c 65 20 66 69 6c 65 0a 7d 0a 70 75 74 73 20  ole file.}.puts 
3f60: 22 20 20 20 20 54 68 65 20 6e 75 6d 62 65 72 20  "    The number 
3f70: 6f 66 20 24 70 61 67 65 53 69 7a 65 2d 62 79 74  of $pageSize-byt
3f80: 65 20 70 61 67 65 73 20 74 68 61 74 20 67 6f 20  e pages that go 
3f90: 69 6e 74 6f 20 66 6f 72 6d 69 6e 67 20 74 68 65  into forming the
3fa0: 20 63 6f 6d 70 6c 65 74 65 0a 20 20 20 20 64 61   complete.    da
3fb0: 74 61 62 61 73 65 22 0a 70 75 74 73 20 7b 0a 50  tabase".puts {.P
3fc0: 61 67 65 73 20 74 68 61 74 20 73 74 6f 72 65 20  ages that store 
3fd0: 64 61 74 61 0a 0a 20 20 20 20 54 68 65 20 6e 75  data..    The nu
3fe0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 68  mber of pages th
3ff0: 61 74 20 73 74 6f 72 65 20 64 61 74 61 2c 20 65  at store data, e
4000: 69 74 68 65 72 20 61 73 20 70 72 69 6d 61 72 79  ither as primary
4010: 20 42 2a 54 72 65 65 20 70 61 67 65 73 20 6f 72   B*Tree pages or
4020: 0a 20 20 20 20 61 73 20 6f 76 65 72 66 6c 6f 77  .    as overflow
4030: 20 70 61 67 65 73 2e 20 20 54 68 65 20 6e 75 6d   pages.  The num
4040: 62 65 72 20 61 74 20 74 68 65 20 72 69 67 68 74  ber at the right
4050: 20 69 73 20 74 68 65 20 64 61 74 61 20 70 61 67   is the data pag
4060: 65 73 20 64 69 76 69 64 65 64 20 62 79 0a 20 20  es divided by.  
4070: 20 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62    the total numb
4080: 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74  er of pages in t
4090: 68 65 20 66 69 6c 65 2e 0a 0a 50 61 67 65 73 20  he file...Pages 
40a0: 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 0a  on the freelist.
40b0: 0a 20 20 20 20 54 68 65 20 6e 75 6d 62 65 72 20  .    The number 
40c0: 6f 66 20 70 61 67 65 73 20 74 68 61 74 20 61 72  of pages that ar
40d0: 65 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20  e not currently 
40e0: 69 6e 20 75 73 65 20 62 75 74 20 61 72 65 20 72  in use but are r
40f0: 65 73 65 72 76 65 64 20 66 6f 72 0a 20 20 20 20  eserved for.    
4100: 66 75 74 75 72 65 20 75 73 65 2e 20 20 54 68 65  future use.  The
4110: 20 70 65 72 63 65 6e 74 61 67 65 20 61 74 20 74   percentage at t
4120: 68 65 20 72 69 67 68 74 20 69 73 20 74 68 65 20  he right is the 
4130: 6e 75 6d 62 65 72 20 6f 66 20 66 72 65 65 6c 69  number of freeli
4140: 73 74 20 70 61 67 65 73 0a 20 20 20 20 64 69 76  st pages.    div
4150: 69 64 65 64 20 62 79 20 74 68 65 20 74 6f 74 61  ided by the tota
4160: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  l number of page
4170: 73 20 69 6e 20 74 68 65 20 66 69 6c 65 2e 0a 0a  s in the file...
4180: 50 61 67 65 73 20 6f 66 20 61 75 74 6f 2d 76 61  Pages of auto-va
4190: 63 75 75 6d 20 6f 76 65 72 68 65 61 64 0a 0a 20  cuum overhead.. 
41a0: 20 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66     The number of
41b0: 20 70 61 67 65 73 20 74 68 61 74 20 73 74 6f 72   pages that stor
41c0: 65 20 64 61 74 61 20 75 73 65 64 20 62 79 20 74  e data used by t
41d0: 68 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 66  he database to f
41e0: 61 63 69 6c 69 74 61 74 65 0a 20 20 20 20 61 75  acilitate.    au
41f0: 74 6f 2d 76 61 63 75 75 6d 2e 20 54 68 69 73 20  to-vacuum. This 
4200: 69 73 20 7a 65 72 6f 20 66 6f 72 20 64 61 74 61  is zero for data
4210: 62 61 73 65 73 20 74 68 61 74 20 64 6f 20 6e 6f  bases that do no
4220: 74 20 73 75 70 70 6f 72 74 20 61 75 74 6f 2d 76  t support auto-v
4230: 61 63 75 75 6d 2e 0a 0a 4e 75 6d 62 65 72 20 6f  acuum...Number o
4240: 66 20 74 61 62 6c 65 73 20 69 6e 20 74 68 65 20  f tables in the 
4250: 64 61 74 61 62 61 73 65 0a 0a 20 20 20 20 54 68  database..    Th
4260: 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 61 62 6c  e number of tabl
4270: 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61  es in the databa
4280: 73 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68  se, including th
4290: 65 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20  e SQLITE_MASTER 
42a0: 74 61 62 6c 65 0a 20 20 20 20 75 73 65 64 20 74  table.    used t
42b0: 6f 20 73 74 6f 72 65 20 73 63 68 65 6d 61 20 69  o store schema i
42c0: 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 4e 75 6d  nformation...Num
42d0: 62 65 72 20 6f 66 20 69 6e 64 69 63 65 73 0a 0a  ber of indices..
42e0: 20 20 20 20 54 68 65 20 74 6f 74 61 6c 20 6e 75      The total nu
42f0: 6d 62 65 72 20 6f 66 20 69 6e 64 69 63 65 73 20  mber of indices 
4300: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  in the database.
4310: 0a 0a 4e 75 6d 62 65 72 20 6f 66 20 6e 61 6d 65  ..Number of name
4320: 64 20 69 6e 64 69 63 65 73 0a 0a 20 20 20 20 54  d indices..    T
4330: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 64  he number of ind
4340: 69 63 65 73 20 63 72 65 61 74 65 64 20 75 73 69  ices created usi
4350: 6e 67 20 61 6e 20 65 78 70 6c 69 63 69 74 20 43  ng an explicit C
4360: 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61 74  REATE INDEX stat
4370: 65 6d 65 6e 74 2e 0a 0a 41 75 74 6f 6d 61 74 69  ement...Automati
4380: 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 64 20  cally generated 
4390: 69 6e 64 69 63 65 73 0a 0a 20 20 20 20 54 68 65  indices..    The
43a0: 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 64 69 63   number of indic
43b0: 65 73 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65  es used to imple
43c0: 6d 65 6e 74 20 50 52 49 4d 41 52 59 20 4b 45 59  ment PRIMARY KEY
43d0: 20 6f 72 20 55 4e 49 51 55 45 20 63 6f 6e 73 74   or UNIQUE const
43e0: 72 61 69 6e 74 73 0a 20 20 20 20 6f 6e 20 74 61  raints.    on ta
43f0: 62 6c 65 73 2e 0a 0a 53 69 7a 65 20 6f 66 20 74  bles...Size of t
4400: 68 65 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73  he file in bytes
4410: 0a 0a 20 20 20 20 54 68 65 20 74 6f 74 61 6c 20  ..    The total 
4420: 61 6d 6f 75 6e 74 20 6f 66 20 64 69 73 6b 20 73  amount of disk s
4430: 70 61 63 65 20 75 73 65 64 20 62 79 20 74 68 65  pace used by the
4440: 20 65 6e 74 69 72 65 20 64 61 74 61 62 61 73 65   entire database
4450: 20 66 69 6c 65 73 2e 0a 0a 42 79 74 65 73 20 6f   files...Bytes o
4460: 66 20 75 73 65 72 20 70 61 79 6c 6f 61 64 20 73  f user payload s
4470: 74 6f 72 65 64 0a 0a 20 20 20 20 54 68 65 20 74  tored..    The t
4480: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62  otal number of b
4490: 79 74 65 73 20 6f 66 20 75 73 65 72 20 70 61 79  ytes of user pay
44a0: 6c 6f 61 64 20 73 74 6f 72 65 64 20 69 6e 20 74  load stored in t
44b0: 68 65 20 64 61 74 61 62 61 73 65 2e 20 54 68 65  he database. The
44c0: 0a 20 20 20 20 73 63 68 65 6d 61 20 69 6e 66 6f  .    schema info
44d0: 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 53  rmation in the S
44e0: 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74 61 62  QLITE_MASTER tab
44f0: 6c 65 20 69 73 20 6e 6f 74 20 63 6f 75 6e 74 65  le is not counte
4500: 64 20 77 68 65 6e 0a 20 20 20 20 63 6f 6d 70 75  d when.    compu
4510: 74 69 6e 67 20 74 68 69 73 20 6e 75 6d 62 65 72  ting this number
4520: 2e 20 20 54 68 65 20 70 65 72 63 65 6e 74 61 67  .  The percentag
4530: 65 20 61 74 20 74 68 65 20 72 69 67 68 74 20 73  e at the right s
4540: 68 6f 77 73 20 74 68 65 20 70 61 79 6c 6f 61 64  hows the payload
4550: 0a 20 20 20 20 64 69 76 69 64 65 64 20 62 79 20  .    divided by 
4560: 74 68 65 20 74 6f 74 61 6c 20 66 69 6c 65 20 73  the total file s
4570: 69 7a 65 2e 0a 0a 50 65 72 63 65 6e 74 61 67 65  ize...Percentage
4580: 20 6f 66 20 74 6f 74 61 6c 20 64 61 74 61 62 61   of total databa
4590: 73 65 0a 0a 20 20 20 20 54 68 65 20 61 6d 6f 75  se..    The amou
45a0: 6e 74 20 6f 66 20 74 68 65 20 63 6f 6d 70 6c 65  nt of the comple
45b0: 74 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  te database file
45c0: 20 74 68 61 74 20 69 73 20 64 65 76 6f 74 65 64   that is devoted
45d0: 20 74 6f 20 73 74 6f 72 69 6e 67 0a 20 20 20 20   to storing.    
45e0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 64 65 73 63  information desc
45f0: 72 69 62 65 64 20 62 79 20 74 68 69 73 20 63 61  ribed by this ca
4600: 74 65 67 6f 72 79 2e 0a 0a 4e 75 6d 62 65 72 20  tegory...Number 
4610: 6f 66 20 65 6e 74 72 69 65 73 0a 0a 20 20 20 20  of entries..    
4620: 54 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72  The total number
4630: 20 6f 66 20 42 2d 54 72 65 65 20 6b 65 79 2f 76   of B-Tree key/v
4640: 61 6c 75 65 20 70 61 69 72 73 20 73 74 6f 72 65  alue pairs store
4650: 64 20 75 6e 64 65 72 20 74 68 69 73 20 63 61 74  d under this cat
4660: 65 67 6f 72 79 2e 0a 0a 42 79 74 65 73 20 6f 66  egory...Bytes of
4670: 20 73 74 6f 72 61 67 65 20 63 6f 6e 73 75 6d 65   storage consume
4680: 64 0a 0a 20 20 20 20 54 68 65 20 74 6f 74 61 6c  d..    The total
4690: 20 61 6d 6f 75 6e 74 20 6f 66 20 64 69 73 6b 20   amount of disk 
46a0: 73 70 61 63 65 20 72 65 71 75 69 72 65 64 20 74  space required t
46b0: 6f 20 73 74 6f 72 65 20 61 6c 6c 20 42 2d 54 72  o store all B-Tr
46c0: 65 65 20 65 6e 74 72 69 65 73 0a 20 20 20 20 75  ee entries.    u
46d0: 6e 64 65 72 20 74 68 69 73 20 63 61 74 65 67 6f  nder this catego
46e0: 72 79 2e 20 20 54 68 65 20 69 73 20 74 68 65 20  ry.  The is the 
46f0: 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20  total number of 
4700: 70 61 67 65 73 20 75 73 65 64 20 74 69 6d 65 73  pages used times
4710: 0a 20 20 20 20 74 68 65 20 70 61 67 65 73 20 73  .    the pages s
4720: 69 7a 65 2e 0a 0a 42 79 74 65 73 20 6f 66 20 70  ize...Bytes of p
4730: 61 79 6c 6f 61 64 0a 0a 20 20 20 20 54 68 65 20  ayload..    The 
4740: 61 6d 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61  amount of payloa
4750: 64 20 73 74 6f 72 65 64 20 75 6e 64 65 72 20 74  d stored under t
4760: 68 69 73 20 63 61 74 65 67 6f 72 79 2e 20 20 50  his category.  P
4770: 61 79 6c 6f 61 64 20 69 73 20 74 68 65 20 64 61  ayload is the da
4780: 74 61 0a 20 20 20 20 70 61 72 74 20 6f 66 20 74  ta.    part of t
4790: 61 62 6c 65 20 65 6e 74 72 69 65 73 20 61 6e 64  able entries and
47a0: 20 74 68 65 20 6b 65 79 20 70 61 72 74 20 6f 66   the key part of
47b0: 20 69 6e 64 65 78 20 65 6e 74 72 69 65 73 2e 20   index entries. 
47c0: 20 54 68 65 20 70 65 72 63 65 6e 74 61 67 65 0a   The percentage.
47d0: 20 20 20 20 61 74 20 74 68 65 20 72 69 67 68 74      at the right
47e0: 20 69 73 20 74 68 65 20 62 79 74 65 73 20 6f 66   is the bytes of
47f0: 20 70 61 79 6c 6f 61 64 20 64 69 76 69 64 65 64   payload divided
4800: 20 62 79 20 74 68 65 20 62 79 74 65 73 20 6f 66   by the bytes of
4810: 20 73 74 6f 72 61 67 65 20 0a 20 20 20 20 63 6f   storage .    co
4820: 6e 73 75 6d 65 64 2e 0a 0a 41 76 65 72 61 67 65  nsumed...Average
4830: 20 70 61 79 6c 6f 61 64 20 70 65 72 20 65 6e 74   payload per ent
4840: 72 79 0a 0a 20 20 20 20 54 68 65 20 61 76 65 72  ry..    The aver
4850: 61 67 65 20 61 6d 6f 75 6e 74 20 6f 66 20 70 61  age amount of pa
4860: 79 6c 6f 61 64 20 6f 6e 20 65 61 63 68 20 65 6e  yload on each en
4870: 74 72 79 2e 20 20 54 68 69 73 20 69 73 20 6a 75  try.  This is ju
4880: 73 74 20 74 68 65 20 62 79 74 65 73 20 6f 66 0a  st the bytes of.
4890: 20 20 20 20 70 61 79 6c 6f 61 64 20 64 69 76 69      payload divi
48a0: 64 65 64 20 62 79 20 74 68 65 20 6e 75 6d 62 65  ded by the numbe
48b0: 72 20 6f 66 20 65 6e 74 72 69 65 73 2e 0a 0a 41  r of entries...A
48c0: 76 65 72 61 67 65 20 75 6e 75 73 65 64 20 62 79  verage unused by
48d0: 74 65 73 20 70 65 72 20 65 6e 74 72 79 0a 0a 20  tes per entry.. 
48e0: 20 20 20 54 68 65 20 61 76 65 72 61 67 65 20 61     The average a
48f0: 6d 6f 75 6e 74 20 6f 66 20 66 72 65 65 20 73 70  mount of free sp
4900: 61 63 65 20 72 65 6d 61 69 6e 69 6e 67 20 6f 6e  ace remaining on
4910: 20 61 6c 6c 20 70 61 67 65 73 20 75 6e 64 65 72   all pages under
4920: 20 74 68 69 73 0a 20 20 20 20 63 61 74 65 67 6f   this.    catego
4930: 72 79 20 6f 6e 20 61 20 70 65 72 2d 65 6e 74 72  ry on a per-entr
4940: 79 20 62 61 73 69 73 2e 20 20 54 68 69 73 20 69  y basis.  This i
4950: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
4960: 75 6e 75 73 65 64 20 62 79 74 65 73 20 6f 6e 0a  unused bytes on.
4970: 20 20 20 20 61 6c 6c 20 70 61 67 65 73 20 64 69      all pages di
4980: 76 69 64 65 64 20 62 79 20 74 68 65 20 6e 75 6d  vided by the num
4990: 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 2e 0a  ber of entries..
49a0: 0a 46 72 61 67 6d 65 6e 74 61 74 69 6f 6e 0a 0a  .Fragmentation..
49b0: 20 20 20 20 54 68 65 20 70 65 72 63 65 6e 74 61      The percenta
49c0: 67 65 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74  ge of pages in t
49d0: 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65  he table or inde
49e0: 78 20 74 68 61 74 20 61 72 65 20 6e 6f 74 0a 20  x that are not. 
49f0: 20 20 20 63 6f 6e 73 65 63 75 74 69 76 65 20 69     consecutive i
4a00: 6e 20 74 68 65 20 64 69 73 6b 20 66 69 6c 65 2e  n the disk file.
4a10: 20 20 4d 61 6e 79 20 66 69 6c 65 73 79 73 74 65    Many filesyste
4a20: 6d 73 20 61 72 65 20 6f 70 74 69 6d 69 7a 65 64  ms are optimized
4a30: 0a 20 20 20 20 66 6f 72 20 73 65 71 75 65 6e 74  .    for sequent
4a40: 69 61 6c 20 66 69 6c 65 20 61 63 63 65 73 73 20  ial file access 
4a50: 73 6f 20 73 6d 61 6c 6c 65 72 20 66 72 61 67 6d  so smaller fragm
4a60: 65 6e 74 61 74 69 6f 6e 20 6e 75 6d 62 65 72 73  entation numbers
4a70: 20 0a 20 20 20 20 73 6f 6d 65 74 69 6d 65 73 20   .    sometimes 
4a80: 72 65 73 75 6c 74 20 69 6e 20 66 61 73 74 65 72  result in faster
4a90: 20 71 75 65 72 69 65 73 2c 20 65 73 70 65 63 69   queries, especi
4aa0: 61 6c 6c 79 20 66 6f 72 20 6c 61 72 67 65 72 0a  ally for larger.
4ab0: 20 20 20 20 64 61 74 61 62 61 73 65 20 66 69 6c      database fil
4ac0: 65 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 66  es that do not f
4ad0: 69 74 20 69 6e 20 74 68 65 20 64 69 73 6b 20 63  it in the disk c
4ae0: 61 63 68 65 2e 0a 0a 4d 61 78 69 6d 75 6d 20 70  ache...Maximum p
4af0: 61 79 6c 6f 61 64 20 70 65 72 20 65 6e 74 72 79  ayload per entry
4b00: 0a 0a 20 20 20 20 54 68 65 20 6c 61 72 67 65 73  ..    The larges
4b10: 74 20 70 61 79 6c 6f 61 64 20 73 69 7a 65 20 6f  t payload size o
4b20: 66 20 61 6e 79 20 65 6e 74 72 79 2e 0a 0a 45 6e  f any entry...En
4b30: 74 72 69 65 73 20 74 68 61 74 20 75 73 65 20 6f  tries that use o
4b40: 76 65 72 66 6c 6f 77 0a 0a 20 20 20 20 54 68 65  verflow..    The
4b50: 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69   number of entri
4b60: 65 73 20 74 68 61 74 20 75 73 65 72 20 6f 6e 65  es that user one
4b70: 20 6f 72 20 6d 6f 72 65 20 6f 76 65 72 66 6c 6f   or more overflo
4b80: 77 20 70 61 67 65 73 2e 0a 0a 54 6f 74 61 6c 20  w pages...Total 
4b90: 70 61 67 65 73 20 75 73 65 64 0a 0a 20 20 20 20  pages used..    
4ba0: 54 68 69 73 20 69 73 20 74 68 65 20 6e 75 6d 62  This is the numb
4bb0: 65 72 20 6f 66 20 70 61 67 65 73 20 75 73 65 64  er of pages used
4bc0: 20 74 6f 20 68 6f 6c 64 20 61 6c 6c 20 69 6e 66   to hold all inf
4bd0: 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20  ormation in the 
4be0: 63 75 72 72 65 6e 74 0a 20 20 20 20 63 61 74 65  current.    cate
4bf0: 67 6f 72 79 2e 20 20 54 68 69 73 20 69 73 20 74  gory.  This is t
4c00: 68 65 20 73 75 6d 20 6f 66 20 69 6e 64 65 78 2c  he sum of index,
4c10: 20 70 72 69 6d 61 72 79 2c 20 61 6e 64 20 6f 76   primary, and ov
4c20: 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 0a 49  erflow pages...I
4c30: 6e 64 65 78 20 70 61 67 65 73 20 75 73 65 64 0a  ndex pages used.
4c40: 0a 20 20 20 20 54 68 69 73 20 69 73 20 74 68 65  .    This is the
4c50: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
4c60: 20 69 6e 20 61 20 74 61 62 6c 65 20 42 2d 74 72   in a table B-tr
4c70: 65 65 20 74 68 61 74 20 68 6f 6c 64 20 6f 6e 6c  ee that hold onl
4c80: 79 20 6b 65 79 20 28 72 6f 77 69 64 29 0a 20 20  y key (rowid).  
4c90: 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 6e    information an
4ca0: 64 20 6e 6f 20 64 61 74 61 2e 0a 0a 50 72 69 6d  d no data...Prim
4cb0: 61 72 79 20 70 61 67 65 73 20 75 73 65 64 0a 0a  ary pages used..
4cc0: 20 20 20 20 54 68 69 73 20 69 73 20 74 68 65 20      This is the 
4cd0: 6e 75 6d 62 65 72 20 6f 66 20 42 2d 74 72 65 65  number of B-tree
4ce0: 20 70 61 67 65 73 20 74 68 61 74 20 68 6f 6c 64   pages that hold
4cf0: 20 62 6f 74 68 20 6b 65 79 20 61 6e 64 20 64 61   both key and da
4d00: 74 61 2e 0a 0a 4f 76 65 72 66 6c 6f 77 20 70 61  ta...Overflow pa
4d10: 67 65 73 20 75 73 65 64 0a 0a 20 20 20 20 54 68  ges used..    Th
4d20: 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f  e total number o
4d30: 66 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73  f overflow pages
4d40: 20 75 73 65 64 20 66 6f 72 20 74 68 69 73 20 63   used for this c
4d50: 61 74 65 67 6f 72 79 2e 0a 0a 55 6e 75 73 65 64  ategory...Unused
4d60: 20 62 79 74 65 73 20 6f 6e 20 69 6e 64 65 78 20   bytes on index 
4d70: 70 61 67 65 73 0a 0a 20 20 20 20 54 68 65 20 74  pages..    The t
4d80: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62  otal number of b
4d90: 79 74 65 73 20 6f 66 20 75 6e 75 73 65 64 20 73  ytes of unused s
4da0: 70 61 63 65 20 6f 6e 20 61 6c 6c 20 69 6e 64 65  pace on all inde
4db0: 78 20 70 61 67 65 73 2e 20 20 54 68 65 0a 20 20  x pages.  The.  
4dc0: 20 20 70 65 72 63 65 6e 74 61 67 65 20 61 74 20    percentage at 
4dd0: 74 68 65 20 72 69 67 68 74 20 69 73 20 74 68 65  the right is the
4de0: 20 6e 75 6d 62 65 72 20 6f 66 20 75 6e 75 73 65   number of unuse
4df0: 64 20 62 79 74 65 73 20 64 69 76 69 64 65 64 20  d bytes divided 
4e00: 62 79 20 74 68 65 0a 20 20 20 20 74 6f 74 61 6c  by the.    total
4e10: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
4e20: 20 6f 6e 20 69 6e 64 65 78 20 70 61 67 65 73 2e   on index pages.
4e30: 0a 0a 55 6e 75 73 65 64 20 62 79 74 65 73 20 6f  ..Unused bytes o
4e40: 6e 20 70 72 69 6d 61 72 79 20 70 61 67 65 73 0a  n primary pages.
4e50: 0a 20 20 20 20 54 68 65 20 74 6f 74 61 6c 20 6e  .    The total n
4e60: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f  umber of bytes o
4e70: 66 20 75 6e 75 73 65 64 20 73 70 61 63 65 20 6f  f unused space o
4e80: 6e 20 61 6c 6c 20 70 72 69 6d 61 72 79 20 70 61  n all primary pa
4e90: 67 65 73 2e 20 20 54 68 65 0a 20 20 20 20 70 65  ges.  The.    pe
4ea0: 72 63 65 6e 74 61 67 65 20 61 74 20 74 68 65 20  rcentage at the 
4eb0: 72 69 67 68 74 20 69 73 20 74 68 65 20 6e 75 6d  right is the num
4ec0: 62 65 72 20 6f 66 20 75 6e 75 73 65 64 20 62 79  ber of unused by
4ed0: 74 65 73 20 64 69 76 69 64 65 64 20 62 79 20 74  tes divided by t
4ee0: 68 65 0a 20 20 20 20 74 6f 74 61 6c 20 6e 75 6d  he.    total num
4ef0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 6e 20  ber of bytes on 
4f00: 70 72 69 6d 61 72 79 20 70 61 67 65 73 2e 0a 0a  primary pages...
4f10: 55 6e 75 73 65 64 20 62 79 74 65 73 20 6f 6e 20  Unused bytes on 
4f20: 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 0a 0a  overflow pages..
4f30: 20 20 20 20 54 68 65 20 74 6f 74 61 6c 20 6e 75      The total nu
4f40: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66  mber of bytes of
4f50: 20 75 6e 75 73 65 64 20 73 70 61 63 65 20 6f 6e   unused space on
4f60: 20 61 6c 6c 20 6f 76 65 72 66 6c 6f 77 20 70 61   all overflow pa
4f70: 67 65 73 2e 20 20 54 68 65 0a 20 20 20 20 70 65  ges.  The.    pe
4f80: 72 63 65 6e 74 61 67 65 20 61 74 20 74 68 65 20  rcentage at the 
4f90: 72 69 67 68 74 20 69 73 20 74 68 65 20 6e 75 6d  right is the num
4fa0: 62 65 72 20 6f 66 20 75 6e 75 73 65 64 20 62 79  ber of unused by
4fb0: 74 65 73 20 64 69 76 69 64 65 64 20 62 79 20 74  tes divided by t
4fc0: 68 65 0a 20 20 20 20 74 6f 74 61 6c 20 6e 75 6d  he.    total num
4fd0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 6e 20  ber of bytes on 
4fe0: 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a  overflow pages..
4ff0: 0a 55 6e 75 73 65 64 20 62 79 74 65 73 20 6f 6e  .Unused bytes on
5000: 20 61 6c 6c 20 70 61 67 65 73 0a 0a 20 20 20 20   all pages..    
5010: 54 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72  The total number
5020: 20 6f 66 20 62 79 74 65 73 20 6f 66 20 75 6e 75   of bytes of unu
5030: 73 65 64 20 73 70 61 63 65 20 6f 6e 20 61 6c 6c  sed space on all
5040: 20 70 72 69 6d 61 72 79 20 61 6e 64 20 6f 76 65   primary and ove
5050: 72 66 6c 6f 77 20 0a 20 20 20 20 70 61 67 65 73  rflow .    pages
5060: 2e 20 20 54 68 65 20 70 65 72 63 65 6e 74 61 67  .  The percentag
5070: 65 20 61 74 20 74 68 65 20 72 69 67 68 74 20 69  e at the right i
5080: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
5090: 75 6e 75 73 65 64 20 62 79 74 65 73 20 0a 20 20  unused bytes .  
50a0: 20 20 64 69 76 69 64 65 64 20 62 79 20 74 68 65    divided by the
50b0: 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   total number of
50c0: 20 62 79 74 65 73 2e 0a 7d 0a 0a 23 20 4f 75 74   bytes..}..# Out
50d0: 70 75 74 20 61 20 64 75 6d 70 20 6f 66 20 74 68  put a dump of th
50e0: 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61  e in-memory data
50f0: 62 61 73 65 2e 20 54 68 69 73 20 63 61 6e 20 62  base. This can b
5100: 65 20 75 73 65 64 20 66 6f 72 20 6d 6f 72 65 0a  e used for more.
5110: 23 20 63 6f 6d 70 6c 65 78 20 6f 66 66 6c 69 6e  # complex offlin
5120: 65 20 61 6e 61 6c 79 73 69 73 2e 0a 23 0a 70 75  e analysis..#.pu
5130: 74 73 20 22 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ts "************
5140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
5170: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 22 0a 70 75 74 73  **********".puts
5180: 20 22 54 68 65 20 65 6e 74 69 72 65 20 74 65 78   "The entire tex
5190: 74 20 6f 66 20 74 68 69 73 20 72 65 70 6f 72 74  t of this report
51a0: 20 63 61 6e 20 62 65 20 73 6f 75 72 63 65 64 20   can be sourced 
51b0: 69 6e 74 6f 20 61 6e 79 20 53 51 4c 20 64 61 74  into any SQL dat
51c0: 61 62 61 73 65 22 0a 70 75 74 73 20 22 65 6e 67  abase".puts "eng
51d0: 69 6e 65 20 66 6f 72 20 66 75 72 74 68 65 72 20  ine for further 
51e0: 61 6e 61 6c 79 73 69 73 2e 20 20 41 6c 6c 20 6f  analysis.  All o
51f0: 66 20 74 68 65 20 74 65 78 74 20 61 62 6f 76 65  f the text above
5200: 20 69 73 20 61 6e 20 53 51 4c 20 63 6f 6d 6d 65   is an SQL comme
5210: 6e 74 2e 22 0a 70 75 74 73 20 22 54 68 65 20 64  nt.".puts "The d
5220: 61 74 61 20 75 73 65 64 20 74 6f 20 67 65 6e 65  ata used to gene
5230: 72 61 74 65 20 74 68 69 73 20 72 65 70 6f 72 74  rate this report
5240: 20 66 6f 6c 6c 6f 77 73 3a 22 0a 70 75 74 73 20   follows:".puts 
5250: 22 2a 2f 22 0a 70 75 74 73 20 22 42 45 47 49 4e  "*/".puts "BEGIN
5260: 3b 22 0a 70 75 74 73 20 24 74 61 62 6c 65 64 65  ;".puts $tablede
5270: 66 0a 75 6e 73 65 74 20 2d 6e 6f 63 6f 6d 70 6c  f.unset -nocompl
5280: 61 69 6e 20 78 0a 6d 65 6d 20 65 76 61 6c 20 7b  ain x.mem eval {
5290: 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 73 70  SELECT * FROM sp
52a0: 61 63 65 5f 75 73 65 64 7d 20 78 20 7b 0a 20 20  ace_used} x {.  
52b0: 70 75 74 73 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20  puts -nonewline 
52c0: 22 49 4e 53 45 52 54 20 49 4e 54 4f 20 73 70 61  "INSERT INTO spa
52d0: 63 65 5f 75 73 65 64 20 56 41 4c 55 45 53 22 0a  ce_used VALUES".
52e0: 20 20 73 65 74 20 73 65 70 20 28 0a 20 20 66 6f    set sep (.  fo
52f0: 72 65 61 63 68 20 63 6f 6c 20 24 78 28 2a 29 20  reach col $x(*) 
5300: 7b 0a 20 20 20 20 73 65 74 20 76 20 24 78 28 24  {.    set v $x($
5310: 63 6f 6c 29 0a 20 20 20 20 69 66 20 7b 24 76 3d  col).    if {$v=
5320: 3d 22 22 20 7c 7c 20 21 5b 73 74 72 69 6e 67 20  ="" || ![string 
5330: 69 73 20 64 6f 75 62 6c 65 20 24 76 5d 7d 20 7b  is double $v]} {
5340: 73 65 74 20 76 20 5b 71 75 6f 74 65 20 24 76 5d  set v [quote $v]
5350: 7d 0a 20 20 20 20 70 75 74 73 20 2d 6e 6f 6e 65  }.    puts -none
5360: 77 6c 69 6e 65 20 24 73 65 70 24 76 0a 20 20 20  wline $sep$v.   
5370: 20 73 65 74 20 73 65 70 20 2c 0a 20 20 7d 0a 20   set sep ,.  }. 
5380: 20 70 75 74 73 20 22 29 3b 22 0a 7d 0a 70 75 74   puts ");".}.put
5390: 73 20 22 43 4f 4d 4d 49 54 3b 22 0a 0a 7d 20 65  s "COMMIT;"..} e
53a0: 72 72 5d 7d 20 7b 0a 20 20 70 75 74 73 20 22 45  rr]} {.  puts "E
53b0: 52 52 4f 52 3a 20 24 65 72 72 22 0a 20 20 70 75  RROR: $err".  pu
53c0: 74 73 20 24 65 72 72 6f 72 49 6e 66 6f 0a 20 20  ts $errorInfo.  
53d0: 65 78 69 74 20 31 0a 7d 0a                       exit 1.}.