本頁面說明如何使用「查詢洞察」資訊主頁,偵測及分析查詢效能。
查詢洞察總覽
使用查詢洞察資訊主頁,監控與指標相關的查詢。您可以根據指標,找出最常使用的查詢,以及可能需要最佳化的高延遲查詢。使用查詢洞察資訊主頁,即可:
- 查詢效能最佳化:找出延遲時間過長且可能需要最佳化的查詢。
- 查詢費用管理:找出高費用查詢並加以最佳化,降低費用。
- 查詢統計資料監控:追蹤查詢統計資料的變化。
- 索引建議:找出遺漏或不理想的複合式索引,並直接從資訊主頁建立建議的索引 (Enterprise 版本)。
查詢洞察資料
查詢洞察包含下列 API 方法的資料:
findaggregate
您可以查看特定專案、資料庫和時間長度 (10 分鐘到 30 天) 內,使用這些方法的查詢資料。結構相同的查詢資料會彙整至單一正規化查詢。
查詢洞察會傳回下列查詢相關資訊:
| 正規化查詢文字 | 以文字表示的查詢結構。 |
| 執行次數 | 所選時間範圍內的執行作業數。 |
| 錯誤數 | 所選時間範圍內的錯誤數量。 |
| 平均執行時間 (毫秒) | 資料庫處理查詢所需的平均時間 (以毫秒為單位)。 |
| 平均傳回的結果數 | 查詢傳回的結果數量。結果包括文件、集合 ID 和匯總值區。 |
| 平均掃描的文件數 | 查詢中掃描的文件數量。 |
| 平均掃描的索引項目數 | 為執行查詢而檢查的索引項目數量。 |
| 負載 (根據平均時間) | 根據平均延遲時間篩選出熱門查詢的資料。 |
| 負載 (根據總計 (可計費) 讀取作業數) | 根據可計費讀取作業總數,篩選出熱門查詢的資料。 |
| 索引建議 | Enterprise 版資料庫中查詢的建議複合索引、已用索引和預估工作負載影響。 |
資料精細程度和保留
資料精細程度取決於指定的期間:
- 間隔時間最長為 4 天前,精細程度為 10 分鐘
- 以 1 小時為單位,最長可回溯至 30 天前
查詢洞察的資料保留期限上限為 30 天。10 分鐘資料會儲存 4 天,每小時資料則會儲存 30 天。
查看查詢洞察
Firebase 控制台
- 如要查看 Cloud Firestore 資料庫的查詢洞察,請在 Google Cloud 控制台中開啟資料庫的「Query insights」(查詢洞察) 窗格。
在 Firebase 控制台中,前往「Firestore Database」頁面。
- 從資料庫清單中選取資料庫。
- 在分頁清單中,按一下「查詢洞察」。
如要根據延遲時間或讀取作業數量找出熱門查詢,請按一下「Latency」(延遲時間) 或「Read operations」(讀取作業)。
索引建議
Firestore Enterprise 版資料庫中,查詢洞察的索引建議會自動找出經常執行的查詢模式,並指出缺少或不理想的複合索引設定。
在 Firestore Enterprise 版中,即使沒有相符的複合索引,也能執行查詢,但可能會導致完整集合掃描或記憶體內排序作業速度緩慢。「查詢洞察」資訊主頁會分析歷來查詢執行統計資料,並建議指定複合索引,以最佳化查詢延遲時間,並減少計費掃描文件。
索引建議的運作方式
離線批次管道會定期評估熱門查詢記錄:
- 查詢結構分析:從經常執行的查詢中,擷取等式、排序和範圍述詞。
- 候選索引生成:使用索引排序經驗法則 (等式 > 排序 > 範圍),生成潛在複合式索引定義。
- 最佳化工具評估:將候選索引插入查詢引擎的成本模型,比較基準查詢執行成本與假設的索引執行計畫。
- 工作負載影響排名:根據預估的工作負載總節省費用,將建議的索引分為不同影響層級:
- 高:將完整集合掃描轉換為選擇性索引搜尋,大幅減少文件讀取次數和執行延遲時間。
- MEDIUM:提供預先排序的索引結果,省去記憶體內排序等高成本作業。
- 低:略微改善搜尋功能。
查看及建立建議的索引
如要查看索引建議,並透過 Firebase 控制台建立建議的索引,請按照下列步驟操作:在 Firebase 控制台中,前往「Firestore Database」頁面。
從資料庫清單中選取 Enterprise 版資料庫。
按一下「查詢洞察」分頁標籤。
在查詢表格中,找出有建議的查詢形狀,然後按一下資料列或彈出式視窗中的「Review Recommendations」(查看建議)。
在索引建議對話方塊中,查看複合索引定義、欄位排序,以及預估的工作負載影響層級 (「HIGH」、「MEDIUM」或「LOW」)。
按一下「儲存」。「Long-Running Operations (LRO)」(長時間執行的作業 (LRO)) 導覽匣會開啟,追蹤索引建構進度。
建構作業完成後,索引會列在「Indexes」(索引) 分頁下方,且建議指標會從查詢列中消失。
支援的版本
索引建議僅適用於 Firestore Enterprise 版資料庫。不支援 Standard 版資料庫。
限制
- 查詢洞察資料會延遲一到兩小時。
- 系統會根據歷來查詢資料定期產生索引建議,而非即時產生。
- 索引建議會建議新的複合式索引,不會建議修改或刪除現有索引。
- 不支援自動建立索引,必須手動建立建議的索引。
- 查詢正規化會將常值替換為預留位置。索引建議是根據正規化查詢範本產生,而非特定執行階段值。
- 費用評估會使用經驗法則,而非即時資料取樣。建議的索引不一定能在所有情境中提升效能,且建立索引會增加寫入和儲存負擔。
定價
使用查詢洞察或索引建議功能,無須額外付費。
必要的角色
如要取得查看「查詢洞察」資訊主頁和建立建議索引所需的權限,請要求管理員授予您專案的下列 IAM 角色:
- 如要查看查詢洞察:Datastore 檢視者 (
roles/datastore.viewer) - 如要建立建議的索引:資料儲存庫索引管理員 (
roles/datastore.indexAdmin) 或 Cloud Datastore 擁有者 (roles/datastore.owner)
這些預先定義的角色包含 datastore.insights.get 和 datastore.indexes.create 權限。