---
id: match
title: ".match()"
slug: match
custom_edit_url: https://github.com/supabase/supabase/edit/master/web/spec/dart.yml
---

import Tabs from '@theme/Tabs';
import TabsPanel from '@theme/TabsPanel';

Finds all rows whose columns match the specified `query` object.


<Tabs
  defaultActiveId="dart"
  groupId="reference/dart"
  values={[{ label: 'Dart', value: 'dart' }]}>

<TabsPanel id="dart" label="dart">

```dart
final res = await supabase
  .from('cities')
  .select('name, country_id')
  .match({'name': 'Beijing', 'country_id': 156})
  .execute();
```


</TabsPanel>

</Tabs>

















## Examples

### With `select()`



<Tabs
  defaultActiveId="dart"
  groupId="reference/dart"
  values={[{ label: 'Dart', value: 'dart' }]}>

<TabsPanel id="dart" label="dart">

```dart
final res = await supabase
  .from('cities')
  .select('name, country_id')
  .match({'name': 'Beijing', 'country_id': 156})
  .execute();
```


</TabsPanel>

</Tabs>

### With `update()`



<Tabs
  defaultActiveId="dart"
  groupId="reference/dart"
  values={[{ label: 'Dart', value: 'dart' }]}>

<TabsPanel id="dart" label="dart">

```dart
final res = await supabase
  .from('cities')
  .update({ 'name': 'Mordor' })
  .match({'name': 'Beijing', 'country_id': 156})
  .execute();
```


</TabsPanel>

</Tabs>

### With `delete()`



<Tabs
  defaultActiveId="dart"
  groupId="reference/dart"
  values={[{ label: 'Dart', value: 'dart' }]}>

<TabsPanel id="dart" label="dart">

```dart
final res = await supabase
  .from('cities')
  .delete()
  .match({'name': 'Beijing', 'country_id': 156})
  .execute();
```


</TabsPanel>

</Tabs>

### With `rpc()`



<Tabs
  defaultActiveId="dart"
  groupId="reference/dart"
  values={[{ label: 'Dart', value: 'dart' }]}>

<TabsPanel id="dart" label="dart">

```dart
// Only valid if the Stored Procedure returns a table type.
final res = await supabase
  .rpc('echo_all_cities')
  .match({'name': 'Beijing', 'country_id': 156})
  .execute();
```


</TabsPanel>

</Tabs>