Skip to main content

.match()

Finds all rows whose columns match the specified query object.

const { data, error } = await supabase
.from('cities')
.select('name, country_id')
.match({name: 'Beijing', country_id: 156})

Parameters#

  • queryrequiredRecord

    The object to filter with, with column names as keys mapped to their filter values.

Examples#

With select()#

const { data, error } = await supabase
.from('cities')
.select('name, country_id')
.match({name: 'Beijing', country_id: 156})

With update()#

const { data, error } = await supabase
.from('cities')
.update({ name: 'Mordor' })
.match({name: 'Beijing', country_id: 156})

With delete()#

const { data, error } = await supabase
.from('cities')
.delete()
.match({name: 'Beijing', country_id: 156})

With rpc()#

// Only valid if the Postgres function returns a table type.
const { data, error } = await supabase
.rpc('echo_all_cities')
.match({name: 'Beijing', country_id: 156})