НОВЫЙPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Посмотреть список изменений →

В реальном времени

Живые данные прямо из вашей базы данных.

Одно соединение WebSocket передает изменения базы данных, широковещательные сообщения и сведения о присутствии. Частные каналы следуют той же безопасности на уровне строк, что и ваши таблицы.

3
типы каналов
25 s
интервал сердцебиения
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()

Что включено

Все, что движется, живое. На одном подключении.

База данных

Изменения базы данных

Подпишитесь на вставки, обновления и удаления в таблице по мере их возникновения.

Фильтры

Фильтры столбцов

Получайте только те строки, которые вас интересуют, например room_id=eq.42. Сервер применяет фильтр перед отправкой события.

Обмен сообщениями

Транслировать

Отправляйте сообщения между клиентами по каналу с дополнительным подтверждением сервера.

Присутствие

Кто онлайн

Отслеживайте пользователей на канале и реагируйте, когда они присоединяются, покидают канал или обновляют свое состояние.

Безопасность

Частные каналы

Политики безопасности на уровне строк определяют, кто может присоединиться к частному каналу, и проверяются снова при обновлении токена.

Безопасность

Только частные проекты

Требуйте, чтобы каждый канал проекта был приватным, независимо от того, о чем просит клиент.

Серверная часть

Трансляция через HTTP

Публикуйте с сервера или пограничной функции одним запросом.

Надежность

Автоматическое переподключение

Контрольный сигнал обнаруживает прерванное соединение, и клиент повторно подключается с задержками и дрожаниями, а затем повторно подписывает свои каналы.

Наблюдаемость

Очистить состояние соединения и канала

Следите за состоянием соединения, получайте ошибки транспорта на той фазе, на которой произошел сбой, и выясняйте, почему канал был отклонен.

Как это работает

От изменения вашего экрана.

  1. 1

    Соединять

    SDK открывает один WebSocket с токеном пользователя.

  2. 2

    Подписаться

    Присоединяйтесь к каналу; сервер проверяет доступ и подтверждает.

  3. 3

    Получать

    Изменения базы данных, трансляции и присутствие поступают по этому каналу.

  4. 4

    Восстанавливаться

    Если ссылка разрывается, SDK повторно подключается и повторно подписывается.

Конечные точки

Два маршрута. Все остальное — канал.

Отправляйте ключ API вашего проекта или токен пользователя с каждым запросом.

МетодКонечная точкаОписание
GET/v1/realtime/wsОткройте соединение WebSocket. Каналы мультиплексируются по нему.
POST/v1/realtime/broadcastОтправьте широковещательную рассылку через HTTP без WebSocket.

Вопросы

Приятно знать.

Как мне получить изменения в базе данных?+
Подпишитесь на postgres_changes на канале с желаемой схемой, таблицей и событием. Добавьте фильтр, чтобы получать только совпадающие строки.
Кто может видеть частный канал?+
Политики безопасности на уровне строк определяют это на основе токена пользователя при подписке. Токен, от которого отказывается политика, получает ошибку канала.
Могу ли я отправлять сообщения со своего сервера?+
Да. httpBroadcast() отправляет широковещательную рассылку по HTTP. Присвойте каналу идентификатор вашего проекта, когда вы вызываете его без сеанса пользователя.
Что происходит, когда соединение обрывается?+
SDK автоматически подключится и повторно подпишется на ваши каналы. Доставка событий, отправленных во время разрыва соединения, не гарантируется, поэтому перечитайте состояние, которое вы не можете позволить себе пропустить.
Почему я должен подписаться перед отправкой?+
Правила доступа для канала рассчитываются при подписке. Отправка на канал, на который вы не подписаны, отклоняется, и SDK сообщает об этом, ничего не отправляя.
Какие события видит фильтр удаления?+
Старый ряд. Какие столбцы он содержит, зависит от идентификатора реплики таблицы: первичный ключ по умолчанию, все столбцы с полной идентификацией реплики.

Готовы выйти в эфир?

Заставьте свое приложение реагировать в режиме реального времени.

Realtime включен в каждый проект. Кредитная карта не требуется.