clusterdb

Nome

clusterdb -- agrupa um banco de dados do PostgreSQL

Sinopse

clusterdb [opção_de_conexão...] [--tabela | -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, reagrupando-as novamente utilizando o mesmo índice usado da última vez. As tabelas que nunca foram agrupadas não são afetadas.

O clusterdb é uma capa 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 ao 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 e não for utilizado -a (ou --all), o nome do banco de dados é lido da variável de ambiente PGDATABASE. Se esta variável não estiver definida, então é 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 (/) é usado 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á 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

Encontrando dificuldades veja em CLUSTER e 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

Veja também

CLUSTER
SourceForge.net Logo