vacuumdb

Name

vacuumdb -- limpa e analisa um banco de dados do PostgreSQL

Synopsis

vacuumdb [opções_de_conexão...] [[-d] nome_bd] [--full | -f] [--verbose | -v] [--analyze | -z] [--table 'tabela [( coluna [,...] )]' ]
vacuumdb [opções_de_conexão...] [--all | -a] [--full | -f] [--verbose | -v] [--analyze | -z]

Entradas

O vacuumdb aceita os seguintes argumentos de linha de comando:

-d nome_bd
--dbname nome_bd

Especifica o nome do banco de dados a ser limpo ou analisado.

-a
--all

Limpa/analisa todos os bancos de dados.

-f
--full

Executa a limpeza completa ("full").

-v
--verbose

Exibe informações detalhadas durante o processamento.

-z
--analyze

Calcula estatísticas a serem utilizadas pelo otimizador.

-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.

Tip: Se forem especificadas as colunas a serem analisadas, provavelmente será necessário fazer o escape dos parênteses para a shell.

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 da máquina onde o servidor está executando. Se o nome iniciar por uma barra (/), é considerado como sendo o diretório do soquete do domínio Unix.

-p porta
--port porta

Especifica a porta Internet TCP/IP, ou o soquete do domínio local Unix, onde o servidor está aguardando as conexões.

-U nome_do_usuário
--username nome_do_usuário

Nome do usuário para se conectar.

-W
--password

Força a solicitação da senha.

-e
--echo

Exibe os comandos que o vacuumdb gera e envia para o servidor.

-q
--quiet

Não exibe a resposta.

Saídas

VACUUM

O comando foi executado com sucesso.

vacuumdb: Vacuum failed.

Aconteceu algum erro. O vacuumdb é apenas um script envoltório. Consulte o comando VACUUM e o aplicativo psql para ver uma discussão detalhada das mensagens de erro e dos problemas possíveis.

Descrição

O vacuumdb é um utilitário para fazer a limpeza de bancos de dados do PostgreSQL. O vacuumdb também gera estatísticas internas usadas pelo otimizador de consultas do PostgreSQL.

O vacuumdb é um script envoltório que usa o comando do servidor VACUUM através do terminal interativo do PostgreSQL psql. Não existe diferença efetiva entre limpar o banco de dados desta ou daquela maneira. O psql deve ser encontrado pelo script, e o servidor de banco de dados deve estar executando na máquina de destino. Também se aplicam os padrões definidos e as variáveis de ambiente disponíveis para o psql e para a biblioteca cliente libpq.

Utilização

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 em um banco de dados chamado xyzzy e analisar uma única coluna da tabela chamada bar para o otimizador:

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