Obtient les informations d'un enregistrement WAL situé sur ou après l'argument in_lsn. Par exemple :

postgres=# SELECT * FROM pg_get_wal_record_info('0/E419E28');
-[ RECORD 1 ]----+-------------------------------------------------
start_lsn        | 0/E419E28
end_lsn          | 0/E419E68
prev_lsn         | 0/E419D78
xid              | 0
resource_manager | Heap2
record_type      | VACUUM
record_length    | 58
main_data_length | 2
fpi_length       | 0
description      | nunused: 5, unused: [1, 2, 3, 4, 5]
block_ref        | blkref #0: rel 1663/16385/1249 fork main blk 364

Si in_lsn n'est pas au début d'un enregistrement WAL, l'information sur le prochain enregistrement WAL valide est affichée à la place. S'il n'y a pas d'enregistrement WAL valide, la fonction renvoie une erreur.

Obtient des informations sur tous les enregistrements WAL valides entre start_lsn et end_lsn. Renvoie une ligne par enregistrement WAL. Par exemple :

postgres=# SELECT * FROM pg_get_wal_records_info('0/1E913618', '0/1E913740') LIMIT 1;
-[ RECORD 1 ]----+--------------------------------------------------------------
start_lsn        | 0/1E913618
end_lsn          | 0/1E913650
prev_lsn         | 0/1E9135A0
xid              | 0
resource_manager | Standby
record_type      | RUNNING_XACTS
record_length    | 50
main_data_length | 24
fpi_length       | 0
description      | nextXid 33775 latestCompletedXid 33774 oldestRunningXid 33775
block_ref        |

Cette fonction renvoie une erreur si start_lsn n'est pas disponible.

Obtient des informations sur chaque référence de bloc à partir de tous les enregistrements WAL valides entre start_lsn et end_lsn avec une ou plusieurs références de blocs. Renvoie une ligne par référence de bloc par enregistrement WAL. Par exemple :

postgres=# SELECT * FROM pg_get_wal_block_info('0/1230278', '0/12302B8');
-[ RECORD 1 ]-----+-----------------------------------
start_lsn         | 0/1230278
end_lsn           | 0/12302B8
prev_lsn          | 0/122FD40
block_id          | 0
reltablespace     | 1663
reldatabase       | 1
relfilenode       | 2658
relforknumber     | 0
relblocknumber    | 11
xid               | 341
resource_manager  | Btree
record_type       | INSERT_LEAF
record_length     | 64
main_data_length  | 2
block_data_length | 16
block_fpi_length  | 0
block_fpi_info    |
description       | off: 46
block_data        | \x00002a00070010402630000070696400
block_fpi_data    |

Cet exemple implique un enregistrement WAL qui contient seulement une référence de bloc, mais beaucoup d'enregistrements WAL contiennent plusieurs références de blocs. Les lignes en sortie de pg_get_wal_block_info sont garanties avoir une combinaison unique de valeurs start_lsn et block_id.

Beaucoup des informations affichées ici correspondent à la sortie de pg_get_wal_records_info, en utilisant les mêmes arguments. Néanmoins, pg_get_wal_block_info désimbrique l'information pour chaque enregistrement WAL dans une forme étendue en affichant une ligne par référence de bloc, donc certains détails sont tracés au niveau de la référence de bloc plutôt qu'au niveau enregistrement. Cette structure est utile avec les requêtes qui tracent comment les blocs individuels changent dans le temps. Notez que les enregistrements sans référence de bloc (enregistrement WAL des COMMIT) n'auront pas de lignes renvoyées, donc pg_get_wal_block_info pourrait en fait renvoyer moins de lignes que pg_get_wal_records_info.

Les paramètres reltablespace, reldatabase et relfilenode référencent respectivement pg_tablespace.oid, pg_database.oid et pg_class.relfilenode. Le champ relforknumber est le numéro de fork dans la relation pour la référence de bloc ; voir common/relpath.h pour les détails.

Il est possible que les clients évitent la surcharge de la matérialisation des données. Ceci peut accélérer l'exécution de la fonction. Quand show_data vaut false, les valeurs de block_data et block_fpi_data sont omises (c'est-à-dire les arguments OUT block_data et block_fpi_data valent NULL pour toutes les lignes renvoyées). À l'évidence, cette optimisation est seulement faisable pour les requêtes où les données de bloc ne sont pas réellement demandées.

La fonction renvoie une erreur si start_lsn n'est pas disponible.

Récupère les statistiques de tous les enregistrements WAL valides entre start_lsn et end_lsn. Par défaut, elle renvoie une ligne par type resource_manager. Lorsque per_record est défini sur true, elle renvoie une ligne par record_type. Par exemple :

postgres=# SELECT * FROM pg_get_wal_stats('0/1E847D00', '0/1E84F500')
             WHERE count > 0 LIMIT 1 AND
                   "resource_manager/record_type" = 'Transaction';
-[ RECORD 1 ]----------------+-------------------
resource_manager/record_type | Transaction
count                        | 2
count_percentage             | 8
record_size                  | 875
record_size_percentage       | 41.23468426013195
fpi_size                     | 0
fpi_size_percentage          | 0
combined_size                | 875
combined_size_percentage     | 2.8634072910530795

La fonction renvoie une erreur si start_lsn n'est pas disponible.