Documentation PostgreSQL 8.4.22 > Référence > Applications client de PostgreSQL > clusterdb | |
Applications client de PostgreSQL | createdb |
clusterdb [options_connexion...]
[[--verbose] | [-v]] [--table | -t table ] [nom_bd]
clusterdb [options_connexion...] [[--all]
| [-a]] [[--verbose] | [-v]]
clusterdb est un outil de regroupage de tables au sein d'une base de données PostgreSQL™. Il trouve les tables précédemment groupées et les groupe à nouveau sur l'index utilisé lors du groupement initial. Les tables qui n'ont jamais été groupées ne sont pas affectées.
clusterdb est un enrobage de la commande SQL CLUSTER. Il n'y a pas de différence réelle entre le groupage de bases par cet outil ou par d'autres méthodes d'accès au serveur.
clusterdb accepte les arguments suivants en ligne de commande :
Grouper toutes les bases de données.
Le nom de la base de données à grouper. Si ni ce nom, ni l'option -a (ou --all) ne sont précisés, le nom de la base de données est lu à partir de la variable d'environnement PGDATABASE. Si cette dernière n'est pas initialisée, le nom de l'utilisateur spécifié pour la connexion est utilisé.
Les commandes engendrées par clusterdb et envoyées au serveur sont affichées.
Aucun message de progression n'est affiché.
Seule la table table est groupée.
Affiche des informations détaillées lors du traitement.
clusterdb accepte aussi les arguments suivants en ligne de commande pour les paramètres de connexion :
Le nom de la machine hôte sur laquelle le serveur fonctionne. Si la valeur commence par une barre oblique (slash), elle est utilisée comme répertoire du socket de domaine Unix.
Le port TCP ou l'extension du fichier du socket local de domaine Unix sur lequel le serveur attend les connexions.
Le nom de l'utilisateur utilisé pour la connexion.
Ne demande jamais un mot de passe. Si le serveur en réclame un pour l'authentification et qu'un mot de passe n'est pas disponible d'une autre façon (par exemple avec le fichier .pgpass), la tentative de connexion échouera. Cette option peut être utile pour les scripts où aucun utilisateur n'est présent pour saisir un mot de passe.
Force clusterdb à demander un mot de passe avant la connexion à une base de données.
Cette option n'est jamais obligatoire car clusterdb demandera automatiquement un mot de passe si le serveur exige une authentification par mot de passe. Néanmoins, clusterdb perdra une tentative de connexion pour trouver que le serveur veut un mot de passe. Dans certains cas, il est préférable d'ajouter l'option -W pour éviter la tentative de connexion.
Paramètres de connexion par défaut.
Cet outil, comme la plupart des autres outils PostgreSQL™, utilise aussi les variables d'environnement supportées par la bibliothèque libpq (voir Section 30.13, « Variables d'environnement »).
En cas de difficulté, voir CLUSTER et psql(1) qui présentent les problèmes et messages d'erreur éventuels. Le serveur de bases de données doit fonctionner 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 client libpq s'appliquent.