pg_waldump — muestra una representación legible por humanos del registro de escritura anticipada (WAL) de un clúster de bases de datos PostgreSQL
pg_waldump [option...] [startseg [endseg]]
pg_waldump muestra el registro de escritura anticipada (WAL) y es principalmente
útil para fines de depuración o educativos.
Esta utilidad solo la puede ejecutar el usuario que instaló el servidor, porque requiere acceso de solo lectura al directorio de datos.
Las siguientes opciones de línea de comandos controlan la ubicación y el formato de la salida:
startsegComienza a leer en el archivo de segmento WAL especificado. Esto determina implícitamente la ruta en la que se buscarán los archivos y la línea de tiempo a utilizar.
endsegSe detiene después de leer el archivo de segmento WAL especificado.
-b--bkp-detailsMuestra información detallada sobre los bloques de copia de seguridad (backup blocks).
-B block--block=block
Solo muestra los registros que modifican el bloque dado. La relación también debe
proporcionarse con --relation o -R.
-e end--end=endSe detiene de leer en la ubicación WAL especificada, en lugar de leer hasta el final del flujo del registro.
-f--followTras alcanzar el final del WAL válido, sigue sondeando una vez por segundo para ver si aparece nuevo WAL.
-F fork--fork=fork
Solo muestra los registros que modifican bloques en la bifurcación (fork) dada.
Los valores válidos son main para el fork principal,
fsm para el mapa de espacio libre,
vm para el mapa de visibilidad,
e init para el fork de inicialización.
-n limit--limit=limitMuestra el número especificado de registros y luego se detiene.
-p path--path=path
Especifica un directorio en el que buscar archivos de segmento WAL o un
directorio con un subdirectorio pg_wal que
contenga dichos archivos. Por defecto se busca en el
directorio actual, en el subdirectorio pg_wal del
directorio actual y en el subdirectorio pg_wal
de PGDATA.
-q--quietNo muestra ninguna salida, excepto los errores. Esta opción puede ser útil cuando quieres saber si un rango de registros WAL se puede analizar con éxito pero no te importa el contenido de los registros.
-r rmgr--rmgr=rmgr
Solo muestra los registros generados por el administrador de recursos especificado. Puedes
especificar la opción varias veces para seleccionar varios administradores de recursos.
Si se pasa list como nombre, muestra una lista de nombres de administradores de recursos
válidos y termina.
Las extensiones pueden definir administradores de recursos personalizados, pero
pg_waldump no
carga el módulo de la extensión y, por lo tanto, no reconoce a los administradores de
recursos personalizados por su nombre. En su lugar, puedes especificar los administradores de
recursos personalizados como custom### donde
### es el ID del administrador de recursos de tres dígitos.
Los nombres con esta forma siempre se considerarán válidos.
-R tblspc/db/rel--relation=tblspc/db/rel
Solo muestra los registros que modifican bloques en la relación dada. La
relación se especifica con el OID del tablespace, el OID de la base de datos y el relfilenode
separados por barras diagonales, por ejemplo 1234/12345/12345.
Este es el mismo formato utilizado para las relaciones en la salida del programa.
-s start--start=startUbicación WAL en la que comenzar a leer. Por defecto se empieza a leer el primer registro WAL válido encontrado en el archivo más antiguo hallado.
-t timeline--timeline=timeline
Línea de tiempo desde la cual leer registros WAL. Por defecto se utiliza el
valor en startseg, si se especifica; de lo contrario, el
valor predeterminado es 1. El valor se puede especificar en decimal o hexadecimal,
por ejemplo 17 o 0x11.
-V--versionMuestra la versión de pg_waldump y termina.
-w--fullpageSolo muestra los registros que incluyen imágenes de página completa.
-x xid--xid=xidSolo muestra los registros marcados con el ID de transacción dado.
-z--stats[=record]Muestra estadísticas de resumen (número y tamaño de registros e imágenes de página completa) en lugar de registros individuales. Opcionalmente, genera estadísticas por registro en lugar de por rmgr.
Si pg_waldump es terminado por la señal SIGINT (Control+C), se muestra el resumen de las estadísticas calculadas hasta el punto de terminación. Esta operación no está admitida en Windows.
--save-fullpage=save_path
Guarda las imágenes de página completa encontradas en los registros WAL en el
directorio save_path. Las imágenes guardadas
están sujetas a los mismos criterios de filtrado y limitación que los
registros mostrados.
Las imágenes de página completa se guardan con el siguiente formato de nombre de archivo:
Los nombres de archivo se componen de las siguientes partes:
TIMELINE-LSN.RELTABLESPACE.DATOID.RELNODE.BLKNO_FORK
| Componente | Descripción |
|---|---|
| TIMELINE | La línea de tiempo del archivo de segmento WAL donde se encuentra el registro,
formateada como un número hexadecimal de 8 caracteres
%08X |
| LSN | El LSN del registro con esta imagen,
formateado como dos números hexadecimales de 8 caracteres
%08X-%08X |
| RELTABLESPACE | OID del tablespace del bloque |
| DATOID | OID de la base de datos del bloque |
| RELNODE | filenode del bloque |
| BLKNO | número del bloque |
| FORK |
El nombre del fork del que proviene la imagen de página completa, como
main, fsm,
vm o init.
|
-?--helpMuestra la ayuda sobre los argumentos de línea de comandos de pg_waldump y termina.
PGDATA
Directorio de datos; véase también la opción -p.
PG_COLOR
Especifica si se debe usar color en los mensajes de diagnóstico. Los valores posibles
son always, auto y
never.
Puede dar resultados incorrectos cuando el servidor está ejecutándose.
Solo se muestra la línea de tiempo especificada (o la predeterminada, si no se especifica ninguna). Se ignoran los registros en otras líneas de tiempo.
pg_waldump no puede leer archivos WAL con el sufijo
.partial. Si es necesario leer esos archivos, se debe eliminar el sufijo
.partial del nombre del archivo.