Saltar al contenido
Logotipo de Aurabase
aurabase

En tiempo real

WebSocket, SSE y NATS autonegociados. Presencia, repetición, pedido garantizado, contrapresión. 1 millón de conexiones por POP, distribución en abanico por debajo de 15 ms p99 entre regiones.

Explicación7 min leerNivel intermedioRevisado el 15 abr 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Sincronización, presencia, transmisión#

El servicio aura-realtime transmite tres tipos de eventos: CDC Postgres (INSERT/UPDATE/DELETE filtrado por RLS), Presencia (que está en línea) y Broadcast (eventos personalizados independientes de la base de datos). Todos pasan por el mismo SDK a través de .channel().

Un canal se identifica con un nombre arbitrario (sensors:live, doc:42, room:abc). Los mensajes se ordenan por canal, se deduplican mediante message_id y se garantizan exactamente una vez dentro del mismo canal.

Información

Las suscripciones heredan las políticas RLS de la base de datos. Un cliente solo puede suscribirse a los cambios que puede leer: el filtro se evalúa en el lado del servidor en WAL, no en el lado del cliente.

Una conexión, N canales#

El SDK mantiene una única conexión TCP multiplexada entre el cliente y el POP más cercano. Puedes abrir 100 canales sin abrir 100 enchufes.

schematext
                      ┌──────────────────┐
   Client (WS)  ────▶ │ aura-realtime    │
                      │  ─ CDC listener  │
                      │  ─ Presence CRDT │
                      │  ─ Broadcast hub │
                      └────────┬─────────┘
                               │ NATS JetStream
          ┌────────────────────┴────────────────────┐
          ▼                    ▼                    ▼
    aura-db WAL         Presence state        autres POPs
Consejo

Los eventos se dividen mediante hash consistente. Un canal siempre vive en el mismo POP, pero se garantiza su replicación a otros POP en menos de 15ms p99.

Seis habilidades nativas#

  • Transporte de alto rendimiento. Conexión WebSocket nativa impulsada por NATS entre servicios.
  • Postgres CDC. Cambios de WAL filtrados en el lado del servidor, RLS aplicados al flujo.
  • API de presencia. Quién está en línea, estado arbitrario, unirse/abandonar eventos.
  • Multiplexación. Varios canales comparten una conexión WebSocket.
  • Entrega de eventos. Entrega en vivo con el mejor esfuerzo y reconexión automática del cliente.
  • Cursores colaborativos. Primitivo nativo, acelerador adaptativo 60 FPS, interpolación del cliente.

Cuatro patrones esenciales#

components/LiveDevices.tsxtypescript
const channel = aura.channel('db:public.devices')
  .on('postgres_changes', {
    event: '*',
    schema: 'public',
    table: 'devices',
    filter: `tenant_id=eq.${tid}`,
  }, ({ new: row }) => render(row))
  .subscribe()
Limpieza obligatoria

Llame siempre a channel.unsubscribe() al desmontar. En React, haga esto en la limpieza useEffect; el gancho useChannel de arriba lo hace por usted.

Lo que prometemos, lo que no prometemos#

✓ GARANTIZADO

  • Ordenar por canal
  • Exactamente una vez por message_id en un canal
  • Fanout p99 <15 ms entre regiones
  • Reconexión automática con repetición de los 60
  • Contrapresión explícita (política de caída configurable)

✗ NO GARANTIZADO

  • Pedidos multicanal
  • Exactamente una vez entre canales (al menos una vez)
  • Latencia sub-ms (< 15 ms p99 es nuestro piso)
  • Reproduzca más allá de los 60 (use un registro Postgres)

para ir más lejos#