vacuumdb

Name

vacuumdb -- nettoie et analyse une base PostgreSQL

Synopsis

vacuumdb [connection-options...] [[-d] dbname] [--full | -f] [--verbose | -v] [--analyze | -z] [--table 'table [( column [,...] )]' ]
vacuumdb [connection-options...] [--all | -a] [--full | -f] [--verbose | -v] [--analyze | -z]

Entrées

vacuumdb accepte les arguments en ligne de commande suivants :

-d dbname, --dbname dbname

Spécifie le nom de la base à nettoyer et analyser.

-a, --all

Vacuum toutes les bases.

-f, --full

Exécute la "totalité" de vacuum.

-v, --verbose

Affiche des informtions détaillées pendant le processus.

-z, --analyze

Calcule des statistiques pour leur usage par l'analyseur.

-t table [ (column [,...]) ], --table table [ (column [,...]) ]

Nettoie ou analyse table seulement. Les noms de colonnes peuvent être spécifiés seulement en conjonction avec l'option --analyze.

Tip

Si vous spécifiez des colonnes à vacuum, vous aurez probablement à échapper les parenthèses depuis le shell.

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

-h host, --host host

Spécifie le nom d'hôte de la machine sur laquelle le serveur tourne. Si l'hôte débute par un slash, il est utilisé comme répertoire d'un socket de domaine Unix.

-p port, --port port

Spécifie le port Internet TCP/IP ou l'extension du socket de domaine local Unix sur lequel le serveur est en attente de connexions.

-U username, --username username

Nom de l'utilisateur connecté

-W, --password

Force le prompt du mot-de-passe.

-e, --echo

Echo la commande que génère vacuumdb et l'envoie au serveur.

-q, --quiet

N'affiche pas de réponse.

Sorties

VACUUM

Tout fonctionne bien.

vacuumdb: Vacuum failed.

Erreur quelque part. vacuumdb est seulement un script d'enveloppe. Voir VACUUM et psql(1) pour des détails sur les messages d'erreur et les problèmes potentiels.

Description

vacuumdb est un utilitaire pour nettoyer une base PostgreSQL. vacuumdb génère aussi des statistiques internes utilisées par l'optimiseur de requête de PostgreSQL.

vacuumdb est un script shell autour de la commande serveur VACUUM via le terminal interactif psql(1) de PostgreSQL. Il n'y a pas de différence effective entre les deux méthodes pour le nettoyage des bases. psql doit être trouvé par le script et un serveur de base doit tourner sur l'hôte cible. Ainsi, les placements et variable d'environnement par défaut disponibles pour psql et la bibliothèque cliente libpq seront appliqués.

Utilisation

Pour nettoyer une base test :

$ vacuumdb test

Pour nettoyer et analyser par l'optimiseur une base nommée bigdb:

$ vacuumdb --analyze bigdb

Pour nettoyer une table unique foo dans une base nommée xyzzy, et analyser une colonne unique bar de la table par l'optimiseur :

$ vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy