clusterdb

Nome

clusterdb -- agrupa um banco de dados do PostgreSQL

Sinopse

clusterdb [opção_de_conexão...] [--table | -t tabela ] [nome_do_banco_de_dados]
clusterdb [opção_de_conexão...] [--all | -a]

Descrição

O clusterdb é um utilitário para reagrupar tabelas em um banco de dados do PostgreSQL. Encontra as tabelas que foram agrupadas anteriormente, e as agrupa novamente utilizando o mesmo índice usado da última vez. As tabelas que nunca foram agrupadas não são afetadas.

O clusterdb é um invólucro em torno do comando CLUSTER do SQL. Não existe diferença efetiva entre agrupar bancos de dado através deste utilitário, ou através de outros métodos para acessar o servidor.

Opções

O clusterdb aceita os seguintes argumentos de linha de comando:

-a
--all

Agrupa todos os bancos de dados.

[-d] nome_do_banco_de_dados
[--dbname] nome_do_banco_de_dados

Especifica o nome do banco de dados a ser agrupado. Se não for especificado o nome do banco de dados, nem for utilizada a opção -a (ou --all), o nome do banco de dados será obtido da variável de ambiente PGDATABASE. Se esta variável não estiver definida, então será utilizado o nome do usuário especificado na conexão.

-e
--echo

Mostra os comandos que o clusterdb gera e envia para o servidor.

-q
--quiet

Não exibe resposta.

-t tabela
--table tabela

Agrupa somente a tabela.

O clusterdb 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 barra (/), será utilizado como o diretório do soquete do domínio Unix.

-p porta
--port porta

Especifica a porta TCP, ou a extensão do arquivo de soquete do domínio Unix local, onde o servidor está atendendo 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 CLUSTER e no psql a discussã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.

Exemplos

Para agrupar o banco de dados teste:

$ clusterdb teste

Para agrupar apenas a tabela foo no banco de dados chamado xyzzy:

$ clusterdb --table foo xyzzy

Consulte também

CLUSTER, Variáveis de ambiente (Seção 29.12)
SourceForge.net Logo CSS válido!