Datenbankänderungen
Abonnieren Sie Einfügungen, Aktualisierungen und Löschungen in einer Tabelle, sobald diese erfolgen.
Echtzeit
Eine WebSocket-Verbindung überträgt Datenbankänderungen, Broadcast-Nachrichten und Anwesenheit. Private Kanäle unterliegen der gleichen Sicherheit auf Zeilenebene wie Ihre Tabellen.
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()
Was ist enthalten?
Abonnieren Sie Einfügungen, Aktualisierungen und Löschungen in einer Tabelle, sobald diese erfolgen.
Erhalten Sie nur die Zeilen, die Sie interessieren, z. B. „room_id=eq.42“. Der Server wendet den Filter an, bevor er das Ereignis sendet.
Senden Sie Nachrichten zwischen Clients auf einem Kanal, mit optionaler Serverbestätigung.
Verfolgen Sie Benutzer auf einem Kanal und reagieren Sie, wenn sie beitreten, ihn verlassen oder ihren Status aktualisieren.
Sicherheitsrichtlinien auf Zeilenebene entscheiden, wer einem privaten Kanal beitreten kann, und werden erneut überprüft, wenn das Token aktualisiert wird.
Erfordern Sie, dass jeder Kanal eines Projekts privat ist, ganz gleich, was der Kunde verlangt.
Veröffentlichen Sie mit einer Anfrage von einem Server oder einer Edge-Funktion.
Ein Heartbeat erkennt tote Verbindungen, und der Client stellt die Verbindung mit Backoff und Jitter wieder her und abonniert dann seine Kanäle erneut.
Verfolgen Sie den Verbindungsstatus, erhalten Sie Transportfehler mit der fehlgeschlagenen Phase und sehen Sie, warum ein Kanal abgelehnt wurde.
Wie es funktioniert
Das SDK öffnet einen WebSocket mit dem Token des Benutzers.
Treten Sie einem Kanal bei; Der Server prüft den Zugriff und bestätigt ihn.
Datenbankänderungen, Broadcasts und Präsenz kommen auf diesem Kanal an.
Wenn die Verbindung unterbrochen wird, stellt das SDK die Verbindung wieder her und abonniert erneut.
Endpunkte
Senden Sie bei jeder Anfrage den API-Schlüssel Ihres Projekts oder das Token des Benutzers.
| Methode | Endpunkt | Beschreibung |
|---|---|---|
| GET | /v1/realtime/ws | Öffnen Sie die WebSocket-Verbindung. Darüber werden Kanäle gemultiplext. |
| POST | /v1/realtime/broadcast | Senden Sie einen Broadcast über HTTP, ohne WebSocket. |
Fragen
postgres_changes auf einem Kanal mit dem gewünschten Schema, der gewünschten Tabelle und dem gewünschten Ereignis. Fügen Sie einen Filter hinzu, um nur übereinstimmende Zeilen zu erhalten. httpBroadcast() sendet einen Broadcast über HTTP. Stellen Sie dem Kanal Ihre Projekt-ID voran, wenn Sie ihn ohne Benutzersitzung aufrufen.Bereit, live zu gehen?
Echtzeit ist in jedem Projekt enthalten. Keine Kreditkarte erforderlich.