pgstattuple devuelve la longitud física de una relación, el porcentaje de tuplas “muertas” (dead tuples) y otra información. Esto puede ayudar a los usuarios a determinar si es necesario realizar un vacuum o no. El argumento es el nombre de la relación objetivo (opcionalmente calificado por esquema) o su OID. Por ejemplo:

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

Las columnas de salida se describen en la Table F.24.

pgstattuple adquiere solo un bloqueo de lectura (read lock) en la relación. Por lo tanto, los resultados no reflejan una instantánea exacta; las actualizaciones concurrentes les afectarán.

pgstattuple juzga que una tupla está “muerta” si HeapTupleSatisfiesDirty devuelve falso.

Esto es lo mismo que pgstattuple(regclass), excepto que la relación objetivo se especifica como TEXT. Esta función se mantiene por compatibilidad hacia atrás por el momento, y será declarada obsoleta (deprecated) en una versión futura.

pgstatindex devuelve un registro que muestra información sobre un índice B-tree. Por ejemplo:

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

Las columnas de salida son:

El tamaño index_size reportado corresponderá normalmente a una página más de las contabilizadas por la suma de internal_pages + leaf_pages + empty_pages + deleted_pages, debido a que también incluye la metapágina (metapage) del índice.

Al igual que con pgstattuple, los resultados se acumulan página por página, y no se debe esperar que representen una instantánea exacta de todo el índice.

Esto es lo mismo que pgstatindex(regclass), excepto que el índice objetivo se especifica como TEXT. Esta función se mantiene por compatibilidad hacia atrás por el momento, y será declarada obsoleta en una versión futura.

pgstatginindex devuelve un registro que muestra información sobre un índice GIN. Por ejemplo:

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

Las columnas de salida son:

pgstathashindex devuelve un registro que muestra información sobre un índice HASH. Por ejemplo:

test=> select * from pgstathashindex('con_hash_index');
-[ RECORD 1 ]--+-----------------
version        | 4
bucket_pages   | 33081
overflow_pages | 0
bitmap_pages   | 1
unused_pages   | 32455
live_items     | 10204006
dead_items     | 0
free_percent   | 61.8005949100872

Las columnas de salida son:

pg_relpages devuelve el número de páginas en la relación.

Esto es lo mismo que pg_relpages(regclass), excepto que la relación objetivo se especifica como TEXT. Esta función se mantiene por compatibilidad hacia atrás por el momento, y será declarada obsoleta en una versión futura.

pgstattuple_approx es una alternativa más rápida a pgstattuple que devuelve resultados aproximados. El argumento es el nombre o OID de la relación objetivo. Por ejemplo:

test=> SELECT * FROM pgstattuple_approx('pg_catalog.pg_proc'::regclass);
-[ RECORD 1 ]--------+-------
table_len            | 573440
scanned_percent      | 2
approx_tuple_count   | 2740
approx_tuple_len     | 561210
approx_tuple_percent | 97.87
dead_tuple_count     | 0
dead_tuple_len       | 0
dead_tuple_percent   | 0
approx_free_space    | 11996
approx_free_percent  | 2.09

Las columnas de salida se describen en la Table F.25.

Mientras que pgstattuple siempre realiza un escaneo completo de la tabla y devuelve un recuento exacto de tuplas vivas y muertas (y sus tamaños) y del espacio libre, pgstattuple_approx intenta evitar el escaneo completo de la tabla y devuelve estadísticas exactas de tuplas muertas junto con una aproximación de la cantidad y el tamaño de las tuplas vivas y del espacio libre.

Hace esto omitiendo las páginas que solo tienen tuplas visibles según el mapa de visibilidad (si una página tiene el bit VM correspondiente activo, se asume que no contiene tuplas muertas). Para tales páginas, obtiene el valor del espacio libre a partir del mapa de espacio libre (FSM), y asume que el resto del espacio en la página está ocupado por tuplas vivas.

Para las páginas que no se pueden omitir, escanea cada tupla, registrando su presencia y tamaño en los contadores correspondientes, y sumando el espacio libre en la página. Al final, estima el número total de tuplas vivas basándose en el número de páginas y tuplas escaneadas (de la misma manera que VACUUM estima pg_class.reltuples).

En la salida anterior, las cifras de espacio libre pueden no coincidir exactamente con la salida de pgstattuple, porque el mapa de espacio libre nos da una cifra aproximada, pero no se garantiza que sea exacta al byte.