JavaScript: 获取数据

对表或视图执行SELECT查询。

• 默认情况下，Supabase项目最多返回1,000行数据。该设置可在项目的API设置中修改。建议保持较低值以限制意外或恶意请求的有效载荷大小。您可以使用range()查询进行数据分页。
• select()可与过滤器结合使用
• select()可与修饰器结合使用
• 如果您使用Supabase平台，apikey是保留关键字，应避免将其作为列名。

Parameters

• columns

  (Optional)

  要检索的列名，用逗号分隔。可通过`自定义名:列名`格式对返回列重命名

• options

  (Required)

  命名参数

Examples

获取数据

const { data, error } = await supabase
  .from('characters')
  .select()

选择特定列

const { data, error } = await supabase
  .from('characters')
  .select('name')

查询关联表

const { data, error } = await supabase
  .from('orchestal_sections')
  .select(`
    name,
    instruments (
      name
    )
  `)

查询含有空格的引用表

const { data, error } = await supabase
  .from('管弦乐声部')
  .select(`
    名称,
    "乐器" (
      名称
    )
  `)

通过关联表查询引用表

const { data, error } = await supabase
  .from('用户')
  .select(`
    名称,
    团队 (
      名称
    )
  `)

多次查询同一个被引用的表

const { data, error } = await supabase
  .from('消息')
  .select(`
    内容,
    发件人:发送者_id(名称),
    收件人:接收者_id(名称)
  `)

// 要推断类型，请使用表名（这里是`用户`）和
// 外键约束的名称。
const { data, error } = await supabase
  .from('消息')
  .select(`
    内容,
    发件人:用户!消息_发送者_id_外键(名称),
    收件人:用户!消息_接收者_id_外键(名称)
  `)

通过连接表查询嵌套的外键表

  const { data, error } = await supabase
    .from('games')
    .select(`
      game_id:id,
      away_team:teams!games_away_team_fkey (
        users (
          id,
          name
        )
      )
    `)

通过引用表进行筛选

const { data, error } = await supabase
  .from('instruments')
  .select('name, orchestral_sections(*)')
  .eq('orchestral_sections.name', 'percussion')

带计数查询引用表

const { data, error } = await supabase
  .from('orchestral_sections')
  .select(`*, instruments(count)`)

带计数选项查询

const { count, error } = await supabase
  .from('characters')
  .select('*', { count: 'exact', head: true })

查询JSON数据

const { data, error } = await supabase
  .from('users')
  .select(`
    id, name,
    address->city
  `)

使用内连接查询引用表

const { data, error } = await supabase
  .from('instruments')
  .select('name, orchestral_sections!inner(name)')
  .eq('orchestral_sections.name', 'woodwinds')
  .limit(1)

按查询切换模式

const { data, error } = await supabase
  .schema('myschema')
  .from('mytable')
  .select()