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

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

簡介

查詢洞察功能可協助您偵測、診斷及預防 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 版執行個體上使用查詢洞察功能，不會產生額外費用。

儲存空間需求

查詢洞察會儲存執行個體的指標資料，因此您必須啟用自動增加儲存空間設定。須支付適用的儲存空間費用。

限制

下列限制適用於 Cloud SQL Enterprise Plus 版本執行個體的查詢洞察：

• 如果執行個體承受大量系統負載，在「查詢洞察」資訊主頁中查詢指標資料時，查詢作業可能需要較長時間才能載入，或會逾時。
• 如果重新建立唯讀副本，重新建立的唯讀副本不會保留先前的指標記錄。
• 如果您使用舊備份還原執行個體，則可能會遺失備份時間和還原執行個體時間之間的指標，導致 Cloud SQL Enterprise Plus 版的查詢洞察功能無法使用。舉例來說，如果您在 4 月 30 日還原執行個體，並使用 4 月 25 日建立的備份檔，那麼 4 月 25 日到 4 月 30 日之間的所有指標可能會遺失。

事前準備

使用查詢洞察前，請先完成下列步驟。

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

必要角色和權限

如要取得存取查詢洞察資訊主控台歷來查詢執行資料所需的權限，請要求管理員在 Cloud SQL 執行個體所在的專案中，授予您下列 IAM 角色：

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

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

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

啟用 Cloud Trace API

如要查看查詢計畫和端對端檢視畫面， Google Cloud 專案 必須啟用 Cloud Trace API。這項設定可讓您的Google Cloud 專案接收來自已驗證來源的追蹤資料，且不需支付額外費用。這項資料有助於偵測及診斷執行個體的效能問題。

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

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

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

2. 點選「啟用 API 和服務」。
3. 在搜尋列中輸入 Cloud Trace API。
4. 如果畫面顯示「API enabled」(API 已啟用)，代表 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 \
--insights-config-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": "user@example.com",
  "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 資源、IO 資源或鎖定資源。資料庫查詢負載是指特定時間範圍內完成的所有查詢耗用的時間與實際時間的比率。

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

圖表中的彩色線條會顯示每個資料庫的負載 (根據執行時間)。查看圖表並使用篩選選項，瞭解下列問題：

• 查詢負載是否偏高？圖表是否會隨時間呈現尖峰或上升趨勢？如果沒有看到高負荷，表示問題與查詢無關。
• 負荷過高多久了？是現在才偏高，還是長期以來都偏高？使用範圍選取器選取不同時間範圍，瞭解問題持續時間。放大即可查看查詢負載尖峰時段。縮小時間軸，即可查看最多一週的資料。
• 哪個資料庫的負載過高？從「資料庫」下拉式選單選取不同資料庫，找出負載最高的資料庫。

篩選資料庫負載

• 所有查詢

• 資料庫

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

查看造成資料庫負載的因素

如要查看資料庫負載的主要貢獻者，可以使用「各資料庫負載的最大維度」表格。「資料庫負載中占比最大的維度」表格會顯示您在「依執行時間劃分的資料庫負載」圖表下拉式選單中選取的時間範圍和維度，並列出這些維度的主要影響因素。您可以修改時間範圍或維度，查看不同維度或時間範圍的主要貢獻者。

在「資料負載量最高的維度」表格中，您可以選取下列分頁標籤。

依查詢篩選

「各資料庫負載的最大維度」表格會概略顯示造成最多查詢負載的查詢。表格會顯示查詢洞察資訊主頁中，所選時間範圍和選項的所有正規化查詢。系統會依據您選取時間範圍內的總執行時間，排序查詢。

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

表格會顯示下列屬性：

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

查詢洞察只會儲存及顯示正規化查詢。

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

查詢計畫會擷取查詢樣本，並細分成個別作業。並說明及分析查詢中的每項作業。

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

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

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

請思考下列問題，盡量縮小問題範圍：

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": "user@example.com",
  "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 Instances」頁面。

   前往 Cloud SQL 執行個體

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

後續步驟

• 發布網誌：使用 Cloud SQL Enterprise Plus 版的最新查詢洞察功能，更快解決資料庫瓶頸
• 網誌：運用 Cloud SQL Insights 提升查詢效能疑難排解技能
• 影片：隆重推出 Cloud SQL Insights
• Podcast：Cloud SQL Insights
• 洞察資料程式碼研究室
• 最佳化高 CPU 使用率
• 最佳化高記憶體用量