Supabase Guide

02/03
Lesson 02

Database Migrations

資料庫建置與管理

學習使用 Supabase CLI 進行資料庫版本控制 (Migrations)，這是在團隊協作中管理資料庫結構的最佳實踐。

1 安裝與初始化

首先確保安裝 Supabase CLI (macOS 為例)：

brew install supabase/tap/supabase

接著登入你的 Supabase 帳號：

supabase login

2 建立 Migration

當我們要修改資料庫結構（例如新增 table）時，不要直接在 Dashboard 操作，而是建立一個 Migration 檔案：

supabase migration new create_profiles

發生了什麼事？

CLI 會在你的專案目錄下產生 supabase/migrations/<timestamp>_create_profiles.sql 檔案。

請直接編輯該 SQL 檔案，寫入建表語法，例如： 

create table profiles (
  id uuid references auth.users not null primary key,
  username text unique,
  avatar_url text
);

3 部署到遠端

首先將本地專案連結到遠端 Supabase 專案 (Project ID 可在 Dashboard 網址找到)：

supabase link --project-ref your_project_id

連結成功後，將 migrations 推送到遠端資料庫：

supabase db push
2