リアルタイム
セルフネゴシエーション型 WebSocket、SSE、および NATS。プレゼンス、リプレイ、保証された順序、バックプレッシャー。 POP による 1M 接続、リージョン間のファンアウトは 15 ミリ秒未満 p99。
同期、プレゼンス、ブロードキャスト#
aura-realtime サービスは 3 種類のイベントをブロードキャストします。 CDC Postgres ( RLSでフィルタリングされた INSERT/UPDATE/DELETE)、 Presence (オンライン)、および Broadcast (データベースから独立したカスタム イベント)。すべては .channel()を介して同じ SDK を経由します。
チャネルは任意の名前 (sensors:live、 doc:42、 room:abc) で識別されます。メッセージはチャネルごとに順序付けされ、 message_idによって重複排除され、同じチャネル内で 1 回だけ保証されます。
サブスクリプションは、データベースから RLS ポリシー を継承します。クライアントは、読み取り可能な変更のみをサブスクライブできます。フィルターは、クライアント側ではなく、WAL のサーバー側で評価されます。
1 つの接続、N チャネル#
SDK は、クライアントと最も近い POP 間の単一の多重 TCP 接続を維持します。 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)。
6つのネイティブアビリティ#
- 高スループットのトランスポート。 サービス間 NATSを利用したネイティブ WebSocket 接続。
- Postgres CDC。 WAL の変更はサーバー側でフィルタリングされ、RLS はフローに適用されます。
- プレゼンス API。 オンライン状態、任意の状態、イベントへの参加/退席。
- 多重化。 複数のチャネルが 1 つの WebSocket 接続を共有します。
- イベント配信。 クライアントの自動再接続によるベストエフォート型のライブ配信。
- 協調カーソル。 ネイティブ プリミティブ、アダプティブ スロットル 60 FPS、クライアント補間。
必須の4つのパターン#
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ごとに 1 回だけ - ファンアウト p99 < 15ms クロスリージョン
- 60秒再生による自動再接続
- 明示的なバックプレッシャー (構成可能なドロップ ポリシー)
✗ 保証はありません
- クロスチャネル注文
- 必ず 1 回のクロスチャネル (少なくとも 1 回)
- ミリ秒未満のレイテンシー (< 15ms p99 が当社のフロアです)
- 60 秒を超えて再生する (Postgres ログを使用)