Naar de inhoud springen
Aurabase-logo
aurabasis

Realtime

Zelfonderhandelde WebSocket, SSE en NATS. Aanwezigheid, herhaling, gegarandeerde bestelling, tegendruk. 1M-verbindingen via POP, fanout sub-15ms p99 tussen regio's.

Uitleg7 min lezenNiveau tussenproductHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Synchronisatie, aanwezigheid, uitzending#

De aura-realtime-service zendt drie soorten gebeurtenissen uit: CDC Postgres (INSERT/UPDATE/DELETE gefilterd door RLS), Aanwezigheid (die online is) en Uitzending (aangepaste gebeurtenissen onafhankelijk van de database). Ze gaan allemaal via dezelfde SDK via .channel().

Een kanaal wordt geïdentificeerd door een willekeurige naam (sensors:live, doc:42, room:abc). Berichten worden geordend per kanaal, gededupliceerd door message_id en gegarandeerd precies één keer binnen hetzelfde kanaal.

Info

Abonnementen nemen het beleid RLS over van de database. Een client kan zich alleen abonneren op wijzigingen die hij kan lezen; het filter wordt aan de serverzijde op de WAL geëvalueerd, niet aan de clientzijde.

Eén verbinding, N kanalen#

De SDK onderhoudt een enkele gemultiplexte TCP-verbinding tussen de client en de dichtstbijzijnde POP. Je kunt 100 kanalen openen zonder 100 stopcontacten te openen.

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

Gebeurtenissen worden gepartitioneerd door consistente hashing. Een kanaal leeft altijd op dezelfde POP, maar de replicatie ervan naar andere POP's is gegarandeerd in minder dan 15 ms p99.

Zes inheemse vaardigheden#

  • Transport met hoge doorvoer. Native WebSocket-verbinding mogelijk gemaakt door inter-service NATS.
  • Postgres CDC. WAL-wijzigingen gefilterd aan de serverzijde, RLS toegepast op de stroom.
  • Aanwezigheids-API. Wie is online, willekeurige status, deelname aan/verlaat evenementen.
  • Multiplexen. Verschillende kanalen delen één WebSocket-verbinding.
  • Levering van evenement. Beste live-levering met automatische herverbinding met de klant.
  • Samenwerkende cursors. Native primitief, adaptief gaspedaal 60 FPS, clientinterpolatie.

Vier essentiële patronen#

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()
Verplichte schoonmaak

Bel altijd channel.unsubscribe() bij het ontkoppelen. In React doe je dit tijdens het opschonen van useEffect - de useChannel hook hierboven doet het voor je.

Wat we beloven, wat we niet beloven#

✓ GEGARANDEERD

  • Bestellen per kanaal
  • Precies één keer per message_id in een kanaal
  • Fanout p99 < 15 ms cross-regio
  • Automatische herverbinding met herhaling uit de jaren 60
  • Expliciete tegendruk (configureerbaar drop-beleid)

✗ NIET GEGARANDEERD

  • Cross-channel bestellen
  • Precies één keer cross-channel (minstens één keer)
  • Latentie onder ms (< 15 ms p99 is onze minimum)
  • Herhaling na 60 seconden (gebruik een Postgres log)

Om verder te gaan#