Query Rows

The Query Rows stage allows you to retrieve data from any table in your Supabase database with powerful filtering, sorting, and column selection capabilities.

Input Parameters

ParameterVariableRequiredDescription
Table Name{{tableName}}YesThe name of the table to query
Select Columns{{selectColumns}}No (default: *)Columns to return, comma-separated
Filters{{filters}}NoFilter string to identify which rows to return
Limit{{limit}}No (default: 1000)Maximum number of rows to return
Order By{{orderBy}}NoColumn to sort results by
Order Direction{{orderDirection}}No (default: asc)Sort direction: asc or desc


 

Output

OutputVariableDescription
Rows{{rows}}Array of row objects matching your query
Success{{success}}Boolean indicating if the query succeeded


 

Usage Examples

Example 1: Get All Records (No Filter)

ParameterValue
tableNamecustomers

Result: Returns up to 1000 rows with all columns


 

Example 2: Single Filter

ParameterValue
tableNameusers
filtersstatus=eq.active


 

Example 3: Multiple Filters (AND)

ParameterValue
tableNamecustomers
filterstier=eq.premium&region=eq.north&is_verified=eq.true


 

Example 4: Select Specific Columns with Sorting

ParameterValue
tableNameusers
selectColumnsid,email,name,created_at
filtersstatus=eq.active
orderBycreated_at
orderDirectiondesc
limit50


 

Example 5: Numeric Range

ParameterValue
tableNameproducts
filtersprice=gte.50&price=lte.200
orderByprice
orderDirectionasc


 

Example 6: Pattern Matching

ParameterValue
tableNamecustomers
filtersemail=ilike.*@gmail.com


 

Example 7: Filter with IN Operator

ParameterValue
tableNameorders
filtersstatus=in.(pending,processing,shipped)

Was this article helpful?