readme.pgstattuple.euc_jp

来自「PostgreSQL 8.2中增加了很多企业用户所需要的功能和性能上的提高,其开」· EUC_JP 代码 · 共 177 行

$PostgreSQL: pgsql/contrib/pgstattuple/README.pgstattuple.euc_jp,v 1.8 2006/09/04 03:49:05 momjian Exp $

pgstattuple README		2002/08/22 佬版茫勺

1. サポ〖トされている簇眶

   pgstattuple
   -----------
   pgstattupleは·UPDATEやDELETEで侯られたリレ〖ションのゴミ挝拌の络きさを·
   リレ〖ション极挛の湿妄弄な络きさに滦するパ〖センテ〖ジで手笛しますˉつ
   まり·手笛猛が络きければ·それだけゴミも驴いので·vacuumをかける涩
   妥があるという冉们の锦けになるわけですˉこれ笆嘲にもいろいろな攫鼠
   が手りますˉ
   pgstattuple() は、リレ〖ションの墓さや、タプルの"ゴミ挝拌"の充圭などの
   攫鼠を手笛します。これらの攫鼠は、vacuum が涩妥かどうか、ユ〖ザが冉们
   するのに舔惟つでしょう。毋えば笆布のような妨になります¨

       test=> \x
       Expanded display is on.
       test=> SELECT * FROM pgstattuple('pg_catalog.pg_proc');
       -[ RECORD 1 ]------+-------
       table_len          | 458752
       tuple_count        | 1470
       tuple_len          | 438896
       tuple_percent      | 95.67
       dead_tuple_count   | 11
       dead_tuple_len     | 3157
       dead_tuple_percent | 0.69
       free_space         | 8932
       free_percent       | 1.95

   笆布が称灌誊の柒推です¨

       table_len		-- リレ〖ションの湿妄弄な络きさ(バイト)
       tuple_count		-- タプル眶
       tuple_len		-- タプル墓の圭纷(バイト)
       tuple_percent	-- タプルの充圭ˉtable_lenに滦するtuple_lenの孺唯ˉ
       dead_tuple_len	-- デッドタプル眶
       dead_tuple_percent	-- デッドタプルの充圭ˉtable_lenに滦するtuple_lenの孺唯ˉ
       free_space		-- 浩网脱材墙な挝拌(バイト)
       free_percent	-- 浩网脱材墙な挝拌ˉtable_lenに滦するfree_spaceの孺唯ˉ

   pg_relpages
   -----------
   pg_relpages() はリレ〖ションのペ〖ジ眶を手笛しますˉ

   pgstatindex
   -----------
   pgstatindex() はインデックスに簇する攫鼠を手笛します¨

       test=> \x
       Expanded display is on.
       test=> SELECT * FROM pgstatindex('pg_cast_oid_index');
       -[ RECORD 1 ]------+------
       version            | 2
       tree_level         | 0
       index_size         | 8192
       root_block_no      | 1
       internal_pages     | 0
       leaf_pages         | 1
       empty_pages        | 0
       deleted_pages      | 0
       avg_leaf_density   | 50.27
       leaf_fragmentation | 0

   bt_metap
   --------
   bt_metap() はbtreeインデックスのメタペ〖ジに簇する攫鼠を手笛します¨

       test=> SELECT * FROM bt_metap('pg_cast_oid_index');
       -[ RECORD 1 ]-----
       magic     | 340322
       version   | 2
       root      | 1
       level     | 0
       fastroot  | 1
       fastlevel | 0

   bt_page_stats
   -------------
   bt_page_stats() は、btreeの帽办のペ〖ジに簇する攫鼠を山绩します¨

       test=> SELECT * FROM bt_page_stats('pg_cast_oid_index', 1);
       -[ RECORD 1 ]-+-----
       blkno         | 1
       type          | l
       live_items    | 256
       dead_items    | 0
       avg_item_size | 12
       page_size     | 8192
       free_size     | 4056
       btpo_prev     | 0
       btpo_next     | 0
       btpo          | 0
       btpo_flags    | 3

   bt_page_items
   -------------
   bt_page_items() は、称btreeペ〖ジの改侍のアイテムに簇する攫鼠を山绩します¨

       test=> SELECT * FROM bt_page_items('pg_cast_oid_index', 1);
        itemoffset |  ctid   | itemlen | nulls | vars |    data
       ------------+---------+---------+-------+------+-------------
                 1 | (0,1)   |      12 | f     | f    | 23 27 00 00
                 2 | (0,2)   |      12 | f     | f    | 24 27 00 00
                 3 | (0,3)   |      12 | f     | f    | 25 27 00 00
                 4 | (0,4)   |      12 | f     | f    | 26 27 00 00
                 5 | (0,5)   |      12 | f     | f    | 27 27 00 00
                 6 | (0,6)   |      12 | f     | f    | 28 27 00 00
                 7 | (0,7)   |      12 | f     | f    | 29 27 00 00
                 8 | (0,8)   |      12 | f     | f    | 2a 27 00 00
 

2. pgstattupleのインスト〖ル

   PostgreSQLが/usr/local/pgsqlにインスト〖ル貉であり·testデ〖タベ〖
   スにpgstattupleをインスト〖ルする眷圭の缄界を绩しますˉ

    $ make
    $ make install

    ユ〖ザ年盗簇眶を判峡しますˉ

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


3. pgstattupleの蝗い数

   pgstattupleの钙び叫し妨及は笆布ですˉ

   CREATE OR REPLACE FUNCTION pgstattuple(text) RETURNS pgstattuple_type
     AS 'MODULE_PATHNAME', 'pgstattuple'
     LANGUAGE C STRICT;

   妈办苞眶: リレ〖ション叹

   簇眶の提りはpgstattuple_type房ですˉ

   pgstattupleはリレ〖ションにAccessShareLockしかかけないので·
   pgstattuple を悸乖面に澈碰リレ〖ションに构糠や猴近が券栏すると·赖しく
   ない冯蔡を手す材墙拉がありますˉ

   pgstattupleがタプルを≈ゴミ∽と冉们する答洁は·
   HeapTupleSatisfiesNow()が刀を手したときですˉ

4. pgstattupleのライセンス掘凤について

   pgstattuple.cの肆片に今いてある奶りですˉまた·pgstattuple は窗链に痰瘦
   沮ですˉpgstattuple を蝗脱したことによって栏じるいかなる冯蔡に簇して
   も勒扦を砷いませんˉ

5. 猖柠旺悟

   2006/06/28

	インデックスに滦しても瓢侯するように橙磨。

   2002/09/04

	SRF恃构に燃い·Tom Lane	が饯赖インタ〖フェイスの饯赖を乖ったˉ
	そのことをこのREADMEにも瓤鼻ˉ

   2002/08/23

	SRF(Set Returning Function)を蝗って7.3脱に今き垂えˉ

   2001/12/20 Tom Laneによる饯赖

   	Fix pgstattuple to acquire a read lock on the target table.  This
	prevents embarassments such as having the table dropped or truncated
	partway through the scan.  Also, fix free space calculation to include
	pages that currently contain no tuples.

   2001/10/01 PostgreSQL 7.2 脱contrib moduleに判峡

   2001/08/30 pgstattuple バ〖ジョン 0.1リリ〖ス