NOWYPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Zobacz dziennik zmian →

W czasie rzeczywistym

Dane na żywo, prosto z Twojej bazy danych.

Jedno połączenie WebSocket umożliwia przesyłanie zmian w bazie danych, rozgłaszanie komunikatów i obecność. Kanały prywatne podlegają tym samym zabezpieczeniom na poziomie wierszy, co Twoje tabele.

3
typy kanałów
25 s
interwał uderzeń serca
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()

Co jest wliczone w cenę

Wszystko, co się rusza, żyje. Na jednym połączeniu.

Baza danych

Zmiany w bazie danych

Subskrybuj wstawiane, aktualizowane i usuwane tabele na bieżąco.

Filtry

Filtry kolumnowe

Otrzymuj tylko te wiersze, na których Ci zależy, np. room_id=eq.42. Serwer stosuje filtr przed wysłaniem zdarzenia.

Wiadomości

Audycja

Wysyłaj wiadomości pomiędzy klientami na kanale, z opcjonalnym potwierdzeniem serwera.

Obecność

Kto jest online

Śledź użytkowników na kanale i reaguj, gdy dołączają, opuszczają lub aktualizują swój stan.

Bezpieczeństwo

Kanały prywatne

Zasady bezpieczeństwa na poziomie wiersza decydują, kto może dołączyć do kanału prywatnego i są sprawdzane ponownie po odświeżeniu tokenu.

Bezpieczeństwo

Projekty wyłącznie prywatne

Wymagaj, aby każdy kanał projektu był prywatny, niezależnie od tego, o co poprosi klient.

Po stronie serwera

Transmisja przez HTTP

Publikuj z serwera lub funkcji brzegowej za pomocą jednego żądania.

Niezawodność

Automatyczne ponowne połączenie

Bicie serca wykrywa martwe połączenia, a klient ponownie łączy się z przerwami i jitterem, a następnie ponownie subskrybuje swoje kanały.

Obserwowalność

Wyczyść stany połączeń i kanałów

Śledź stan połączenia, uzyskaj błędy transportu w fazie, która się nie powiodła, i zobacz, dlaczego kanał został odrzucony.

Jak to działa

Od zmiany na ekranie.

  1. 1

    Łączyć

    SDK otwiera jeden WebSocket z tokenem użytkownika.

  2. 2

    Subskrybować

    Dołącz do kanału; serwer sprawdza dostęp i potwierdza.

  3. 3

    Odbierać

    Zmiany w bazie danych, transmisje i obecność pojawiają się na tym kanale.

  4. 4

    Odzyskiwać

    Jeśli łącze zostanie zerwane, zestaw SDK ponownie nawiąże połączenie i dokona ponownej subskrypcji.

Punkty końcowe

Dwie trasy. Wszystko inne to kanał.

Przy każdym żądaniu wysyłaj klucz API swojego projektu lub token użytkownika.

MetodaPunkt końcowyOpis
GET/v1/realtime/wsOtwórz połączenie WebSocket. Kanały są przez niego multipleksowane.
POST/v1/realtime/broadcastWyślij transmisję przez HTTP, bez protokołu WebSocket.

Pytania

Dobrze wiedzieć.

Jak otrzymywać zmiany w bazie danych?+
Subskrybuj postgres_changes na kanale z wybranym schematem, tabelą i wydarzeniem. Dodaj filtr, aby otrzymać tylko pasujące wiersze.
Kto może oglądać kanał prywatny?+
Zasady bezpieczeństwa na poziomie wiersza decydują o tym na podstawie tokena użytkownika podczas subskrypcji. Token odrzucony przez zasady powoduje błąd kanału.
Czy mogę wysyłać wiadomości z mojego serwera?+
Tak. httpBroadcast() wysyła transmisję poprzez HTTP. Poprzedź kanał identyfikatorem projektu, gdy wywołujesz go bez sesji użytkownika.
Co się stanie, gdy połączenie zostanie zerwane?+
Pakiet SDK automatycznie łączy się ponownie i ponownie subskrybuje Twoje kanały. Nie ma gwarancji, że zdarzenia wysłane w czasie braku połączenia zostaną dostarczone, więc ponownie przeczytaj stan, którego nie możesz przegapić.
Dlaczego muszę subskrybować przed wysłaniem?+
Reguły dostępu do kanału są obliczane podczas subskrypcji. Wysyłanie na kanał, którego nie subskrybujesz, jest odrzucane, a zestaw SDK zgłasza to bez wysyłania czegokolwiek.
Jakie zdarzenia widzi filtr usuwania?+
Stary rząd. To, które kolumny zawiera, zależy od tożsamości repliki tabeli: domyślnie klucz podstawowy, wszystkie kolumny z pełną tożsamością repliki.

Gotowy do transmisji na żywo?

Spraw, aby Twoja aplikacja reagowała w czasie rzeczywistym.

Realtime jest zawarty w każdym projekcie. Nie jest wymagana karta kredytowa.