Especifica el nombre de la base de datos que se va a exportar. Si esto no se especifica, se utiliza la variable de entorno PGDATABASE. Si esta no está configurada, se utiliza el nombre de usuario especificado para la conexión.

Exporta solo los datos, no el esquema (definiciones de datos) ni las estadísticas. Se exportan los datos de las tablas, los objetos grandes (large objects) y los valores de las secuencias.

Esta opción es similar a, pero por razones históricas no idéntica a, especificar --section=data.

Incluye objetos grandes en la copia de seguridad. Este es el comportamiento predeterminado excepto cuando se especifica --schema, --table, --schema-only, --statistics-only o --no-data. Por lo tanto, la opción -b solo es útil para agregar objetos grandes a las copias de seguridad donde se ha solicitado un esquema o tabla específicos. Ten en cuenta que los objetos grandes se consideran datos y, por lo tanto, se incluirán cuando se utiliza --data-only, pero no cuando se utiliza --schema-only o --statistics-only.

Excluye los objetos grandes en la copia de seguridad.

Cuando se proporcionan tanto -b como -B, el comportamiento es generar objetos grandes cuando se están exportando datos, consulta la documentación de -b.

Genera comandos para eliminar (DROP) todos los objetos de base de datos exportados antes de generar los comandos para crearlos. Esta opción es útil cuando la restauración va a sobrescribir una base de datos existente. Si alguno de los objetos no existe en la base de datos de destino, se informará de mensajes de error ignorables durante la restauración, a menos que también se especifique --if-exists.

Esta opción se ignora cuando se genera un archivo de salida de archivo de respaldo (no de texto). Para los formatos de archivo de respaldo, puedes especificar la opción cuando llames a pg_restore.

Comienza la salida con un comando para crear la propia base de datos y volverse a conectar a la base de datos creada. (Con un script de esta forma, no importa a qué base de datos de la instalación de destino te conectes antes de ejecutar el script). Si también se especifica --clean, el script elimina y vuelve a crear la base de datos de destino antes de volver a conectarse a ella.

Con --create, la salida también incluye el comentario de la base de datos si lo hubiera, y cualquier parámetro de variable de configuración que sea específico de esta base de datos, es decir, cualquier comando ALTER DATABASE ... SET ... y ALTER ROLE ... IN DATABASE ... SET ... que mencione esta base de datos. Los privilegios de acceso para la propia base de datos también se exportan, a menos que se especifique --no-acl.

Esta opción se ignora cuando se genera un archivo de salida de archivo de respaldo (no de texto). Para los formatos de archivo de respaldo, puedes especificar la opción cuando llames a pg_restore.

Exporta solo las extensiones que coincidan con el patrón. Cuando esta opción no está especificada, se exportarán todas las extensiones que no sean del sistema en la base de datos de destino. Se pueden seleccionar múltiples extensiones escribiendo múltiples opciones -e. El parámetro patrón se interpreta como un patrón de acuerdo con las mismas reglas utilizadas por los comandos \d de psql (ver Patterns), por lo que también se pueden seleccionar múltiples extensiones escribiendo caracteres comodín en el patrón. Al usar comodines, ten cuidado de entrecomillar el patrón si es necesario para evitar que el shell expanda los comodines.

Cualquier relación de configuración registrada por pg_extension_config_dump se incluye en la copia de seguridad si su extensión es especificada por --extension.

Crea la copia de seguridad en la codificación de caracteres especificada. Por defecto, la copia de seguridad se crea en la codificación de la base de datos. (Otra forma de obtener el mismo resultado es establecer la variable de entorno PGCLIENTENCODING a la codificación de copia de seguridad deseada). Las codificaciones admitidas se describen en Section 23.3.1.

Envía la salida al archivo especificado. Este parámetro se puede omitir para los formatos de salida basados en archivos, en cuyo caso se utiliza la salida estándar. Sin embargo, debe proporcionarse para el formato de salida de directorio, donde especifica el directorio de destino en lugar de un archivo. En este caso, el directorio es creado por pg_dump y no debe existir previamente.

