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