NUOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Vedi il registro delle modifiche →

In tempo reale

Dati in tempo reale, direttamente dal tuo database.

Una connessione WebSocket trasporta modifiche al database, messaggi broadcast e presenza. I canali privati ​​seguono la stessa sicurezza a livello di riga delle tue tabelle.

3
tipi di canale
25 s
intervallo di battito cardiaco
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()

Cosa è incluso

Tutto ciò che si muove vive. Su una connessione.

Database

Modifiche alla banca dati

Iscriviti a inserimenti, aggiornamenti ed eliminazioni su una tabella non appena si verificano.

Filtri

Filtri di colonna

Ricevi solo le righe che ti interessano, ad esempio room_id=eq.42. Il server applica il filtro prima di inviare l'evento.

Messaggistica

Trasmettere

Invia messaggi tra client su un canale, con riconoscimento del server opzionale.

Presenza

Chi è online

Tieni traccia degli utenti su un canale e reagisci quando si uniscono, abbandonano o aggiornano il loro stato.

Sicurezza

Canali privati

Le policy di sicurezza a livello di riga decidono chi può unirsi a un canale privato e vengono controllate nuovamente quando il token viene aggiornato.

Sicurezza

Progetti esclusivamente privati

Richiedere che ogni canale di un progetto sia privato, qualunque sia la richiesta del cliente.

Lato server

Trasmesso su HTTP

Pubblica da un server o da una funzione edge con una sola richiesta.

Affidabilità

Riconnessione automatica

Un heartbeat rileva le connessioni inattive e il client si riconnette con backoff e jitter, quindi sottoscrive nuovamente i propri canali.

Osservabilità

Cancella gli stati di connessione e canale

Segui lo stato della connessione, ottieni errori di trasporto con la fase non riuscita e scopri perché un canale è stato rifiutato.

Come funziona

Da un cambiamento al tuo schermo.

  1. 1

    Connettiti

    L'SDK apre un WebSocket con il token dell'utente.

  2. 2

    Iscriviti

    Partecipa a un canale; il server controlla l'accesso e conferma.

  3. 3

    Ricevi

    Su quel canale arrivano modifiche al database, trasmissioni e presenze.

  4. 4

    Recuperare

    Se il collegamento si interrompe, l'SDK si riconnette e si sottoscrive nuovamente.

Endpoint

Due percorsi. Tutto il resto è un canale.

Invia la chiave API del tuo progetto o il token dell'utente con ogni richiesta.

MetodoPunto finaleDescrizione
GET/v1/realtime/wsApri la connessione WebSocket. I canali vengono multiplexati su di esso.
POST/v1/realtime/broadcastInvia una trasmissione su HTTP, senza WebSocket.

Domande

Buono a sapersi.

Come ricevo le modifiche al database?+
Iscriviti a postgres_changes su un canale con lo schema, la tabella e l'evento che desideri. Aggiungi un filtro per ricevere solo le righe corrispondenti.
Chi può vedere un canale privato?+
Le policy di sicurezza a livello di riga lo decidono dal token dell'utente al momento dell'iscrizione. Un token rifiutato dalla policy riceve un errore di canale.
Posso inviare messaggi dal mio server?+
Sì. httpBroadcast() invia una trasmissione su HTTP. Anteponi al canale il tuo ID progetto quando lo chiami senza una sessione utente.
Cosa succede quando la connessione si interrompe?+
L'SDK si riconnette automaticamente e iscrive nuovamente i tuoi canali. Non è garantito che gli eventi inviati mentre la connessione fosse interrotta vengano consegnati, quindi rileggi lo stato che non puoi permetterti di perdere.
Perché devo iscrivermi prima di inviare?+
Le regole di accesso per un canale vengono calcolate al momento dell'iscrizione. L'invio su un canale a cui non sei iscritto viene rifiutato e l'SDK lo segnala senza inviare nulla.
Quali eventi vede un filtro di eliminazione?+
La vecchia fila. Le colonne trasportate dipendono dall'identità di replica della tabella: la chiave primaria per impostazione predefinita, tutte le colonne con identità di replica completa.

Pronti per andare in diretta?

Fai reagire la tua app in tempo reale.

Il tempo reale è incluso in ogni progetto. Nessuna carta di credito richiesta.