Chapter 3. PostGIS Verwaltung

Diese Einstellungen werden in postgresql.conf konfiguriert:

constraint_exclusion

shared_buffers

max_worker_processes Diese Einstellung ist ab PostgreSQL 9.4 verfügbar. Ab PostgreSQL 9.6 kann mit dieser Einstellung zusätzlich die maximale Anzahl von Prozessen bei parallelen Abfragen eingestellt werden.

work_mem - setzt die Speichergröße für Sortiervorgänge und komplexe Abfragen

maintenance_work_mem - die Speichergröße, welche für VACUUM, CREATE INDEX, etc. verwendet wird.

max_parallel_Arbeiter_pro_Gruppe

Diese Einstellung ist nur für PostgreSQL 9.6+ verfügbar und wirkt sich nur auf PostGIS 2.3+ aus, da nur PostGIS 2.3+ parallele Abfragen unterstützt. Wenn sie auf einen Wert größer als 0 gesetzt wird, können einige Abfragen, z.B. solche, die Beziehungsfunktionen wie ST_Intersects beinhalten, mehrere Prozesse verwenden und können dabei mehr als doppelt so schnell laufen. Wenn Sie viele Prozessoren zur Verfügung haben, sollten Sie den Wert auf so viele Prozessoren ändern, wie Sie haben. Stellen Sie außerdem sicher, dass max_worker_processes mindestens so hoch ist wie diese Zahl.

Wenn ab PostgreSQL 9.1 die Extensions/Postgis-Module installiert sind, kann die Datenbank mit Hilfe des EXTENSION-Mechanismus in eine spatiale Datenbank verwandelt werden.

Die Postgis-Erweiterung selbst enthält die Module geometry, geography, spatial_ref_sys inklusive aller Funktionen und Kommentare. Die Module raster und topology sind in separate Erweiterungen verpackt.

Um die spatiale Erweiterung in einer Datenbank zu aktivieren, wird der folgende SQL Befehl ausgeführt:

CREATE EXTENSION IF NOT EXISTS plpgsql;
      CREATE EXTENSION postgis;
      CREATE EXTENSION postgis_raster; -- OPTIONAL
      CREATE EXTENSION postgis_topology; -- OPTIONAL

	Dies ist in der Regel nur dann notwendig, wenn PostGIS nicht in das Erweiterungsverzeichnis von PostgreSQL installiert werden kann oder soll (wie in einer Test-, Entwicklungs- oder eingeschränkten Umgebung).

Das Hinzufügen von PostGIS-Objekten und Funktionsdefinitionen in Ihre Datenbank erfolgt durch das Laden unterschiedlicher SQL-Dateien unter [prefix]/share/contrib, wie während der Erstellungsphase angezeigt.

Die zentralen PostGIS-Objekte (Geometrie- und Geografietypen sowie deren Unterstützungsfunktionen) befinden sich im Skript postgis.sql. Rasterobjekte sind im Skript rtpostgis.sql. Topologieobjekte sind im Skript topology.sql.

Für einen vollständigen Satz an EPSG-Koordinatensystemdefinitionen können Sie auch die Definitionsdatei spatial_ref_sys.sql laden um die Tabelle spatial_ref_sys zu befüllen. Dies ermöglicht Ihnen ST_Transform()-Operationen an Geometrien durchzuführen.

Wenn Sie Kommentare zu den PostGIS-Funktionen hinzufügen möchten, finden Sie diese im Skript postgis_comments.sql. Kommentare können durch die Eingabe von \dd [function_name] in einem psql Terminalfenster angezeigt werden.

Führen Sie die folgenden Shell-Befehle in Ihrem Terminal aus:

DB=[yourdatabase]
    SCRIPTSDIR=`pg_config --sharedir`/contrib/postgis-3.4/

    # Core objects
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/spatial_ref_sys.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis_comments.sql # OPTIONAL

    # Raster support (OPTIONAL)
    psql -d ${DB} -f ${SCRIPTSDIR}/rtpostgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/raster_comments.sql # OPTIONAL

    # Topology support (OPTIONAL)
    psql -d ${DB} -f ${SCRIPTSDIR}/topology.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/topology_comments.sql # OPTIONAL

Wenn Sie Ihre Datenbank mithilfe von EXTENSION installiert haben, müssen Sie das Upgrade ebenfalls über das EXTENSION Modell durchführen. Falls Sie die Installation über die alte SQL-Skript-Methode vorgenommen haben, wird empfohlen, auf die Nutzung von EXTENSION umzusteigen, da die Skript-Methode nicht länger unterstützt wird.

3.4.1.1. Sanfte Aktualisierung 9.1+ mittels Erweiterungen

Wenn Sie PostGIS ursprünglich mithilfe von EXTENSION installiert haben, müssen Sie das Upgrade ebenfalls über EXTENSION durchführen. Ein kleines Upgrade mit Erweiterungen ist relativ unkompliziert.

Wenn Sie PostGIS 3 oder höher verwenden, sollten Sie die Funktion PostGIS_Extensions_Upgrade nutzen, um auf die neueste installierte Version zu aktualisieren.

SELECT postgis_extensions_upgrade();

Falls Sie PostGIS 2.5 oder niedriger verwenden, gehen Sie bitte wie folgt vor:

ALTER EXTENSION postgis UPDATE;
SELECT postgis_extensions_upgrade();
-- This second call is needed to rebundle postgis_raster extension
SELECT postgis_extensions_upgrade();

