EXPLAIN query מציג את התוכנית ש-PostgreSQL בוחר לשאילתה: עץ של שלבים (צמתים) עם עלויות ומספרי שורות משוערים. EXPLAIN ANALYZE query גם מריץ את השאילתה ומוסיף את הזמן, השורות והלולאות האמיתיים של כל צומת. קראו את העץ מהצומת המוזח ביותר החוצה: צמתים פנימיים מעבירים את השורות שלהם לצומת שמעליהם.
אין אינדקס על email, ולכן התוכנית היא Seq Scan: PostgreSQL קורא כל שורה ושומר את אלה שעוברות את ה-Filter. Rows Removed by Filter מראה את העבודה המבוזבזת. הזמנים שונים בכל הרצה; הצורה של התוכנית חשובה יותר מהמספרים.
לקרוא שורה אחת בתוכנית
כל צומת מדפיס שורה בצורה הזו:
Seq Scan on users (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
| חלק | משמעות |
|---|---|
cost=STARTUP..TOTAL | העבודה המשוערת לפני השורה הראשונה, ולכל השורות, ביחידות של ה-planner (לא מילישניות) |
rows (הראשון) | מספר השורות המשוער שהצומת מחזיר |
width | גודל השורה הממוצע המשוער בבתים |
actual time | מילישניות עד השורה הראשונה ועד השורה האחרונה, לכל לולאה |
rows (בפועל) | השורות שהוחזרו, לכל לולאה |
loops | כמה פעמים הצומת רץ; הכפילו בו את הזמן ואת השורות |
העלויות של הורה כוללות את הילדים שלו. Planning Time ו-Execution Time בתחתית הם סכומים של כל הפקודה.
לזהות את צומתי התוכנית הנפוצים
EXPLAIN (COSTS OFF) מסתיר את המספרים, כך שקל יותר לראות את הצורה של התוכנית:
קראו מבפנים. שתי הטבלאות נסרקות והלקוחות שסוננו נכנסים ל-Hash. ה-Hash Join בודק מולו כל הזמנה, וה-GroupAggregate שלמעלה סופר את התוצאה. הצמתים שתפגשו הכי הרבה:
| צומת | מה הוא עושה |
|---|---|
Seq Scan | קורא את כל הטבלה |
Index Scan | מוצא שורות דרך אינדקס, ואז קורא כל שורה מהטבלה |
Index Only Scan | עונה מהאינדקס בלי לגשת לטבלה |
Bitmap Index Scan + Bitmap Heap Scan | אוסף מאינדקס את המיקומים של השורות שמתאימות, ואז קורא אותן לפי סדר הטבלה |
Nested Loop | לכל שורה חיצונית, מחפש התאמות בקלט הפנימי; טוב כשהצד החיצוני קטן |
Hash Join + Hash | בונה טבלת hash מקלט אחד ובודק מולה את השני |
Merge Join | מצרף שני קלטים שכבר ממוינים לפי מפתח הצירוף |
Sort, Incremental Sort | ממיין שורות ל-ORDER BY, ל-DISTINCT או ל-merge join |
HashAggregate, GroupAggregate | GROUP BY עם טבלת hash, או על קלט ממוין |
Limit | עוצר אחרי N שורות |
Gather | אוסף שורות מ-workers שרצים במקביל |
למצוא הערכות שורות שגויות
הבדיקה השימושית ביותר ב-EXPLAIN ANALYZE היא ה-rows המשוער מול ה-rows בפועל באותו צומת. כשהם רחוקים זה מזה, ה-planner בחר את התוכנית שלו לפי מספרים שגויים, לעיתים קרובות כי הסטטיסטיקות חסרות או ישנות:
הסריקה מחזירה 10 שורות בפועל, אבל ההערכה גבוהה בהרבה כי הטבלה עוד לא נותחה. הוסיפו ANALYZE tasks; לפני ה-EXPLAIN וההערכה מתקרבת ל-10. Autovacuum מנתח טבלאות ברקע, אבל הריצו ANALYZE בעצמכם אחרי טעינה גדולה (ראו VACUUM ו-autovacuum).
להסביר שינוי נתונים בלי לשמור אותו
EXPLAIN ANALYZE מבצע את הפקודה, כך ש-UPDATE או DELETE משנים שורות. עטפו אותו בטרנזקציה ובטלו אותה:
כל 1000 השורות עדיין שם אחרי ה-rollback.
להציג I/O עם BUFFERS ואפשרויות אחרות
EXPLAIN (ANALYZE, BUFFERS) SELECT ...; -- pages read from cache (hit) and disk (read)
EXPLAIN (ANALYZE, BUFFERS, SETTINGS) SELECT ...; -- also list changed planner settings
EXPLAIN (FORMAT JSON) SELECT ...; -- machine-readable, for plan visualizers
EXPLAIN (ANALYZE, TIMING OFF) SELECT ...; -- row counts without per-node timing overhead
BUFFERS מציג I/O: צומת עם הרבה דפים ב-read פנה לדיסק. PostgreSQL 17 הוסיף את SERIALIZE (העלות של המרת שורות הפלט לטקסט) ואת MEMORY (הזיכרון של ה-planner). המדריך הרשמי ל-EXPLAIN עובר על תוכניות נוספות.
לבדוק תוכנית עם הגדרות של ה-planner
כדי לראות באיזו תוכנית PostgreSQL היה משתמש בלי שיטה מסוימת, כבו את השיטה הזו ב-session שלכם. עשו את זה רק בניסויים, אף פעם לא בקוד של production:
עם 100 שורות ה-planner מעדיף Seq Scan; עם enable_seqscan = off התוכנית מציגה Index Scan using items_pkey. השוו את הזמנים של שני ה-EXPLAIN ANALYZE כדי לראות אם האינדקס עוזר. RESET enable_seqscan; מחזיר את ברירת המחדל.
שאלות נפוצות
מה ההבדל בין EXPLAIN ל-EXPLAIN ANALYZE?
EXPLAIN רק מתכנן את השאילתה ומציג הערכות. EXPLAIN ANALYZE גם מריץ אותה ומוסיף את הזמן, מספר השורות ומספר הלולאות האמיתיים של כל צומת, ולכן הוא לוקח זמן כמו השאילתה עצמה.
מה המשמעות של cost בתוכנית של PostgreSQL?
Cost הוא ההערכה של ה-planner ביחידות שרירותיות, בקנה מידה שבו קריאה סדרתית של דף אחד עולה 1 (seq_page_cost). הוא שימושי להשוואה בין תוכניות של אותה שאילתה, לא כזמן במילישניות.
האם EXPLAIN ANALYZE משנה נתונים?
כן, ב-INSERT, UPDATE, DELETE ו-MERGE הוא מבצע את השינוי. הריצו אותו בין BEGIN ל-ROLLBACK כדי למדוד בלי לשמור את התוצאה.
למה נבחר Seq Scan כשיש אינדקס?
כי ה-planner מעריך שזה זול יותר: הטבלה קטנה, השאילתה מחזירה חלק גדול מהשורות, או שהתנאי לא יכול להשתמש באינדקס. גם סטטיסטיקות ישנות יכולות להטעות אותו, ו-ANALYZE מתקן את זה.