clusterdb — agrupa um banco de dados do PostgreSQL
clusterdb [opção_de_conexão...] [opção...]
[
--table | -t
tabela
]
... [
nome_do_banco_de_dados | -a | --all
]
O clusterdb é um utilitário para agrupar tabelas em banco de dados do PostgreSQL. Ele encontra as tabelas que foram agrupadas anteriormente, e as agrupa novamente pelo mesmo índice que foi usado da última vez. As tabelas que nunca foram agrupadas não são afetadas.
O clusterdb é um invólucro em torno do comando SQL CLUSTER. Não há nenhuma diferença efetiva entre agrupar bancos de dados por meio desse utilitário ou por meio de outros métodos de acesso ao servidor.
O clusterdb aceita os seguintes argumentos de linha de comando:
-a--allAgrupa 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, quando
não é usado -a/--all.
Se não for especificada, o nome do banco de dados será obtido
da variável de ambiente PGDATABASE.
Se esta variável de ambiente não estiver definida, será usado
o nome de usuário especificado para a conexão.
O nome_do_banco_de_dados pode ser uma
cadeia de caracteres de conexão.
Neste caso, os parâmetros da cadeia de caracteres de conexão
têm precedência sobre quaisquer opções de linha de comando
conflitantes.
-e--echoMostra os comandos que o clusterdb gera e envia para o servidor.
-q--quietNão mostra mensagens de progresso.
-t tabela--table=tabela
Reagrupa apenas a tabela.
Podem ser agrupadas várias tabelas escrevendo a opção
-t várias vezes.
-v--verboseMostra informações detalhadas durante o processamento.
-V--versionMostra a versão do clusterdb, e termina.
-?--helpMostra a ajuda sobre os argumentos da linha de comando do clusterdb, e termina.
O clusterdb também aceita os seguintes argumentos de linha de comando para parâmetros de conexão:
-h hospedeiro--host=hospedeiroEspecifica o nome de hospedeiro da máquina na qual o servidor está sendo executado. Se começar com uma barra, será usado como o diretório para o soquete de domínio Unix.
-p porta--port=portaEspecifica a porta TCP, ou extensão de arquivo de soquete de domínio Unix local, na qual o servidor está aguardando conexões.
-U nome_do_usuário--username=nome_do_usuárioNome de usuário para se conectar como.
-w--no-password
Nunca emite uma solicitação de senha.
Se o servidor exigir autenticação por senha, e uma senha não
estiver disponível por outros meios, como o arquivo
.pgpass, a tentativa de conexão irá falhar.
Esta opção pode ser útil em tarefas em lote e scripts nos quais
nenhum usuário está presente para inserir uma senha.
-W--passwordForça o clusterdb solicitar uma senha antes de se conectar ao banco de dados.
Esta opção nunca é essencial, porque o
clusterdb solicita automaticamente
a senha se o servidor exigir autenticação por senha.
No entanto, o clusterdb irá desperdiçar
uma tentativa de conexão ao descobrir que o servidor pede uma senha.
Em alguns casos vale a pena digitar -W para
evitar a tentativa extra de conexão.
--maintenance-db=nome_do_banco_de_dados
Quando é usada a opção -a/--all,
deve-se conectar a este banco de dados para obter a lista de
bancos de dados a serem agrupados.
Caso não seja especificado, será usado o banco de dados
postgres ou, se este não existir, será usado
o banco de dados template1.
O nome do banco de dados pode ser substituído por uma
cadeia de caracteres de conexão.
Neste caso, os parâmetros da cadeia de caracteres de conexão
substituirão quaisquer opções conflitantes da linha de comando.
Além disso, os parâmetros da cadeia de caracteres de conexão,
com exceção do próprio nome do banco de dados, serão reutilizados
ao conectar com os outros bancos de dados.
PGDATABASEPGHOSTPGPORTPGUSERParâmetros de conexão padrão
PG_COLOR
Especifica se devem ser usadas cores nas mensagens de diagnóstico.
Os valores possíveis são always,
auto e never.
Este utilitário, como a maioria dos outros utilitários do PostgreSQL, também usa as variáveis de ambiente com suporte pela libpq (veja Variáveis de ambiente).
Em caso de dificuldade, veja o comando CLUSTER e o utilitário psql para obter informações sobre possíveis problemas e mensagens de erro. O servidor de banco de dados deverá estar ativo no hospedeiro especificado. Além disso, se aplicam todas as configurações de conexão padrão e variáveis de ambiente usadas pela biblioteca cliente libpq.
Para agrupar o banco de dados teste:
$clusterdb teste
Para agrupar uma única tabela foo em um banco
de dados chamado xyzzy:
$clusterdb --table=foo xyzzy