Query optimization with EXPLAIN in Supabase - Mini Project: Build & Apply

Query optimization with EXPLAIN

📖 Scenario: You are working with a Supabase database that stores information about books and their authors. You want to understand how your SQL queries run so you can make them faster and more efficient.

🎯 Goal: Learn how to use the EXPLAIN command in Supabase to see how your queries are executed and identify ways to optimize them.

📋 What You'll Learn

Create a simple SQL SELECT query on the books table

Add an EXPLAIN command to analyze the query

Interpret the EXPLAIN output to find the query plan

Modify the query or database structure based on EXPLAIN insights

💡 Why This Matters

🌍 Real World

Database administrators and developers use EXPLAIN to understand how queries run and find ways to make them faster.

💼 Career

Knowing how to optimize queries with EXPLAIN is a key skill for backend developers, data engineers, and cloud database specialists.

1

Write a basic SELECT query

Write a SQL query called query that selects all columns from the books table.

Supabase

-- Write the SQL query to select all columns from books
-- Your code here

Hint

Use SELECT * FROM books; to get all data from the books table.

2

Add EXPLAIN to the query

Create a new variable called explain_query that adds the EXPLAIN keyword before the query variable to analyze it.

Supabase

query = "SELECT * FROM books;"
-- Add EXPLAIN before the query
-- Your code here

Hint

Use string concatenation to add EXPLAIN before the query string.

3

Run the EXPLAIN query

Write a function called run_explain that takes a SQL string sql and returns the result of running it on the Supabase database client supabase using supabase.rpc('sql', { query: sql }).

Supabase

query = "SELECT * FROM books;"
explain_query = "EXPLAIN " + query

# Write a function to run the EXPLAIN query
# Your code here

Hint

Define a function with def run_explain(sql): and return the result of supabase.rpc('sql', { 'query': sql }).

4

Interpret and optimize the query

Add a comment explaining that you will check the EXPLAIN output to find slow parts and then add an index on the author_id column of the books table using CREATE INDEX idx_author_id ON books(author_id); to speed up queries filtering by author.

Supabase

query = "SELECT * FROM books;"
explain_query = "EXPLAIN " + query

def run_explain(sql):
    return supabase.rpc('sql', { 'query': sql })

# Add a comment about checking EXPLAIN output and creating an index
# Your code here

Hint

Write a comment about using EXPLAIN output and add the exact SQL command to create the index.

Practice

1. What is the main purpose of using EXPLAIN in Supabase queries?

easy

A. To execute the query faster automatically

B. To see how the database plans to run your query

C. To delete data from the database

D. To create new tables in the database

Solution

1. Step 1: Understand the role of EXPLAIN

   EXPLAIN shows the query plan, which is how the database intends to run the query.

2. Step 2: Differentiate EXPLAIN from other commands

   It does not execute or change data; it only provides information about query execution.

3. Final Answer:

   To see how the database plans to run your query -> Option B

4. Quick Check:

   EXPLAIN = query plan info [OK]

Hint: EXPLAIN shows query plans, not data changes [OK]

Common Mistakes:

• Thinking EXPLAIN runs the query faster
• Confusing EXPLAIN with data modification commands
• Assuming EXPLAIN creates or deletes tables

2. Which of the following is the correct syntax to get detailed execution info of a query in Supabase?

easy

A. EXPLAIN ANALYZE SELECT * FROM users;

B. EXPLAIN SELECT * FROM users;

C. ANALYZE EXPLAIN SELECT * FROM users;

D. SELECT EXPLAIN ANALYZE * FROM users;

Solution

1. Step 1: Recall the syntax for detailed query execution

   To get real execution details, use EXPLAIN ANALYZE before the query.

2. Step 2: Check each option's syntax

   EXPLAIN ANALYZE SELECT * FROM users; correctly places EXPLAIN ANALYZE before the SELECT statement; others are incorrect or invalid.

3. Final Answer:

   EXPLAIN ANALYZE SELECT * FROM users; -> Option A

4. Quick Check:

   EXPLAIN ANALYZE = detailed execution [OK]

Hint: Use EXPLAIN ANALYZE before SELECT for details [OK]

Common Mistakes:

• Swapping EXPLAIN and ANALYZE order
• Placing EXPLAIN inside SELECT
• Using ANALYZE without EXPLAIN

3. Given the EXPLAIN output shows a sequential scan on a large table, what is the likely effect on query performance?

medium

A. The query will be very fast because it uses an index

B. The query will fail due to missing indexes

C. The query will only scan a small part of the table

D. The query might be slow because it reads the whole table

Solution

1. Step 1: Understand sequential scan meaning

   A sequential scan reads every row in the table, which can be slow for large tables.

2. Step 2: Compare with index scan

   Index scans read only relevant rows, making queries faster; sequential scans do not use indexes.

3. Final Answer:

   The query might be slow because it reads the whole table -> Option D

4. Quick Check:

   Seq scan = full table read, slower [OK]

Hint: Seq scan reads all rows, slowing large queries [OK]

Common Mistakes:

• Assuming sequential scan uses indexes
• Thinking sequential scan reads only part of table
• Confusing failure with slow performance

4. You run EXPLAIN ANALYZE SELECT * FROM orders WHERE customer_id = 123; but notice the query is slow. What is a likely cause and fix?

medium

A. No index on customer_id; add an index on that column

B. The query syntax is wrong; rewrite the SELECT statement

C. The database is offline; restart the server

D. The table orders does not exist; create it first

Solution

1. Step 1: Analyze slow query cause

   Slow queries filtering by a column often mean missing indexes on that column.

2. Step 2: Suggest fix based on EXPLAIN ANALYZE

   Adding an index on customer_id helps the database find rows faster, improving speed.

3. Final Answer:

   No index on customer_id; add an index on that column -> Option A

4. Quick Check:

   Missing index = slow filter; add index [OK]

Hint: Slow filtered query? Check indexes on filter columns [OK]

Common Mistakes:

• Assuming syntax error causes slowness
• Restarting server without checking query plan
• Thinking missing table causes slow query

5. You want to optimize a complex query joining two large tables. The EXPLAIN ANALYZE shows nested loops causing slow performance. What is the best approach to improve it?

hard

A. Increase the database server's CPU without changing the query

B. Remove all indexes to force sequential scans

C. Add indexes on join columns and rewrite query to use explicit JOIN syntax

D. Split the query into multiple smaller queries without joins

Solution

1. Step 1: Understand nested loops impact

   Nested loops join can be slow on large tables without proper indexes on join columns.

2. Step 2: Apply optimization techniques

   Adding indexes on join columns helps the database find matching rows faster. Using explicit JOIN syntax clarifies the query for optimization.

3. Final Answer:

   Add indexes on join columns and rewrite query to use explicit JOIN syntax -> Option C

4. Quick Check:

   Indexes + clear JOIN = faster joins [OK]

Hint: Index join columns and use explicit JOIN for speed [OK]

Common Mistakes:

• Removing indexes causing slower scans
• Splitting queries losing join benefits
• Relying only on hardware upgrades