Selecciona el formato de la salida. format puede ser uno de los siguientes:

Ejecuta la copia de seguridad en paralelo exportando njobs tablas simultáneamente. Esta opción puede reducir el tiempo necesario para realizar la copia de seguridad, pero también aumenta la carga en el servidor de bases de datos. Solo puedes utilizar esta opción con el formato de salida de directorio porque este es el único formato de salida donde múltiples procesos pueden escribir sus datos al mismo tiempo.

pg_dump abrirá njobs + 1 conexiones a la base de datos, así que asegúrate de que tu parámetro max_connections esté configurado con un valor lo suficientemente alto como para acomodar todas las conexiones.

Solicitar bloqueos exclusivos sobre objetos de base de datos mientras se ejecuta una copia de seguridad en paralelo podría hacer que la copia de seguridad falle. La razón es que el proceso líder de pg_dump solicita bloqueos compartidos (ACCESS SHARE) sobre los objetos que los procesos trabajadores van a exportar más tarde para asegurarse de que nadie los elimine ni los haga desaparecer mientras se ejecuta la copia de seguridad. Si otro cliente solicita entonces un bloqueo exclusivo sobre una tabla, ese bloqueo no se otorgará, sino que se encolará esperando a que se libere el bloqueo compartido del proceso líder. Como consecuencia, cualquier otro acceso a la tabla tampoco se otorgará y se encolará detrás de la solicitud de bloqueo exclusivo. Esto incluye al proceso trabajador que intenta exportar la tabla. Sin ninguna precaución, esto sería una situación clásica de interbloqueo (deadlock). Para detectar este conflicto, el proceso trabajador de pg_dump solicita otro bloqueo compartido utilizando la opción NOWAIT. Si al proceso trabajador no se le otorga este bloqueo compartido, significa que alguien más debe haber solicitado un bloqueo exclusivo en el ínterin y no hay forma de continuar con la copia de seguridad, por lo que a pg_dump no le queda más remedio que abortar la copia de seguridad.

Para realizar una copia de seguridad en paralelo, el servidor de bases de datos necesita admitir instantáneas sincronizadas, una característica que se introdujo en PostgreSQL 9.2 para servidores primarios y 10 para servidores en espera (standby). Con esta característica, los clientes de base de datos pueden asegurarse de ver el mismo conjunto de datos aunque utilicen conexiones diferentes. pg_dump -j utiliza múltiples conexiones de base de datos; se conecta a la base de datos una vez con el proceso líder y una vez más por cada trabajo trabajador (worker). Sin la característica de instantánea sincronizada, no se garantizaría que los diferentes trabajos trabajadores vieran los mismos datos en cada conexión, lo que podría conducir a una copia de seguridad inconsistente.

Exporta solo los esquemas que coincidan con el patrón; esto selecciona tanto el propio esquema como todos los objetos contenidos en él. Cuando no se especifica esta opción, se exportarán todos los esquemas que no sean del sistema en la base de datos de destino. Se pueden seleccionar múltiples esquemas escribiendo múltiples opciones -n. El parámetro patrón se interpreta como un patrón de acuerdo con las mismas reglas utilizadas por los comandos \d de psql (ver Patterns), por lo que también se pueden seleccionar múltiples esquemas escribiendo caracteres comodín en el patrón. Al usar comodines, ten cuidado de entrecomillar el patrón si es necesario para evitar que el shell expanda los comodines; consulta la sección Examples a continuación.

No exporta ningún esquema que coincida con el patrón. El patrón se interpreta de acuerdo con las mismas reglas que para -n. Se puede proporcionar -N más de una vez para excluir esquemas que coincidan con cualquiera de varios patrones.

Cuando se proporcionan tanto -n como -N, el comportamiento es exportar solo los esquemas que coincidan al menos con una opción -n pero con ninguna opción -N. Si aparece -N sin -n, entonces los esquemas que coincidan con -N se excluyen de lo que de otro modo sería una copia de seguridad normal.

