SuperAPI AI 工具集

supabase

编程与开发

查看项目

更新于 10-16 07:25

技能介绍

用途:该技能面向 Supabase 的 PostgREST 数据 API,帮助用户通过 HTTP 请求操作 Postgres 数据库与认证相关数据。当用户提到 Supabase、supabase.co、分享 Supabase 链接或询问 Supabase 数据库时适用。

主要能力:基础地址为 ${SUPABASE_URL}/rest/v1,所有请求需携带 apikey 头。支持读取全部行、选择指定列、使用 PostgREST 运算符过滤(eq、neq、gt、gte、lt、lte、like、ilike、in、is)、OR 条件、排序(order,支持多列)、分页(limit 与 offset)、通过 Prefer: count=exact 获取行数、插入单行或多行、按过滤条件更新、使用 Prefer: resolution=merge-duplicates 做 upsert、按过滤条件删除、通过外键嵌入关联表数据、全文搜索(fts)以及调用 PostgreSQL 函数(/rest/v1/rpc/函数名)。写入时可用 Prefer: return=representation 返回受影响的行。

使用方式:以 curl 发起请求,例如读取:curl -s "$SUPABASE_URL/rest/v1/users?select=*" -H "apikey: $SUPABASE_TOKEN";插入、更新、upsert 等写操作通常先把 JSON 写入 /tmp/supabase_request.json,再用 -d @/tmp/supabase_request.json 提交。故障排查可运行 zero doctor check-connector --env-name SUPABASE_TOKEN 或 zero doctor check-connector --url https://your-project.supabase.co/rest/v1/ --method GET。

适用场景:需要以脚本或命令行方式快速访问 Supabase 数据、做数据查询与维护、调用数据库函数,或在启用 RLS 的前提下进行读写。

限制与安全建议:读取操作建议使用 publishable key 并启用 RLS;secret key 仅限服务端用于写操作或管理访问。应使用 select 限制返回列、为常用过滤列建索引,避免无过滤条件的全表操作以防误删数据。响应头 Content-Range 可查看行范围与总数,Preference-Applied 确认已应用的偏好设置。官方参考包括 Supabase API 文档、API Keys 指南、PostgREST 文档与项目 API 设置页。认证(auth)部分的具体接口细节资料未提供。