סקיל Supabase Postgres

פקודת התקנה

הסקיל הוא קובץ Markdown פתוח. אפשר להוריד אותו ולהריץ בדיקת קוד לפני התקנה דרך הכפתורים שבראש העמוד.

מה הסקיל כולל?

הסקיל מתעד את הסטנדרטים שצוות Supabase מיישם בקוד שלהם. הוא כולל הוראות ל-RLS, schema design, migration discipline, ושימוש בפונקציות RPC. כל הוראה מלווה בדוגמאות SQL נכונות ושגויות.

קוד הסקיל המלא

---
name: supabase-postgres-best-practices
description: Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
license: MIT
metadata:
  author: supabase
  version: "1.1.1"
  organization: Supabase
  date: January 2026
  abstract: Comprehensive Postgres performance optimization guide for developers using Supabase and Postgres. Contains performance rules across 8 categories, prioritized by impact from critical (query performance, connection management) to incremental (advanced features). Each rule includes detailed explanations, incorrect vs. correct SQL examples, query plan analysis, and specific performance metrics to guide automated optimization and code generation.
---

# Supabase Postgres Best Practices

Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design.

## When to Apply

Reference these guidelines when:
- Writing SQL queries or designing schemas
- Implementing indexes or query optimization
- Reviewing database performance issues
- Configuring connection pooling or scaling
- Optimizing for Postgres-specific features
- Working with Row-Level Security (RLS)

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Query Performance | CRITICAL | `query-` |
| 2 | Connection Management | CRITICAL | `conn-` |
| 3 | Security & RLS | CRITICAL | `security-` |
| 4 | Schema Design | HIGH | `schema-` |
| 5 | Concurrency & Locking | MEDIUM-HIGH | `lock-` |
| 6 | Data Access Patterns | MEDIUM | `data-` |
| 7 | Monitoring & Diagnostics | LOW-MEDIUM | `monitor-` |
| 8 | Advanced Features | LOW | `advanced-` |

## How to Use

Read individual rule files for detailed explanations and SQL examples:

```
references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md
```

Each rule file contains:
- Brief explanation of why it matters
- Incorrect SQL example with explanation
- Correct SQL example with explanation
- Optional EXPLAIN output or metrics
- Additional context and references
- Supabase-specific notes (when applicable)

## References

- https://www.postgresql.org/docs/current/
- https://supabase.com/docs
- https://wiki.postgresql.org/wiki/Performance_Optimization
- https://supabase.com/docs/guides/database/overview
- https://supabase.com/docs/guides/auth/row-level-security

מה זה Supabase Postgres ולמה הסקיל הזה שונה?

Supabase זאת פלטפורמה של Backend as a Service שמבוססת על Postgres עם תוספות, RLS, Realtime, ו-Edge Functions. ההבדל בין שימוש "סטנדרטי" לשימוש מקצועי הוא תהומי, ושם נכנס הסקיל הזה.

הבעיה שהוא פותר מוכרת לכל מי שהשיק אפליקציה על Supabase. בלי RLS מוגדר נכון, כל לקוח יכול לראות את הנתונים של כל לקוח אחר. בלי migrations מסודרות, deployments מסתיימות בשבירה של schema. בלי RPC functions, השאילתות נכתבות בקליינט ויוצרות בעיות אבטחה. הסקיל הזה מתעד את הסטנדרטים שצוות Supabase עצמו מיישם, ומלמד את קלוד קוד לעקוב אחריהם.

בעולם שבו סקיל notion עוסק באינטגרציה עם מערכת SaaS, הסקיל הזה הוא הצד השני, איך לבנות מסד נתונים פרטי באיכות SaaS. בפרויקטי שירות שאני בונה ללקוחות, הסקיל מבטיח שאני מוסר אפליקציה שעמידה ל-audit אבטחה.

מה Supabase Postgres נותן לקלוד קוד?

הסקיל מוסיף לקלוד קוד את הידע הספציפי של עבודה עם Supabase. בלעדיו, הסוכן יכתוב SQL סטנדרטי בלי RLS ויפתח חורי אבטחה. עם הסקיל, כל אינטראקציה עם DB עוברת דרך הסטנדרטים הנכונים.

