Menu

EXPLAIN ANALYZE ב-PostgreSQL: איך קוראים תוכנית שאילתה

EXPLAIN מציג את התוכנית ש-PostgreSQL בוחר לשאילתה, ו-EXPLAIN ANALYZE מריץ את השאילתה ומוסיף את מספרי השורות והזמנים האמיתיים של כל שלב. כך קוראים את עץ התוכנית ואת שמות הצמתים הנפוצים.

בדף הזה יש עורכים שאפשר להריץ. לערוך, להריץ ולראות את הפלט מיד.

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, GroupAggregateGROUP 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 מתקן את זה.

איור של שפות התכנות ב-Coddy

ללמוד תכנות עם Coddy

להתחיל