W czasie rzeczywistym
Samonegocjowane gniazdo WebSocket, SSE i NATS. Obecność, powtórka, gwarantowana kolejność, przeciwciśnienie. 1 mln połączeń przez POP, rozwarcie poniżej 15 ms p99 pomiędzy regionami.
Synchronizacja, obecność, transmisja#
Usługa aura-realtime emituje trzy rodzaje zdarzeń: CDC Postgres (INSERT/UPDATE/DELETE filtrowane przez RLS), Obecność (która jest online) i Broadcast (niestandardowe zdarzenia niezależne od bazy danych). Wszystkie przechodzą przez ten sam zestaw SDK przez .channel().
Kanał jest identyfikowany przez dowolną nazwę (sensors:live, doc:42, room:abc). Wiadomości są sortowane według kanałów, deduplikowane przez message_id i gwarantowane dokładnie raz w tym samym kanale.
Subskrypcje dziedziczą zasady RLS z bazy danych. Klient może subskrybować tylko zmiany, które może odczytać — filtr jest oceniany po stronie serwera na WAL, a nie po stronie klienta.
Jedno połączenie, N kanałów#
Zestaw SDK utrzymuje pojedyncze multipleksowane połączenie TCP pomiędzy klientem a najbliższym punktem POP. Można otworzyć 100 kanałów bez otwierania 100 gniazd.
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
Zdarzenia są dzielone poprzez spójne mieszanie. Kanał zawsze znajduje się w tym samym POP, ale jego replikacja do innych POP jest gwarantowana w czasie krótszym niż 15 ms p99.
Sześć rodzimych umiejętności#
- Transport o dużej przepustowości. Natywne połączenie WebSocket obsługiwane przez międzyusługowe NATS.
- Postgres CDC. Zmiany WAL filtrowane po stronie serwera, RLS zastosowane do przepływu.
- API obecności. Kto jest online, dowolny stan, dołącz/opuść wydarzenie.
- Multipleksowanie. Kilka kanałów korzysta z jednego połączenia WebSocket.
- Dostarczenie zdarzenia. Najlepsza dostawa na żywo z automatycznym ponownym połączeniem klienta.
- Wspólne kursory. Natywny prymitywny, adaptacyjna przepustnica 60 FPS, interpolacja klienta.
Cztery podstawowe wzorce#
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()
Zawsze wywołuj channel.unsubscribe() przy odmontowaniu. W React zrób to w ramach porządkowania useEffect — powyższy hak useChannel zrobi to za Ciebie.
Co obiecujemy, czego nie obiecujemy#
✓ GWARANTOWANE
- Zamawianie według kanału
- Dokładnie raz na
message_idw kanale - Fanout p99 < 15 ms między regionami
- Automatyczne ponowne połączenie z powtórką z lat 60
- Wyraźne przeciwciśnienie (konfigurowalna polityka spadku)
✗ NIE GWARANTOWANE
- Zamawianie międzykanałowe
- Dokładnie raz w wielu kanałach (przynajmniej raz)
- Opóźnienie poniżej ms (< 15 ms, p99 to nasz najniższy poziom)
- Odtwórz ponownie po 60 sekundach (użyj dziennika Postgres)