Zmiany w bazie danych
Subskrybuj wstawiane, aktualizowane i usuwane tabele na bieżąco.
W czasie rzeczywistym
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.
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ę
Subskrybuj wstawiane, aktualizowane i usuwane tabele na bieżąco.
Otrzymuj tylko te wiersze, na których Ci zależy, np. room_id=eq.42. Serwer stosuje filtr przed wysłaniem zdarzenia.
Wysyłaj wiadomości pomiędzy klientami na kanale, z opcjonalnym potwierdzeniem serwera.
Śledź użytkowników na kanale i reaguj, gdy dołączają, opuszczają lub aktualizują swój stan.
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.
Wymagaj, aby każdy kanał projektu był prywatny, niezależnie od tego, o co poprosi klient.
Publikuj z serwera lub funkcji brzegowej za pomocą jednego żądania.
Bicie serca wykrywa martwe połączenia, a klient ponownie łączy się z przerwami i jitterem, a następnie ponownie subskrybuje swoje kanały.
Ś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
SDK otwiera jeden WebSocket z tokenem użytkownika.
Dołącz do kanału; serwer sprawdza dostęp i potwierdza.
Zmiany w bazie danych, transmisje i obecność pojawiają się na tym kanale.
Jeśli łącze zostanie zerwane, zestaw SDK ponownie nawiąże połączenie i dokona ponownej subskrypcji.
Punkty końcowe
Przy każdym żądaniu wysyłaj klucz API swojego projektu lub token użytkownika.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /v1/realtime/ws | Otwórz połączenie WebSocket. Kanały są przez niego multipleksowane. |
| POST | /v1/realtime/broadcast | Wyślij transmisję przez HTTP, bez protokołu WebSocket. |
Pytania
postgres_changes na kanale z wybranym schematem, tabelą i wydarzeniem. Dodaj filtr, aby otrzymać tylko pasujące wiersze. httpBroadcast() wysyła transmisję poprzez HTTP. Poprzedź kanał identyfikatorem projektu, gdy wywołujesz go bez sesji użytkownika.Gotowy do transmisji na żywo?
Realtime jest zawarty w każdym projekcie. Nie jest wymagana karta kredytowa.