No genera comandos para establecer la propiedad de los objetos para que coincida con la base de datos original. Por defecto, pg_dump emite sentencias ALTER OWNER o SET SESSION AUTHORIZATION para establecer la propiedad de los objetos de base de datos creados. Estas sentencias fallarán cuando se ejecute el script a menos que sea iniciado por un superusuario (o el mismo usuario propietario de todos los objetos del script). Para hacer un script que pueda ser restaurado por cualquier usuario, pero que otorgue a ese usuario la propiedad de todos los objetos, especifica -O.

Esta opción se ignora cuando se genera un archivo de salida de archivo de respaldo (no de texto). Para los formatos de archivo de respaldo, puedes especificar la opción cuando llames a pg_restore.

Esta opción está obsoleta pero aún se acepta por compatibilidad con versiones anteriores.

Exporta solo las definiciones de objetos (esquema), no los datos ni las estadísticas.

Esta opción no se puede usar con --data-only o --statistics-only. Es similar a, pero por razones históricas no idéntica a, especificar --section=pre-data --section=post-data.

(No confundas esto con la opción --schema, que utiliza la palabra “esquema” con un significado diferente).

Para excluir los datos de las tablas solo para un subconjunto de tablas en la base de datos, consulta --exclude-table-data.

Especifica el nombre de usuario del superusuario que se utilizará al deshabilitar los disparadores (triggers). Esto es relevante solo si se utiliza --disable-triggers. (Normalmente, es mejor omitir esto y, en su lugar, iniciar el script resultante como superusuario).

Exporta solo las tablas con nombres que coincidan con el patrón. Se pueden seleccionar múltiples tablas escribiendo múltiples opciones -t. El parámetro patrón se interpreta como un patrón de acuerdo con las mismas reglas utilizadas por los comandos \d de psql (ver Patterns), por lo que también se pueden seleccionar múltiples tablas escribiendo caracteres comodín en el patrón. Al usar comodines, ten cuidado de entrecomillar el patrón si es necesario para evitar que el shell expanda los comodines; consulta la sección Examples a continuación.

Además de las tablas, esta opción se puede utilizar para exportar la definición de vistas, vistas materializadas, tablas foráneas y secuencias que coincidan. No exportará el contenido de las vistas o vistas materializadas, y el contenido de las tablas foráneas solo se exportará si el servidor foráneo correspondiente se especifica con --include-foreign-data.

Las opciones -n y -N no tienen efecto cuando se utiliza -t, porque las tablas seleccionadas por -t se exportarán independientemente de esas opciones, y los objetos que no sean tablas no se exportarán.

No exporta ninguna tabla que coincida con el patrón. El patrón se interpreta de acuerdo con las mismas reglas que para -t. Se puede proporcionar -T más de una vez para excluir tablas que coincidan con cualquiera de varios patrones.

Cuando se proporcionan tanto -t como -T, el comportamiento es exportar solo las tablas que coincidan al menos con una opción -t pero con ninguna opción -T. Si aparece -T sin -t, entonces las tablas que coincidan con -T se excluyen de lo que de otro modo sería una copia de seguridad normal.

Especifica el modo detallado (verbose). Esto hará que pg_dump escriba comentarios detallados sobre los objetos y los tiempos de inicio/finalización en el archivo de copia de seguridad, y mensajes de progreso en la salida de error estándar. Repetir la opción hace que aparezcan mensajes de depuración adicionales en la salida de error estándar.

Muestra la versión de pg_dump y termina.

Evita la exportación de privilegios de acceso (comandos grant/revoke).

Especifica el método de compresión y/o el nivel de compresión que se utilizará. El método de compresión se puede establecer en gzip, lz4, zstd o none para que no haya compresión. Opcionalmente, se puede especificar una cadena de detalle de compresión. Si la cadena de detalle es un número entero, especifica el nivel de compresión. De lo contrario, debe ser una lista de elementos separados por comas, cada uno con la forma keyword o keyword=value. Actualmente, las palabras clave admitidas son level y long.

