חומרי עזר לדוח Query Explain

חומרי עזר לדוח Query Explain

הערכים הבאים מוחזרים כתוצאות של פעולות שבוצעו באמצעות Firestore Query Explain.

הערה: הכלי 'הסבר על שאילתה' מיועד לניתוח אד-הוק שימושי. פורמט הדוח שלו ישתנה כדי להקל על הקריאה וההבנה, ולא כדי להתאים לעיבוד על ידי מכונה. צפוי שחלק מהמדדים ישתנו ככל ש-Firestore במצב Native יתפתח (כלומר, יכול להיות שיוספו, יוסרו או יעודכנו מדדים), והם לא כפופים לאותה מדיניות הוצאה משימוש כמו ממשקי API אחרים של Firestore במצב Native. בטבלאות הבאות מפורטים חלקי הנתונים שעשויים להשתנות.

רשומות של תוכניות

מפתח	סוג	השדה עשוי להשתנות?	תיאור
indexes_used	רשימה של Generic Structs	כן, התוכן בתשובה המובנית כפוף לשינויים.	רשימת האינדקסים שנבחרו לשאילתה הזו. מידע נוסף מופיע בהמשך.

האינדקסים שבהם נעשה שימוש

התוכן של האינדקסים שבהם נעשה שימוש עשוי להשתנות ככל ש-Firestore במצב Native מתפתח.

מפתח	סוג	תיאור
query_scope	String	ההיקף שבו מורצת שאילתה. לדוגמה: Collection, Collection Group ו-Includes Ancestors.
נכסים	String	שדות האינדקס בפורמט. לדוגמה: (age ASC, __name__ ASC).

נתוני ביצוע

נתונים סטטיסטיים מצטברים של הביצוע של השאילתה.

מפתח	סוג	השדה עשוי להשתנות?	תיאור
results_returned	ארוך	לא	המספר הכולל של התוצאות שהוחזרו, כולל מסמכים, תחזיות, תוצאות צבירה ומפתחות.
execution_duration	משך הזמן	לא	הזמן הכולל לביצוע השאילתה בקצה העורפי.
read_operations	ארוך	לא	סך כל פעולות הקריאה שניתנות לחיוב.
debug_stats	Generic Struct	כן, התוכן בתשובה המובנית כפוף לשינויים.	נתונים סטטיסטיים לניפוי באגים מביצוע השאילתה. אפשר לראות אותם למטה.

סטטיסטיקות של ניפוי באגים

התוצאות הבאות שימושיות לניפוי באגים בתרחישי שימוש ולניתוח של נתונים סטטיסטיים גולמיים ואופציונליים.

התוכן של נתוני הניפוי באגים עשוי להשתנות ככל ש-Firestore במצב Native מתפתח.

מפתח	סוג	תיאור
index_entries_scanned	String	המספר הכולל של רשומות האינדקס שנבדקו במהלך השאילתה.
documents_scanned	String	המספר הכולל של המסמכים שנסרקו במהלך השאילתה.
billing_details	Generic Struct	פרטי החיוב, כולל מדדים כמו: documents_billable,‏ index_entries_billable,‏ knn_vector_index_entries_billable,‏ min_query_cost.