Zum Inhalt springen
Aurabase-Logo
Aurabasis

Echtzeit

Selbstverhandelter WebSocket, SSE und NATS. Präsenz, Wiedergabe, garantierte Ordnung, Gegendruck. 1 Mio. Verbindungen per POP, Fanout unter 15 ms p99 zwischen Regionen.

Erklärung7 Min. gelesenEbene MittelstufeÜberarbeitet am 15.04.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Synchronisierung, Präsenz, Übertragung#

Der Dienst aura-realtime sendet drei Arten von Ereignissen: CDC Postgres (INSERT/UPDATE/DELETE gefiltert nach RLS), Presence (das online ist) und Broadcast (benutzerdefinierte Ereignisse unabhängig von der Datenbank). Alle durchlaufen dasselbe SDK über .channel().

Ein Kanal wird durch einen beliebigen Namen identifiziert (sensors:live, doc:42, room:abc). Nachrichten werden nach Kanal sortiert, von message_id dedupliziert und garantiert genau einmal innerhalb desselben Kanals.

Infos

Abonnements erben die Richtlinien RLS aus der Datenbank. Ein Client kann nur Änderungen abonnieren, die er lesen kann – der Filter wird serverseitig auf der WAL ausgewertet, nicht clientseitig.

Eine Verbindung, N Kanäle#

Das SDK unterhält eine einzelne gemultiplexte TCP-Verbindung zwischen dem Client und dem nächstgelegenen POP. Sie können 100 Kanäle öffnen, ohne 100 Sockets zu öffnen.

schematext
                      ┌──────────────────┐
   Client (WS)  ────▶ │ aura-realtime    │
                      │  ─ CDC listener  │
                      │  ─ Presence CRDT │
                      │  ─ Broadcast hub │
                      └────────┬─────────┘
                               │ NATS JetStream
          ┌────────────────────┴────────────────────┐
          ▼                    ▼                    ▼
    aura-db WAL         Presence state        autres POPs
Tipp

Ereignisse werden durch konsistentes Hashing partitioniert. Ein Kanal lebt immer auf demselben POP, aber seine Replikation auf andere POPs ist garantiert in weniger als 15 ms p99.

Sechs native Fähigkeiten#

  • Transport mit hohem Durchsatz. Native WebSocket-Verbindung mit dienstübergreifender Unterstützung NATS.
  • Postgres CDC. WAL-Änderungen werden auf der Serverseite gefiltert, RLS werden auf den Fluss angewendet.
  • Präsenz-API. Wer ist online, beliebiger Status, Ereignisse beitreten/verlassen.
  • Multiplexing. Mehrere Kanäle teilen sich eine WebSocket-Verbindung.
  • Ereigniszustellung. Bestmögliche Live-Bereitstellung mit automatischer Client-Wiederverbindung.
  • Kollaborative Cursor. Natives Primitiv, adaptive Drosselung 60 FPS, Client-Interpolation.

Vier wesentliche Muster#

components/LiveDevices.tsxtypescript
const channel = aura.channel('db:public.devices')
  .on('postgres_changes', {
    event: '*',
    schema: 'public',
    table: 'devices',
    filter: `tenant_id=eq.${tid}`,
  }, ({ new: row }) => render(row))
  .subscribe()
Obligatorische Reinigung

Rufen Sie beim Unmounten immer channel.unsubscribe() auf. Führen Sie dies in React in der useEffect-Bereinigung aus – der useChannel-Hook oben erledigt das für Sie.

Was wir versprechen, was wir nicht versprechen#

✓ GARANTIERT

  • Sortierung nach Kanal
  • Genau einmal pro message_id in einem Kanal
  • Fanout p99 < 15 ms überregional
  • Automatische Wiederverbindung mit 60er-Wiedergabe
  • Expliziter Gegendruck (konfigurierbare Drop-Richtlinie)

✗ NICHT GARANTIERT

  • Kanalübergreifende Bestellung
  • Genau einmal kanalübergreifend (mindestens einmal)
  • Sub-ms-Latenz (< 15 ms p99 ist unser Mindestwert)
  • Wiedergabe über 60 Sekunden hinaus (verwenden Sie ein Postgres-Protokoll)

Um weiter zu gehen#