Si no se especifica ningún nivel de compresión, se utilizará el nivel de compresión predeterminado. Si solo se especifica un nivel sin mencionar un algoritmo, se utilizará la compresión gzip si el nivel es mayor que 0, y no se utilizará ninguna compresión si el nivel es 0.

Para los formatos de archivo de respaldo personalizado y de directorio, esto especifica la compresión de los segmentos de datos de tablas individuales, y el valor predeterminado es comprimir utilizando gzip a un nivel moderado. Para la salida de texto plano, establecer un nivel de compresión distinto de cero hace que todo el archivo de salida se comprima, como si se hubiera enviado a través de gzip, lz4 o zstd; pero el valor predeterminado es no comprimir. Con la compresión zstd, el modo long puede mejorar la relación de compresión, a costa de un mayor uso de memoria.

El formato de archivo tar actualmente no admite compresión en absoluto.

Esta opción es para uso de las utilidades de actualización en el lugar. Su uso para otros fines no está recomendado ni admitido. El comportamiento de la opción puede cambiar en futuras versiones sin previo aviso.

Exporta los datos como comandos INSERT con nombres de columna explícitos (INSERT INTO tabla (columna, ...) VALUES ...). Esto hará que la restauración sea muy lenta; es principalmente útil para realizar copias de seguridad que se puedan cargar en bases de datos que no sean de PostgreSQL. Cualquier error durante la restauración hará que se pierdan solo las filas que forman parte del comando INSERT problemático, en lugar de todo el contenido de la tabla.

Esta opción deshabilita el uso de la delimitación por dólares (dollar quoting) para los cuerpos de las funciones y los fuerza a ser delimitados utilizando la sintaxis de cadena estándar de SQL.

Esta opción es relevante solo cuando se crea una copia de seguridad que incluye datos pero no incluye el esquema. Instruye a pg_dump para que incluya comandos para deshabilitar temporalmente los disparadores (triggers) en las tablas de destino mientras se restauran los datos. Utiliza esto si tienes comprobaciones de integridad referencial u otros disparadores en las tablas que no deseas invocar durante la restauración de datos.

Actualmente, los comandos emitidos para --disable-triggers deben realizarse como superusuario. Por lo tanto, también debes especificar un nombre de superusuario con -S, o preferiblemente tener cuidado de iniciar el script resultante como superusuario.

Esta opción se ignora cuando se genera un archivo de salida de archivo de respaldo (not-text). Para los formatos de archivo de respaldo, puedes especificar la opción cuando llames a pg_restore.

Esta opción es relevante solo cuando se exporta el contenido de una tabla que tiene seguridad a nivel de fila. Por defecto, pg_dump establecerá row_security a off, para asegurarse de que se exporten todos los datos de la tabla. Si el usuario no tiene privilegios suficientes para eludir la seguridad a nivel de fila, se lanza un error. Este parámetro instruye a pg_dump para que establezca row_security a on en su lugar, lo que permite al usuario exportar las partes del contenido de la tabla a las que tiene acceso.

Ten en cuenta que si utilizas esta opción actualmente, probablemente también quieras que la copia de seguridad esté en formato INSERT, ya que el comando COPY FROM durante la restauración no admite la seguridad a nivel de fila.

No exporta ninguna extensión que coincida con el patrón. El patrón se interpreta de acuerdo con las mismas reglas que para -e. Se puede proporcionar --exclude-extension más de una vez para excluir extensiones que coincidan con cualquiera de varios patrones.

Cuando se proporcionan tanto -e como --exclude-extension, el comportamiento es exportar solo las extensiones que coincidan al menos con una opción -e pero con ninguna opción --exclude-extension. Si aparece --exclude-extension sin -e, entonces las extensiones que coincidan con --exclude-extension se excluyen de lo que de otro modo sería una copia de seguridad normal.

