Vai al contenuto
Logo Aurabase
aurabase

In tempo reale

WebSocket autonegoziato, SSE e NATS. Presenza, replay, ordine garantito, contropressione. 1 milione di connessioni tramite POP, fanout inferiore a 15 ms p99 tra regioni.

Spiegazione7 min lettoLivello intermedioRevisionato il 15 apr 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Sincronizzazione, presenza, trasmissione#

Il servizio aura-realtime trasmette tre tipi di eventi: CDC Postgres (INSERT/UPDATE/DELETE filtrato da RLS), Presenza (che è online) e Broadcast (eventi personalizzati indipendente dal database). Tutti passano attraverso lo stesso SDK tramite .channel().

Un canale è identificato da un nome arbitrario (sensors:live, doc:42, room:abc). I messaggi vengono ordinati per canale, deduplicati da message_id e garantiti esattamente una volta all'interno dello stesso canale.

Informazioni

Gli abbonamenti ereditano le policy RLS dal database. Un client può sottoscrivere solo le modifiche che può leggere: il filtro viene valutato lato server sul WAL, non lato client.

Una connessione, N canali#

L'SDK mantiene una singola connessione TCP multiplex tra il client e il POP più vicino. Puoi aprire 100 canali senza aprire 100 socket.

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

Gli eventi vengono partizionati tramite hashing coerente. Un canale risiede sempre sullo stesso POP, ma la sua replica su altri POP è garantita in meno di 15ms p99.

Sei abilità native#

  • Trasporto ad alto rendimento. Connessione WebSocket nativa alimentata da interservizi NATS.
  • Postgres CDC. Modifiche WAL filtrate sul lato server, RLS applicate al flusso.
  • API di presenza. Chi è online, stato arbitrario, eventi di partecipazione/uscita.
  • Multiplexing. Diversi canali condividono una connessione WebSocket.
  • Consegna evento. Consegna in tempo reale con la massima comodità con riconnessione automatica del client.
  • Cursori collaborativi. Primitivo nativo, acceleratore adattivo 60 FPS, interpolazione client.

Quattro modelli essenziali#

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()
Pulizia obbligatoria

Chiama sempre channel.unsubscribe() durante lo smontaggio. In React, esegui questa operazione nella pulizia useEffect: l'hook useChannel sopra lo fa per te.

Ciò che promettiamo, ciò che non promettiamo#

✓ GARANTITO

  • Ordinazione per canale
  • Esattamente una volta per message_id in un canale
  • Fanout p99 < 15ms tra regioni
  • Riconnessione automatica con riproduzione anni '60
  • Contropressione esplicita (politica di caduta configurabile)

✗ NON GARANTITO

  • Ordinamento multicanale
  • Cross-channel esattamente una volta (almeno una volta)
  • Latenza sub-ms (< 15ms p99 è il nostro limite)
  • Riproduci oltre i 60 secondi (usa un registro Postgres)

Per andare oltre#