NOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Veja o changelog →

Tempo real

Dados em tempo real, direto do seu banco de dados.

Uma conexão WebSocket transporta alterações de banco de dados, mensagens de transmissão e presença. Os canais privados seguem a mesma segurança em nível de linha que suas tabelas.

3
tipos de canais
25 s
intervalo de batimentos cardíacos
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()

O que está incluído

Tudo o que se move vive. Em uma conexão.

Banco de dados

Mudanças no banco de dados

Assine inserções, atualizações e exclusões em uma tabela conforme elas acontecem.

Filtros

Filtros de coluna

Receba apenas as linhas de seu interesse, como room_id=eq.42. O servidor aplica o filtro antes de enviar o evento.

Mensagens

Transmitir

Envie mensagens entre clientes em um canal, com confirmação opcional do servidor.

Presença

Quem está on-line

Rastreie usuários em um canal e reaja quando eles entrarem, saírem ou atualizarem seu estado.

Segurança

Canais privados

As políticas de segurança em nível de linha decidem quem pode ingressar em um canal privado e são verificadas novamente quando o token é atualizado.

Segurança

Projetos apenas privados

Exija que todos os canais de um projeto sejam privados, independentemente do que o cliente solicitar.

Lado do servidor

Transmitir por HTTP

Publique a partir de um servidor ou função de borda com uma solicitação.

Confiabilidade

Reconexão automática

Uma pulsação detecta conexões inativas e o cliente se reconecta com espera e jitter e, em seguida, inscreve novamente seus canais.

Observabilidade

Limpar conexão e estados de canal

Acompanhe o estado da conexão, obtenha erros de transporte com a fase que falhou e veja por que um canal foi recusado.

Como funciona

De uma mudança na sua tela.

  1. 1

    Conectar

    O SDK abre um WebSocket com o token do usuário.

  2. 2

    Inscrever-se

    Junte-se a um canal; o servidor verifica o acesso e confirma.

  3. 3

    Receber

    Mudanças no banco de dados, transmissões e presença chegam nesse canal.

  4. 4

    Recuperar

    Se o link cair, o SDK se reconectará e se inscreverá novamente.

Pontos finais

Duas rotas. Todo o resto é um canal.

Envie a chave API do seu projeto ou o token do usuário com cada solicitação.

MétodoPonto finalDescrição
GET/v1/realtime/wsAbra a conexão WebSocket. Os canais são multiplexados nele.
POST/v1/realtime/broadcastEnvie uma transmissão por HTTP, sem WebSocket.

Perguntas

É bom saber.

Como recebo alterações no banco de dados?+
Inscreva-se em postgres_changes em um canal com o esquema, tabela e evento desejado. Adicione um filtro para receber apenas linhas correspondentes.
Quem pode ver um canal privado?+
As políticas de segurança em nível de linha decidem isso a partir do token do usuário quando ele se inscreve. Um token recusado pela política gera um erro de canal.
Posso enviar mensagens do meu servidor?+
Sim. httpBroadcast() envia uma transmissão por HTTP. Prefixe o canal com o ID do seu projeto ao chamá-lo sem uma sessão de usuário.
O que acontece quando a conexão cai?+
O SDK se reconecta automaticamente e inscreve novamente seus canais. Os eventos enviados enquanto a conexão estava inoperante não têm garantia de entrega, portanto, releia o estado que você não pode perder.
Por que devo me inscrever antes de enviar?+
As regras de acesso para um canal são calculadas quando você se inscreve. O envio em um canal que você não está inscrito é recusado e o SDK reporta isso sem enviar nada.
Quais eventos um filtro de exclusão vê?+
A velha fila. As colunas que ela carrega dependem da identidade da réplica da tabela: a chave primária por padrão, todas as colunas com identidade de réplica completa.

Pronto para ir ao vivo?

Faça seu aplicativo reagir em tempo real.

O tempo real está incluído em todos os projetos. Não é necessário cartão de crédito.