使用查詢洞察改善查詢效能

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

簡介

查詢洞察可協助您偵測、診斷及預防 Cloud SQL 資料庫的查詢效能問題。這項功能支援直覺化的監控工具，並提供診斷資訊，協助您在偵測到效能問題後，進一步找出根本原因。

查詢洞察可協助您改善 Cloud SQL 查詢效能，方法是引導您完成下列步驟：

• 查看熱門查詢的資料庫負載
• 找出可能有問題的查詢

查詢 Cloud SQL Enterprise Plus 版的洞察資料

如果您使用的是 Cloud SQL Enterprise Plus 版本，則可以使用查詢洞察中的其他功能，執行進階查詢效能診斷作業。除了查詢洞察資訊資訊主頁的標準功能之外，Cloud SQL Enterprise Plus 版的查詢洞察資訊還可讓您執行下列操作：

• 擷取長達 20 KB 的查詢文字。
• 擷取所有已執行查詢的查詢計畫。
• 每分鐘最多可取樣 200 個查詢計畫。
• 將指標的保留時間延長至 30 天。
• 從索引顧問取得索引建議。
• 在執行中查詢中終止工作階段或長時間執行的交易。
• 使用 AI 輔助的疑難排解機制 (預先發布版)。

下表比較 Cloud SQL Enterprise 版的查詢洞察功能需求和功能，以及 Cloud SQL Enterprise Plus 版的查詢洞察功能。

為 Cloud SQL Enterprise Plus 版本啟用查詢洞察資料

如要為 Cloud SQL Enterprise Plus 版本啟用查詢洞察，請在 Cloud SQL Enterprise Plus 版本執行個體上啟用查詢洞察時，選取「啟用 Enterprise Plus 功能」。

定價

您無須額外付費，即可在 Cloud SQL Enterprise 或 Cloud SQL Enterprise Plus 版本的執行個體上查看查詢洞察資料。

儲存空間需求

查詢洞察資料會在執行個體上儲存指標資料，且需要您持續啟用自動增加儲存空間設定。須支付適用的儲存空間費用。

事前準備

使用查詢深入分析功能前，請先完成下列步驟。

1. 新增必要角色和權限。
2. 啟用 Cloud Trace API。
3. 如果您使用的是 Cloud SQL Enterprise 版本的查詢洞察或 Cloud SQL Enterprise Plus 版本的查詢洞察，請確認已為執行個體啟用自動增加儲存空間功能。

必要角色和權限

如要使用查詢洞察資料，您必須授予預先定義的角色、建立自訂角色，或是為使用者帳戶提供必要的 Identity and Access Management 權限。

如要進一步瞭解如何授予角色，請參閱「管理存取權」。

如要取得在「查詢深入分析」資訊主頁存取歷史查詢執行資料所需的權限，請要求管理員在代管 Cloud SQL 執行個體的專案中，授予您下列 IAM 角色：

• 資料庫洞察資料監控檢視器 (roles/databaseinsights.monitoringViewer)
• Cloud SQL Viewer (roles/cloudsql.viewer)

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

這些預先定義的角色具備查詢洞察資訊資訊主頁中查詢執行資料所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

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

• Cloud SQL 編輯器 (roles/cloudsql.editor)
• Cloud SQL 管理員 (roles/cloudsql.admin)

啟用 Trace API

如要查看查詢計畫及其端對端檢視畫面， Google Cloud 專案必須啟用 Trace API。這項設定可讓您的Google Cloud 專案免費接收來自已驗證來源的追蹤記錄資料。這項資料可協助您偵測及診斷執行個體的效能問題。

如要確認是否已啟用 Trace API，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「API 和服務」：

   前往「APIs and Services」(API 和服務) 頁面

2. 點選「啟用 API 和服務」。
3. 在搜尋列中輸入 Trace API。
4. 如果畫面顯示「API enabled」，表示這個 API 已啟用，您不需採取任何行動。如果畫面未顯示這項資訊，請按一下「Enable」。

啟用自動增加儲存空間

如果您使用的是 Cloud SQL Enterprise Plus 版的查詢洞察功能，請確認執行個體的自動增加儲存空間功能設定仍處於啟用狀態。根據預設，Cloud SQL 執行個體會啟用這個選項。

如果您先前已停用此執行個體設定，但想為 Cloud SQL Enterprise Plus 版本啟用查詢洞察功能，請先重新啟用自動增加儲存空間功能。您無法關閉自動增加儲存空間功能，也無法為 Cloud SQL Enterprise Plus 版本啟用查詢洞察資料。

啟用查詢洞察

啟用查詢深入分析後，所有其他作業都會暫時停止。這些作業包括健康檢查、記錄、監控和其他執行個體作業。

    gcloud sql instances patch INSTANCE_ID \
    --insights-config-query-insights-enabled
  

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--query_plans_per_minute=QUERY_PLANS_PER_MINUTE \
--tier=API_TIER_STRING \
--region=REGION
  

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings" : {
     "insightsConfig" : {
       "queryInsightsEnabled" : true,
       "recordClientAddress" : true,
       "queryStringLength" : 1024,
       "queryPlansPerMinute" : 20,
   }
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2025-03-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

