PostgreSQL

Datenbankprovider

Muss die GBD WebSuite sich mit der Datenbank direkt verbinden, z.B. um eine [postgres-Layer](TODO LINK) anzuzeigen, in der Datenbank zu [Suchen](TODO LINK), um [Modelle](TODO LINK) zu [editieren](TODO LINK) oder gegen die Datenbank zu [authentifizieren](TODO LINK), so muss ein Datenbankprovider in der Konfiguration der GBD WebSuite hinterlegt werden, der eine Verbindungsmöglichkeit zu der Datenbank beschreibt.

{
    database.providers+ {
        type postgres
        uid "example_db"
        host "db.example.com"
        port 5432
        database "my_gis_db"
        username "exampleuser"
        password "examplepassword123"
    }
}

{
    database.providers+ {
        type postgres
        ...
        options {
            "connect_timeout": 10
            "passfile": "/data/.pgpass"
        }
    }
}

pg_service.conf

Greift nicht nur die GBD WebSuite, sondern auch der QGIS Server, oder Anwender mit QGIS Desktop auf die Datenbank zu reicht in einem Unternehmen mit mehreren mitarbeitern schnell der gemeinsame Zugriff über einen einzelnen Datenbankbenutzer nicht mehr aus.

Im folgenden wird ein Szenario beschrieben welches durch die Verwendung der pg_service.conf zur Ablage von PostgreSQL Verbindungen stark vereinfacht werden kann:

• Es gibt eine PostgreSQL Datenbank mit mehreren Benutzerrollen, die mit teils unterschiedlichen Berechtigungen auf eine oder mehrere gemeinsame Datenbanken zugreifen müssen.
• Die Zugansinformationen zur Datenbank können somit nicht direkt in QGIS Projekten (.qgs) abgelegt werden, da durch Weitergabe der QGIS Projekte zwischen Anwendern diese Ihre Zugangsinformationen zur Datenbank mit weitergeben würden.
• Die QGIS Projekte werden in einer Datenbank abgelegt. Einerseits können die Anwender so auf die gleichen Projekte zugreifen ohne eine gemeinsame Dateiablage zu verwenden, andererseits liest die GBD WebSuite diese QGIS Projekte aus der Datenbank um diese direkt als Karten im Browser oder als Dienst zur Verfügung zu stellen.

Dieses Szenario kann wie folgt gelöst werden:

im Home-Verzeichnis jedes Anwenders, sowie im /data/ Verzeichnis der GBD WebSuite wird eine Textdatei (pg_service.conf) hinterlegt, welche mindestens einen Dienst definiert:

/data/pg_service.conf

[mein_dienst]
host=db.example.com
port=5432
dbname=example_db
user=exampleuser
password=******

[mein_anderer_dienst]
host=db.example.com
port=5432
dbname=noch_eine_datenbank
user=readonly_user
password=*******

In der docker-compose.yml muss die Umgebungsvariable PGSERVICECONF für sowohl den gws als auch den qgis Container gesetzt werden.

Werden QGIS Projekte aus der Datenbank geladen, muss für den qgis Container ebenfalls die Variable QGIS_SERVER_PROJECT_CACHE_STRATEGY auf periodic gesetzt werden, damit Änderungen an den QGIS Projekten vom QGIS Server erkannt werden.

docker-compose.yml

services:
  gws:
    ...
    environment:
      - PGSERVICEFILE=/data/pg_service.conf
  qgis:
    ...
    environment:
      - PGSERVICEFILE=/data/pg_service.conf
      - QGIS_SERVER_PROJECT_CACHE_STRATEGY=periodic

Die Konfiguration der database.providers für die GBD WebSuite kann ebenfalls die Zugangsdaten aus der /data/pg_service.conf lesen:

/data/config.cx

{
  database.providers+ {
    type postgres
    uid mein_dienst
    service mein_dienst
  }
  database.providers+ {
    type postgres
    uid db2
    service mein_anderer_dienst
  }
}

Für die Verwendung mit Desktop QGIS kann die pg_service.conf an einem beliebigen Ort im Dateisystem des Desktop Rechners hinterlegt werden. Hier kann für jeden Anwender ein eigener User zum Verbindungsaufbau mit der Datenbank hinterlegt werden. Wird die pg_service.conf durch zentralisierte Administration automatisch für den Anwender hinterlegt sind hier sogar regelmäßige Passwort rotationen für Postgres-Anwenderaccounts möglich ohne dass der Anwender davon etwas mitbekommt. Für QGIS Desktop muss die PGSERVICEFILE Umgebungsvariable ebenfalls gesetzt werden.

Bei der Anlage der Datenbankverbindung in QGIS muss dann lediglich der Name des Dienstes angegeben werden, in diesem Beispiel mein_dienst oder mein_anderer_dienst. Dies ist die einzige Information die im QGIS Projekt (.qgs) für eine Datenquelle hinterlegt wird.

QGIS Projekte in Datenbank

QGIS kann Projekte direkt in der Datenbank speichern, statt in einer .qgs-Datei.

Die GBD WebSuite kann für die Darstellung von [QGIS-Layern](TODO LINK) diese QGIS Projekte direkt aus der Datenbank lesen.

host.docker.internal

Ist PostgreSQL auf dem Host System direkt installiert, so kann in der Providerkonfiguration oder der [pg_service.conf] nicht der Hostname localhost verwendet werden.

Wird in der docker-compose.yml der folgende Eintrag hinterlegt:

docker-compose.yml

services:
  gws:
    ...
    extra_hosts:
      - "host.docker.internal:host-gateway"
  qgis:
    ...
    extra_hosts:
      - "host.docker.internal:host-gateway"

ist es möglich unter host.docker.internal auf den Hostrechner des Containers zuzugreifen.

Dieser Name muss dann auch in der pg_service.conf oder der Providerkonfiguration als Hostname hinterlegt werden.

host.docker.internal ist der konventionell für den Zugriff des Containers auf den Hostrechner verwendete Name. Wenn gewünscht kann dieser an allen Stellen durch einen selbst gewählten Namen ersetzt werden.