Esto es lo mismo que la opción -T/--exclude-table, excepto que también excluye cualquier partición o tabla hija de herencia de las tablas que coincidan con el patrón.

No exporta datos para ninguna tabla que coincida con el patrón. El patrón se interpreta de acuerdo con las mismas reglas que para -t. Se puede proporcionar --exclude-table-data más de una vez para excluir tablas que coincidan con cualquiera de varios patrones. Esta opción es útil cuando necesitas la definición de una tabla en particular aunque no necesites los datos que contiene.

Para excluir datos de todas las tablas de la base de datos, consulta --schema-only o --statistics-only.

Esto es lo mismo que la opción --exclude-table-data, excepto que también excluye los datos de cualquier partición o tabla hija de herencia de las tablas que coincidan con el patrón.

Utiliza el valor especificado de extra_float_digits al exportar datos de punto flotante, en lugar de la precisión máxima disponible. Las copias de seguridad rutinarias realizadas con fines de respaldo no deberían utilizar esta opción.

Especifica un nombre de archivo del cual leer patrones de objetos para incluir o excluir de la copia de seguridad. Los patrones se interpretan de acuerdo con las mismas reglas que las opciones correspondientes: -t/--table, --table-and-children, -T/--exclude-table y --exclude-table-and-children para tablas, -n/--schema y -N/--exclude-schema para esquemas, --include-foreign-data para datos en servidores foráneos, --exclude-table-data y --exclude-table-data-and-children para datos de tablas, y -e/--extension y --exclude-extension para extensiones. Para leer de la entrada estándar (STDIN), utiliza - como nombre de archivo. La opción --filter se puede especificar en conjunto con las opciones enumeradas anteriormente para incluir o excluir objetos, y también se puede especificar más de una vez para múltiples archivos de filtro.

El archivo enumera un patrón de objeto por fila, con el siguiente formato:

{ include | exclude } { extension | foreign_data | table | table_and_children | table_data | table_data_and_children | schema } PATTERN

La primera palabra clave especifica si los objetos que coinciden con el patrón se van a incluir o excluir. La segunda palabra clave especifica el tipo de objeto a filtrar utilizando el patrón:

Las líneas que comienzan con # se consideran comentarios y se ignoran. Los comentarios también se pueden colocar después de una fila de patrón de objeto. Las líneas en blanco también se ignoran. Consulta Patterns para saber cómo realizar el entrecomillado en los patrones.

Los archivos de ejemplo se enumeran a continuación en la sección Examples.

Utiliza comandos DROP ... IF EXISTS para eliminar objetos en el modo --clean. Esto suprime los errores de tipo “no existe” que de otro modo podrían informarse. Esta opción no es válida a menos que también se especifique --clean.

Exporta los datos de cualquier tabla foránea con un servidor foráneo que coincida con el patrón foreignserver. Se pueden seleccionar múltiples servidores foráneos escribiendo múltiples opciones --include-foreign-data. Además, el parámetro foreignserver se interpreta como un patrón de acuerdo con las mismas reglas utilizadas por los comandos \d de psql (ver Patterns), por lo que también se pueden seleccionar múltiples servidores foráneos escribiendo caracteres comodín en el patrón. Al usar comodines, ten cuidado de entrecomillar el patrón si es necesario para evitar que el shell expanda los comodines; consulta la sección Examples a continuación. La única excepción es que no se permite un patrón vacío.

Exporta los datos como comandos INSERT (en lugar de COPY). Esto hará que la restauración sea muy lenta; es principalmente útil para realizar copias de seguridad que se puedan cargar en bases de datos que no sean de PostgreSQL. Cualquier error durante la restauración hará que se pierdan solo las filas que forman parte del comando INSERT problemático, en lugar de todo el contenido de la tabla. Ten en cuenta que la restauración podría fallar por completo si has reorganizado el orden de las columnas. La opción --column-inserts es segura frente a los cambios en el orden de las columnas, aunque es aún más lenta.

