Mudanças no banco de dados
Assine inserções, atualizações e exclusões em uma tabela conforme elas acontecem.
Tempo real
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.
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
Assine inserções, atualizações e exclusões em uma tabela conforme elas acontecem.
Receba apenas as linhas de seu interesse, como room_id=eq.42. O servidor aplica o filtro antes de enviar o evento.
Envie mensagens entre clientes em um canal, com confirmação opcional do servidor.
Rastreie usuários em um canal e reaja quando eles entrarem, saírem ou atualizarem seu estado.
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.
Exija que todos os canais de um projeto sejam privados, independentemente do que o cliente solicitar.
Publique a partir de um servidor ou função de borda com uma solicitação.
Uma pulsação detecta conexões inativas e o cliente se reconecta com espera e jitter e, em seguida, inscreve novamente seus canais.
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
O SDK abre um WebSocket com o token do usuário.
Junte-se a um canal; o servidor verifica o acesso e confirma.
Mudanças no banco de dados, transmissões e presença chegam nesse canal.
Se o link cair, o SDK se reconectará e se inscreverá novamente.
Pontos finais
Envie a chave API do seu projeto ou o token do usuário com cada solicitação.
| Método | Ponto final | Descrição |
|---|---|---|
| GET | /v1/realtime/ws | Abra a conexão WebSocket. Os canais são multiplexados nele. |
| POST | /v1/realtime/broadcast | Envie uma transmissão por HTTP, sem WebSocket. |
Perguntas
postgres_changes em um canal com o esquema, tabela e evento desejado. Adicione um filtro para receber apenas linhas correspondentes. 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.Pronto para ir ao vivo?
O tempo real está incluído em todos os projetos. Não é necessário cartão de crédito.