基础查询 .from().select()

Supabase：

const { data, error } = await supabase
.from('users')
.select('*');

MySQL：

SELECT * FROM users;

条件筛选 .eq() / .neq() / .lt() / .gt() / .gte() / .lte()

Supabase：

supabase.from('users').select('*')
    .eq('age', 18)
    .neq('status', 'inactive')
    .gt('score', 60)
    .lt('rank', 100)
    .gte('experience', 3)
    .lte('level', 5);

MySQL：

SELECT * FROM users
WHERE age = 18 AND status != 'inactive' AND score > 60
AND rank < 100 AND experience >= 3 AND level <= 5;

范围匹配 .in() / .not() / .like() / .ilike()

Supabase：

supabase.from('users').select('*')
    .in('role', ['admin', 'editor'])
    .like('email', '%@gmail.com')
    .ilike('username', '%john%');

MySQL：

SELECT * FROM users
WHERE role IN ('admin', 'editor')
  AND email LIKE '%@gmail.com'
  AND username ILIKE '%john%';

组合条件 .or() / .not() / .filter()

Supabase：

supabase.from('users')
    .select('*')
    .or('status.eq.active,status.eq.pending')
    .not('deleted', 'is', true)
    .filter('age', 'gte', 18);

MySQL：

SELECT * FROM users
WHERE (status = 'active' OR status = 'pending')
  AND deleted IS NOT true
  AND age >= 18;

排序分页 .order() / .limit() / .range()

Supabase：

supabase.from('users')
  .select('*')
  .order('created_at', { ascending: false })
  .range(10, 19); // 第 2 页，每页 10 条

MySQL：

SELECT * FROM users ORDER BY created_at DESC LIMIT 10 OFFSET 10;

获取单行 .single() / .maybeSingle()

Supabase：

supabase.from('config')
    .select('value')
    .eq('key', 'site_title')
    .single();

• .single()：返回一行，0 或多行都会报错
• .maybeSingle()：0 或 1 行都可接受

插入数据 .insert()

Supabase：

await supabase.from('users').insert({ name: 'Tom', age: 30 });

MySQL：

INSERT INTO users (name, age) VALUES ('Tom', 30);

• 可插入多个：insert([{...}, {...}])
• 默认返回插入后的数据

更新数据 .update()

Supabase：

await supabase.from('users')
  .update({ age: 35 })
  .eq('id', 1);

MySQL：

UPDATE users SET age = 35 WHERE id = 1;

删除数据 .delete()

Supabase：

await supabase.from('users')
  .delete()
  .eq('id', 1);

MySQL：

DELETE FROM users WHERE id = 1;

原始 SQL 支持（服务端）

Supabase 控制台支持原始 SQL 查询，但 前端不支持直接执行原生 SQL。

推荐通过 RPC 函数调用：

await supabase.rpc('get_user_stats', { user_id: 123 });

错误处理 .throwOnError()

supabase.from('users').select('*').throwOnError();

等价于：

const { data, error } = await supabase.from('users').select('*');
if (error) throw error;

所有查询方法对照表

Supabase 方法	SQL 对应	说明
.select()	SELECT	查询字段
.eq()	=	等于
.neq()	!=	不等于
.gt(), .lt()	>, <	比较运算
.gte(), .lte()	>=, <=	比较运算
.in()	IN	多值匹配
.like()	LIKE	模糊匹配
.ilike()	ILIKE	忽略大小写匹配（Postgres）
.order()	ORDER BY	排序
.limit()	LIMIT	限制数量
.range()	OFFSET + LIMIT	分页
.or()	OR	或条件
.not()	NOT	非条件
.filter()	通用 WHERE	动态运算符传入
.single()	1 行限制	多行或 0 行报错
.maybeSingle()	最多 1 行	宽容版本
.insert()	INSERT	插入数据
.update()	UPDATE	修改数据
.delete()	DELETE	删除数据
.throwOnError()	无	自动抛出错误

最佳实践建议

• 所有操作均为异步 await，不可漏写
• 前端使用匿名 key，受限于 Row Level Security（RLS）
• 服务端使用 service_role key，可访问所有数据
• 建议封装为统一查询服务（如 NestJS Service）
• 支持链式调用，可组合多个条件与功能

总结

Supabase 的客户端 API 提供了一个现代、类型安全、SQL 等价的数据库操作方式，无需写原生 SQL 就能完成绝大多数业务逻辑。