PostgreSQL-Erweiterungen verwalten: installieren, versionieren, aktualisieren und dumpen

Worum es geht

Die Dokumentation beschreibt eine Erweiterung als Skriptdatei mit den SQL-Befehlen, die ihre Objekte erzeugen, plus einer Control-Datei mit Eigenschaften wie Standardversion, Verschiebbarkeit (relocatability) und ob sie trusted ist, optional mit einer Shared Library. CREATE EXTENSION name [SCHEMA s] [VERSION v] [CASCADE] lädt sie in die aktuelle Datenbank; pg_available_extensions und pg_available_extension_versions zeigen, was die Serverinstallation anbietet. ALTER EXTENSION name UPDATE [TO v] führt die Update-Skripte des Autors von der installierten Version bis zum Ziel aus. DROP EXTENSION entfernt alle zugehörigen Objekte auf einmal, und pg_dump schreibt nur den Befehl CREATE EXTENSION, nicht die Mitgliedsobjekte.

Warum es wichtig ist

Drei Versionen existieren gleichzeitig: die auf dem Server installierten Dateien (meist ein Betriebssystempaket), die im Datenbankkatalog erfasste Version und, bei Erweiterungen mit C-Code, die vom laufenden Server geladene Bibliothek. Sie laufen auseinander bei Paket-Upgrades, bei pg_upgrade und wenn ein Dump auf einem Server wiederhergestellt wird, dessen Dateien älter sind oder fehlen. Ein Dump hängt deshalb still davon ab, dass die Erweiterungsdateien zum Zeitpunkt der Wiederherstellung vorhanden sind.

So wird es angewendet

• Erweiterungsdateien auf demselben Weg installieren wie den Server (Betriebssystempakete oder die Allowlist des Managed-Service), und die benötigten Erweiterungen und Versionen in der Migrationshistorie festhalten, damit eine frische Umgebung sie nachbildet.
• In Migrationen CREATE EXTENSION IF NOT EXISTS ... SCHEMA extensions verwenden, sofern die Erweiterung eine Schemawahl erlaubt (eine, die in ihrer Control-Datei ein Schema festlegt, lässt sich nicht übersteuern), damit Mitgliedsobjekte keine Anwendungsobjekte verdecken und die Search Paths sauber bleiben.
• Die Installation braucht normalerweise Superuser-Rechte; eine als trusted markierte Erweiterung kann jeder installieren, der CREATE auf der Datenbank hat. Die Dokumentation warnt, dass ein unachtsam geschriebenes Skript über Trojaner-Objekte im Installationsschema ausgenutzt werden kann – deshalb in Schemata installieren, in denen nicht vertrauenswürdige Nutzer kein CREATE-Privileg besitzen.
• Nach Paket-Upgrades installed_version mit default_version in pg_available_extensions vergleichen und ALTER EXTENSION ... UPDATE in einem Wartungsfenster ausführen; nach pg_upgrade das von ihm erzeugte Update-Skript ausführen.
• Module, die in shared_preload_libraries stehen müssen (pg_stat_statements, auto_explain), wirken erst nach einem Serverneustart; diesen einplanen.
• Mitgliedsobjekte nie von Hand mit CREATE OR REPLACE FUNCTION ändern; die Dokumentation hält fest, dass solche Änderungen nicht gedumpt werden.

Stolpersteine

Erweiterungsnamen sind eindeutig je Datenbank, nicht je Schema. CASCADE installiert Abhängigkeiten in ihren Standardversionen. Erweiterungen, die in Tabellen verwendete Datentypen definieren (postgis, hstore, vector), müssen vorhanden sein, bevor die Tabellen wiederhergestellt werden können, sonst scheitert die Wiederherstellung für diese Tabellen, nicht nur für Funktionen. Managed Services veröffentlichen Allowlists; eine Erweiterung ausserhalb der Liste blockiert eine Migration zu diesem Dienst.