Al exportar datos para una partición de tabla, hace que las sentencias COPY o INSERT se dirijan a la raíz de la jerarquía de particionamiento que la contiene, en lugar de a la propia partición. Esto hace que la partición adecuada se vuelva a determinar para cada fila cuando se cargan los datos. Esto puede ser útil al restaurar datos en un servidor donde las filas no siempre caen en las mismas particiones que en el servidor original. Eso podría suceder, por ejemplo, if la columna de particionamiento es de tipo text y los dos sistemas tienen definiciones diferentes de la intercalación (collation) utilizada para ordenar la columna de particionamiento.

No espera indefinidamente para adquirir bloqueos de tabla compartidos al comienzo de la copia de seguridad. En su lugar, falla si no se puede bloquear una tabla dentro del tiempo de espera especificado. El tiempo de espera se puede especificar en cualquiera de los formatos aceptados por SET statement_timeout. (Los formatos permitidos varían según la versión del servidor de la que estés exportando, pero todas las versiones aceptan un número entero de milisegundos).

No exporta comandos COMMENT.

No exporta los datos.

No exporta políticas de seguridad a nivel de fila (row security policies).

No exporta publicaciones.

No exporta el esquema (definiciones de datos).

No exporta etiquetas de seguridad.

No exporta estadísticas. Este es el comportamiento predeterminado.

No exporta suscripciones.

Por defecto, pg_dump esperará a que todos los archivos se escriban de forma segura en el disco. Esta opción hace que pg_dump devuelva el control sin esperar, lo que es más rápido, pero significa que un fallo posterior del sistema operativo puede dejar corrupta la copia de seguridad. Generalmente, esta opción es útil para pruebas pero no debe utilizarse al exportar datos de una instalación de producción.

No genera comandos para seleccionar métodos de acceso a tablas. Con esta opción, todos los objetos se crearán con el método de acceso a tablas que sea el predeterminado durante la restauración.

Esta opción se ignora cuando se genera un archivo de salida de archivo de respaldo (no de texto). Para los formatos de archivo de respaldo, puedes especificar la opción cuando llames a pg_restore.

No genera comandos para seleccionar tablespaces. Con esta opción, todos los objetos se crearán en el tablespace que sea el predeterminado durante la restauración.

Esta opción se ignora cuando se genera un archivo de salida de archivo de respaldo (no de texto). Para los formatos de archivo de respaldo, puedes especificar la opción cuando llames a pg_restore.

No genera comandos para establecer métodos de compresión TOAST. Con esta opción, todas las columnas se restaurarán con la configuración de compresión predeterminada.

No exporta el contenido de las tablas y secuencias no registradas (unlogged). Esta opción no tiene efecto sobre si se exportan o no las definiciones de las tablas y secuencias (esquema); solo suprime la exportación de los datos de las tablas y secuencias. Los datos de las tablas y secuencias no registradas siempre se excluyen cuando se realiza la copia de seguridad desde un servidor en espera (standby).

Agrega ON CONFLICT DO NOTHING a los comandos INSERT. Esta opción no es válida a menos que también se especifique --inserts, --column-inserts o --rows-per-insert.

Fuerza el entrecomillado de todos los identificadores. Esta opción se recomienda cuando se exporta una base de datos desde un servidor cuya versión principal de PostgreSQL es diferente de la versión de pg_dump, o cuando la salida está destinada a cargarse en un servidor de una versión principal diferente. Por defecto, pg_dump entrecomilla solo los identificadores que son palabras reservadas en su propia versión principal. Esto a veces da como resultado problemas de compatibilidad al tratar con servidores de otras versiones que pueden tener conjuntos de palabras reservadas ligeramente diferentes. El uso de --quote-all-identifiers evita tales problemas, a costa de un script de copia de seguridad más difícil de leer.

