vacuumdb

Documentação do PostgreSQL 7.4.1
Anterior	Início		Fim	Próxima

Descrição

O vacuumdb é um utilitário para limpar um banco de dados do PostgreSQL. O vacuumdb também gera as estatísticas internas usadas pelo otimizador de comandos do PostgreSQL.

O vacuumdb é uma capa em torno do comando VACUUM do SQL. Não existe diferença efetiva entre limpar o banco de dados através deste utilitário ou através de outros métodos para acessar o servidor.

Opções

O vacuumdb aceita os seguintes argumentos de linha de comando:

-a --all: Limpa todos bancos de dados.
[-d] nome_do_banco_de_dados [--dbname] nome_do_banco_de_dados: Especifica o nome do banco de dados a ser limpo ou analisado. Se não for especificado, e a opção -a (ou --all) não for usada, o nome do banco de dados é obtido a partir da variável de ambiente PGDATABASE. Se esta variável não estiver definida, então é usado o nome do usuário especificado para a conexão.
-e --echo: Mostra os comandos que o vacuumdb gera e envia para o servidor.
-f --full: Executa a limpeza "completa".
-q --quiet: Não exibe resposta.
-t tabela [ (coluna [,...]) ] --table tabela [ (coluna [,...]) ]: Limpa ou analisa somente a tabela. Os nomes das colunas só podem ser especificados juntamente com a opção --analyze.

Dica: Se forem especificadas as colunas, provavelmente será necessário fazer o escape (\) dos parênteses para o interpretador de linhas de comando (Veja exemplos abaixo).
-v --verbose: Mostra informações detalhadas durante o processamento.
-z --analyze: Calcula as estatísticas a serem utilizadas pelo otimizador.

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

-h hospedeiro --host hospedeiro: Especifica o nome de hospedeiro da máquina onde o servidor está executando. Se o nome iniciar por uma barra (/) é usado como o diretório do soquete do domínio Unix.
-p porta --port porta: Especifica a porta TCP, ou a extensão de arquivo do soquete do domínio Unix local, onde o servidor está escutando as conexões.
-U nome_do_usuário --username nome_do_usuário: Nome do usuário para conectar.
-W --password: Força a solicitação da senha.

Ambiente

PGDATABASE PGHOST PGPORT PGUSER: Parâmetros de conexão padrão.

Diagnósticos

Havendo dificuldade, veja no comando VACUUM e no psql a explicação dos problemas possíveis e as mensagens de erro. O servidor de banco de dados deve estar executando no hospedeiro de destino. Também se aplicam todas as definições de conexão padrão e as variáveis de ambiente utilizadas pela biblioteca cliente libpq.

Observações

Pode haver necessidade do vacuumdb se conectar várias vezes ao servidor PostgreSQL, solicitando a senha cada uma destas vezes. Neste caso é conveniente existir o arquivo $HOME/.pgpass. Veja a Seção 27.11 para obter mais informações.

Exemplos

Para limpar o banco de dados teste:

$ vacuumdb teste

Para limpar e analisar para o otimizador o banco de dados chamado grande_bd:

$ vacuumdb --analyze grande_bd

Para limpar uma única tabela chamada foo, no banco de dados chamado xyzzy, e analisar para o otimizador uma única coluna desta tabela chamada bar:

$ vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy