В реальном времени
Самосогласующийся WebSocket, SSE и NATS. Присутствие, повтор, гарантированный заказ, противодавление. 1M соединений по POP, разветвление менее 15 мс p99 между регионами.
Синхронизация, присутствие, трансляция#
Служба aura-realtime передает три типа событий: CDC Postgres (INSERT/UPDATE/DELETE с фильтрацией RLS), Presence (в сети) и Broadcast (настраиваемые события, независимые от базы данных). Все проходят через один и тот же SDK через .channel().
Канал идентифицируется произвольным именем (sensors:live, doc:42, room:abc). Сообщения упорядочиваются по каналам, дедуплицируются с помощью message_id и гарантированно выполняются ровно один раз в пределах одного канала.
Подписки наследуют политики RLS из базы данных. Клиент может подписаться только на те изменения, которые он может прочитать — фильтр оценивается на стороне сервера в WAL, а не на стороне клиента.
Одно соединение, N каналов#
SDK поддерживает одно мультиплексное TCP-соединение между клиентом и ближайшим POP. Вы можете открыть 100 каналов, не открывая 100 розеток.
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
События разделяются посредством последовательного хеширования. Канал всегда находится на одном и том же POP, но его репликация на другие POP гарантирована менее чем за 15 мс p99.
Шесть врожденных способностей#
- Высокопроизводительный транспорт. Собственное соединение WebSocket на базе межсервисного NATS.
- Postgres CDC. Изменения WAL фильтруются на стороне сервера, RLS применяется к потоку.
- API присутствия. Кто в сети, произвольное состояние, присоединение/выход из событий.
- Мультиплексирование. Несколько каналов используют одно соединение WebSocket.
- Доставка событий. Оперативная доставка с максимальными усилиями и автоматическим переподключением клиента.
- Совместные курсоры. Родной примитив, адаптивный дроссель 60 FPS, клиентская интерполяция.
Четыре основных шаблона#
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()
Всегда вызывайте channel.unsubscribe() при размонтировании. В React сделайте это при очистке useEffect — крючок useChannel, указанный выше, сделает это за вас.
Что мы обещаем, чего не обещаем#
✓ ГАРАНТИРОВАНО
- Заказ по каналу
- Ровно один раз на
message_idв канале - Разветвление p99 < 15 мс между регионами
- Автоматическое переподключение с повтором 60-х годов
- Явное противодавление (настраиваемая политика сброса)
✗ НЕ ГАРАНТИРОВАНО
- Межканальный заказ
- Ровно один раз межканальный (хотя бы один раз)
- Задержка менее 1 мс (< 15 мс, p99 — наш минимальный уровень)
- Воспроизведение после 60 секунд (используйте журнал Postgres)