clusterdb [opção_de_conexão...] [--table | -t tabela ] [nome_do_banco_de_dados]
clusterdb [opção_de_conexão...] [--all | -a]
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.
O clusterdb aceita os seguintes argumentos de linha de comando:
Agrupa todos os bancos 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.
Mostra os comandos que o clusterdb gera e envia para o servidor.
Não exibe resposta.
Agrupa somente a tabela.
O clusterdb também aceita os seguintes argumentos de linha de comando para os parâmetros de conexão:
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.
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.
Nome do usuário para conectar.
Força a solicitação da senha.
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.
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
