postgresql

History

Tom Lane 10a3471bed Add a RESTART (without parameter) option to ALTER SEQUENCE, allowing a sequence to be reset to its original starting value. This requires adding the original start value to the set of parameters (columns) of a sequence object, which is a user-visible change with potential compatibility implications; it also forces initdb. Also add hopefully-SQL-compatible RESTART/CONTINUE IDENTITY options to TRUNCATE TABLE. RESTART IDENTITY executes ALTER SEQUENCE RESTART for all sequences "owned by" any of the truncated relations. CONTINUE IDENTITY is a no-op option. Zoltan Boszormenyi		2008-05-16 23:36:05 +00:00
..
po	Translation updates	2008-01-31 18:04:52 +00:00
Makefile	Update copyrights in source tree to 2008.	2008-01-01 19:46:01 +00:00
README	More README src cleanups.	2008-03-21 13:23:29 +00:00
common.c	Change the rules for inherited CHECK constraints to be essentially the same	2008-05-09 23:32:05 +00:00
dumputils.c	Update copyrights in source tree to 2008.	2008-01-01 19:46:01 +00:00
dumputils.h	Update copyrights in source tree to 2008.	2008-01-01 19:46:01 +00:00
nls.mk	Add missing "ko".	2005-01-25 17:32:00 +00:00
pg_backup.h	Turn the -i/--ignore-version options of pg_dump and pg_dumpall into no-ops:	2008-04-13 03:49:22 +00:00
pg_backup_archiver.c	add ; missing due to my carelessness	2008-05-04 08:32:21 +00:00
pg_backup_archiver.h	Use "alternative" instead of "alternate" where it is clearer.	2007-11-07 12:24:24 +00:00
pg_backup_custom.c	Make pg_dump and friends consistently report both the filename and the	2007-10-28 21:55:52 +00:00
pg_backup_db.c	Turn the -i/--ignore-version options of pg_dump and pg_dumpall into no-ops:	2008-04-13 03:49:22 +00:00
pg_backup_db.h	Mark a few functions as static or NOT_USED.	2006-07-18 17:42:01 +00:00
pg_backup_files.c	Make pg_dump and friends consistently report both the filename and the	2007-10-28 21:55:52 +00:00
pg_backup_null.c	Remove 576 references of include files that were not needed.	2006-07-14 14:52:27 +00:00
pg_backup_tar.c	pgindent run for 8.3.	2007-11-15 21:14:46 +00:00
pg_backup_tar.h	$Header: -> $PostgreSQL Changes ...	2003-11-29 19:52:15 +00:00
pg_dump.c	Add a RESTART (without parameter) option to ALTER SEQUENCE, allowing a	2008-05-16 23:36:05 +00:00
pg_dump.h	Change the rules for inherited CHECK constraints to be essentially the same	2008-05-09 23:32:05 +00:00
pg_dump_sort.c	Update copyrights in source tree to 2008.	2008-01-01 19:46:01 +00:00
pg_dumpall.c	Turn the -i/--ignore-version options of pg_dump and pg_dumpall into no-ops:	2008-04-13 03:49:22 +00:00
pg_restore.c	Turn the -i/--ignore-version options of pg_dump and pg_dumpall into no-ops:	2008-04-13 03:49:22 +00:00

README

$PostgreSQL: pgsql/src/bin/pg_dump/README,v 1.7 2008/03/21 13:23:28 momjian Exp $

Notes on pg_dump
================

1. pg_dump, by default, still outputs text files.

2. pg_dumpall forces all pg_dump output to be text, since it also outputs text into the same output stream.

3. The plain text output format cannot be used as input into pg_restore.


To dump a database into the new custom format, type:

    pg_dump <db-name> -Fc > <backup-file>

or, to dump in TAR format

	pg_dump <db-name> -Ft > <backup-file>

To restore, try
 
   To list contents:

       pg_restore -l <backup-file> | less

   or to list tables:

       pg_restore <backup-file> --table | less

   or to list in a different order

       pg_restore <backup-file> -l --oid --rearrange | less

Once you are happy with the list, just remove the '-l', and an SQL script will be output.


You can also dump a listing:

       pg_restore -l <backup-file> > toc.lis
  or
       pg_restore -l <backup-file> -f toc.lis

edit it, and rearrange the lines (or delete some):

    vi toc.lis

then use it to restore selected items:

    pg_restore <backup-file> --use=toc.lis -l | less

When you like the list, type

    pg_restore backup.bck --use=toc.lis > script.sql

or, simply:

    createdb newdbname
    pg_restore backup.bck --use=toc.lis | psql newdbname


TAR
===

The TAR archive that pg_dump creates currently has a blank username & group for the files, 
but should be otherwise valid. It also includes a 'restore.sql' script which is there for
the benefit of humans. The script is never used by pg_restore.

Note: the TAR format archive can only be used as input into pg_restore if it is in TAR form.
(ie. you should not extract the files then expect pg_restore to work). 

You can extract, edit, and tar the files again, and it should work, but the 'toc'
file should go at the start, the data files be in the order they are used, and
the BLOB files at the end.


Philip Warner, 16-Jul-2000
pjw@rhyme.com.au