pg_restore

Descrição

O pg_restore é um utilitário para restaurar um banco de dados do PostgreSQL, a partir de uma cópia de segurança criada pelo pg_dump em um dos formatos não-texto-puro. São executados os comandos necessários para reconstruir o banco de dados, no estado em que este se encontrava na hora em que foi salvo. Os arquivos de cópia de segurança também permitem ao pg_restore selecionar o que será restaurado, ou mesmo reordenar os itens antes de serem restaurados. Os arquivos de cópia de segurança são projetados para serem portáveis entre arquiteturas diferentes.

O pg_restore pode operar de dois modos: Se o nome do banco de dados for especificado, a cópia de segurança é restaurada diretamente no banco de dados (Os objetos grandes só podem ser restaurados utilizando uma conexão direta com o banco de dados como esta). Senão, é criado um script, no formato texto-puro, contendo os comandos SQL necessários para reconstruir o banco de dados (escrito em um arquivo ou na saída padrão), semelhante aos scripts criados pelo pg_dump. Algumas das opções que controlam a criação do script são, portanto, análogas às opções do pg_dump.

Obviamente, o pg_restore não pode restaurar informações que não estejam presentes no arquivo de cópia de segurança. Por exemplo, se a cópia de segurança for gerada usando a opção "salvar dados como comandos INSERT", o pg_restore não poderá restaurar os dados usando comandos COPY.

Opções

O pg_restore aceita os seguintes argumentos de linha de comando.

O pg_restore também aceita os seguintes argumentos de linha de comando para os parâmetros de conexão:

Ambiente

Diagnósticos

Quando a conexão direta com o banco de dados é especificada usando a opção -d, o pg_restore executa internamente comandos SQL. Se acontecerem problemas ao executar o pg_restore, deve-se ter certeza que é possível selecionar informações no banco de dados utilizando, por exemplo, o utilitário psql .

Observações

Se o agrupamento de bancos de dados tiver alguma adição local ao banco de dados template1, deve-se ter o cuidado de restaurar a saída do pg_restore em um banco de dados totalmente vazio; senão, podem acontecer erros devido à duplicidade de definição dos objetos adicionados. Para criar um banco de dados vazio, sem nenhuma adição local, deve-se fazê-lo partir de template0, e não de template1 como, por exemplo:

CREATE DATABASE foo WITH TEMPLATE template0;

As limitações do pg_restore estão descritas abaixo.

• Ao restaurar os dados em uma tabela pré-existente utilizando a opção --disable-triggers, o pg_restore emite comandos para desabilitar os gatilhos das tabelas do usuário antes de inserir os dados, e comandos para reabilitá-los após os dados terem sido inseridos. Se a restauração for interrompida antes do fim, os catálogos do sistema podem ser deixados em um estado errado.
• O pg_restore não restaura objetos grandes para uma única tabela. Se a cópia de segurança contém objetos grandes, então todos os objetos grandes são restaurados.

Veja também a documentação do pg_dump para obter os detalhes de suas limitações.

Uma vez restaurado, é aconselhável executar o comando ANALYZE em todas as tabelas restauradas para que o otimizador possua estatísticas úteis.

Exemplos

Para gerar uma cópia de segurança do banco de dados meu_bd, que contém objetos grandes, em um arquivo tar:

$ pg_dump -Ft -b meu_bd > db.tar

Para restaurar este banco de dados (com os objetos grandes) no banco de dados chamado novo_bd:

$ pg_restore -d novo_bd db.tar

Para reordenar os itens do banco de dados, primeiro é necessário criar um arquivo contendo a tabela de conteúdo (índice) da cópia de segurança:

$ pg_restore -l copia_de_seguranca.arquivo > copia_de_seguranca.list

O arquivo de listagem consiste de um cabeçalho e uma linha para cada item como, por exemplo,

;
; Archive created at Fri Jul 28 22:28:36 2000
;     dbname: birds
;     TOC Entries: 74
;     Compression: 0
;     Dump Version: 1.4-0
;     Format: CUSTOM
;
;
; Selected TOC Entries:
;
2; 145344 TABLE species postgres
3; 145344 ACL species
4; 145359 TABLE nt_header postgres
5; 145359 ACL nt_header
6; 145402 TABLE species_records postgres
7; 145402 ACL species_records
8; 145416 TABLE ss_old postgres
9; 145416 ACL ss_old
10; 145433 TABLE map_resolutions postgres
11; 145433 ACL map_resolutions
12; 145443 TABLE hs_old postgres
13; 145443 ACL hs_old

Ponto-e-vírgula inicia um comentário, e os números no início das linhas referem-se aos identificadores internos da cópia de segurança atribuídos a cada item.

As linhas do arquivo podem ser transformadas em comentário, excluídas e reordenadas. Por exemplo

10; 145433 TABLE map_resolutions postgres
;2; 145344 TABLE species postgres
;4; 145359 TABLE nt_header postgres
6; 145402 TABLE species_records postgres
;8; 145416 TABLE ss_old postgres

poderia ser usado como entrada do pg_restore e somente restauraria os itens 10 e 6, nesta ordem.

$ pg_restore -L copia_de_seguranca.list copia_de_seguranca.arquivo

Histórico

O utilitário pg_restore apareceu pela primeira vez no PostgreSQL 7.1.

Veja também