データベースの変更
テーブルに対する挿入、更新、削除が発生したときにサブスクライブします。
リアルタイム
1 つの 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 など、関心のある行のみを受信します。サーバーはイベントを送信する前にフィルターを適用します。
オプションのサーバー確認応答を使用して、チャネル上のクライアント間でメッセージを送信します。
チャネル上のユーザーを追跡し、ユーザーが参加、脱退、または状態を更新したときに反応します。
行レベルのセキュリティ ポリシーは、誰がプライベート チャネルに参加できるかを決定し、トークンが更新されるときに再度チェックされます。
クライアントの要求が何であれ、プロジェクトのすべてのチャネルをプライベートにする必要があります。
1 回のリクエストでサーバーまたはエッジ機能から発行します。
ハートビートによって切断された接続が検出され、クライアントはバックオフとジッターを使用して再接続し、チャネルを再サブスクライブします。
接続状態を追跡し、失敗したフェーズでトランスポート エラーを取得し、チャネルが拒否された理由を確認します。
仕組み
SDK はユーザーのトークンを使用して 1 つの WebSocket を開きます。
チャンネルに参加してください。サーバーはアクセスをチェックして確認します。
データベースの変更、ブロードキャスト、およびプレゼンスがそのチャネルに到着します。
リンクが切断された場合、SDK は再接続して再サブスクライブします。
エンドポイント
各リクエストとともにプロジェクトの API キーまたはユーザーのトークンを送信します。
| 方法 | エンドポイント | 説明 |
|---|---|---|
| GET | /v1/realtime/ws | WebSocket 接続を開きます。チャネルはその上で多重化されます。 |
| POST | /v1/realtime/broadcast | WebSocket を使用せずに、HTTP 経由でブロードキャストを送信します。 |
質問
postgres_changes をサブスクライブします。一致する行のみを受信するフィルターを追加します。 httpBroadcast() は HTTP 経由でブロードキャストを送信します。ユーザー セッションなしでチャネルを呼び出す場合は、プロジェクト ID をチャネルの前に付けます。