文档中心
登录
注册
AI 原生 BaaS 平台 Supabase 版
文档指南
AI 原生 BaaS 平台 Supabase 版
AI 原生 BaaS 平台 Supabase 版
文档指南
请输入
产品动态
新功能发布记录
产品公告
AI 原生 BaaS 平台 Supabase 版支持 Lakebase 引擎
2026 年 8 月 20 日起对 Vector Bucket 进行计费
产品简介
什么是 AI 原生 BaaS 平台 Supabase 版
产品规格
产品优势
应用场景
约束与限制
术语表
产品计费
概述
计费项与价格
大模型访问计费项与价格
欠费说明
用户指南
主页
功能概览
使用自然语言管理资源
Supabase 引擎用户指南
Workspace 管理
创建 Workspace
查看 Workspace 列表
查看 Workspace 详情
修改 Workspace 配置
修改 Workspace 的名称
设置 Workspace 的删除保护
修改 Workspace 的初始算力配置
设置私网域名公网解析
修改 Workspace 的可回溯时间
暂停 Workspace
启动 Workspace
休眠 Workspace
删除 Workspace
管理标签
标签概述
绑定标签
解绑标签
恢复延迟删除的 Workspace
分支管理
创建分支
创建子分支
查看分支详情
重命名分支
设置为默认分支
重启分支
删除分支
恢复分支
对比分支
算力管理
获取算力的连接信息
修改算力
监控告警
监控指标说明
查看监控信息
连接管理
设置 Workspace 的公网访问
设置 Workspace 的私网访问
获取 Supabase 服务的连接信息
重置 Supabase 控制台账号和密码
访问控制
查看 Workspace 的 IP 白名单
修改 Workspace 的 IP 白名单
任务管理
查看任务
使用 Supabase 控制台
Supabase 控制台概览
登录 Supabase 控制台
获取变量
使用 Database
使用 Authentication
使用 Authentication
设置基于火山短信服务的账号注册和登录
设置基于邮件的注册和登录
设置微信授权登录
设置企业微信授权登录
设置 CAS 授权登录
设置钉钉授权登录
设置 Third-Party 登录
设置密码强度
设置 Auth Hooks
启用行级安全(RLS)
设置自定义身份认证提供商登录
设置飞书授权登录
使用 Storage
使用 Storage
配置和管理 Storage
创建文件 Bucket
创建 Vector Bucket
通过 S3 协议访问 Storage
使用 Edge Function
使用 Realtime
配置 Realtime
使用 Realtime
可观测性
配置 Custom Routes
大模型访问管理
模型使用
限额管理
APP/Agent 通过 AI-Gateway 访问 AI 模型
前端部署
沙箱服务
使用沙箱
查看沙箱列表
限额管理
使用记忆服务
PostgreSQL 引擎用户指南
Workspace 管理
创建 Workspace
查看 Workspace 列表
查看 Workspace 详情
修改 Workspace 配置
修改 Workspace 的名称
修改 Workspace 的初始算力配置
修改 Workspace 的可回溯时间
修改 Workspace 的网络配置
设置 Workspace 的删除保护
设置 Workspace 的共享公网
暂停 Workspace
启动 Workspace
休眠 Workspace
删除 Workspace
管理标签
标签概述
绑定标签
解绑标签
恢复延迟删除的 Workspace
分支管理
创建分支
创建子分支
查看分支详情
重命名分支
设置分支保护
重置分支
设置为默认分支
删除分支
恢复数据
对比分支
算力管理
创建算力
获取算力的连接信息
修改算力
重启算力
删除算力
开启 AP 加速
管理数据湖连接
修改最大连接数
账号管理
创建账号
重置账号密码
删除账号
数据库管理
创建数据库
删除数据库
监控告警
监控指标说明
查看监控信息
任务管理
查看任务
表管理和 SQL 查询
管理模式
管理表
命令操作
插件
支持的插件列表
插件发布记录
高维向量相似度搜索(pgvector)
任务调度器扩展(pg_cron)
中文分词(zhparser)
逻辑日志转换(wal2json)
中文搜索(pg_jieba)
全文检索(pg_bigm)
基于时间和基于序列的表分区集管理(pg_partman)
数据库原生 JWT 生成与验证(pgjwt)
原生消息队列(pgmq)
原生 GraphQL 服务引擎(pg_graphql)
内存虚拟索引(hypopg)
智能索引推荐(index_advisor)
时间有序的全局唯一标识符(pg_uuidv7)
共享缓冲区实时监控与分析(pg_buffercache)
清理空间(pg_repack)
AI Function 智能处理(rds_ai)
概述
快速开始
配置与访问控制
语义生成(ai_query)
语义向量化(ai_embed)
语义检索(ai_retrieve)
文本重排(ai_rank)
检索增强生成(ai_rag)
语义摘要(ai_summarize)
语义分类(ai_classify)
语义抽取(ai_extract)
运维治理
API 参考
常见问题与升级说明
混合事务分析处理(pg_duckdb)
日志记录扩展(pg_jobmon)
全文检索(pg_textsearch)
veDB MySQL 引擎用户指南(邀测)
Workspace 管理
创建 Workspace
查看 Workspace 列表
查看 Workspace 详情
修改 Workspace 配置
修改 Workspace 的名称
修改 Workspace 的可回溯时间
设置 Workspace 的删除保护
删除 Workspace
管理标签
标签概述
绑定标签
解绑标签
分支管理
创建分支
创建子分支
查看分支详情
重命名分支
删除分支
算力管理
获取算力的连接信息
创建只读算力
删除只读算力
账号管理
创建账号
重置账号密码
删除账号
数据库管理
创建数据库
删除数据库
任务管理
查看任务
API 参考
API 发布历史
API 列表
调用方式
请求结构
公共参数
签名机制
返回结果
全局管理
DescribeAccountUsage
ListWorkspaceUsageTop
Workspace 管理
CreateWorkspace
DescribeWorkspaces
DescribeWorkspaceDetail
DescribeWorkspaceDetailList
DescribeWorkspaceOverview
ModifyComputeSettings
ModifyWorkspaceSettings
ModifyWorkspaceName
DeleteWorkspace
ModifyWorkspaceDeletionProtectionPolicy
AddTagsToWorkspaces
RemoveTagsFromWorkspaces
StartWorkspace
SuspendWorkspace
StopWorkspace
DescribeChargeInfo
CreateWorkspacesExportTask
DescribeWorkspacesExportTask
RecoverDelayedDeleteWorkspace
分支管理
CreateBranch
DescribeBranches
DescribeBranchesList
DescribeChildBranches
DescribeBranchDetail
DescribeDefaultBranch
DescribeDefaultBranchList
UpdateBranch
SetAsDefaultBranch
ResetBranch
GetRestoreWindow
DescribeRestorableBranches
BranchRestore
DescribeAPIKeys
RestartBranch
DeleteBranch
DescribeBranchSchemaNames
CreateSchemaDiff
DescribeSchemaDiffJobStatus
DescribeSchemaDiffResultMeta
DescribeSchemaDiffResultSQLText
DescribeSchemaDiffResultSQLTextAll
GetSchemaDiffResultDownloadLink
算力管理
CreateCompute
DescribeComputes
DescribeComputeDetail
ModifyComputeSpec
ModifyComputeName
ModifyComputeParameters
DeleteCompute
ModifyComputeAnalyticPolicy
CreateDataLakeSecretConnection
DeleteDataLakeSecretConnection
DescribeDataLakeSecretConnection
CheckDataLakeSecretConnection
ListDatabasesDataLakeSecretConnection
账号管理
CreateDBAccount
DescribeDBAccounts
DescribeDBAccountConnection
ResetDBAccountPassword
DeleteDBAccount
数据库管理
CreateDatabase
DescribeDatabases
DropDatabase
连接管理
DescribeWorkspaceEndpoint
DescribeWorkspaceEndpointList
ModifyVpcSettings
ModifyWorkspacePublicConnectionPolicy
CreateEndpointPublicAddress
DeleteEndpointPublicAddress
ModifyPrivateNetworkToSharedMode
ResetWorkspaceAccountPassword
ApplyPrivateDNSToPublic
访问控制
CreateAccessControlList
DescribeAccessControlList
ModifyAccessControlList
DeleteAccessControlList
任务管理
DescribeOperations
前端部署
ListPagesProject
BindPagesProject
DescribePagesBinding
SyncPagesDeployEnvVars
UnbindPagesProject
DescribeSupabaseDeployEnvVars
大模型访问管理
DescribeBaasAIModels
DescribeBaasAIGlobalQuota
ModifyBaasAIGlobalQuota
DescribeBaasAIUserSummaries
ModifyBaasAIUserQuotas
SQL 限流
CreateSQLConcurrencyControlRule
ModifySQLConcurrencyControlRule
DescribeSQLConcurrencyControlRules
SwitchSQLConcurrencyControlRule
DeleteSQLConcurrencyControlRule
错误码
SDK 参考
SDK 发布历史
概述
使用 Go SDK
使用 Python SDK
开发者工具
火山引擎 Supabase MCP Server 用户指南
火山引擎 Supabase Skill 用户指南
CLI(byted-supabase-cli)
火山引擎 PostgreSQL MCP Server 用户指南
火山引擎 PostgreSQL Skill 用户指南
火山引擎 PostgreSQL CLI 用户指南
最佳实践
在 ArkClaw 中使用 Supabase Skill 开发应用
Supabase Edge Function 对接 RPC 实践
基于 Agent Plan 接入火山引擎 Supabase
火山 Supabase + IGA Pages 全栈部署实践
火山引擎 Supabase + Trae Work 实战:搭建多人游戏应用
相关协议
产品和服务测试协议
附录
预留字列表
可修改参数列表(PostgreSQL 引擎)
文档首页
AI 原生 BaaS 平台 Supabase 版
用户指南
Supabase 引擎用户指南
使用 Supabase 控制台
使用 Realtime
使用 Realtime
复制全文
下载 pdf
我的收藏
使用 Realtime
使用 Realtime
复制全文
下载 pdf
我的收藏
使用 Realtime
文档反馈
问问助手
本文介绍不同角色使用 Realtime 功能模块的方式与方法。
背景信息
Supabase 控制台通过 Realtime 组件提供实时消息通信和消息广播能力。客户端与 Realtime 之间通过 WebSocket 建立连接,结合 PostgreSQL 数据库自带的逻辑复制 Slot 和 Trigger 触发器,并监听 Realtime 的 messages 系统表变更,可以将数据库中的记录更新实时推送到多个客户端。
在 Supabase 控制台调试 Realtime 订阅
前提条件
已创建使用 Supabase 引擎的 Workspace 且 Workspace 的状态为
运行中
。关于创建 Workspace 的更多详细信息,请参见
创建 Workspace
。
已通过目标 Workspace 成功登录 Supabase 控制台。关于登录控制台的详细信息,请参见
登录 Supabase 控制台
。
操作步骤
在 Supabase 控制台单击左侧的
Realtime
,进入
Realtime
页面。
在
Realtime
页面,选择
Channel
和
Role
后,即可开始对指定 Channel 的监听。
说明
在
Realtime
页面,您还可以进行为监听配置过滤、发起广播等操作。更多详细信息,请参见
Realtime
。
通过 Supabase Client SDK 创建 Realtime 订阅
前提条件
已获取
SUPABASE_BASE_URL
、
SERVICE_ROLE_KEY
和
SUPABASE_ANON_KEY
。关于获取变量的详细信息,请参见
获取变量
。
操作步骤
订阅 Database changes。
JavaScript
复制
import
{ createClient }
from
'@supabase/supabase-js'
const
supabase =
createClient
(
"<SUPABASE_BASE_URL>"
,
"<SUPABASE_ANON_KEY>"
)
// 订阅数据库表变化
const
channel1 = supabase.
channel
(
'db-channel'
)
channel1
.
on
(
'postgres_changes'
, {
event
:
'*'
,
schema
:
'public'
,
table
:
'mytable'
},
payload
=>
{
console
.
log
(
'mytable changed: '
, payload)
})
.
subscribe
()
订阅 Broadcast。
JavaScript
复制
// 订阅广播消息
const
channel2 = supabase.
channel
(
'broadcast-channel'
)
channel2
.
on
(
'broadcast'
, {
event
:
'message'
},
payload
=>
{
console
.
log
(
'received: '
, payload.
payload
)
})
.
subscribe
()
// 发送消息
channel2.
send
({
type
:
'broadcast'
,
event
:
'message'
,
payload
:
'hello'
})
订阅 Precense。
JavaScript
复制
// 订阅在线状态
const
channel3 = supabase.
channel
(
'presence-channel'
)
channel3
.
on
(
'presence'
, {
event
:
'sync'
},
() =>
{
const
state = channel3.
presenceState
()
console
.
log
(
'在线用户'
, state)
})
.
on
(
'presence'
, {
event
:
'join'
},
(
{ key }
) =>
{
console
.
log
(key +
' 上线了'
)
})
.
on
(
'presence'
, {
event
:
'leave'
},
(
{ key }
) =>
{
console
.
log
(key +
' 下线了'
)
})
.
subscribe
(
async
status => {
if
(status ===
'SUBSCRIBED'
) {
await
channel3.
track
(
'user123'
, {
name
:
'测试用户'
})
}
})
最近更新时间:2026.03.30 11:08:50
这个页面对您有帮助吗?
有用
有用
无用
无用