pg_waldump

pg_waldump — muestra una representación legible por humanos del registro de escritura anticipada (WAL) de un clúster de bases de datos PostgreSQL

Synopsis

pg_waldump [option...] [startseg [endseg]]

Descripción

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.

Opciones

Las siguientes opciones de línea de comandos controlan la ubicación y el formato de la salida:

startseg

Comienza 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.

endseg

Se detiene después de leer el archivo de segmento WAL especificado.

-b
--bkp-details

Muestra 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=end

Se detiene de leer en la ubicación WAL especificada, en lugar de leer hasta el final del flujo del registro.

-f
--follow

Tras 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=limit

Muestra 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
--quiet

No 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=start

Ubicació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
--version

Muestra la versión de pg_waldump y termina.

-w
--fullpage

Solo muestra los registros que incluyen imágenes de página completa.

-x xid
--xid=xid

Solo 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: TIMELINE-LSN.RELTABLESPACE.DATOID.RELNODE.BLKNO_FORK Los nombres de archivo se componen de las siguientes partes:

ComponenteDescripción
TIMELINELa línea de tiempo del archivo de segmento WAL donde se encuentra el registro, formateada como un número hexadecimal de 8 caracteres %08X
LSNEl LSN del registro con esta imagen, formateado como dos números hexadecimales de 8 caracteres %08X-%08X
RELTABLESPACEOID del tablespace del bloque
DATOIDOID de la base de datos del bloque
RELNODEfilenode del bloque
BLKNOnúmero del bloque
FORK El nombre del fork del que proviene la imagen de página completa, como main, fsm, vm o init.

-?
--help

Muestra la ayuda sobre los argumentos de línea de comandos de pg_waldump y termina.

Entorno

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.

Notas

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.

Véase también

Section 28.6