疑難排解

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

執行 gcloud sql operations list 指令，即可列出指定 Cloud SQL 執行個體的所有作業。

查看記錄並篩選文字，找出使用者。您可能需要使用稽核記錄來處理私人資訊。相關記錄檔案包括：

• cloudsql.googlapis.com/mysql-general.log
• cloudsql.googleapis.com/mysql.err
• 如果已啟用 Cloud 稽核記錄，且您具備查看記錄的必要權限，cloudaudit.googleapis.com/activity 也可能會顯示。

如果您刪除執行個體時沒有備份最終資料，就無法復原資料。不過，如果您還原執行個體，Cloud SQL 也會還原備份。如要進一步瞭解如何復原已刪除的執行個體，請參閱「還原備份資料」。

如果您已執行匯出作業，請建立新的例項，然後執行匯入作業來重新建立資料庫。匯出內容會寫入 Cloud Storage，匯入內容則會從 Cloud Storage 讀取。

如果您確實需要取消作業，可以請 客戶服務團隊force restart執行個體。

請先 建立資料庫使用者，再還原 SQL 傾印內容。

如要無限期保留備份，您可以建立隨選備份，因為系統不會以與自動備份相同的方式刪除隨選備份。隨選備份會無限期保留。也就是說，這些備份會一直存在，直到您刪除備份或刪除其所屬的執行個體為止。由於這類備份不會自動刪除，因此可能會影響計費。

您嘗試取消已完成、失敗或已取消的匯入或匯出作業。如果作業正在執行，您可以取消作業。

Cloud SQL 不支援作業的取消作業，因為它具有 IMPORT 或 EXPORT 以外的作業類型。

Cloud SQL 目前無法取消匯入或匯出作業。 請稍後再試。如果問題仍未解決，請與Google Cloud 支援團隊聯絡。

請盡可能從 Cloud SQL 執行個體中移除所有 Authorized Networks 項目。否則，請建立副本，但不含任何 Authorized Networks 項目。

您嘗試使用 Google Cloud 控制台複製具有私人 IP 位址的執行個體，但未指定要使用的已分配 IP 範圍，且來源執行個體並未使用指定範圍建立。因此，複製的執行個體會在隨機範圍內建立。

使用 gcloud 複製執行個體，並為
--allocated-ip-range-name 參數提供值。詳情請參閱「複製具有私人 IP 的執行個體」。

• 網路不穩定。
• 對 TCP 保活指令沒有回應 (用戶端或伺服器沒有回應，可能已超載)
• 資料庫引擎連線逾時，因此伺服器會終止連線。

應用程式必須能容許網路失敗，並遵循最佳做法，例如連線集區和重試。大多數連線集區會盡可能擷取這些錯誤。否則，應用程式必須重新嘗試或優雅失敗。

針對連線重試，我們建議採用下列方法：

1. 指數輪詢。每次重試之間的時間間隔會以指數方式增加。
2. 也新增隨機退避。

結合這些方法有助於減少頻寬限制。

用戶端憑證已過期，或憑證路徑不正確。

重新建立憑證。

• 私人服務連線的已分配 IP 範圍大小小於 /24。
• 私人服務連線的 IP 範圍大小，相較於 Cloud SQL 執行個體的數量太小。
• 如果在多個區域中建立執行個體，則所需的 IP 範圍大小會更大。請參閱「已指派的範圍大小」

如要解決這個問題，您可以擴展現有的 IP 範圍，也可以為私人服務連線分配額外的 IP 範圍。詳情請參閱「分配 IP 位址範圍」。

如果您在建立 Cloud SQL 執行個體時使用 --allocated-ip-range-name 標記，則只能擴大指定的 IP 範圍。

如果您要分配新的範圍，請注意分配範圍不得與任何現有分配重疊。

建立新的 IP 範圍後，請使用下列指令更新 VPC 配對：

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com \
--ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID \
--force
    

如果要擴大現有分配範圍，請務必只增加分配範圍，不要縮小分配範圍。舉例來說，如果原始分配範圍為 10.0.10.0/24，則新分配範圍至少應為 10.0.10.0/23。

一般來說，如果從 /24 分配開始，針對每個條件 (額外的執行個體類型群組、額外的區域) 將 /mask 遞減 1 是一個不錯的經驗法則。舉例來說，如果您嘗試在相同的配置中建立兩個執行個體類型群組，從 /24 改為 /23 就足夠了。

擴充現有 IP 範圍後，請使用下列指令更新 VPC 對等連線：

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com \
--ranges=RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID
    

使用下列指令啟用 Service Networking API，然後再次嘗試建立 Cloud SQL 執行個體。

gcloud services enable servicenetworking.googleapis.com \
--project=PROJECT_ID
    

