실시간
자체 협상 WebSocket, SSE 및 NATS. 존재감, 재생, 순서 보장, 배압. POP를 통한 100만 연결, 리전 간 팬아웃 15ms 미만 p99.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
동기화, 현재 상태, 브로드캐스트#
aura-realtime 서비스는 CDC Postgres(RLS로 필터링된 INSERT/UPDATE/DELETE), 존재(온라인) 및 브로드캐스트(사용자 지정)의 세 가지 유형의 이벤트를 브로드캐스트합니다. 데이터베이스와 독립적인 이벤트). 모두 .channel()를 통해 동일한 SDK를 통과합니다.
채널은 임의의 이름(sensors:live, doc:42, room:abc)으로 식별됩니다. 메시지는 채널별로 정렬되고 message_id에 의해 중복 제거되며 동일한 채널 내에서 정확히 한 번만 보장됩니다.
정보
구독은 데이터베이스에서 RLS 정책을 상속합니다. 클라이언트는 읽을 수 있는 변경 사항만 구독할 수 있습니다. 필터는 클라이언트 측이 아닌 WAL의 서버 측에서 평가됩니다.
하나의 연결, 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로의 복제는 15ms 이내에 보장됩니다. p99.
6가지 기본 능력#
- 처리량이 높은 전송. 서비스 간 NATS에 의해 구동되는 기본 WebSocket 연결.
- Postgres CDC. WAL 변경 사항은 서버 측에서 필터링되고 RLS는 흐름에 적용됩니다.
- 프레즌스 API. 온라인, 임의 상태, 참여/탈퇴 이벤트는 누구입니까?
- 멀티플렉싱. 여러 채널이 하나의 WebSocket 연결을 공유합니다.
- 이벤트 전달. 자동 클라이언트 재연결을 통한 최선의 실시간 전달.
- 협업 커서. 기본 기본, 적응형 스로틀 60FPS, 클라이언트 보간.
네 가지 필수 패턴#
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초 재생으로 자동 재접속
- 명시적 배압(구성 가능한 삭제 정책)
✗ 보장되지 않음
- 교차채널 주문
- 정확히 한 번 교차 채널(최소 한 번)
- 1ms 미만의 대기 시간(< 15ms p99가 우리 층임)
- 60초 이후 재생(Postgres 로그 사용)