NOUVEAUPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Voir le changelog →

Temps réel

Données en direct, directement depuis votre base de données.

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.

3
types de canaux
25 s
intervalle de battement de coeur
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()

Ce qui est inclus

Tout ce qui bouge vit. Sur une seule connexion.

Base de données

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.

Filtres

Filtres de colonnes

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.

Messagerie

Diffusion

Envoyez des messages entre clients sur un canal, avec accusé de réception facultatif du serveur.

Présence

Qui est en ligne

Suivez les utilisateurs sur une chaîne et réagissez lorsqu’ils rejoignent, quittent ou mettent à jour leur état.

Sécurité

Chaînes privées

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.

Sécurité

Projets privés uniquement

Exigez que chaque canal d’un projet soit privé, quelle que soit la demande du client.

Côté serveur

Diffusion via HTTP

Publiez à partir d’un serveur ou d’une fonction Edge avec une seule requête.

Fiabilité

Reconnexion automatique

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.

Observabilité

États clairs de connexion et de canal

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

D’un changement sur votre écran.

  1. 1

    Se connecter

    Le SDK ouvre un WebSocket avec le jeton de l’utilisateur.

  2. 2

    Abonnez-vous

    Rejoignez une chaîne ; le serveur vérifie l’accès et confirme.

  3. 3

    Recevoir

    Les modifications de la base de données, les diffusions et la présence arrivent sur cette chaîne.

  4. 4

    Récupérer

    Si le lien est interrompu, le SDK se reconnecte et se réabonne.

Points de terminaison

Deux itinéraires. Tout le reste est un canal.

Envoyez la clé API de votre projet ou le token de l’utilisateur avec chaque demande.

MéthodePoint de terminaisonDescriptif
GET/v1/realtime/wsOuvrez la connexion WebSocket. Les chaînes y sont multiplexées.
POST/v1/realtime/broadcastEnvoyez une diffusion via HTTP, sans WebSocket.

Questions

Bon à savoir.

Comment puis-je recevoir les modifications de la base de données ?+
Abonnez-vous à 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.
Qui peut voir une chaîne privée ?+
Les politiques de sécurité au niveau des lignes en décident à partir du jeton de l’utilisateur lors de son abonnement. Un jeton refusé par la stratégie génère une erreur de canal.
Puis-je envoyer des messages depuis mon serveur ?+
Oui. httpBroadcast() envoie une diffusion via HTTP. Préfixez le canal avec votre ID de projet lorsque vous l’appelez sans session utilisateur.
Que se passe-t-il lorsque la connexion est interrompue ?+
Le SDK se reconnecte automatiquement et réabonne vos chaînes. Il n’est pas garanti que les événements envoyés alors que la connexion était interrompue soient livrés, alors relisez l’état que vous ne pouvez pas vous permettre de manquer.
Pourquoi dois-je m’abonner avant d’envoyer ?+
Les règles d’accès à une chaîne sont calculées lors de votre inscription. L’envoi sur une chaîne à laquelle vous n’êtes pas abonné est refusé et le SDK le signale sans rien envoyer.
Quels événements un filtre de suppression voit-il ?+
L’ancienne rangée. Les colonnes qu’il transporte dépendent de l’identité de réplica de la table : la clé primaire par défaut, toutes les colonnes avec une identité de réplica complète.

Prêt à passer en direct ?

Faites réagir votre application en temps réel.

Le temps réel est inclus dans chaque projet. Aucune carte de crédit requise.