内容提要
本文介绍华为云RDS Supabase的Database Data API:建表后自动生成增删改查接口,无需手写后端。以产品定价管理为例,说明获取地址与API Key、安装SDK、建表、启用RLS并配置策略、授予表级权限及刷新缓存,再用前端SDK直连实现查询、新增、更新、Upsert、删除和关联查询。强调Publishable Key仅用于前端、Secret Key仅限服务端,写操作须登录,更新删除必带过滤条件,并先判错再用数据。
延伸解读
GRANT 与 RLS:两道门缺一不可
文章用“门禁卡”和“抽屉锁”比喻权限模型:GRANT 决定角色能否对表执行 SELECT/INSERT/UPDATE/DELETE,RLS 策略决定哪些行可见或可操作。只启用 RLS 不 GRANT,角色连表都进不去;只 GRANT 不设 RLS 策略,所有行对授权角色可见,等于没有行级保护。配置时需先建表、启用 RLS、创建策略,再授予表级权限,最后刷新 schema 缓存。
写操作的安全边界:登录态与过滤条件
未登录请求以 anon 身份发起,只能读;写操作须 authenticated 角色,凭证由认证流程签发。更新和删除必须搭配 .eq 等过滤条件,否则 update() 会改全表、delete() 会清空全表。此外,删除产品时因外键设了 ON DELETE CASCADE,其定价记录会一并级联删除,操作前需确认影响范围。
关联查询:!inner 决定父行是否被过滤
PostgREST 通过外键自动识别表间关系,在 select() 中用“关联表(字段)”嵌套子表字段,一次请求即可拿到产品及其定价。一对多关系中,子表数据以数组返回,反向查询则返回对象。使用 !inner 时,过滤条件写在嵌入列上会过滤父行而非子行;去掉 !inner 则为左连接,仍返回全部产品,但只展示符合条件的定价档位。
Key 的使用红线与错误处理范式
Publishable Key 受 RLS 约束,可安全放入前端;Secret Key 对应 service_role,具 BYPASSRLS 属性、绕过所有行级策略,仅限服务端,严禁暴露到前端。SDK 调用返回包含 data 和 error 的对象,应先解构、先判错、再用数据。网络、权限、RLS 异常都反映在 error 里,跳过判错直接取 data 只会得到 undefined。
Q&A
RDS Supabase 的 Database Data API 是怎么做到建表就自动生成接口的?
它基于 RDS 托管的 PostgreSQL,由 PostgREST 按表结构自动生成 HTTP 接口,覆盖增删改查。新增表会同步生成端点,无需额外配置,前端用 Supabase JavaScript SDK 即可直连调用。
Publishable Key 和 Secret Key 分别该在什么场景用?
Publishable Key(旧称 Anon Key)受 RLS 约束,可安全放入前端代码,未登录时角色为 anon,登录后为 authenticated;Secret Key(旧称 Service Role Key)对应 service_role,绕过所有 RLS 策略,仅限服务端使用,严禁暴露到前端。
建完表后为什么前端还是查不到数据?需要做哪些权限配置?
建表后默认无行级保护,需显式启用 RLS,并配置 RLS 策略;同时还要授予表级 GRANT 权限,两层缺一不可。启用 RLS 但未配策略时默认拒绝,anon 与 authenticated 都查不到任何行。配置完成后执行 NOTIFY pgrst, 'reload schema' 刷新缓存即可生效。
用 SDK 做更新或删除时有什么必须注意的坑?
update() 和 delete() 必须搭配过滤条件(如 .eq('id', 1)),否则会更新或清空全表,属于事故级操作。另外因外键设了 ON DELETE CASCADE,删除产品时其关联的定价记录会一并级联删除。
怎么在一次请求里同时拿到产品和它的多条定价?
无需手写 JOIN,PostgREST 通过外键自动识别表间关系。在 select() 中用“关联表(字段)”嵌套子表字段,例如 select(`id, name, category, product_pricings(id, tier, price, unit)`),一次请求即可拿到关联数据,子行以数组返回。
关联查询里的 !inner 和普通写法有什么区别?
!inner 强制内连接,会过滤父行,只返回存在匹配子行的产品;去掉 !inner 则为左连接,仍返回全部产品,但每条只展示符合条件的子行。!inner 决定的是“父行是否被过滤”,而非“子行是否被过滤”。
调用 Data API 时错误处理应该怎么写?
API 返回包含 data 和 error 的对象,应解构后先判错再用数据:const { data, error } = await supabase.from('products').select('*');if (error) { console.error(error); return }。网络、权限、RLS 异常都反映在 error 里,跳过判错直接取 data 只会得到 undefined。