Los archivos de texto creados por pg_dump están destinados a ser leídos por el programa psql utilizando su configuración por defecto. La forma general del comando para restaurar un volcado de texto es

psql -X dbname < dumpfile

donde dumpfile es el archivo de salida del comando pg_dump. La base de datos dbname no será creada por este comando, por lo que debes crearla tú mismo a partir de template0 antes de ejecutar psql (por ejemplo, con createdb -T template0 dbname). Para asegurarte de que psql se ejecute con su configuración por defecto, utiliza la opción -X (--no-psqlrc). psql admite opciones similares a pg_dump para especificar el servidor de base de datos al que conectarse y el nombre de usuario a utilizar. Consulta la página de referencia de psql para obtener más información.

Los volcados de archivos que no son de texto deben restaurarse utilizando la utilidad pg_restore.

Antes de restaurar un volcado SQL, todos los usuarios que son propietarios de objetos o a los que se les concedieron permisos sobre objetos en la base de datos volcada ya deben existir. Si no es así, la restauración no podrá recrear los objetos con la propiedad y/o los permisos originales. (A veces esto es lo que quieres, pero normalmente no es así).

Por defecto, el script de psql continuará ejecutándose después de encontrar un error SQL. Es posible que desees ejecutar psql con la variable ON_ERROR_STOP establecida para alterar ese comportamiento y hacer que psql salga con un estado de salida de 3 si ocurre un error SQL:

psql -X --set ON_ERROR_STOP=on dbname < dumpfile

De cualquier manera, solo tendrás una base de datos parcialmente restaurada. Alternativamente, puedes especificar que todo el volcado se restaure como una sola transacción, de modo que la restauración se complete por completo o se revierta (rollback) por completo. Este modo se puede especificar pasando las opciones de línea de comandos -1 o --single-transaction a psql. Al utilizar este modo, ten en cuenta que incluso un error menor puede revertir una restauración que ya se ha ejecutado durante muchas horas. Sin embargo, eso podría ser preferible a limpiar manualmente una base de datos compleja después de un volcado parcialmente restaurado.

La capacidad de pg_dump y psql para escribir o leer desde tuberías (pipes) hace posible volcar una base de datos directamente de un servidor a otro, por ejemplo:

pg_dump -h host1 dbname | psql -X -h host2 dbname

Después de restaurar un respaldo, es aconsejable ejecutar ANALYZE en cada base de datos para que el optimizador de consultas tenga estadísticas útiles; consulta Section 24.1.3 y Section 24.1.6 para obtener más información. Para obtener más consejos sobre cómo cargar grandes cantidades de datos en PostgreSQL de manera eficiente, consulta Section 14.4.

pg_dump vuelca solo una base de datos a la vez, y no vuelca información sobre roles o tablespaces (porque estos son para todo el clúster y no por base de datos). Para permitir un volcado conveniente de todo el contenido de un clúster de bases de datos, se proporciona el programa pg_dumpall. pg_dumpall respalda cada base de datos en un clúster dado, y también preserva los datos globales de todo el clúster, como las definiciones de roles y tablespaces. El uso básico de este comando es:

pg_dumpall > dumpfile

El volcado resultante se puede restaurar con psql:

psql -X -f dumpfile postgres

(En realidad, puedes especificar cualquier nombre de base de datos existente para comenzar, pero si estás cargando en un clúster vacío, normalmente se debe usar postgres). Siempre es necesario tener acceso de superusuario de la base de datos al restaurar un volcado de pg_dumpall, ya que eso se requiere para restaurar la información de roles y tablespaces. Si utilizas tablespaces, asegúrate de que las rutas de los tablespaces en el volcado sean adecuadas para la nueva instalación.

pg_dumpall funciona emitiendo comandos para volver a crear roles, tablespaces y bases de datos vacías, y luego invocando pg_dump para cada base de datos. Esto significa que, aunque cada base de datos será internamente consistente, las instantáneas de diferentes bases de datos no están sincronizadas.

Los datos de todo el clúster se pueden volcar por separado utilizando la opción --globals-only de pg_dumpall. Esto es necesario para respaldar completamente el clúster si se ejecuta el comando pg_dump en bases de datos individuales.

Algunos sistemas operativos tienen límites máximos de tamaño de archivo que causan problemas al crear archivos de salida grandes de pg_dump. Afortunadamente, pg_dump puede escribir en la salida estándar, por lo que puedes utilizar herramientas Unix estándar para evitar este problema potencial. Existen varios métodos posibles:

Utilizar volcados comprimidos.  Puedes usar tu programa de compresión favorito, por ejemplo gzip:

pg_dump dbname | gzip > filename.gz

Vuelve a cargar con:

gunzip -c filename.gz | psql dbname

o:

cat filename.gz | gunzip | psql dbname

Utilizar split.  El comando split te permite dividir la salida en archivos más pequeños que tengan un tamaño aceptable para el sistema de archivos subyacente. Por ejemplo, para hacer fragmentos de 2 gigabytes:

pg_dump dbname | split -b 2G - filename

Vuelve a cargar con:

cat filename* | psql dbname

Si estás utilizando la versión GNU de split, es posible utilizarla junto con gzip:

pg_dump dbname | split -b 2G --filter='gzip > $FILE.gz'

Se puede restaurar usando zcat.

Utilizar el formato de volcado personalizado de pg_dump.  Si PostgreSQL se compiló en un sistema con la biblioteca de compresión zlib instalada, el formato de volcado personalizado comprimirá los datos a medida que los escribe en el archivo de salida. Esto producirá tamaños de archivo de volcado similares a los de usar gzip, pero tiene la ventaja añadida de que las tablas se pueden restaurar de forma selectiva. El siguiente comando vuelca una base de datos utilizando el formato de volcado personalizado:

pg_dump -Fc dbname > filename

Un volcado de formato personalizado no es un script para psql, sino que debe restaurarse con pg_restore, por ejemplo:

pg_restore -d dbname filename

Consulta las páginas de referencia de pg_dump y pg_restore para obtener detalles.

Para bases de datos muy grandes, es posible que debas combinar split con uno de los otros dos enfoques.

Utilizar la función de volcado paralelo de pg_dump.  Para acelerar el volcado de una base de datos grande, puedes utilizar el modo paralelo de pg_dump. Esto volcará múltiples tablas al mismo tiempo. Puedes controlar el grado de paralelismo con el parámetro -j. Los volcados paralelos solo se admiten para el formato de archivo «directorio» (directory).

pg_dump -j num -F d -f out.dir dbname

Puedes utilizar pg_restore -j para restaurar un volcado en paralelo. Esto funcionará para cualquier archivo del modo de archivo «personalizado» (custom) o «directorio», se haya creado o no con pg_dump -j.