Modifications de la base de données
Abonnez-vous aux insertions, mises à jour et suppressions sur une table au fur et à mesure qu’elles se produisent.
Temps réel
Une connexion WebSocket transporte les modifications de la base de données, les messages diffusés et la présence. Les canaux privés suivent la même sécurité au niveau des lignes que vos tables.
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()
Ce qui est inclus
Abonnez-vous aux insertions, mises à jour et suppressions sur une table au fur et à mesure qu’elles se produisent.
Recevez uniquement les lignes qui vous intéressent, telles que room_id=eq.42. Le serveur applique le filtre avant d’envoyer l’événement.
Envoyez des messages entre clients sur un canal, avec accusé de réception facultatif du serveur.
Suivez les utilisateurs sur une chaîne et réagissez lorsqu’ils rejoignent, quittent ou mettent à jour leur état.
Les politiques de sécurité au niveau des lignes décident qui peut rejoindre un canal privé et sont à nouveau vérifiées lors de l’actualisation du jeton.
Exigez que chaque canal d’un projet soit privé, quelle que soit la demande du client.
Publiez à partir d’un serveur ou d’une fonction Edge avec une seule requête.
Un battement de cœur détecte les connexions mortes et le client se reconnecte avec interruption et instabilité, puis se réabonne à ses canaux.
Suivez l’état de la connexion, obtenez les erreurs de transport avec la phase qui a échoué et voyez pourquoi un canal a été refusé.
Comment ça marche
Le SDK ouvre un WebSocket avec le jeton de l’utilisateur.
Rejoignez une chaîne ; le serveur vérifie l’accès et confirme.
Les modifications de la base de données, les diffusions et la présence arrivent sur cette chaîne.
Si le lien est interrompu, le SDK se reconnecte et se réabonne.
Points de terminaison
Envoyez la clé API de votre projet ou le token de l’utilisateur avec chaque demande.
| Méthode | Point de terminaison | Descriptif |
|---|---|---|
| GET | /v1/realtime/ws | Ouvrez la connexion WebSocket. Les chaînes y sont multiplexées. |
| POST | /v1/realtime/broadcast | Envoyez une diffusion via HTTP, sans WebSocket. |
Questions
postgres_changes sur un canal avec le schéma, la table et l’événement souhaités. Ajoutez un filtre pour recevoir uniquement les lignes correspondantes. httpBroadcast() envoie une diffusion via HTTP. Préfixez le canal avec votre ID de projet lorsque vous l’appelez sans session utilisateur.Prêt à passer en direct ?
Le temps réel est inclus dans chaque projet. Aucune carte de crédit requise.