コンテンツへスキップ
オーラベースのロゴ
オーラベース

リアルタイム

セルフネゴシエーション型 WebSocket、SSE、および NATS。プレゼンス、リプレイ、保証された順序、バックプレッシャー。 POP による 1M 接続、リージョン間のファンアウトは 15 ミリ秒未満 p99。

解説7 分 読み取りレベル 中間2026/04/15 に改訂

このページは自動翻訳されました。英語版が正式です。

同期、プレゼンス、ブロードキャスト#

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 個のチャネルを開くことができます。

schematext
                      ┌──────────────────┐
   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つのパターン#

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()
清掃の義務化

アンマウント時には常に channel.unsubscribe() を呼び出します。 React では、useEffect クリーンアップでこれを実行します。上記の useChannel フックが自動的に実行します。

約束すること、約束しないこと#

✓ 保証あり

  • チャネルごとの注文
  • チャネル内の message_id ごとに 1 回だけ
  • ファンアウト p99 < 15ms クロスリージョン
  • 60秒再生による自動再接続
  • 明示的なバックプレッシャー (構成可能なドロップ ポリシー)

✗ 保証はありません

  • クロスチャネル注文
  • 必ず 1 回のクロスチャネル (少なくとも 1 回)
  • ミリ秒未満のレイテンシー (< 15ms p99 が当社のフロアです)
  • 60 秒を超えて再生する (Postgres ログを使用)

さらに進むには#