JSON direkt von Postgres an die API geleitet
Eine JSON‑Passthrough‑Architektur entworfen, in der
PostgreSQL‑Funktionen vollständiges JSON zurückgeben, das die Go‑API
unverändert weiterreicht; damit entfällt die zwischenzeitliche
Deserialisierung und das Frontend bleibt von Schemaänderungen
entkoppelt.
2025

Situation. Der übliche Weg von der Datenbank zum Browser ist ein
Staffellauf von Transformationen. Die Datenbank liefert Zeilen an
die API, die sie in Structs deserialisiert, umformt und wieder zu
JSON serialisiert, bevor sie versandt werden. Jeder Übergang
bedeutet zu schreibenden und zu testenden Code sowie eine weitere
Stelle, an der die Datenvorstellungen von API und Datenbank
auseinanderlaufen können.

Aufgabe. Dieser Staffellauf sollte entfallen. Wenn die Datenbank die
fertige Antwort liefert, kann die API sie weiterreichen. Das
Frontend kann sich dann direkt auf die Datenbankstruktur stützen
statt auf eine von Hand gepflegte Kopie in Go.

Massnahmen. Die Lösung wurde als direkte Weiterleitung aufgebaut.
PostgreSQL‑Funktionen setzen die gesamte Antwort als JSON zusammen.
Die Formgebung ist eine SQL‑Aufgabe und erfolgt dort, wo die Daten
ohnehin liegen. Der Go‑Handler erhält das Ergebnis als
json.RawMessage und reicht es unverändert weiter, ohne es zu
zerlegen oder neu zu codieren. Eine kleine QueryJSON‑Hilfsfunktion
machte dieses Muster zum einfachsten Weg statt zu einer Regel, an
die man denken musste. Damit entfiel die gesamte Zwischenmechanik
einer herkömmlichen geschichteten API: DTOs, Mapper und
Antwort‑Structs.

Ergebnis. Der Handler‑Code wurde erheblich kürzer. Wesentlicher war,
dass das Frontend nicht mehr an Go gekoppelt war. Ändert sich das
Funktionsergebnis, gelangt die neue Struktur direkt zum Client, ohne
eine Zeile Handler‑Code zu bearbeiten. Weniger bewegliche Teile
bedeuten, dass eine ganze Kategorie von Abweichungen zwischen
Schichten hier nicht mehr existiert.

Kategorien:
1Plattformarchitektur	/de/categories/platform-architecture/	engineer.company	70
1Backend‑Entwicklung	/de/categories/backend/	engineer.company	70
1APIs und Integration	/de/categories/api/	engineer.company	70
1Datenbanken	/de/categories/databases/	engineer.company	70
1PostgreSQL	/de/categories/postgresql/	engineer.company	70
1SQL	/de/categories/sql/	engineer.company	70
1Performanceoptimierung	/de/categories/performance/	engineer.company	70

Leistungen:
1Plattform- und Lösungsarchitektur	/de/services/platform-architecture/	engineer.company	70
1Backend- und API‑Entwicklung	/de/services/backend-development/	engineer.company	70
1Werkzeuge für KI‑Agenten und MCP‑Server	/de/services/ai-tools/	engineer.company	70
1Datenbankdesign und Datenmodellierung	/de/services/database-design/	engineer.company	70

hDiese Seite im Web	URL:https://engineer.company/de/portfolio/designed-a-json-passthrough-from-postgres-to-api/	engineer.company	70