Utiliza la cadena proporcionada como la clave \restrict de psql en la salida de la copia de seguridad. Esto solo se puede especificar para copias de seguridad de texto plano, es decir, cuando --format está establecido en plain o se omite la opción --format. Si no se especifica ninguna clave de restricción, pg_dump generará una aleatoria según sea necesario. Las claves solo pueden contener caracteres alfanuméricos.

Esta opción está destinada principalmente a fines de prueba y otros escenarios que requieren una salida repetible (por ejemplo, comparar archivos de copia de seguridad). No se recomienda para uso general, ya que un servidor malicioso con conocimiento previo de la clave podría inyectar código arbitrario que se ejecutará en la máquina que ejecuta psql con la salida de la copia de seguridad.

Exporta datos como comandos INSERT (en lugar de COPY). Controla el número máximo de filas por comando INSERT. El valor especificado debe ser un número mayor que cero. Cualquier error durante la restauración hará que se pierdan solo las filas que forman parte del comando INSERT problemático, en lugar de todo el contenido de la tabla.

Solo exporta la sección nombrada. El nombre de la sección puede ser pre-data, data o post-data. Esta opción se puede especificar más de una vez para seleccionar múltiples secciones. El valor predeterminado es exportar todas las secciones.

La sección de datos (data) contiene los datos reales de las tablas, el contenido de los objetos grandes, los valores de las secuencias y las estadísticas para las tablas, vistas materializadas y tablas foráneas. Los elementos post-datos (post-data) incluyen definiciones de índices, disparadores, reglas, estadísticas para índices y restricciones distintas de las restricciones check validadas y not-null. Los elementos pre-datos (pre-data) incluyen todos los demás elementos de definición de datos.

Incluye los datos de las secuencias en la copia de seguridad. Este es el comportamiento predeterminado excepto cuando se especifica --no-data, --schema-only o --statistics-only.

Utiliza una transacción serializable para la copia de seguridad, para garantizar que la instantánea utilizada sea consistente con los estados posteriores de la base de datos; pero hace esto esperando un punto en el flujo de transacciones en el que no puedan presentarse anomalías, de modo que no exista el riesgo de que la copia de seguridad falle o haga que otras transacciones se reviertan con una serialization_failure. Consulta Chapter 13 para obtener más información sobre el aislamiento de transacciones y el control de concurrencia.

Esta opción no es beneficiosa para una copia de seguridad destinada únicamente a la recuperación ante desastres. Podría ser útil para una copia de seguridad utilizada para cargar una copia de la base de datos para informes u otro uso compartido de carga de solo lectura mientras la base de datos original continúa actualizándose. Sin ella, la copia de seguridad puede reflejar un estado que no es consistente con ninguna ejecución serial de las transacciones finalmente confirmadas. Por ejemplo, si se utilizan técnicas de procesamiento por lotes, un lote puede mostrarse como cerrado en la copia de seguridad sin que aparezcan todos los elementos que están en el lote.

Esta opción no marcará ninguna diferencia si no hay transacciones de lectura-escritura activas cuando se inicia pg_dump. Si hay transacciones de lectura-escritura activas, el inicio de la copia de seguridad puede retrasarse durante un período de tiempo indeterminado. Una vez en ejecución, el rendimiento con o sin la opción es el mismo.

Utiliza la instantánea sincronizada especificada al realizar una copia de seguridad de la base de datos (consulta Table 9.100 para obtener más detalles).

Esta opción es útil cuando se necesita sincronizar la copia de seguridad con un slot de replicación lógica (ver Chapter 47) o con una sesión concurrente.

En el caso de una copia de seguridad en paralelo, se utiliza el nombre de la instantánea definido por esta opción en lugar de tomar una nueva instantánea.

Exporta las estadísticas del optimizador.

Exporta solo las estadísticas, no el esquema (definiciones de datos) ni los datos. Se exportan las estadísticas del optimizador para tablas, vistas materializadas, tablas foráneas e índices.

