בדף הזה מוסבר איך לאחזר מידע על ביצוע שאילתות כשמריצים שאילתה.
שימוש ב-Query Explain
אפשר להשתמש ב-Query Explain כדי להבין איך השאילתות מבוצעות. הדוח הזה מספק פרטים שבעזרתם אפשר לבצע אופטימיזציה של השאילתות.
אפשר להשתמש ב-Query Explain דרך מסוף Google Cloud.
המסוף
מריצים שאילתה בעורך השאילתות ופותחים את הכרטיסייה הסבר:
-
נכנסים לדף Databases במסוף Google Cloud.
- ברשימת מסדי הנתונים, בוחרים מסד נתונים מסוג Cloud Firestore. ייפתח Firestore Explorer במסוף Google Cloud עבור מסד הנתונים הזה.
- מזינים שאילתה בעורך השאילתות ולוחצים על הפעלה.
-
לוחצים על הכרטיסייה הסבר כדי לראות את פלט ניתוח השאילתה.
ניתוח
הפלט של Query Explain מכיל שני רכיבים עיקריים: סיכום נתונים סטטיסטיים ועץ הביצוע. דוגמה לשאילתה:
db.pipeline().collection('/users').sort(field("status").ascending()).limit(100)
סיכום נתונים סטטיסטיים
בחלק העליון של הפלט המוסבר מופיע סיכום של נתוני הביצוע. אפשר להשתמש בנתונים הסטטיסטיים האלה כדי לקבוע אם לשאילתה יש חביון או עלות גבוהים. הוא כולל גם נתונים סטטיסטיים לגבי הזיכרון, שמאפשרים לדעת כמה קרובה השאילתה למגבלות הזיכרון.
Execution:
results returned: 2
request peak memory usage: 20.25 KiB (20,736 B)
data bytes read: 148 B
entity row scanned: 2
Billing:
read units: 1
עץ הביצוע
עץ ההרצה מתאר את הרצת השאילתה כסדרה של צמתים. הצמתים התחתונים (צמתי עלים) מאחזרים נתונים משכבת האחסון, והנתונים עוברים במעלה העץ כדי ליצור תשובה לשאילתה.
פרטים על כל צומת הפעלה מופיעים בחומר העזר בנושא הפעלה.
לפרטים על אופן השימוש במידע הזה כדי לבצע אופטימיזציה של השאילתות, אפשר לעיין במאמר בנושא אופטימיזציה של ביצוע שאילתות.
דוגמה לעץ ביצוע:
Tree:
• Compute
| $out_1: map_set($record_1, "__name__", $__name___1, "__key__", unset)
| is query result: true
|
| Execution:
| records returned: 2
| latency: 5.96 ms (local <1 ms)
|
└── • Compute
| $__name___1: map_get($record_1, "__key__")
|
| Execution:
| records returned: 2
| latency: 5.88 ms (local <1 ms)
|
└── • MajorSort
| fields: [$v_1 ASC]
| output: [$record_1]
| limit: 100
|
| Execution:
| records returned: 2
| latency: 5.86 ms (local <1 ms)
| peak memory usage: 20.25 KiB (20,736 B)
|
└── • Compute
| $v_1: map_get($record_1, "status")
|
| Execution:
| records returned: 2
| latency: 5.23 ms (local <1 ms)
|
└── • TableScan
source: /users
order: UNDEFINED
properties: *
row range: (-∞..+∞)
output record: $record_1
variables: [$record_1]
Execution:
records returned: 2
latency: 4.68 ms
records scanned: 2
data bytes read: 148 B
המאמרים הבאים
- מידע על הצמתים בעץ ההרצה זמין בחומר העזר בנושא הרצת שאילתות.
- כדי ללמוד איך לבצע אופטימיזציה של השאילתות, אפשר לעיין במאמר בנושא אופטימיזציה של ביצוע שאילתות.