Rolling back migrations in Supabase - Time & Space Complexity

Time Complexity: Rolling back migrations

O(n)

Understanding Time Complexity

When rolling back migrations in Supabase, it's important to understand how the time to undo changes grows as more migrations exist.

We want to know how the rollback process scales with the number of migrations applied.

Scenario Under Consideration

Analyze the time complexity of rolling back migrations one by one.

// Rollback the last migration
await supabase.migrations.rollback();

// Rollback multiple migrations in a loop
for (let i = 0; i < n; i++) {
  await supabase.migrations.rollback();
}

This sequence rolls back the last migration once, or multiple times to undo several migrations in order.

Identify Repeating Operations

Look at what happens repeatedly during rollback.

• Primary operation: Calling the rollback API to undo one migration.
• How many times: Once per migration being undone.

How Execution Grows With Input

Each rollback call undoes one migration, so the total calls grow directly with the number of migrations.

Input Size (n)	Approx. API Calls/Operations
10	10 rollback calls
100	100 rollback calls
1000	1000 rollback calls

Pattern observation: The number of rollback calls increases one-to-one with the number of migrations to undo.

Final Time Complexity

Time Complexity: O(n)

This means the time to rollback grows linearly with how many migrations you want to undo.

Common Mistake

[X] Wrong: "Rolling back multiple migrations happens all at once in a single call."

[OK] Correct: Each rollback call only undoes one migration, so multiple calls are needed for multiple rollbacks.

Interview Connect

Understanding how rollback operations scale helps you design reliable deployment processes and troubleshoot database changes confidently.

Self-Check

"What if the rollback command could undo multiple migrations in one call? How would the time complexity change?"

Practice

1. What does the command supabase db rollback do?

easy

A. It creates a new migration file.

B. It undoes the last applied database migration.

C. It applies all pending migrations to the database.

D. It deletes the entire database.

Solution

1. Step 1: Understand the purpose of rollback

   Rollback means undoing changes, so this command reverses migrations already applied.

2. Step 2: Identify the command effect

   supabase db rollback specifically undoes the last migration applied to the database.

3. Final Answer:

   It undoes the last applied database migration. -> Option B

4. Quick Check:

   Rollback = undo last migration [OK]

Hint: Rollback means undo last migration applied [OK]

Common Mistakes:

• Confusing rollback with applying migrations
• Thinking rollback creates new migrations
• Assuming rollback deletes the database

2. Which of the following is the correct syntax to rollback the last 3 migrations using Supabase CLI?

easy

A. supabase db rollback --steps 3

B. supabase db rollback -n 3

C. supabase rollback db 3

D. supabase db undo 3

Solution

1. Step 1: Recall the rollback command syntax

   The Supabase CLI uses --steps to specify how many migrations to rollback.

2. Step 2: Match the correct option

   supabase db rollback --steps 3 uses supabase db rollback --steps 3, which is the correct syntax.

3. Final Answer:

   supabase db rollback --steps 3 -> Option A

4. Quick Check:

   Use --steps to rollback multiple migrations [OK]

Hint: Use --steps to specify rollback count [OK]

Common Mistakes:

• Using incorrect flags like -n instead of --steps
• Wrong command order like 'rollback db'
• Using 'undo' instead of 'rollback'

3. Given the following commands run in order:
supabase db push
supabase db push
supabase db rollback --steps 1
What is the state of migrations after these commands?

medium

A. All migrations are rolled back except the last one.

B. No migrations are applied.

C. Both migrations are still applied.

D. Only the first migration is applied.

Solution

1. Step 1: Apply two migrations

   Running supabase db push twice applies two migrations in order.

2. Step 2: Rollback one migration

   The rollback with --steps 1 undoes the last applied migration, leaving the first migration applied.

3. Final Answer:

   Only the first migration is applied. -> Option D

4. Quick Check:

   Rollback 1 step removes last migration applied [OK]

Hint: Rollback with --steps 1 undoes last migration only [OK]

Common Mistakes:

• Assuming rollback removes all migrations
• Thinking rollback does not affect applied migrations
• Confusing push and rollback order

4. You run supabase db rollback --steps 2 but get an error saying no migrations to rollback. What is the most likely cause?

medium

A. There are fewer than 2 migrations applied to rollback.

B. The migrations folder is missing.

C. The database connection is not configured.

D. Rollback command requires a --force flag.

Solution

1. Step 1: Understand rollback error

   The error indicates no migrations to rollback, meaning none or fewer than requested are applied.

2. Step 2: Identify cause

   If fewer than 2 migrations are applied, trying to rollback 2 steps causes this error.

3. Final Answer:

   There are fewer than 2 migrations applied to rollback. -> Option A

4. Quick Check:

   Rollback steps > applied migrations causes error [OK]

Hint: Check applied migrations count before rollback steps [OK]

Common Mistakes:

• Assuming rollback always works without applied migrations
• Thinking rollback needs --force flag
• Ignoring database connection issues

5. You have applied 5 migrations but want to rollback only the 3rd migration without affecting others. Which approach is best?

hard

A. Delete the 3rd migration file and run supabase db push.

B. Use supabase db rollback --steps 3 to rollback only the 3rd migration.

C. Rollback all migrations from the 3rd onwards, then reapply the ones after it.

D. Directly edit the database to remove changes from the 3rd migration.

Solution

1. Step 1: Understand migration order

   Migrations apply in order; you cannot rollback a middle migration without undoing later ones first.

2. Step 2: Plan rollback and reapply

   Rollback migrations after the 3rd (steps 2), then rollback the 3rd, then reapply the later migrations.

3. Final Answer:

   Rollback all migrations from the 3rd onwards, then reapply the ones after it. -> Option C

4. Quick Check:

   Rollback middle migration requires undoing later ones first [OK]

Hint: Undo later migrations first, then rollback target migration [OK]

Common Mistakes:

• Trying to rollback a single middle migration directly
• Deleting migration files without rollback
• Editing database manually causing inconsistency