| PostgreSQL: Das Offizielle Handbuch | ||||
|---|---|---|---|---|
| Zurück | Schnell zurück | Schnell nach vorne | Nach vorne | |
clusterdb [verbindungsoption...] [--table | -t tabelle ] [dbname]
clusterdb [verbindungsoption...] [--all | -a]
clusterdb ist ein Hilfsprogramm um Tabellen in einer PostgreSQL-Datenbank neu zu clustern. Es findet Tabellen, die vorher schon geclustert worden sind und clustert sie erneut mit dem selben Index, der beim letzten Mal verwendet wurde. Tabellen, die noch nie geclustert wurden, werden nicht berührt.
clusterdb ist ein Shell-Skript-Wrapperprogramm um den SQL-Befehl CLUSTER unter Verwendung des Programms psql. Es macht keinen Unterschied, ob eine Datenbank mit dieser oder einer anderen Methode geclustert wird. psql muss von dem Skript gefunden werden und ein Datenbankserver muss auf dem ausgewählten Host laufen. Außerdem gelten etwaige Voreinstellungen und Umgebungsvariablen, die von psql und der Clientbibliothek libpq verwendet werden.
Es kann sein, dass clusterdb mehrmals mit dem PostgreSQL-Server verbinden muss und jedes Mal nach einem Passwort fragt. In solchen Fällen kann es sinnvoll sein, die Datei $HOME/.pgpass einzurichten.
clusterdb akzeptiert die folgenden Kommandozeilenargumente:
Clustere alle Datenbanken.
Gibt den Namen der Datenbank an, die geclustert werden soll. Wenn dies nicht angegeben ist und -a (oder --all) nicht verwendet wird, dann wird der Datenbankname aus der Umgebungsvariable PGDATABASE gelesen. Wenn diese nicht gesetzt ist, dann wird der für die Verbindung angegebene Benutzername verwendet.
Gib die Befehle aus, die clusterdb erzeugt und an den Server schickt.
Gib keine Antwort aus.
Clustere nur tabelle.
clusterdb akzeptiert außerdem die folgenden Kommandozeilenargumente für Verbindungsparameter:
Gibt den Hostnamen der Maschine, auf der der Datenbankserver läuft, an. Wenn der Wert mit einem Schrägstrich anfängt, dann wird er als Verzeichnis für die Unix-Domain-Socket verwendet.
Gibt den TCP-Port oder die Dateierweiterung der lokalen Unix-Domain-Socket an, wo der Server auf Verbindungen wartet.
Der Benutzername, unter dem verbunden werden soll
Erzwinge eine Passworteingabe
Alles hat geklappt.
Irgendwas ist schief gelaufen. clusterdb ist nur ein Wrapper-Skript. Bei CLUSTER und psql finden Sie eine detailliertere Besprechung von Fehlermeldungen und potentiellen Problemen. Beachten Sie, dass diese Meldung einmal für jede geclusterte Tabelle erscheinen könnte.
Um die Datenbank test zu clustern:
$ clusterdb test
Um eine einzelne Tabelle foo in einer Datenbank namens xyzzy zu clustern:
$ clusterdb --table foo xyzzy
| Zurück | Zum Anfang | Nach vorne |
| PostgreSQL-Clientanwendungen | Nach oben | createdb |