实时
自协商 WebSocket、SSE 和 NATS。存在、重播、保证顺序、背压。通过 POP 实现 1M 连接,区域之间的扇出低于 15ms p99。
该页面已自动翻译。英文版具有权威性。
同步、存在、广播#
aura-realtime 服务广播三种类型的事件: CDC Postgres (按 RLS过滤插入/更新/删除)、 存在 (在线)和 广播 (独立于数据库的自定义事件)。所有这些都通过 .channel()使用相同的 SDK。
通道由任意名称(sensors:live、 doc:42、 room:abc)标识。消息按通道排序,通过 message_id进行重复数据删除,并保证在同一通道内恰好一次。
信息
订阅从数据库继承 RLS 策略。客户端只能订阅它可以读取的更改 - 过滤器在 WAL 上的服务器端进行评估,而不是在客户端。
1个连接,N个通道#
SDK 在客户端和最近的 POP 之间维护 单个 多路复用 TCP 连接。无需打开 100 个套接字即可打开 100 个通道。
text
┌──────────────────┐
Client (WS) ────▶ │ aura-realtime │
│ ─ CDC listener │
│ ─ Presence CRDT │
│ ─ Broadcast hub │
└────────┬─────────┘
│ NATS JetStream
┌────────────────────┴────────────────────┐
▼ ▼ ▼
aura-db WAL Presence state autres POPs
提示
事件通过一致性哈希进行分区。通道始终位于同一个 POP 上,但保证其复制到其他 POP 的时间少于 15 毫秒 p99。
六种原生能力#
- 高通量传输。 由服务间 NATS提供支持的本机 WebSocket 连接。
- Postgres CDC。 WAL 更改在服务器端过滤,RLS 应用于流。
- 存在 API。 谁在线,任意状态,加入/离开事件。
- 多路复用。 多个通道共享一个 WebSocket 连接。
- 事件传递。 通过自动客户端重新连接进行尽力实时交付。
- 协作光标。 本机原语、自适应油门 60 FPS、客户端插值。
四种基本模式#
typescript
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 < 15ms
- 自动重连,60秒重播
- 显式背压(可配置丢弃策略)
✗ 不保证
- 跨渠道订购
- 恰好一次跨通道(至少一次)
- 亚毫秒级延迟(< 15 毫秒 p99 是我们的下限)
- 重播超过 60 秒(使用 Postgres 日志)