Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Επαγγελματική ροή αλλαγών σχήματος: Local branching, schema diffing και zero-downtime migrations.
Σε ένα επαγγελματικό περιβάλλον, οι αλλαγές σχήματος βάσης δεδομένων (DDL) πρέπει να αντιμετωπίζονται με την ίδια πειθαρχία όπως ο κώδικας της εφαρμογής: με version control στο Git, αυτοματοποιημένο review σε Pull Requests και δυνατότητα αναπαραγωγής σε οποιοδήποτε staging περιβάλλον.
Το Supabase CLI τρέχει ολόκληρο το stack (Postgres, GoTrue Auth, PostgREST, Storage, Realtime και Inbucket email server) τοπικά μέσω Docker:
# 1. Αρχικοποίηση φακέλου supabase/ στο project
supabase init
# 2. Εκκίνηση του τοπικού dev environment (απαιτεί Docker)
supabase start
# 3. Έλεγχος των URLs και API keys
supabase statussupabase db diffΑντί να γράφετε χειροκίνητα πολύπλοκα scripts DDL, κάντε τις αλλαγές σας στο τοπικό Supabase Studio (http://localhost:54323) ή εκτελέστε δοκιμαστικά SQL queries. Στη συνέχεια, αφήστε το CLI να συγκρίνει το τοπικό σχήμα με το προηγούμενο state:
# Αυτόματη παραγωγή timestamped migration αρχείου από το diff
supabase db diff -f add_subscriptions_table
# Το αρχείο παράγεται στο: supabase/migrations/20260305140000_add_subscriptions_table.sqlΕλέγξτε πάντα το παραγόμενο SQL αρχείο πριν το κάνετε commit στο Git!
Όταν εκτελείτε migrations σε πίνακες με εκατομμύρια γραμμές, ορισμένες εντολές DDL δεσμεύουν αποκλειστικό κλείδωμα (ACCESS EXCLUSIVE LOCK), καθιστώντας την εφαρμογή μη διαθέσιμη. Ακολουθήστε αυτούς τους 3 χρυσούς κανόνες:
Στην PostgreSQL 11+, η προσθήκη στήλης με σταθερό default δεν ξαναγράφει τον πίνακα:
-- ✅ ΑΣΦΑΛΕΣ (Metadata update σε < 1ms):
ALTER TABLE public.profiles
ADD COLUMN IF NOT EXISTS tier text DEFAULT 'free' NOT NULL;-- 1. Προσθήκη CHECK constraint χωρίς άμεσο validation (μηδενικό lock)
ALTER TABLE public.profiles
ADD CONSTRAINT check_email_not_null CHECK (email IS NOT NULL) NOT VALID;
-- 2. Επικύρωση σε δεύτερο χρόνο χωρίς blocking άλλων queries
ALTER TABLE public.profiles
VALIDATE CONSTRAINT check_email_not_null;Προσοχή: η στήλη παραμένει
nullableστον κατάλογο — τα ORMs τη βλέπουν nullable.
CONCURRENTLY)-- ❌ ΜΗΝ ΤΟ ΚΑΝΕΤΕ: Κλειδώνει το table για γράψιμο
-- CREATE INDEX idx_users_email ON public.profiles (email);
-- ✅ ΒΕΛΤΙΣΤΟ: Χτίζει το index στο παρασκήνιο χωρίς downtime
CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_users_email ON public.profiles (email);Στο GitHub Actions workflow σας, συνδέστε το CLI απευθείας με το production project μέσω του Access Token:
- name: Εφαρμογή migrations στο Supabase
env:
SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
SUPABASE_DB_PASSWORD: ${{ secrets.SUPABASE_DB_PASSWORD }}
run: |
# Σύνδεση με το remote project (το CLI διαβάζει το token από το περιβάλλον)
supabase link --project-ref ${{ secrets.SUPABASE_PROJECT_ID }}
# Εφαρμογή εκκρεμών migrations
supabase db pushsupabase init και supabase start, ενώ το supabase db diff παράγει timestamped migration αρχεία.DEFAULT είναι ασφαλής ενημέρωση metadata, ενώ το NOT VALID με μεταγενέστερο VALIDATE CONSTRAINT αποφεύγει το blocking.CREATE INDEX CONCURRENTLY και εφαρμόζονται μέσω supabase db push.