NUEVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Ver el registro de cambios →

En tiempo real

Datos en vivo, directamente desde su base de datos.

Una conexión WebSocket transporta cambios en la base de datos, mensajes de difusión y presencia. Los canales privados siguen la misma seguridad a nivel de fila que sus tablas.

3
tipos de canales
25 s
intervalo de latido del corazón
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()

¿Qué está incluido?

Todo lo que se mueve vive. En una conexión.

Base de datos

Cambios en la base de datos

Suscríbase a inserciones, actualizaciones y eliminaciones en una tabla a medida que ocurren.

Filtros

Filtros de columna

Reciba solo las filas que le interesan, como room_id=eq.42. El servidor aplica el filtro antes de enviar el evento.

Mensajería

Difusión

Envíe mensajes entre clientes en un canal, con reconocimiento de servidor opcional.

Presencia

¿Quién está en línea?

Realice un seguimiento de los usuarios en un canal y reaccione cuando se unan, abandonen o actualicen su estado.

Seguridad

canales privados

Las políticas de seguridad a nivel de fila deciden quién puede unirse a un canal privado y se verifican nuevamente cuando se actualiza el token.

Seguridad

Proyectos solo privados

Exigir que todos los canales de un proyecto sean privados, lo que el cliente pida.

Lado del servidor

Transmisión a través de HTTP

Publique desde un servidor o una función perimetral con una sola solicitud.

Fiabilidad

Reconexión automática

Un latido detecta conexiones inactivas y el cliente se vuelve a conectar con retroceso y fluctuación, luego vuelve a suscribir sus canales.

Observabilidad

Borrar estados de conexión y canal

Siga el estado de la conexión, obtenga errores de transporte con la fase que falló y vea por qué se rechazó un canal.

como funciona

De un cambio a su pantalla.

  1. 1

    Conectar

    El SDK abre un WebSocket con el token del usuario.

  2. 2

    Suscríbete

    Únase a un canal; el servidor comprueba el acceso y lo confirma.

  3. 3

    Recibir

    A ese canal llegan cambios de base de datos, retransmisiones y presencia.

  4. 4

    recuperar

    Si el enlace se cae, el SDK se vuelve a conectar y se vuelve a suscribir.

Puntos finales

Dos rutas. Todo lo demás es un canal.

Envíe la clave API de su proyecto o el token del usuario con cada solicitud.

MétodoPunto finalDescripción
GET/v1/realtime/wsAbra la conexión WebSocket. Los canales se multiplexan sobre él.
POST/v1/realtime/broadcastEnvíe una transmisión a través de HTTP, sin WebSocket.

Preguntas

Es bueno saberlo.

¿Cómo recibo cambios en la base de datos?+
Suscríbase a postgres_changes en un canal con el esquema, tabla y evento que desee. Agregue un filtro para recibir solo filas coincidentes.
¿Quién puede ver un canal privado?+
Las políticas de seguridad a nivel de fila lo deciden a partir del token del usuario cuando se suscribe. Un token que la política rechaza recibe un error de canal.
¿Puedo enviar mensajes desde mi servidor?+
Sí. httpBroadcast() envía una transmisión a través de HTTP. Prefije el canal con su ID de proyecto cuando lo llame sin una sesión de usuario.
¿Qué sucede cuando se cae la conexión?+
El SDK se vuelve a conectar automáticamente y vuelve a suscribir sus canales. No se garantiza que los eventos enviados mientras la conexión estaba inactiva se entreguen, por lo que no puede perderse el estado de relectura.
¿Por qué debo suscribirme antes de enviar?+
Las reglas de acceso a un canal se calculan cuando se suscribe. Se rechaza el envío a un canal al que no está suscrito y el SDK lo informa sin enviar nada.
¿Qué eventos ve un filtro de eliminación?+
La vieja fila. Las columnas que contiene dependen de la identidad de réplica de la tabla: la clave principal de forma predeterminada, todas las columnas con identidad de réplica completa.

¿Listo para empezar a vivir?

Haga que su aplicación reaccione en tiempo real.

El tiempo real está incluido en cada proyecto. No se requiere tarjeta de crédito.