File: README.pgstattuple

package info (click to toggle)
postgresql 7.2.1-2woody8
  • links: PTS
  • area: main
  • in suites: woody
  • size: 42,424 kB
  • ctags: 30,027
  • sloc: ansic: 290,568; java: 18,529; sh: 12,197; sql: 11,401; yacc: 11,189; tcl: 8,063; perl: 4,067; makefile: 3,332; xml: 2,874; lex: 2,799; python: 1,237; cpp: 845; pascal: 81; asm: 70; awk: 20; sed: 8
file content (47 lines) | stat: -rw-r--r-- 1,335 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
pgstattuple README			2001/10/01 Tatsuo Ishii

1. What is pgstattuple?

   pgstattuple returns the percentage of the "dead" tuples of a
   table. This will help users to judge if vacuum is needed.

   In addition, pgstattuple prints more detailed information using
   NOTICE.

test=# select pgstattuple('tellers');
NOTICE:  physical length: 0.08MB live tuples: 20 (0.00MB, 1.17%) dead tuples: 320 (0.01MB, 18.75%) free/reusable space: 0.01MB (18.06%) overhead: 62.02%
 pgstattuple 
-------------
       18.75
(1 row)

   Above example shows tellers table includes 18.75% dead tuples.

   physical length	physical size of the table in MB
   live tuples		information on the live tuples
   dead tuples		information on the dead tuples
   free/reusable space	available space
   overhead		overhead space

2. Installing pgstattuple

    $ make
    $ make install
    $ psql -e -f /usr/local/pgsql/share/contrib/pgstattuple.sql test

3. Using pgstattuple

   pgstattuple can be called as a function:

   pgstattuple(NAME) RETURNS FLOAT8

   The argument is the table name.  pgstattuple returns the percentage
   of the "dead" tuples of a table.

4. Notes

   pgstattuple acquires only a read lock on the table. So concurrent
   update may affect the result.

   pgstattuple judges a tuple is "dead" if HeapTupleSatisfiesNow()
   returns false.