Wenn Sie mehrere Versionen von PostGIS installiert haben und nicht auf die neueste Version aktualisieren möchten, können Sie die gewünschte Version wie folgt explizit angeben:

ALTER EXTENSION postgis UPDATE TO "3.6.0dev";
ALTER EXTENSION postgis_topology UPDATE TO "3.6.0dev";

Falls Sie eine Fehlermeldung erhalten, die in etwa wie folgt aussieht:

No migration path defined for … to 3.6.0dev

Dann müssen Sie eine Sicherungskopie Ihrer Datenbank anlegen, eine neue Datenbank erstellen, wie unter Section 3.3.1, “Die spatiale Datenbankerweiterung mittels EXTENSION aktivieren” beschrieben, und dann Ihre Sicherungskopie in dieser neuen Datenbank wiederherstellen.

Falls Sie eine Hinweisnachricht erhalten, die in etwa wie folgt aussieht:

Version "3.6.0dev" of extension "postgis" is already installed

Dann ist bereits alles auf dem neuesten Stand und Sie können das getrost ignorieren. Es sei denn, Sie versuchen, von einer Entwicklungsversion auf die nächste zu aktualisieren (die keine neue Versionsnummer erhält); in diesem Fall können Sie "next" an die Versionszeichenfolge anhängen, und beim nächsten Mal müssen Sie das Suffix "next" wieder weglassen:

ALTER EXTENSION postgis UPDATE TO "3.6.0devnext";
ALTER EXTENSION postgis_topology UPDATE TO "3.6.0devnext";

	Wenn Sie PostGIS ursprünglich installiert haben ohne eine Version anzugeben , können Sie die Neuinstallation der postgis-Erweiterung vor der Wiederherstellung oftmals überspringen, da im Backup nur CREATE EXTENSION postgis steht und daher die aktuellste Version für die Wiederherstellung herangezogen wird.

	Wenn Sie die PostGIS-Erweiterung vor Version 3.0.0 aktualisieren, erhalten Sie die neue Erweiterung postgis_raster, welche Sie getrost löschen können, wenn Sie keine Rasterunterstützung benötigen. Sie können diese wie folgt entfernen: DROP EXTENSION postgis_raster;

3.4.1.2. Section 3.3.2, “Räumliche Aktivierung der Datenbank ohne Verwendung von EXTENSION (nicht empfohlen)”Sanfte Aktualisierung bei Version kleiner 9.1 oder wenn nicht mittels Erweiterungen installiert wurde

Dieser Abschnitt gilt nur, wenn PostGIS ohne Erweiterungen installiert wurde. Wenn Erweiterungen existieren und eine Aktualiserung mit diesem Ansatz versucht wird, erhalten Sie eine Meldungen wie:

can't drop … because postgis extension depends on it

HINWEIS: Wenn Sie von PostGIS 1.* zu PostGIS 2.* oder von PostGIS 2.* vor r7409 wechseln, können Sie dieses Verfahren nicht verwenden, sondern müssen ein HARD UPGRADE durchführen.

Nach dem Kompilieren und Installieren (make install) sollten Sie eine Reihe von *_upgrade.sql Dateien in den Installationsordnern finden. Sie können alle wie folgt auflisten:

ls `pg_config --sharedir`/contrib/postgis-3.6.0dev/*_upgrade.sql

Laden Sie diese alle nacheinander, beginnend mit postgis_upgrade.sql.

psql -f postgis_upgrade.sql -d your_spatial_database

Das gleiche Verfahren gilt auch für die Raster-, Topologie- und sfcgal-Erweiterungen, mit den Upgrade-Dateien rtpostgis_upgrade.sql, topology_upgrade.sql und sfcgal_upgrade.sql. Falls Sie diese benötigen:

psql -f rtpostgis_upgrade.sql -d your_spatial_database

psql -f topology_upgrade.sql -d your_spatial_database

psql -f sfcgal_upgrade.sql -d your_spatial_database

Wir empfehlen Ihnen, zu einer Installation mit EXTENSION zu wechseln, indem Sie folgendes ausführen

psql -c "SELECT postgis_extensions_upgrade();"

	Wenn Sie postgis_upgrade.sql für das Upgrade Ihrer Version nicht finden können, so liegt das daran, dass die Version für ein Soft-Upgrade zu niedrig ist und Sie daher ein HARD UPGRADE durchführen müssen.

Die Funktion PostGIS_Full_Version sollte Sie über die Meldung "procs need upgrade" von der Notwendigkeit eines solchen Upgrades informieren.

Unter HARD UPGRADE verstehen wir ein vollständiges Dump/Reload von PostGIS-aktivierten Datenbanken. Ein HARD UPGRADE ist erforderlich, wenn sich der interne Speicher von PostGIS-Objekten ändert oder wenn ein SOFT UPGRADE nicht möglich ist. Der Anhang Release Notes gibt für jede Version an, ob ein Dump/Reload (HARD UPGRADE) für ein Upgrade erforderlich ist.

Der Dump/Reload-Prozess wird durch das postgis_restore-Skript unterstützt, das dafür sorgt, dass alle Definitionen, die zu PostGIS gehören (einschließlich der alten), aus dem Dump ausgelassen werden. So können Sie Ihre Schemata und Daten in einer Datenbank mit installiertem PostGIS wiederherstellen, ohne dass es zu Fehlern bei doppelten Symbolen kommt oder veraltete Objekte mitgenommen werden.

Ergänzende Anleitungen für Windows-Benutzer finden Sie unter Windows Hard Upgrade.

Das Verfahren ist wie folgt:

In den folgenden Fällen kann es zu Fehlern kommen: