Zum Hauptinhalt springen

Überblick über das Daten-Gateway

Analysten · externe Systeme · BI · KI-Agenten greifen nicht direkt auf das Repository zu. Das Daten-Gateway (:5500 · TLS :5501) nimmt vier Abfragesprachen an einem Endpunkt entgegen, blockiert Anweisungen, die das Schema ändern, begrenzt Ergebnisse und protokolliert alle Abfragen.

SpracheVerbindung zuSicht auf
PQLPostgreSQLMetadaten — Anlagen · Tags · Benutzer · Konfiguration
CQLAster TSDBSensor-Rohdaten · Aggregationen · BLOB-Metadaten
SQLKyuubi (Spark)Iceberg-Kaltdatenebene · Data Warehouse
TQLZeitreihen-Engine (TSE)Metriken · Rollups
Öffnen, ohne zu verletzen

Das Gateway ist kein „Sperrtor“, sondern ein „kontrolliertes Tor“. Lesen ist breit geöffnet; nur Anweisungen, die die Struktur verändern, und übermäßige Ergebnisse werden blockiert.

Aufbau​

KI-Agenten kommen durch dasselbe Tor

Die MCP-Tools der Plattform laufen intern über dieses Gateway mit denselben Rechten · demselben Protokoll · denselben Grenzen. Für Agenten gibt es keinen erweiterten Zugriff.

Drei Zugriffswege​

MethodeWann
REST POST /api/v1/query · /query/streamExterne Systeme · Skripte · Agenten
SQL-Konsole https://<server-ip>:5501/Mensch im Browser – Daten-Gateway-Konsole
Java-SDK plantpulse-data-gateway-clientEingebettet in Anwendungen – Daten-Gateway-Client

Für BI-Tools, die direkt auf das Repository zugreifen müssen, gibt es ein separates Set an JDBC-Treibern – siehe Datenabfrage.

Eine Zeile in 5 Minuten​

# 1. 살아 있나 (익명 readiness — 이 경로만 HTTPS 강제에서 빠집니다)
curl -fsS http://127.0.0.1:5500/api/health
# {"status":"UP","service":"plantpulse-data-gateway-web",…,
#  "checks":{"database":true,"inmemory":true,"query_log":true}}

# 2. 메타데이터 한 줄 (PQL)
curl -fsS -X POST -H "X-API-Key: ${PP_DATA_GATEWAY_API_KEY}" -H "X-Lang: PQL" \
  -H "Content-Type: application/json" \
  -d "SELECT tablename FROM pg_tables WHERE schemaname='pp'" \
  http://127.0.0.1:5500/api/v1/query

# 3. 큰 결과는 스트림으로 (NDJSON)
curl -fsS -X POST -H "X-API-Key: ${PP_DATA_GATEWAY_API_KEY}" -H "X-Lang: CQL" \
  -H "Content-Type: application/json" \
  -d "SELECT * FROM pp.tm_tag_value WHERE tag_id='TAG_001' LIMIT 100" \
  http://127.0.0.1:5500/api/v1/query/stream

Struktur dieses Abschnitts​

SeiteWann ansehen
APIEndpunkte · Header · Parameterbindung · Fehlerverträge
Kontrolle und GrenzenWas blockiert und protokolliert wird – DDL · Rate-Limits · Obergrenzen

Verwandte Dokumentation​