Ir para o conteúdo
Aura Logo
aurabase

Tempo real

WebSocket, SSE e NATS autonegociados. Presença, repetição, ordem garantida, contrapressão. Conexões de 1M por POP, fanout sub-15ms p99 entre regiões.

Explicação7 min lidoNível intermediárioRevisado em 15 de abr. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Sincronização, presença, transmissão#

O serviço aura-realtime transmite três tipos de eventos: CDC Postgres (INSERT/UPDATE/DELETE filtrado por RLS), Presence (que está online) e Broadcast (eventos personalizados independentes do banco de dados). Todos passam pelo mesmo SDK via .channel().

Um canal é identificado por um nome arbitrário (sensors:live, doc:42, room:abc). As mensagens são ordenadas por canal, desduplicadas por message_id e garantidas exatamente uma vez no mesmo canal.

Informações

As assinaturas herdam as políticas RLS do banco de dados. Um cliente só pode assinar alterações que pode ler – o filtro é avaliado no lado do servidor no WAL, não no lado do cliente.

Uma conexão, N canais#

O SDK mantém uma única conexão TCP multiplexada entre o cliente e o POP mais próximo. Você pode abrir 100 canais sem abrir 100 soquetes.

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

Os eventos são particionados por hashing consistente. Um canal vive sempre no mesmo POP, mas a sua replicação para outros POPs é garantida em menos de 15ms p99.

Seis habilidades nativas#

  • Transporte de alto rendimento. Conexão WebSocket nativa alimentada por interserviços NATS.
  • Postgres CDC. alterações WAL filtradas no lado do servidor, RLS aplicadas ao fluxo.
  • API de presença. Quem está online, estado arbitrário, entrar/sair de eventos.
  • Multiplexação. Vários canais compartilham uma conexão WebSocket.
  • Entrega de eventos. Entrega ao vivo de melhor esforço com reconexão automática do cliente.
  • Cursores colaborativos. Primitivo nativo, acelerador adaptativo 60 FPS, interpolação do cliente.

Quatro padrões essenciais#

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()
Limpeza obrigatória

Sempre chame channel.unsubscribe() ao desmontar. No React, faça isso na limpeza useEffect — o gancho useChannel acima faz isso para você.

O que prometemos, o que não prometemos#

✓ GARANTIDO

  • Ordenação por canal
  • Exatamente uma vez por message_id em um canal
  • Fanout p99 <15ms entre regiões
  • Reconexão automática com replay dos anos 60
  • Contrapressão explícita (política de queda configurável)

✗ NÃO GARANTIDO

  • Ordenação entre canais
  • Exatamente uma vez entre canais (pelo menos uma vez)
  • Latência sub-ms (<15ms p99 é o nosso piso)
  • Replay além dos 60s (use um log Postgres)

Para ir mais longe#