分析查詢效能統計資料

本頁面說明如何使用「查詢洞察」資訊主頁偵測及分析查詢效能。

查詢洞察總覽

使用「查詢洞察」資訊主頁,監控與指標相關的查詢。您可以根據指標,找出最常使用的查詢,以及可能需要最佳化的高延遲查詢。使用查詢洞察資訊主頁,可協助您:

  • 查詢效能最佳化:找出延遲時間過長且可能需要最佳化的查詢。
  • 查詢費用管理:找出高費用查詢並加以最佳化,降低費用。
  • 查詢統計資料監控:追蹤一段時間內的查詢統計資料。
  • 索引建議:找出遺漏或不理想的複合式索引,並直接從資訊主頁建立建議的索引 (Enterprise 版)。

查詢洞察資料

查詢洞察包含下列 API 方法的資料:

您可以查看特定專案、資料庫和時間長度 (1 分鐘到 30 天) 內,使用這些方法的查詢資料。結構相同的查詢資料會彙整至單一正規化查詢。

查詢洞察會傳回下列查詢相關資訊:

正規化查詢文字 以文字表示的查詢結構。
執行次數 所選時間範圍內的執行作業數。
錯誤數 所選時間範圍內的錯誤數量。
平均執行時間 (毫秒) 資料庫處理查詢所需的平均時間 (以毫秒為單位)。
平均傳回的結果數 查詢傳回的結果數量。結果包括文件、集合 ID 和匯總值區。
平均掃描的文件數 查詢中掃描的文件數量。
平均掃描的索引項目數 為執行查詢而檢查的索引項目數量。
負載 (根據平均時間) 根據平均延遲時間篩選出熱門查詢的資料。
負載 (根據總計 (可計費) 讀取作業數) 根據可計費讀取作業總數,篩選出熱門查詢的資料。
索引建議 Enterprise 版資料庫中查詢的建議複合索引、使用中的索引,以及預估工作負載影響。

資料精細程度和保留

資料精細程度取決於指定的期間:

  • 間隔時間最長為 6 小時前,精細程度為 1 分鐘
  • 間隔時間最長為 4 天前,精細程度為 10 分鐘
  • 以 1 小時為單位,最長可回溯至 30 天前

查詢洞察的資料保留期限上限為 30 天。1 分鐘資料會儲存 6 小時,10 分鐘資料會儲存 4 天,每小時資料則會儲存 30 天。

查看查詢洞察

如要查看 Firestore 資料庫的查詢洞察,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Databases」(資料庫) 頁面。

    前往「資料庫」

  2. 從資料庫清單中選取資料庫。

  3. 在導覽選單中,點選「查詢洞察」。

「Query insights」(查詢洞察) 頁面會顯示熱門查詢的時間序列圖,以及正規化查詢統計資料表。如要分析查詢效能,請按照下列步驟操作:

  • 選取時間範圍,即可查看歷來趨勢或近乎即時的指標 (間隔 1 分鐘)。
  • 使用「Load type」(負載類型) 清單,依平均延遲時間或讀取作業總數,將熱門查詢排序。
  • 在表格中選取個別查詢,即可在圖表上繪製及比較執行次數、延遲時間、掃描的文件、掃描的索引項目和錯誤次數。

索引建議

Firestore Enterprise 版資料庫中,查詢洞察的索引建議會自動找出經常執行的查詢模式,並指出缺少或不理想的複合索引設定。

在 Firestore Enterprise 版中,即使沒有相符的複合索引,也能執行查詢,但可能會導致完整集合掃描或記憶體內排序作業速度緩慢。「查詢洞察」資訊主頁會分析歷來查詢執行統計資料,並建議指定複合索引,以最佳化查詢延遲時間,並減少計費掃描文件。

索引建議的運作方式

離線批次管道會定期評估熱門查詢記錄:

  • 查詢結構分析:從經常執行的查詢中,擷取等式、排序和範圍述詞。
  • 候選索引生成:使用索引排序經驗法則 (等式 > 排序 > 範圍),生成潛在複合式索引定義。
  • 最佳化工具評估:將候選索引插入查詢引擎的成本模型,比較基準查詢執行成本與假設的索引執行計畫。
  • 工作負載影響排名:根據預估的工作負載總節省費用,將建議的索引分為不同影響層級:
    • 高:將完整集合掃描轉換為選擇性索引搜尋,大幅減少文件讀取次數和執行延遲時間。
    • MEDIUM:提供預先排序的索引結果,省去記憶體內排序等高成本作業。
    • 低:略微改善搜尋功能。
如要透過Google Cloud 控制台查看索引建議並建立建議的索引,請按照下列步驟操作:

  1. 在 Google Cloud 控制台中,前往「Databases」(資料庫) 頁面。

    前往「資料庫」

  2. 從資料庫清單中選取 Enterprise 版資料庫。

  3. 在導覽選單中,點選「查詢洞察」。

  4. 在查詢資料表中,選取查詢模式即可查看其「Recommendations」(建議) 資訊卡。資訊卡會顯示:

    • 建議的複合式索引定義 (集合、欄位、排列順序或 array-contains 屬性)。
    • 預估的工作負載影響層級 (HIGH、MEDIUM 或 LOW)。
    • 使用的索引,或表示已執行完整集合掃描。
  5. 按一下建議資訊卡上的「建立索引」。系統會開啟對話方塊,並預先填入集合、查詢範圍和欄位。

  6. 按一下「建立」,開始建立索引。您可以在 Google Cloud 控制台的「Indexes」(索引) 頁面,監控索引建立進度。

支援的版本和模式

Firestore Enterprise 版資料庫支援索引建議,包括:

  • 原生模式的 Firestore
  • 與 MongoDB 相容的 Firestore

Standard 版資料庫不支援索引建議。

限制

  • 查詢洞察統計資料不含即時監聽器。
  • 執行查詢後,幾分鐘內即可取得查詢洞察資料。
  • 系統會根據歷來查詢資料定期產生索引建議,而非即時產生。
  • 索引建議會建議新的複合式索引,不會建議修改或刪除現有索引。
  • 不支援自動建立索引,必須手動建立建議的索引。
  • 查詢正規化會將常值替換為預留位置。索引建議是根據正規化查詢範本產生,而非特定執行階段值。
  • 費用評估會使用經驗法則,而非即時資料取樣。建議的索引不一定能在所有情況下提高效能,而且建立索引會增加寫入和儲存負擔。

定價

查詢洞察或索引建議不會產生額外費用。

必要的角色

如要取得查看查詢洞察資訊主頁及建立建議索引所需的權限,請要求管理員授予您專案的下列 IAM 角色:

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備查看查詢洞察資訊主頁和建立建議索引所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

您必須具備下列權限,才能查看「查詢洞察」資訊主頁及建立建議的索引:

  • 查看查詢洞察:datastore.insights.get
  • 建立建議的索引:
    • datastore.indexes.create
    • datastore.indexes.update

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

後續步驟