새로운Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2변경 내역 보기 →

실시간

데이터베이스에서 바로 실시간 데이터를 얻을 수 있습니다.

하나의 WebSocket 연결은 데이터베이스 변경 사항, 브로드캐스트 메시지 및 현재 상태를 전달합니다. 비공개 채널은 테이블과 동일한 행 수준 보안을 따릅니다.

3
채널 유형
25 s
하트비트 간격
realtime.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
aura
.channel('room')
.on(
'postgres_changes',
{
event: 'INSERT',
schema: 'public',
table: 'messages',
filter: 'room_id=eq.42',
},
(payload) => console.log(payload),
)
.subscribe()

포함된 내용

움직이는 모든 것이 실시간으로 이루어집니다. 하나의 연결에서.

데이터베이스

데이터베이스 변경

테이블에서 발생하는 삽입, 업데이트, 삭제를 구독하세요.

필터

열 필터

room_id=eq.42와 같이 관심 있는 행만 수신합니다. 서버는 이벤트를 보내기 전에 필터를 적용합니다.

메시징

방송

선택적 서버 승인을 사용하여 채널의 클라이언트 간에 메시지를 보냅니다.

존재

누가 온라인에 있어?

채널에서 사용자를 추적하고 사용자가 참여하거나 탈퇴하거나 상태를 업데이트할 때 반응합니다.

보안

비공개 채널

행 수준 보안 정책은 비공개 채널에 참여할 수 있는 사람을 결정하고 토큰이 새로 고쳐질 때 다시 확인됩니다.

보안

개인 전용 프로젝트

고객이 요청하는 모든 프로젝트의 모든 채널을 비공개로 유지해야 합니다.

서버 측

HTTP를 통한 브로드캐스트

한 번의 요청으로 서버 또는 에지 기능에서 게시합니다.

신뢰성

자동 재연결

하트비트는 끊어진 연결을 감지하고 클라이언트는 백오프 및 지터로 다시 연결한 다음 해당 채널을 다시 구독합니다.

관찰 가능성

연결 및 채널 상태 지우기

연결 상태를 추적하여 실패한 단계에서 전송 오류를 확인하고 채널이 거부된 이유를 확인하세요.

작동 원리

화면 변경부터.

  1. 1

    연결하다

    SDK는 사용자의 토큰으로 하나의 WebSocket을 엽니다.

  2. 2

    구독

    채널에 가입하세요. 서버는 액세스를 확인하고 확인합니다.

  3. 3

    수신

    데이터베이스 변경 사항, 브로드캐스트 및 현재 상태가 해당 채널에 도착합니다.

  4. 4

    복구

    링크가 끊어지면 SDK가 다시 연결하고 다시 구독합니다.

엔드포인트

두 가지 경로. 다른 모든 것은 채널입니다.

각 요청과 함께 프로젝트의 API 키 또는 사용자 토큰을 보냅니다.

방법엔드포인트설명
GET/v1/realtime/wsWebSocket 연결을 엽니다. 채널은 그 위에 다중화됩니다.
POST/v1/realtime/broadcastWebSocket 없이 HTTP를 통해 브로드캐스트를 보냅니다.

질문

알아두면 좋아요.

데이터베이스 변경 사항을 어떻게 받나요?+
원하는 스키마, 테이블 및 이벤트가 있는 채널에서 postgres_changes 을 구독하세요. 일치하는 행만 수신하려면 필터를 추가하세요.
비공개 채널은 누가 볼 수 있나요?+
행 수준 보안 정책은 사용자가 구독할 때 사용자의 토큰에서 이를 결정합니다. 정책이 거부하는 토큰에는 채널 오류가 발생합니다.
내 서버에서 메시지를 보낼 수 있나요?+
그렇습니다. httpBroadcast() 는 HTTP를 통해 브로드캐스트를 보냅니다. 사용자 세션 없이 채널을 호출하는 경우 프로젝트 ID를 채널 앞에 붙입니다.
연결이 끊어지면 어떻게 되나요?+
SDK가 자동으로 다시 연결되어 채널을 다시 구독합니다. 연결이 끊어진 동안 전송된 이벤트는 전달이 보장되지 않으므로 상태를 다시 읽으면 놓칠 수 없습니다.
보내기 전에 구독해야 하는 이유는 무엇입니까?+
채널에 대한 액세스 규칙은 구독 시 계산됩니다. 구독하지 않은 채널에서의 전송은 거부되며 SDK는 아무것도 전송하지 않고 이를 보고합니다.
삭제 필터에는 어떤 이벤트가 표시되나요?+
이전 행. 전달하는 열은 테이블의 복제본 ID에 따라 다릅니다. 즉, 기본 키는 기본 키이며 모든 열은 전체 복제본 ID를 갖습니다.

실시간 스트리밍을 시작할 준비가 되셨나요?

앱이 실시간으로 반응하도록 하세요.

모든 프로젝트에는 실시간이 포함됩니다. 신용 카드가 필요하지 않습니다.