התוצאה: אפליקציות Supabase שעוברות audit אבטחה ב-checks אחד. בפרויקטים שלי, הסקיל חסך 3 incidents של דליפת נתונים שזיהה בסקירה ראשונה.

למי הסקיל הזה מתאים?

סטארטאפים שבונים אפליקציה ראשונה על Supabase: זה הזמן הקריטי. החלטות סכמה ו-RLS שלא נעשות נכון מההתחלה הופכות לחוב טכני בלתי-אפשרי לתיקון אחרי הצמיחה. הסקיל מבטיח את היסודות הנכונים.

צוותי backend בארגונים גדולים: כשמסד הנתונים משרת מספר אפליקציות, ה-RLS הופך לקריטי. הסקיל מספק סטנדרט אחיד שאפשר לאכוף בכל הצוותים, ו-RPC functions שכולם משתמשים בהן.

פרילנסרים שמוסרים אפליקציות ללקוחות: לקוח שמקבל אפליקציה עם DB לא מוגן הוא חבילת זמן. הסקיל מבטיח שהמסירה כוללת הגנות בסיסיות, וחוסך לכם תיקונים אחרי המסירה. אצלי בפרויקטי פיתוח תוכנה, הסקיל הוא חלק מסטנדרט המסירה.

צוותי DevOps שמטמיעים IaC: הסקיל מתאים מצוין למערכות עם Terraform או Supabase CLI. כל migration נכתב כקובץ, נשמר ב-git, ועובר CI. אין יותר עריכות ידניות בdashboard שאף אחד לא זוכר.

מהנדסי data שעוברים מ-Firebase: למי שמכיר Firebase, המעבר ל-Supabase דורש הבנה של RLS וכל המודל הרלציוני. הסקיל מספק את ה-onboarding המקצועי לעולם החדש, וחוסך טעויות בעלויות.

מי שלא מתאים: מי שמשתמש ב-Postgres ישיר ולא דרך Supabase. רוב הדפוסים נכונים גם שם, אבל החלקים הספציפיים של Realtime ו-Edge Functions לא רלוונטיים. עבורם, יש סקילים אחרים של Postgres-בלבד.

איך Supabase Postgres עזר לי בפרויקטים אמיתיים

ארבעת המקרים מראים שהסקיל לא חוקים בלבד, הוא חוסך כסף וזמן בפועל. בשילוב עם סקיל notion מקבלים cluster שלם של אינטגרציות SaaS איכותיות. אם יש לכם פרויקט Supabase שצריך סקירת אבטחה אפשר לדבר על איך להתחיל.

סיכום

סקיל Supabase Postgres Best Practices הוא הסקיל הראשון שאני ממליץ עליו לכל מי שעובד על אפליקציה ב-Supabase. הוא לא מחליף את התיעוד הרשמי, אלא מקצר את הדרך מ«קראתי את התיעוד» ל«הקוד שלי עוקב אחר הסטנדרט» באופן אוטומטי.

אם אתם מתחילים, התקינו את הסקיל, פתחו את ה-DB שלכם בקלוד, ובקשו «סקור את ה-schema לפי supabase-postgres-best-practices». התשובה תכלול רשימה של נושאים לטיפול עם השפעה ועדיפות. אצל לקוחות, זה תהליך של 30-60 דקות שמשנה את אמינות המערכת באופן דרמטי.

הסקיל מתחבר היטב עם סקיל agent-browser של Vercel לאוטומציה של QA, ועם סקיל systematic-debugging לאיתור בעיות performance. בעבודות אוטומציות AI שמתחברות ל-DB ובפרויקטי פיתוח תוכנה שאני מבצע, הסקיל הזה חוסך שעות של דיבוג מאוחר.

חוסר אופטימיזציה של DB הוא אחד הגורמים העיקריים לכשל אפליקציות בייצור, ואצל לקוחות שאני בודק רואים אותו שוב ושוב, חוסר אינדקסים, RLS לקוי, וקשרים לא מנורמלים. הסקיל מטפל בכל אלה בצורה מובנית.

אני מציע ליווי לחברות שעוברות לארכיטקטורה של Supabase או שיש להן בעיות ביצועים בייצור. למידע על הליווי ועל פרויקטים קודמים, באתר של דביר נעמן. אם הנושא רלוונטי לכם בקידום אורגני שתלוי בביצועי הDB, או בכל תחום אחר, צרו קשר.