在表(table)或视图(view)上执行 SELECT 查询。

  • 默认情况下,Supabase项目返回最多1,000行数据。你可以在项目的API设置中更改此设置。建议将其保持较低,以限制意外或恶意请求的负载大小。你可以使用range()查询来对数据进行分页处理。
  • select()可以与过滤器(Filters)组合使用,用于过滤数据。
  • select()可以与修饰器(Modifiers)组合使用,用于对数据进行修改。
  • 如果你使用Supabase平台,apikey是一个保留关键字,应避免将其用作列名

案例教程

案例1 (获取数据)

案例2 (选择特定列)

案例3 (查询外键表)

如需了解更多关于多表关联的信息,可以查阅此文档:多表关联

如需了解更多关于数据表的信息,可以查阅此文档:表格和数据

案例4 (通过连接表查询外键表)

如需了解更多关于多表关联的信息,可以查阅此文档:多表关联

如需了解更多关于数据表的信息,可以查阅此文档:表格和数据

案例5 (多次查询同一外键表)

如需了解更多关于多表关联的信息,可以查阅此文档:多表关联

如需了解更多关于数据表的信息,可以查阅此文档:表格和数据

案例6 (通过外键表进行筛选)

如需了解更多关于多表关联的信息,可以查阅此文档:多表关联

如需了解更多关于数据表的信息,可以查阅此文档:表格和数据

案例7 (使用COUNT对外键表进行查询)

案例8 (使用COUNT选项进行查询)

案例9 (查询JSON数据)

参数说明

  • 列(column) [可选参数] query类型

    要检索的列,用逗号分隔

  • 选项(option) [必要参数] object类型

    命名的参数

      特性
    • count [可选参数] exact | planned | estimated

      用来计算表格或视图中的行数的算法。

      exact:可以精确计算行数,但执行速度较慢。执行 COUNT(*) 操作。

      planned:可以快速计算行数,但是结果可能略有偏差。使用了Postgres 的统计数据。

      estimated:对于较小的数值使用精确计数,对于较大的数值使用计划计数。根据行数的大小决定使用精确计数或计划计数的算法。

    • head [可选参数] boolean类型

      当设置为 true时,data将不被返回。 如果你只需要计数,则很有用。