第 6 章 · 实时数据订阅（Realtime）

第 6 章 · 实时数据订阅（Realtime）

章节摘要：Supabase Realtime 基于 PostgreSQL 的逻辑复制（CDC，Change Data Capture）能力，将数据库中的数据变更主动推送给已订阅的客户端，并可借助广播（Broadcast）与在线状态（Presence）构建协作应用。本章讲解实时订阅的工作原理、数据库变更订阅、广播与在线状态，以及性能与连接管理。掌握 Realtime，你就能构建协作编辑、实时聊天、在线看板、行情推送等实时应用，让原本静态的前端获得动态、即时更新的能力。

学习目标

阅读本章后，你将能够：

• 理解 Realtime 基于 Postgres CDC 的工作机制
• 订阅数据表的插入、更新、删除事件并按条件过滤
• 使用广播与在线状态构建协作应用
• 管理实时连接的性能、重连与并发

本章概览

传统应用里，前端要看到最新数据，往往得每隔几秒向服务器轮询一次——既浪费资源，又不真正「实时」。Supabase Realtime 改变了这一点：当数据库里的数据被任何途径修改时（无论是哪个客户端、还是后端函数），所有正在订阅的客户端会几乎同时收到变更通知。

下面的序列图展示了一次实时订阅的完整链路：客户端订阅某张表，当该表数据变更时，变更事件经 Realtime 服务推送到客户端，前端据此更新界面。

这条「数据库变更 → 自动推送」的链路，是 Realtime 区别于轮询的根本。

子章节导航

本章按「原理 → 数据订阅 → 协作能力 → 管理」组织：

1. 实时订阅工作原理：讲清 CDC、逻辑复制与事件模型。
2. 数据库变更订阅：实操订阅表的增删改并过滤。
3. 广播与在线状态：用 Broadcast 和 Presence 构建协作。
4. 性能与连接管理：处理重连、节流与并发。

建议按顺序学习。数据变更订阅是最常用的能力，广播与在线状态按需使用。

与其他章节的关联

Realtime 的订阅范围受第 5 章 RLS 约束——用户只能订阅到自己「有权看到」的数据。同时，Realtime 监听的是第 2、3 章设计的数据表。它常与第 7 章 Storage（如新文件上传触发通知）和第 8 章边缘函数（函数修改数据后自动推送）配合使用。