Zum Hauptinhalt springen
Data Operations

Endpunkte

Das Paket Endpunkte enthält Nodes, die Daten der Plattform nach außen bereitstellen. Derzeit umfasst es den Node PostgreSQL CSV API, der konfigurierbare PostgreSQL-Tabellen als CSV-Download hinter einem Open-Data-Endpunkt veröffentlicht. Node-RED übernimmt dabei die Datenpipeline, ein API-Gateway wie APISIX den öffentlichen Zugang. Das Paket wurde von der Stadt Menden (Sauerland) beauftragt und als Open Source freigegeben.

Paket
@htag/node-red-contrib-hypertegrity-endpoints
Version
0.3.1
Nodes
1 (plus 2 Konfigurationsnodes)
Lizenz
EUPL-1.2

Enthaltene Nodes​

postgresql-csv-api

PostgreSQL CSV API

Veröffentlicht im Modellregister definierte PostgreSQL-Tabellen als CSV über GET /api/opendata/v1/:model.csv, mit Spalten- und Entitätsausschluss.

Node öffnen

Zum Node gehören die Konfigurationsnodes PostgreSQL CSV API: Verbindung (postgresql-csv-api-connection) für die Datenbankverbindung und PostgreSQL CSV API: Modellregister (postgresql-csv-api-registry) für die veröffentlichten Modelle. Beide sind auf der Node-Seite beschrieben.

Installation​

npm install @htag/node-red-contrib-hypertegrity-endpoints

Alternativ installieren Sie das Paket im Node-RED-Editor über Menü → Palette verwalten → Installieren und suchen nach hypertegrity-endpoints. Voraussetzung sind Node-RED ab Version 4.0.5 und Node.js ab Version 20.18. Der Node erscheint in der Palette in der Kategorie DataOps.

Gemeinsame Hinweise​

  • Abhängigkeiten: Das Paket installiert den PostgreSQL-Client pg mit. Für die optionale Ausgabe von Koordinaten muss in der Datenbank die Erweiterung PostGIS vorhanden sein.
  • Datenbankzugang: Die Verbindung wird im Konfigurationsnode hinterlegt; Benutzer und Passwort liegen verschlüsselt in flows_cred.json. Alle Felder unterstützen Platzhalter der Form ${VAR}; leere Felder fallen auf die Umgebungsvariablen DB_HOST, DB_PORT, DB_NAME, DB_USER und DB_PASSWORD zurück. Verwenden Sie einen Datenbankbenutzer, der nur lesen darf. Die Verbindung zur Datenbank erfolgt ohne SSL; betreiben Sie Node-RED und PostgreSQL deshalb im selben vertrauenswürdigen Netz.
  • Zugriffsschutz: Der Endpunkt prüft selbst keine Zugangsdaten. Node-RED darf nicht direkt aus dem öffentlichen Netz erreichbar sein; vorgesehen ist ein API-Gateway (APISIX) mit API-Schlüssel, das nur die Open-Data-Route veröffentlicht und den Node-RED-Editor verbirgt.
  • Proxy: Der Node baut ausschließlich Verbindungen zur Datenbank auf; eine Proxy-Konfiguration ist nicht vorgesehen.
  • Datenschutz: Veröffentlichte Tabellen können personenbezogene Daten enthalten. Der Node entfernt nichts automatisch. Schließen Sie betroffene Spalten und entity_id-Werte im Modellregister aus und prüfen Sie jedes Modell vor der Freigabe als Open Data.