PostgreSQLLa base de données la plus sophistiquée au monde.

Version anglaise

F.30. pgstattuple

Le module pgstattuple fournit plusieurs fonctions pour obtenir des statistiques au niveau ligne.

F.30.1. Fonctions

pgstattuple(text) returns record

pgstattuple renvoie la longueur physique d'une relation, le pourcentage des lignes « mortes », et d'autres informations. Ceci peut aider les utilisateurs à déterminer si une opération de VACUUM est nécessaire. L'argument est le nom de la relation cible (qui peut être qualifié par le nom du schéma) ou l'OID. Par exemple :

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
      

Les colonnes en sortie sont décrites dans Tableau F.23, « Colonnes de pgstattuple ».

Tableau F.23. Colonnes de pgstattuple

Colonne Type Description
table_len bigint Longueur physique de la relation en octets
tuple_count bigint Nombre de lignes vivantes
tuple_len bigint Longueur totale des lignes vivantes en octets
tuple_percent float8 Pourcentage des lignes vivantes
dead_tuple_count bigint Nombre de lignes mortes
dead_tuple_len bigint Longueur totale des lignes mortes en octets
dead_tuple_percent float8 Pourcentage des lignes mortes
free_space bigint Espace libre total en octets
free_percent float8 Pourcentage de l'espace libre

[Note]

Note

La valeur de la colonne table_len sera toujours supérieur à la somme des colonnes tuple_len, dead_tuple_len et free_space. La différence correspond aux données systèmes comme la table de pointeurs vers les lignes (une table par bloc) et aux octets d'alignements permettant de s'assurer que les lignes sont correctement alignées.

pgstattuple acquiert seulement un verrou en lecture sur la relation. Donc les relations ne reflètent pas une image instantanée  des mises à jour en parallèle peuvent les affecter.

pgstattuple juge qu'une ligne est « morte » si HeapTupleSatisfiesDirty renvoie false.

pgstattuple(text) returns record

Identique à pgstattuple(regclass), sauf que la relation cible est désignée en tant que TEXT. Cette fonction est conservée pour raison de compatibilité ascendante, et sera dépréciée dans une prochaine version.

pgstatindex(regclass) returns record

pgstatindex renvoie un enregistrement affichant des informations sur un index B-Tree. Par exemple :

test=> SELECT * FROM pgstatindex('pg_cast_oid_index');
-[ RECORD 1 ]------+------
version            | 2
tree_level         | 0
index_size         | 16384
root_block_no      | 1
internal_pages     | 0
leaf_pages         | 1
empty_pages        | 0
deleted_pages      | 0
avg_leaf_density   | 54.27
leaf_fragmentation | 0
     

En voici les colonnes:

Colonne Type Description
version integer Numéro de version du B-tree
tree_level integer Niveau de l'arbre pour la page racine
index_size bigint Taille totale de l'index en octets
root_block_no bigint Emplacement du bloc racine (0 si aucun)
internal_pages bigint Nombre de pages « internes » (niveau supérieur)
leaf_pages bigint Nombre de pages feuilles
empty_pages bigint Nombre de pages vides
deleted_pages bigint Nombre de pages supprimées
avg_leaf_density float8 Densité moyenne des pages feuilles
leaf_fragmentation float8 Fragmentation des pages feuilles

L'information index_size rapportée correspondra normalement à un bloc de plus que ce qui est indiqué par la formule internal_pages + leaf_pages + empty_pages + deleted_pages car elle inclut aussi le bloc de méta-données de l'index.

Comme pour pgstattuple, les résultats sont accumulés page par page, et ne représentent pas forcément une image instantanée de l'index complet.

pgstatindex(text) returns record

Identique à pgstatindex(regclass), sauf que l'index cible est spécifié en tant que TEXT. Cette fonction est conservée pour raison de compatibilité ascendante, et sera dépréciée dans une prochaine version.

pgstatginindex(regclass) returns record

pgstatginindex renvoie un enregistrement montrant les informations sur un index GIN. Par exemple :

test=> SELECT * FROM pgstatginindex('test_gin_index');
-[ RECORD 1 ]--+--
version        | 1
pending_pages  | 0
pending_tuples | 0
      

Les colonnes en sortie sont :

Colonne Type Description
version integer Numéro de version GIN
pending_pages integer Nombre de pages dans la liste en attente
pending_tuples bigint Nombre de lignes dans la liste en attente
pg_relpages(regclass) returns bigint

pg_relpages renvoie le nombre de pages dans la relation.

pg_relpages(text) returns bigint

Identique à pg_relpages(regclass), sauf que la relation cible est spécifiée en tant que TEXT. Cette fonction est conservée pour raison de compatibilité ascendante, et sera dépréciée dans la prochaine version.

F.30.2. Auteurs

Tatsuo Ishii et Satoshi Nagayasu