Befehlsreferenz

Einführung

Befehle führen die verschiedenen pgBackRest-Funktionen aus. Hier sind sämtliche Befehlsoptionen aufgeführt: Jede auf einen Befehl anwendbare Option wird bei diesem Befehl genannt, auch wenn sie für weitere Befehle gilt. Dazu gehören alle Optionen, die auch in pgbackrest.conf konfiguriert werden können.

Nicht boolesche Optionen aus pgbackrest.conf lassen sich über die Befehlszeile mit dem Präfix reset- auf ihren Standardwert zurücksetzen. Damit kann ein Backup direkt auf einem Repository-Host wiederhergestellt werden. Normalerweise meldet pgBackRest einen Fehler, weil es erkennt, dass sich die Datenbank auf einem entfernten Host befindet und Wiederherstellungen nicht aus der Ferne möglich sind. Mit --reset-pg1-host in der Befehlszeile ignoriert pgBackRest den entfernten Datenbank-Host und führt die Wiederherstellung lokal aus. Möglicherweise muss ein neuer Wert für --pg1-path angegeben werden, um die Wiederherstellung in einem bestimmten Pfad zu erzwingen, also nicht in dem auf dem Datenbank-Host verwendeten Pfad.

Mit dem Präfix no- lässt sich eine boolesche Option über die Befehlszeile auf false setzen.

Jede Option kann über eine Umgebungsvariable gesetzt werden. Dazu werden das Präfix PGBACKREST_ und der Optionsname in Großbuchstaben verwendet, wobei - durch _ ersetzt wird. Beispielsweise wird pg1-path zu PGBACKREST_PG1_PATH und stanza zu PGBACKREST_STANZA. Boolesche Optionen werden wie in einer Konfigurationsdatei angegeben, etwa PGBACKREST_COMPRESS="n"; Varianten mit reset-* sind nicht zulässig. Für Optionen, die mehrfach in der Befehlszeile oder einer Konfigurationsdatei angegeben werden können, werden die Werte durch Doppelpunkte getrennt, etwa PGBACKREST_DB_INCLUDE="db1:db2".

Befehlszeilenoptionen haben Vorrang vor Umgebungsvariablen; diese haben wiederum Vorrang vor Optionen aus der Konfigurationsdatei.

Informationen zu den Optionentypen finden Sie in der Einführung zur Konfiguration

Befehle