Zum Hauptinhalt springen
Connic

PostgreSQL

Von Connic

Connic hört auf einen Postgres NOTIFY Channel und löst den Agenten aus, sobald eine Zeile eintrifft. Zusätzliche Polling- oder CDC-Infrastruktur ist nicht erforderlich: Die Datenbank wird zur Event-Quelle.

Inbound

Überblick

PostgreSQL bringt einen Pub/Sub-Mechanismus mit: LISTEN/NOTIFY. Eine Trigger Function oder der Anwendungscode ruft pg_notify() auf einem Channel auf, und jede dort lauschende Verbindung erhält die Payload sofort. Die PostgreSQL-Verbindung hält eine persistente Verbindung zur Datenbank, abonniert den konfigurierten Channel und verwandelt jede Notification in einen Agent Run mit deren Payload.

Damit entfällt die übliche Infrastruktur für Reaktionen auf Datenänderungen: keine Polling-Schleife, die die Tabelle belastet, keine Change-Data-Capture-Pipeline und kein Worker-Dienst, der bereitgestellt und überwacht werden muss. Die Datenbank weiß bereits, wann sich eine Zeile ändert; die Verbindung leitet dieses Ereignis direkt an einen Agenten weiter.

So funktioniert es

1

Datenbank erreichbar machen

Der PostgreSQL Server muss aus dem Internet erreichbar sein. Alternativ verbindet die Connic Bridge Datenbanken in privaten Netzwerken.

2

NOTIFY Trigger hinzufügen

Erstelle für die zu überwachende Tabelle eine Trigger-Funktion mit pg_notify() oder sende Benachrichtigungen direkt aus dem Anwendungscode. Üblich ist eine JSON Payload mit den Zeilendaten.

3

Verbindung erstellen

Füge im Verbindungsdiagramm des Agenten eine PostgreSQL-Verbindung hinzu und trage Host, Port, Database, Username, Password, Channel Name und SSL-Einstellungen ein. Connic hört sofort auf dem Channel.

Muster für den Produktivbetrieb

Muster für den Produktivbetrieb, bei denen Connic Queues, Worker und Scheduler betreibt.

Trigger

Neue Kundenzeile eingefügt

NOTIFY customers_insert
Agent-Aktion

Der Agent sucht das Unternehmen auf Clearbit, ergänzt Unternehmensmerkmale und schreibt das Ergebnis in die Kundenzeile zurück, bevor die Willkommens-E-Mail versendet wird.

Verbindung und Zugangsdaten

Die Verbindung authentifiziert sich mit einem normalen Datenbanknutzer und Passwort. Dieser Nutzer benötigt nur die Berechtigung CONNECT für die Datenbank. Für NOTIFY Events sind weder Tabellenzugriff noch besondere Grants erforderlich, sodass ein dedizierter Nutzer mit geringen Rechten ausreicht. Der SSL-Modus ist konfigurierbar: disable, prefer oder require. Jede Verbindung hält pro Channel eine persistente Datenbankverbindung, was bei strengen Connection Limits relevant ist.

Jede Notification wird zu einem normalen Agent Run und erscheint in der Run History mit vollständigen Traces, Token- und Kosten-Tracking sowie denselben Guardrails und Approval-Regeln wie jeder andere Trigger.

Payload-Struktur und Limits

Der Agent erhält die Notification Payload und einen _postgres Metadatenblock mit Channel Name, Backend Process ID und Timestamp. Bei aktiviertem Parse JSON Payload (Standard) kommt eine JSON Notification als strukturiertes Objekt statt als String an. PostgreSQL begrenzt NOTIFY Payloads auf 8000 Bytes. Zuverlässiger ist es deshalb, nur IDs und wichtige Felder zu senden, über die der Agent den vollständigen Datensatz lädt. Separate Channels pro Event-Typ wie orders_created und users_updated halten das Routing übersichtlich. PostgreSQL-Dokumentation: Trigger und Payload-Format.

Informationen

Publisher
Von Connic
Verbindungen
Verbindungen
Modi
Inbound
Dokumentation
PostgreSQL Docs

Häufig gestellte Fragen

Dazu wird an der Tabelle eine Trigger Function eingerichtet, die pg_notify() mit einer JSON Payload aufruft. Eine Connic PostgreSQL-Verbindung abonniert diesen Channel. Jeder Insert löst eine Notification aus, aus der die Verbindung einen Agent Run mit der Payload als Input erstellt. Updates und Deletes funktionieren ebenso mit einem AFTER UPDATE oder AFTER DELETE Trigger. Weitere Trigger-to-Agent Patterns zeigt der Leitfaden zu Verbindungsmustern.

Nein. Die Verbindung hält eine persistente Datenbankverbindung und abonniert mit LISTEN einen NOTIFY Channel. PostgreSQL überträgt Events in dem Moment, in dem sie auftreten. Wiederholte Abfragen der Tabellen entfallen; pro Channel besteht nur eine Verbindung.

Ja. Wenn der PostgreSQL Server nicht aus dem Internet erreichbar ist, bindet die Connic Bridge Datenbanken in privaten Netzwerken an, ohne sie öffentlich zugänglich zu machen. Funktionsweise der Connic Bridge.
Plane einen Agenten-Workflow mit PostgreSQL und Connic

Beschreibe die Event-Quelle, die Struktur der Payload, das Ziel für die Ergebnisse und die Anforderungen an private Netzwerke oder Freigaben. Wir helfen, PostgreSQL mit dem passenden Verbindungsmodus, Deployment und Monitoring in Connic einzurichten.

Sprich mit Sales