rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
postgresql/src/bin/pg_dump
History
Tom Lane c0d5be5d6a Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 
a separate archive entry for each BLOB, and use pg_dump's standard methods
for dealing with its ownership, ACL if any, and comment if any.  This means
that switches like --no-owner and --no-privileges do what they're supposed
to.  Preliminary testing says that performance is still reasonable even
with many blobs, though we'll have to see how that shakes out in the field.

KaiGai Kohei, revised by me
 		2010-02-18 01:29:10 +00:00
..
po Translation updates 2009-12-19 20:23:26 +00:00
Makefile Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
README More README src cleanups. 2008-03-21 13:23:29 +00:00
common.c Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
dumputils.c Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +00:00
dumputils.h Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
keywords.c Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
nls.mk Translation updates 2009-12-19 20:23:26 +00:00
pg_backup.h 8.4 pgindent run, with new combined Linux/FreeBSD/MinGW typedef list 2009-06-11 14:49:15 +00:00
pg_backup_archiver.c Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +00:00
pg_backup_archiver.h Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +00:00
pg_backup_custom.c Remove unused variable. 2009-08-24 14:15:09 +00:00
pg_backup_db.c Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +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/pg_restore --clean options drop large objects too. 2009-07-21 21:46:10 +00:00
pg_backup_null.c Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +00:00
pg_backup_tar.c Remove all the special-case code for INT64_IS_BUSTED, per decision that 2010-01-07 04:53:35 +00:00
pg_backup_tar.h $Header: -> $PostgreSQL Changes ... 2003-11-29 19:52:15 +00:00
pg_dump.c Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +00:00
pg_dump.h Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +00:00
pg_dump_sort.c Fix up pg_dump's treatment of large object ownership and ACLs. We now emit 2010-02-18 01:29:10 +00:00
pg_dumpall.c Stamp HEAD as 9.0devel, and update various places that were referring to 8.5 2010-02-17 04:19:41 +00:00
pg_restore.c Typo: dump -> restore 2009-11-19 22:05:48 +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