postgresql

mirror of https://git.postgresql.org/git/postgresql.git synced 2024-09-08 18:49:21 +02:00

History

Tom Lane 327e025071 Create the catalog infrastructure for foreign-data-wrapper handlers. Add a fdwhandler column to pg_foreign_data_wrapper, plus HANDLER options in the CREATE FOREIGN DATA WRAPPER and ALTER FOREIGN DATA WRAPPER commands, plus pg_dump support for same. Also invent a new pseudotype fdw_handler with properties similar to language_handler. This is split out of the "FDW API" patch for ease of review; it's all stuff we will certainly need, regardless of any other details of the FDW API. FDW handler functions will not actually get called yet. In passing, fix some omissions and infelicities in foreigncmds.c. Shigeru Hanada, Jan Urbanski, Heikki Linnakangas		2011-02-19 00:07:15 -05:00
..
po	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
.gitignore	Convert cvsignore to gitignore, and add .gitignore for build targets.	2010-09-22 12:57:04 +02:00
common.c	DDL support for collations	2011-02-12 15:55:18 +02:00
compress_io.c	Add 'directory' format to pg_dump. The new directory format is compatible	2011-01-23 23:10:15 +02:00
compress_io.h	Add 'directory' format to pg_dump. The new directory format is compatible	2011-01-23 23:10:15 +02:00
dumputils.c	Basic foreign table support.	2011-01-01 23:48:11 -05:00
dumputils.h	Stamp copyrights for year 2011.	2011-01-01 13:18:15 -05:00
keywords.c	Stamp copyrights for year 2011.	2011-01-01 13:18:15 -05:00
Makefile	Add 'directory' format to pg_dump. The new directory format is compatible	2011-01-23 23:10:15 +02:00
nls.mk	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
pg_backup_archiver.c	Fix parallel pg_restore to handle comments on POST_DATA items correctly.	2011-02-18 13:11:45 -05:00
pg_backup_archiver.h	Add 'directory' format to pg_dump. The new directory format is compatible	2011-01-23 23:10:15 +02:00
pg_backup_custom.c	Remove misleading comments. Move _Clone and _DeClone functions before	2010-12-03 14:58:24 +02:00
pg_backup_db.c	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
pg_backup_db.h	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
pg_backup_directory.c	Reorder includes to unbreak MSVC	2011-01-23 22:44:07 +01:00
pg_backup_files.c	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
pg_backup_null.c	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
pg_backup_tar.c	Add 'directory' format to pg_dump. The new directory format is compatible	2011-01-23 23:10:15 +02:00
pg_backup_tar.h	Remove cvs keywords from all files.	2010-09-20 22:08:53 +02:00
pg_backup.h	Add 'directory' format to pg_dump. The new directory format is compatible	2011-01-23 23:10:15 +02:00
pg_dump_sort.c	DDL support for collations	2011-02-12 15:55:18 +02:00
pg_dump.c	Create the catalog infrastructure for foreign-data-wrapper handlers.	2011-02-19 00:07:15 -05:00
pg_dump.h	Create the catalog infrastructure for foreign-data-wrapper handlers.	2011-02-19 00:07:15 -05:00
pg_dumpall.c	Fix pg_upgrade of large object permissions by preserving pg_auth.oid,	2011-01-07 21:59:29 -05:00
pg_restore.c	Add 'directory' format to pg_dump. The new directory format is compatible	2011-01-23 23:10:15 +02:00
README	Remove useless whitespace at end of lines	2010-11-23 22:34:55 +02:00

README

src/bin/pg_dump/README

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