指標應在查詢完成後幾分鐘內，出現在查詢深入分析中。

查看「查詢洞察」資訊主頁

「查詢洞察」資訊主頁會根據您選取的因素，顯示查詢負載。查詢負載可用於測量執行個體在所選時間範圍內，所有查詢產生的總工作量。資訊主頁提供一系列篩選器，方便您查看查詢負載。

如要開啟「查詢深入分析」資訊主頁，請按照下列步驟操作：

1. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
2. 在 Cloud SQL 導覽選單中，按一下「查詢洞察」，或在「執行個體總覽」頁面中按一下「前往查詢洞察，進一步瞭解查詢和效能」。

系統會開啟「查詢洞察」資訊主頁。視您是使用 Cloud SQL Enterprise 版本的查詢洞察，還是 Cloud SQL Enterprise Plus 版本的查詢洞察，查詢洞察資訊主頁會顯示以下有關執行個體的資訊：

• 資料庫：篩選特定資料庫或所有資料庫的查詢負載。
• 時間範圍：依時間範圍篩選查詢負載，例如 1 小時、6 小時、1 天、7 天、30 天或自訂範圍。
• 資料庫負載圖表：根據篩選的資料顯示查詢負載圖表。
• 查詢和資料庫：依所選查詢或資料庫篩選查詢負載。請參閱篩選資料庫負載。

查看所有查詢的資料庫負載

資料庫查詢負載是指在所選資料庫中，執行查詢作業過去一段時間的衡量指標，以 CPU 使用秒數為單位。每個執行中的查詢都會使用或等待 CPU 資源、I/O 資源或鎖定資源。資料庫查詢負載是指特定時間範圍內完成的所有查詢耗用的時間與實際時間的比率。

頂層查詢洞察資訊主頁會顯示「資料庫負載 (依執行時間劃分)」圖表。您可以使用資訊主頁的下拉式選單，篩選所有資料庫或特定資料庫的圖表。

圖表中的彩色線條代表每個資料庫負載的執行時間。查看圖表並使用篩選選項，探索下列問題：

• 查詢負載是否很高？圖表是否會隨時間推移而出現尖峰或升高？如果您沒有看到高負載，表示問題並非出在查詢。
• 負載高峰持續多久？是現在才高，還是長期以來都很高？使用範圍選取器選取各種時間範圍，找出問題持續多久。放大即可查看發生查詢負載尖峰的時間範圍。縮小時間軸，最多可查看一週的時間軸。
• 哪個資料庫發生負載問題？從「資料庫」下拉式選單中選取不同的資料庫，找出負載量最高的資料庫。

篩選資料庫負載

• 所有查詢

• 資料庫

如要自訂資料庫負載圖表，請從「資料庫負載 (根據執行時間)」下拉式選單中選取一個維度。

查看資料庫負載的主要因素

如要查看資料庫負載的最大貢獻者，可以使用「各資料庫負載的最大維度」表格。「依資料庫負載排序的前幾個維度」表格會顯示您在「依執行時間排序的資料庫負載」圖表下拉式選單中選取的時間範圍和維度中，占比最大的因素。您可以修改時間範圍或維度，查看不同維度或時間範圍的頂尖貢獻者。

在「依資料負載排序的熱門維度」表格中，您可以選取下列分頁。

依查詢篩選

「Top queries」表格會概略說明造成最多查詢負載的查詢。表格會顯示所選時間範圍內的所有標準化查詢，以及在「查詢洞察」資訊主頁上選取的選項。並依據您選取的時間範圍內的總執行時間排序查詢。

如要排序表格，請選取資料欄標題。

下表列出以下屬性：

• Query：標準化查詢字串。根據預設，查詢洞察資料只會顯示查詢字串中的 1024 個字元。
• 資料庫：執行查詢的資料庫。
• 最佳化建議：建議的最佳化建議，例如建立索引，可改善查詢效能。
• 平均執行時間 (毫秒)：查詢的平均執行時間。
• 總執行時間 (毫秒)：查詢的總執行時間。
• 呼叫次數：應用程式呼叫查詢的次數。
• 平均傳回列數：查詢傳回的平均列數。

查詢洞察資料儲存庫，並只顯示已規格化的查詢。

檢查取樣查詢計畫中的作業

查詢計畫會擷取查詢範例，並將其細分為個別作業。並說明及分析查詢中的每項作業。

「查詢計畫樣本」圖表會顯示在特定時間執行的所有查詢計畫，以及每個計畫的執行時間。您可以變更每分鐘擷取查詢方案樣本的頻率。請參閱啟用查詢洞察。

根據預設，右側面板會顯示花費最長時間的查詢計畫樣本詳細資料，如「查詢計畫樣本」圖表所示。如要查看其他查詢計畫的詳細資料，請按一下圖表中的相關圓圈。展開詳細資料後，您會看到查詢計畫中所有作業的模型。

