Изменения базы данных
Подпишитесь на вставки, обновления и удаления в таблице по мере их возникновения.
В реальном времени
Одно соединение WebSocket передает изменения базы данных, широковещательные сообщения и сведения о присутствии. Частные каналы следуют той же безопасности на уровне строк, что и ваши таблицы.
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()
Что включено
Подпишитесь на вставки, обновления и удаления в таблице по мере их возникновения.
Получайте только те строки, которые вас интересуют, например room_id=eq.42. Сервер применяет фильтр перед отправкой события.
Отправляйте сообщения между клиентами по каналу с дополнительным подтверждением сервера.
Отслеживайте пользователей на канале и реагируйте, когда они присоединяются, покидают канал или обновляют свое состояние.
Политики безопасности на уровне строк определяют, кто может присоединиться к частному каналу, и проверяются снова при обновлении токена.
Требуйте, чтобы каждый канал проекта был приватным, независимо от того, о чем просит клиент.
Публикуйте с сервера или пограничной функции одним запросом.
Контрольный сигнал обнаруживает прерванное соединение, и клиент повторно подключается с задержками и дрожаниями, а затем повторно подписывает свои каналы.
Следите за состоянием соединения, получайте ошибки транспорта на той фазе, на которой произошел сбой, и выясняйте, почему канал был отклонен.
Как это работает
SDK открывает один WebSocket с токеном пользователя.
Присоединяйтесь к каналу; сервер проверяет доступ и подтверждает.
Изменения базы данных, трансляции и присутствие поступают по этому каналу.
Если ссылка разрывается, SDK повторно подключается и повторно подписывается.
Конечные точки
Отправляйте ключ API вашего проекта или токен пользователя с каждым запросом.
| Метод | Конечная точка | Описание |
|---|---|---|
| GET | /v1/realtime/ws | Откройте соединение WebSocket. Каналы мультиплексируются по нему. |
| POST | /v1/realtime/broadcast | Отправьте широковещательную рассылку через HTTP без WebSocket. |
Вопросы
postgres_changes на канале с желаемой схемой, таблицей и событием. Добавьте фильтр, чтобы получать только совпадающие строки. httpBroadcast() отправляет широковещательную рассылку по HTTP. Присвойте каналу идентификатор вашего проекта, когда вы вызываете его без сеанса пользователя.Готовы выйти в эфир?
Realtime включен в каждый проект. Кредитная карта не требуется.