clusterdb

Nom

clusterdb -- groupe les bases de données de PostgreSQL

Synopsis

clusterdb [options_connexion...] [--table | -t table ] [nom_db]
clusterdb [options_connexion...] [--all | -a]

Description

clusterdb est un outil de regroupement des tables dans une base de données PostgreSQL. Il trouve des tables qui ont été précédemment groupées et les regroupe encore une fois sur le même index qui a été utilisé précédemment. Les tables qui n'ont jamais été groupées n'ont pas été affectées.

clusterdb est un emballage autour de la commande SQL CLUSTER. Il n'y a pas de différence réelle entre les bases de données groupées via cet outil et via d'autres méthodes pour accéder au serveur.

Options

clusterdb accepte les arguments suivants en ligne de commande :

-a
--all

Groupe toutes les bases de données.

[-d] nom_db
[--dbname] nom_db

Spécifie le nom de la base de données à grouper. S'il n'est pas spécifié et -a (ou --all) n'est pas utilisé, le nom de la base de données est lu à partir de la variable d'environnement PGDATABASE. Si elle n'est pas configurée, le nom de l'utilisateur spécifié pour la connexion est utilisé.

-e
--echo

Affiche les commandes que clusterdb génère et envoie au serveur.

-q
--quiet

N'affiche aucune réponse.

-t table
--table table

Groupe uniquement table.

clusterdb accepte aussi les arguments suivants en ligne de commande pour les paramètres de connexion :

-h hôte
--host hôte

Spécifie le nom de l'hôte de la machine sur lequel le serveur fonctionne. Si la valeur commence avec un slash, elle est utilisée comme répertoire du socket de domaine Unix.

-p port
--port port

Spécifie le port TCP ou l'extension du fichier du socket local de domaine Unix sur lequel le serveur attend les connexions.

-U nomutilisateur
--username nomutilisateur

Nom de l'utilisateur qui se connecte

-W
--password

Force la demande du mot de passe.

Environnement

PGDATABASE
PGHOST
PGPORT
PGUSER

Paramètres de connexion par défaut

Diagnostiques

En cas de difficulté, voir CLUSTER et psql pour des discussions sur les problèmes et messages d'erreur potentiels. Le serveur de la base de données doit être en cours d'exécution sur l'hôte cible. De plus, toutes les configurations de connexion par défaut et variables d'environnement utilisées par la bibliothèque libpq seront appliquées.

Exemples

Pour grouper la base de données test :

$ clusterdb test

Pour grouper une seule table foo dans une base de données nommée xyzzy :

$ clusterdb --table foo xyzzy

Voir aussi

CLUSTER