請確認您要新增至 Cloud SQL 執行個體伺服器憑證的 DNS 名稱符合下列條件：

• 不含萬用字元。
• 不含結尾的句點。
• 符合 RFC 1034 規格。

使用 CSV 匯出功能，只匯出所需資料。

使用 匯出卸載功能。在匯出卸載作業中，Cloud SQL 不會在來源執行個體上發出匯出作業，而是會啟動卸載執行個體來執行匯出作業。匯出卸載有許多優點，包括提升來源執行個體的效能，以及在匯出作業執行期間解除封鎖管理作業。使用匯出卸載功能時，總延遲時間可能會因啟動卸載執行個體所需的時間而增加。一般來說，如果匯出檔案的大小適中，延遲時間就不會太嚴重。不過，如果匯出內容的大小不大，您可能會發現延遲時間增加。

您可以使用 Google Cloud產品 (例如 Cloud Scheduler、Pub/Sub 和 Cloud Run 函式) 建構自己的自動匯出系統，類似於本文中說明的 自動備份。

確認外部主要裝置可連線。 您也可以修改來源執行個體的 net_read_timeout 和 net_write_timeout 標記值，以停止錯誤。如要進一步瞭解這些旗標的可用值，請參閱「設定資料庫旗標」。

如要進一步瞭解如何使用 mysqldump 標記來進行受管理的匯入遷移作業，請參閱「 允許的初始同步處理標記和預設標記」一文。

請確認 binlog-do-db、binlog-ignore-db、replicate-do-db 或 replicate-ignore-db 等複製標記並未以衝突的方式設定。

在主要執行個體上執行 show master status 指令，即可查看目前的設定。

• 在 Google Cloud 控制台的「Cloud Monitoring」專區中，查看複本執行個體的 複製指標。
• 您可以在 mysql.err log 檔案的 Cloud Logging 中，找到 MySQL IO 執行緒或 SQL 執行緒的錯誤。
• 連線到複本執行個體時，也會發生這個錯誤。 執行 SHOW SLAVE STATUS 指令，並在輸出內容中檢查下列欄位：
  • Slave_IO_Running
  • Slave_SQL_Running
  • Last_IO_Error
  • Last_SQL_Error

增加複本執行個體的磁碟空間。您可以手動增加磁碟大小，也可以啟用儲存空間自動增加功能。

使用正確的標記設定建立新的傾印檔案，然後使用該檔案設定外部複本

1. 透過 Compute Engine 執行個體連線至 mysql 用戶端。
2. 執行 mysqldump，並使用 --master-data=1 和 --flush-privileges 標記。

   重要事項：請勿加入 --set-gtid-purged=OFF 旗標。

   瞭解詳情。

3. 確認剛建立的傾印檔案包含 SET @@GLOBAL.GTID_PURGED='...' 行。
4. 將轉儲檔案上傳至 Cloud Storage 值區，然後 使用轉儲檔案設定備用資源。

編輯執行個體，升級至較大的機器大小，以便取得更多 CPU 和記憶體。

關閉未使用的作業。請檢查 Cloud SQL 執行個體的 CPU 和記憶體用量，確保有充足的資源可供使用。如要確保匯入作業有最多資源可用，請先重新啟動執行個體，再開始執行作業。

重新啟動：

• 關閉所有連線。
• 結束可能會耗用資源的工作。

請先 建立資料庫使用者，再匯入資料。

建議做法：

在轉儲檔案開頭處加入以下這一行：

SET FOREIGN_KEY_CHECKS=0;
  

此外，請在轉儲檔案的結尾處新增這一行：

SET FOREIGN_KEY_CHECKS=1;
  

這些設定會在匯入作業進行時停用資料完整性檢查，並在資料載入後重新啟用。這不會影響資料庫中資料的完整性，因為資料在建立轉儲檔案時已完成驗證。

例如，使用者遭到刪除，但您無法找出刪除者。 記錄顯示作業已開始，但沒有提供其他資訊。您必須啟用稽核記錄功能，才能記錄這類詳細的個人識別資訊 (PII)。

連線至資料庫並執行下列指令，瞭解每種類型的詳細資訊：

SHOW VARIABLES LIKE 'innodb_log_file%';