Requiere que cada patrón de extensión (-e/--extension), esquema (-n/--schema) y tabla (-t/--table) coincida al menos con una extensión/esquema/tabla en la base de datos a exportar. Esto también se aplica a los filtros utilizados con --filter. Ten en cuenta que si ninguno de los patrones de extensión/esquema/tabla encuentra coincidencias, pg_dump generará un error incluso sin --strict-names.

Esta opción no tiene efecto en --exclude-extension, -N/--exclude-schema, -T/--exclude-table o --exclude-table-data. Que un patrón de exclusión no coincida con ningún objeto no se considera un error.

Cuando se establece en fsync, que es el valor predeterminado, pg_dump --format=directory abrirá y sincronizará de forma recursiva todos los archivos en el directorio del archivo de respaldo.

En Linux, se puede usar syncfs en su lugar para solicitar al sistema operativo que sincronice todo el sistema de archivos que contiene el directorio del archivo de respaldo. Consulta recovery_init_sync_method para obtener información sobre las advertencias que debes tener en cuenta al usar syncfs.

Esta opción no tiene efecto cuando se utiliza --no-sync o cuando --format no está establecido en directory.

Esto es lo mismo que la opción -t/--table, excepto que también incluye cualquier partición o tabla hija de herencia de las tablas que coincidan con el patrón.

Genera comandos SET SESSION AUTHORIZATION estándar de SQL en lugar de comandos ALTER OWNER para determinar la propiedad de los objetos. Esto hace que la copia de seguridad sea más compatible con los estándares, pero dependiendo de la historia de los objetos en la copia de seguridad, podría no restaurarse correctamente. Además, una copia de seguridad que utilice SET SESSION AUTHORIZATION ciertamente requerirá privilegios de superusuario para restaurarse correctamente, mientras que ALTER OWNER requiere privilegios menores.

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

Especifica el nombre de la base de datos a la que conectarse. Esto es equivalente a especificar dbname como el primer argumento que no es una opción en la línea de comandos. El dbname puede ser una cadena de conexión. Si es así, los parámetros de la cadena de conexión anularán cualquier opción de línea de comandos en conflicto.

Especifica el nombre de host de la máquina en la que se ejecuta el servidor. Si el valor comienza con una barra diagonal, se utiliza como el directorio para el socket de dominio Unix. El valor predeterminado se toma de la variable de entorno PGHOST, si está configurada; de lo contrario, se intenta una conexión por socket de dominio Unix.

Especifica el puerto TCP o la extensión del archivo del socket de dominio Unix local en el que el servidor escucha las conexiones. El valor predeterminado es la variable de entorno PGPORT, si está configurada, o un valor predeterminado compilado.

Nombre de usuario con el que conectarse.

Nunca solicita una contraseña. Si el servidor requiere autenticación por contraseña y no hay una contraseña disponible por otros medios como un archivo .pgpass, el intento de conexión fallará. Esta opción puede ser útil en trabajos por lotes y scripts donde no hay ningún usuario presente para introducir una contraseña.

Fuerza a pg_dump a solicitar una contraseña antes de conectarse a una base de datos.

Esta opción nunca es indispensable, ya que pg_dump solicitará automáticamente una contraseña si el servidor requiere autenticación por contraseña. Sin embargo, pg_dump desperdiciará un intento de conexión para descubrir que el servidor requiere una contraseña. En algunos casos, vale la pena escribir -W para evitar el intento de conexión adicional.

Especifica un nombre de rol que se utilizará para crear la copia de seguridad. Esta opción hace que pg_dump emita un comando SET ROLE rolename después de conectarse a la base de datos. Es útil cuando el usuario autenticado (especificado por -U) carece de los privilegios necesarios para pg_dump, pero puede cambiar a un rol con los derechos requeridos. Algunas instalaciones tienen una política contra el inicio de sesión directo como superusuario, y el uso de esta opción permite realizar copias de seguridad sin violar la política.

Parámetros de conexión predeterminados.

Especifica si se debe usar color en los mensajes de diagnóstico. Los valores posibles son always, auto y never.