pg_dump

Nombre

pg_dump  --  Extrae una base de datos Postgres a un fichero de script

Synopsis

pg_dump [ base_de_datos ]
pg_dump [ -h hu�sped ] [ -p puerto ]
    [ -t tabla ]
    [ -a ] [ -c ] [ -d ] [ -D ] [ -n ] [ -N ]
    [ -o ] [ -s ] [ -u ] [ -v ] [ -x ]
    [ base_de_datos ]
  

Entrada

pg_dump accepta los siguientes argumentos de la l�nea de comando:

base_de_datos

Epecif�ca el nombre de la base de datos que se va a extraer. base_de_datos tiene como est�ndar el valor de la variable de entorno USER

-a

Vuelca s�lo los datos, no el esquema (las definiciones).

-c

Limpia el esquema antes de crearlo.

-d

Vuelca la data como propios insertos de cadenas.

-D

Vuelca la data como insertos con nombres de atributos

-n

Suprime las dobles comillas de los identificadores, a menos que sean absolutamente necesarias. Esto puede causar problemas al cargar la misma si esta data volcada contiene palabras reservadas usadas por los identificadores. Esta era la conducta est�ndar en pg_dump pre-v6.4.

-N

Incluye comillas dobles en los identificadores. Este es el est�ndar.

-o

Vuelca los identificadores de objetos (OIDs) para cada tabla.

-s

Vuelca solo el esquema (las definiciones), no la data.

-t tabla

Vuelca la data para la tabla �nicamnete.

-u

Usa autenticaci�n por medio de clave de acceso. Pide un nombre de usuario y clave de acceso.

-v

Epecifica el modo verbose(parlanch�n)

-x

Evita el volcado de ACLs (comandos grant/revoke) y la informaci�n de propiedad de la tabla.

pg_dump tambi�n acepta los siguientes argumentos de l�nea de comando para par�metros de conexi�n:

-h hu�sped

Especifica el nombre del hu�sped de la m�quina en la cual se est� ejecutando el postmaster. El est�ndar es usar un socket de dominio local Unix en vez de una conexi�n IP..

-p puerto

Especifica el puerto de Internet TCP/IP o extensi�n de archivo socket de dominio local Unix en el cual postmaster est� esperando que se efect�en conexiones. En n�mero est�ndar de puerto es 5432, o el valor de la variable de ambiente PGPORT (si est� establecida).

-u

Usa autenticaci�n con clave de acceso. Pide nombre_de_usuario y clave_de_acceso.

Salida

pg_dump crear� un fichero o escribir� a stdout.

La conexi�n con la base de datos 'template1' fall�. connectDB() fall�: �Est� el postmaster ejecut�ndose y acceptando conexiones en el 'Socket de UNIX' en el puerto 'puerto'?

pg_dump no pudo unirse al proceso postmaster en el hu�sped y puerto especificados. Si ve usted este mensaje, verifique que postmaster se este ejecutando en el hu�sped indicado, y que usted especific� el puerto correcto. Si su site usa alg�n sistema de autenticaci�n, verifique que usted tiene las credenciales de autenticaci�n requeridas.

La conexi�n con la base de datos 'base_de_datos' fall�. FATAL 1: SetUserId: el usuario 'nombre_de_usuario' no est� en 'pg_shadow'

Usted no posee una entrada v�lida en la relaci�n pg_shadow y no le ser� permitido tener acceso a Postgres. Contacte a su administrador de Postgres.

dumpSequence(tabla): SELECT fall�

Usted carece del permiso para leer la base de datos. Contacte a su administrador de site Postgres.

Nota

pg_dump ejecuta internamente las directivas SELECT. Si tiene problemas ejecutando pg_dump, verifique que puede seleccionar la informaci�n de la base de datos mediante el uso de, por ejemplo, psql.

Descripci�n

pg_dump es un utilitario para volcar una base de datos Postgres en un fichero de script conteniendo comandos de consulta. Los ficheros de script son en formato de texto y pueden ser usados para reconstru�r la base de datos, incluso en otras m�quinas y con otras arquitecturas. pg_dump producir� las consultas necesarias para regenerar todos los tipos definidos por el usuario, funciones, tablas, �ndices, agregados, y operadores. Adicionalmente, toda la data es copiada en formato de texto el cual puede ser nuevamente copiado, tambi�n puede ser importado a herramientas para su edici�n.

pg_dump es �til para verter el contenido de una base de datos que se vaya a mudar de una instalaci�n de Postgres a otra. Despu�s de ejecutar pg_dump, se debe examinar el script de salida a ver si contiene alguna advertencia, especialmente a la luz de las limitaciones citadas en la parte inferior.

Notas

pg_dump tiene pocas limitaciones. Las limitaciones surgen principalmente de la dificultad para extraer ciertas meta-informaciones de los cat�logos del sistema.

Uso

Para volcar una base de datos del mismo nombre que el usuario:

% pg_dump > db.out
   

Para volver a cargar esta base de datos:

% psql -e base_de_datos < db.out