SELECT ROUND(SUM(LENGTH(argument)/POW(1024,2),2)
AS GB from mysql.general_log;

SHOW BINARY LOGS;
    

如要以 JSON 格式下載記錄，請按照下列步驟操作：

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json
    

如要將記錄下載為文字檔，請按照下列步驟操作：

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt
   

如要查看一般記錄的大小，請連線至資料庫並執行以下查詢：

建議做法：

• 您可以在 MySQL 指令列介面中使用下列指令，查看二進位記錄檔所占用的儲存空間： SHOW BINARY LOGS;
• 臨時資料表也可能會占用大量儲存空間。如要查看暫時性空間使用情形，請使用下列指令：SELECT * FROM INFORMATION_SCHEMA.FILES WHERE TABLESPACE_NAME='innodb_temporary'\G。
• 您可以使用下列指令檢查重做記錄大小： SHOW VARIABLES LIKE 'innodb_log_file%';
• 您可以使用這個指令檢查 general_log 的大小 (如果已啟用)：SELECT ROUND(SUM(LENGTH(argument)/POW(1024,2)),2) AS GB from mysql.general_log;
• 如有需要，您可以使用 API 截斷記錄資料表。詳情請參閱 instances.truncateLog 參考資料頁面。
• 進一步瞭解如何設定和 設定慢速查詢記錄。

連線至資料庫並執行以下查詢：

SHOW PROCESSLIST。

清單中的第一個項目可能會是持有鎖定項目的項目，後續項目會等待該項目。

SHOW INNODB STATUS 查詢也可能很有幫助。

SELECT * FROM INFORMATION_SCHEMA.FILES WHERE TABLESPACE_NAME='innodb_temporary'\G

連線至資料庫並執行下列查詢：

SELECT TABLE_SCHEMA, TABLE_NAME, sum(DATA_LENGTH+INDEX_LENGTH)/pow(1024,2) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA NOT IN ('PERFORMANCE_SCHEMA','INFORMATION_SCHEMA','SYS','MYSQL') GROUP BY TABLE_SCHEMA, TABLE_NAME;

盡可能分割執行個體。使用多個小型 Cloud SQL 執行個體，效果會比使用單個大型的執行個體更好。

重新啟動會刪除暫存檔，但不會減少儲存空間。只有 客戶服務團隊可以重設執行個體大小。

在刪除時間附近的記錄中查看，看看是否有從資訊主頁或其他自動化程序執行的不明指令碼。

可能的原因包括：

• 正在處理另一項作業。Cloud SQL 作業不會同時執行。等待其他作業完成。
• 只要使用至少一個 beta 標記，就會觸發 INSTANCE_RISKY_FLAG_CONFIG 警告。移除風險性旗標設定並重新啟動執行個體

很抱歉，除了重新啟動服務之外，您無法以任何其他方法縮減 ibtmp1 檔案。

其中一個因應做法是使用 ROW_FORMAT=COMPRESSED 建立臨時資料表，以便將其儲存在臨時檔案目錄中的個別資料表檔案表空間中。不過，缺點是為每個臨時資料表建立和移除個別檔案表格空間時，會產生效能成本。

如果執行個體的儲存空間用盡，且未啟用自動增加儲存空間功能，執行個體就會離線。如要避免這個問題，您可以 編輯執行個體，啟用自動增加儲存空間功能。

透過連線持續時間不超過 60 秒，可避免大部分不正常關閉的情況，包括來自資料庫指令提示的連線。如果這些連線保持開啟狀態數小時或數天，關機時可能會發生不正常情形。

找出哪些物件依附於使用者，然後將這些物件刪除或重新指派給其他使用者。

請參閱 一般成效提示。

針對較慢的資料庫插入、更新或刪除作業，請考慮採取下列行動：

• 如果啟用 long_query_time 標記，您可以檢查記錄檔，找出執行速度緩慢的查詢。前往專案的「Logs Explorer」頁面，執行以下查詢：

  resource.type="cloudsql_database"
  resource.labels.database_id="INSTANCE-ID"
  log_name="projects/PROJECT-ID/logs/cloudsql.googleapis.com%2Fmysql-slow.log"
        

  您可以 下載 JSON 或 TEXT 格式的記錄，以便在本機處理。

• 請檢查寫入者和資料庫的位置；長距離傳送資料會導致延遲發生。
• 檢查讀取器和資料庫的位置；延遲時間對讀取效能的影響，比寫入效能更為顯著

為降低延遲，建議您將來源和目的地資源都放在同一個區域。

除了工作負載之外，還有其他因素可能會影響記憶體用量，例如有效連線數量和內部額外程序。這些資訊不一定會顯示在監控圖表中。

請確保執行個體有足夠的額外負擔，可處理您的工作負載。

如要保存資料，請在 刪除執行個體之前， 將資料匯出至 Cloud Storage。

Cloud SQL 管理員角色包含刪除執行個體的權限。為避免意外刪除，請只在必要時授予這個角色。

您也可以透過其他方式建立新例項來達成目標。

• 您可以複製要重新命名的執行個體，並為複製的執行個體設定新名稱。這樣一來，您就能建立新例項，而無須手動匯入資料。就像建立新執行個體一樣，複製的執行個體也會有新的 IP 位址。
• 您可以將執行個體中的資料匯出至 Cloud Storage 值區，然後使用所需的新名稱建立新的執行個體，再將資料匯入新執行個體。

無論是哪種情況，您都可以在作業完成後刪除舊的執行個體。我們建議您採用複製方式，因為這種方式不會影響效能，也不需要您重新設定任何執行個體設定，例如標記、機器類型、儲存空間大小和記憶體。

1. 查看端點的狀態。

   gcloud

   如要查看狀態，請使用
   gcloud compute forwarding-rules describe 指令。

   gcloud compute forwarding-rules describe ENDPOINT_NAME \
   --project=PROJECT_ID \
   --region=REGION_NAME \
   | grep pscConnectionStatus

   請將以下項目改為對應的值：

   • ENDPOINT_NAME：端點名稱
   • PROJECT_ID：包含端點的 Google Cloud 專案 ID 或專案編號
   • REGION_NAME：端點的區域名稱

   REST

   使用任何要求資料之前，請先替換以下項目：

   • PROJECT_ID：包含 Private Service Connect 端點的 Google Cloud 專案 ID 或專案編號
   • REGION_NAME：區域名稱
   • ENDPOINT_NAME：端點名稱

   HTTP 方法和網址：

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME

   如要傳送要求，請展開以下其中一個選項：

   curl (Linux、macOS 或 Cloud Shell)

   執行下列指令：

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME"

   PowerShell (Windows)

   執行下列指令：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME" | Select-Object -Expand Content

   您應該會收到如下的 JSON 回應：

   {
     "kind": "compute#forwardingRule",
     "id": "ENDPOINT_ID",
     "creationTimestamp": "2024-05-09T12:03:21.383-07:00",
     "name": "ENDPOINT_NAME",
     "region": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME",
     "IPAddress": "IP_ADDRESS",
     "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_NAME",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME",
     "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
     "serviceDirectoryRegistrations": [
       {
         "namespace": "goog-psc-default"
       }
     ],
     "networkTier": "PREMIUM",
     "labelFingerprint": "LABEL_FINGERPRINT_ID",
     "fingerprint": "FINGERPRINT_ID",
     "pscConnectionId": "CONNECTION_ID",
     "pscConnectionStatus": "ACCEPTED",
     "allowPscGlobalAccess": true
   }
   

2. 確認端點的狀態為 ACCEPTED。如果狀態為 PENDING，則表示執行個體不允許包含端點的 Google Cloud 專案。請確認建立端點的網路專案是否允許端點。詳情請參閱「編輯已啟用 Private Service Connect 的執行個體」。

首先，請確認 max_connections 標記的值大於或等於主要執行個體的值。

如果 max_connections 標記設定正確，請在 Cloud Logging 中檢查記錄，找出實際錯誤。

如果錯誤為 set Service Networking service account as servicenetworking.serviceAgent role on consumer project，請停用再重新啟用 Service Networking API。這個動作會建立繼續程序所需的服務帳戶。

重新啟動複本執行個體，以便回收暫時性記憶體空間。

編輯執行個體，啟用 automatic storage increase。

• 複本上的查詢速度緩慢。找出並修正這些問題。
• 所有資料表都必須有專屬/主索引鍵。在這種沒有唯一/主鍵的資料表上進行的每項更新，都會導致備援資料庫進行完整資料表掃描。
• DELETE ... WHERE field < 50000000 這類查詢會導致以列為基礎的複製作業出現延遲，因為複本上會累積大量更新。

可能的解決方法包括：

• 設定平行複製功能。
• 將唯讀備用資源的 innodb_flush_log_at_trx_commit 標記設為 2。

  如要進一步瞭解此標記，請參閱使用標記的提示。

• 編輯執行個體，以增加複本的大小。
• 降低資料庫的負載。
• 將讀取流量傳送至讀取備用資源。
• 為資料表建立索引。
• 找出並修正寫入查詢速度緩慢的問題。
• 重新建立備用資源。

為避免交易時間過長，可採用以下解決方案：

• 將交易拆分為多筆小額交易
• 將單一大型寫入查詢分割為較小的批次
• 請嘗試將長時間執行的 SELECT 查詢與混合 DML 的交易分開

在顯示錯誤訊息的主執行個體上設定平行複製標記：

1. 修改 binlog_transaction_dependency_tracking 和 transaction_write_set_extraction 標記：
   • binlog_transaction_dependency_tracking=COMMIT_ORDER
   • transaction_write_set_extraction=OFF
2. 新增 slave_pending_jobs_size_max 旗標：

   slave_pending_jobs_size_max=33554432

3. 修改 transaction_write_set_extraction 標記：

   transaction_write_set_extraction=XXHASH64

4. 修改 binlog_transaction_dependency_tracking 標記：

   binlog_transaction_dependency_tracking=WRITESET

停止所有執行中的查詢後，重新建立複本。