每項作業都會顯示傳回的資料列，以及作業費用 (如有)。您可以使用全螢幕檢視畫面或「End-to-end」分頁，查看每個節點 (作業) 的預估執行統計資料，以及與根節點相關的執行階段執行統計資料。

請嘗試回答以下問題，以便縮小問題範圍：

1. 資源用量為何？
2. 與其他查詢的關係為何？
3. 消費量是否會隨時間而變化？

查詢詳細資料功能

查詢詳細資料可提供特定查詢的詳細資訊，包括平均執行時間、呼叫次數和傳回的平均列數。還可提供索引等最佳化建議，協助改善查詢效能。

查詢詳細資料也會提供下列指標：

• 查詢計畫範例：這些範例會針對查詢範例細分其中的各項作業，藉此說明及分析您的查詢。

  

• 一段時間內的查詢執行次數：顯示在指定時間範圍內完成查詢的次數。這張圖表有助您進一步瞭解查詢通常執行的時間，並可協助您估算查詢對執行個體效能造成的影響。

  

• 一段時間內平均傳回的資料列數：顯示一段時間內查詢傳回的平均資料列數。這項資料可協助您將查詢速度比平常慢，與這些查詢傳回的資料量增加做連結。

  

• I/O 統計資料：顯示查詢的輸入和輸出統計資料，包括下列篩選器：
  • 平均邏輯讀取次數
  • 平均實體讀取次數
  • 平均邏輯寫入次數

  您可以使用 I/O 指標，瞭解與平常查詢速度較慢的關聯性，並瞭解 I/O 用量或 I/O 模式變化情形。

  舉例來說，如果邏輯讀取次數增加，可能表示查詢開始讀取比平常更多的資料。如果實際讀取次數增加，表示 Cloud SQL 開始從磁碟讀取更多資料，而非從緩衝區快取讀取。舉例來說，可能記憶體不足以快取所有資料，或是執行個體開始讀取過多資料。如果邏輯寫入次數增加，可能表示查詢開始將更多資料寫入資料磁碟。

  以下是這項指標如何協助評估查詢對執行個體 I/O 的影響。

  

• 記憶體統計資料：顯示查詢的記憶體用量統計資料，包括下列篩選器：
  • 平均理想記憶體用量
  • 平均預留記憶體
  • 平均記憶體用量

  這項指標可協助您偵測與查詢相關的記憶體用量變化，包括下列範例：

  • 使用這個指標偵測 Cloud SQL 是否誤判執行查詢所需的記憶體用量，並可能保留比查詢所需更多記憶體。
  • 使用這項指標偵測 Cloud SQL 無法配置足夠記憶體，並保留較小記憶體授予量。在這種情況下，Cloud SQL 會使用 tempdb 資料庫，這比使用記憶體更慢。
  • 請搭配使用這項指標和查詢執行次數，評估查詢對執行個體記憶體用量造成的影響。
  • 當您發現記憶體用量或記憶體壓力偏高時，請使用此指標。

  

• CPU 作業時間和執行時間統計資料：顯示查詢的 CPU 作業時間和執行時間統計資料。您可以使用 CPU 時間指標，調查執行個體的高 CPU 使用率，包括下列範例：
  • 您可以結合 CPU 時間和執行次數指標，評估查詢對執行個體中 CPU 總用量產生的影響。
  • 您可以結合 CPU 時間、執行時間和平行處理指標，評估查詢等待資源的時間百分比。
  • 您可以使用執行時間指標，偵測查詢的執行時間是否比平常長。

  

• 其他查詢統計資料：顯示與查詢相關的其他統計資料，包括下列篩選器：
  • 通用語言執行階段 (CLR) 統計資料
  • 資料欄儲存庫統計資料
  • 記憶體溢寫
  • 平行處理作業統計資料

  

停用查詢洞察

gcloud sql instances patch INSTANCE_ID \
  --no-insights-config-query-insights-enabled

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

停用 Cloud SQL Enterprise Plus 版本的查詢洞察功能

如要停用 Cloud SQL Enterprise Plus 版的查詢洞察，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Cloud SQL 執行個體」頁面。

   前往 Cloud SQL 執行個體

2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
3. 按一下 [編輯]。
4. 在「自訂執行個體」專區中，展開「查詢洞察資料」。
5. 取消勾選「Enable Enterprise Plus features」(啟用 Enterprise Plus 功能) 核取方塊。
6. 按一下 [儲存]。

後續步驟

• 推出網誌：透過 Cloud SQL Enterprise Plus 最新的查詢洞察資料，更快解決資料庫瓶頸
• 網誌：運用 Cloud SQL Insights 提升查詢效能疑難排解技巧
• 影片：隆重推出 Cloud SQL Insights
• Podcast：Cloud SQL Insights
• 深入分析程式碼研究室
• 降低 CPU 使用率
• 改善高記憶體用量