排解 Cloud SQL 問題

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

查看記錄，然後依文字篩選，找出使用者。您可能需要使用稽核記錄來取得私人資訊。相關記錄檔包括：

• 如果啟用 Cloud 稽核記錄，且您具備查看記錄的必要權限，則可能也會顯示 cloudaudit.googleapis.com/activity。

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

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

如果真的需要取消作業，可以請 客戶服務force restart執行個體。

還原 SQL 傾印檔前，請先建立資料庫使用者。

如要無限期保留備份，可以建立隨選備份，因為這類備份不會像自動備份一樣遭到刪除。隨選備份會無限期保留。也就是說，這些備份會一直存在，直到您刪除備份或刪除所屬執行個體為止。這類備份不會自動刪除，因此可能會影響帳單。

• 開放連線可能過多。如果連線中途發生錯誤，且沒有 autovacuum 設定可清除無效連線，就可能導致連線過多。
• 如果任何自訂程式碼使用重試邏輯，且在幾次失敗後不會停止，就可能發生循環。
• 網路流量可能過大。使用連線集區和其他連線最佳做法。

建議做法：

1. 確認資料庫已 設為 autovacuum。
2. 檢查自訂程式碼中是否已設定任何連線重試邏輯。
3. 調降流量，直到資料庫復原為止，然後再慢慢調高流量。

CREATE UNLOGGED TABLE ...。

從備份還原時，不會還原下列資料表：

• 在 HA 執行個體上，未記錄的資料表內容不會在容錯移轉後保留。
• 未記錄的資料表在 PostgreSQL 發生當機時會遺失。
• 系統不會將未記錄的資料表複製到唯讀副本。
• 備份還原期間，系統會自動清除未記錄的資料表。

解決方法是避免使用未記錄的資料表，以免無法透過備份還原這些資料表。如果從已含有未記錄資料表的資料庫還原，您可以將資料庫傾印至檔案，並在修改傾印檔案，將這些資料表上的 ALTER TABLE 改為 SET LOGGED 後，重新載入資料。

• 將最終備份值設為與執行個體的現有備份設定相符。
• 刪除執行個體時，請將最終備份欄位留空。如果將這個欄位留空，Cloud SQL 會採用執行個體設定中設定的最終備份設定，進行最終備份並定義保留期限。

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

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

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

• 網路不穩定。
• 對 TCP keep-alive 命令沒有回應 (用戶端或伺服器沒有回應，可能已過載)
• 資料庫引擎連線生命週期已超過，伺服器會終止連線。

應用程式必須能容許網路故障，並遵循最佳做法，例如連線集區和重試。連線集區器大多會盡可能偵測到這些錯誤。否則應用程式必須重試或優雅地失敗。

如要重試連線，建議使用下列方法：

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

結合使用這些方法有助於減少節流。

• 建立 Microsoft Entra ID 登入作業的速度緩慢
• 無法建立 Microsoft Entra ID 登入
• 無法使用 Microsoft Entra ID 驗證連線至執行個體

如要進一步瞭解如何解決這些問題，請參閱「排解 Microsoft Entra ID 整合問題」。

連線至預設使用者，然後變更使用者。

在執行個體建立要求時，所選區域缺少要求的資源或 VM 類型容量。要求提出時，該特定區域位置可能同時有大量作業需求。

如要解決這個問題，請嘗試在其他區域建立執行個體，或在一天中的其他時間，嘗試在收到錯誤的相同區域建立執行個體。

• 分配給私人服務連線的 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 會啟動卸載執行個體來執行匯出作業，而不是在來源執行個體上發出匯出作業。卸載匯出作業有許多優點，包括提升來源執行個體的效能，以及在匯出作業執行期間解除管理作業的封鎖。使用匯出卸載功能時，總延遲時間可能會增加，因為系統需要時間啟動卸載執行個體。一般來說，只要匯出檔案大小合理，延遲時間就不會太長。不過，如果匯出作業的資料量不大，延遲時間可能會增加。

編輯 dump 檔案，移除參照。

使用 pg_dump 工具手動匯出。

您可以 Google Cloud運用 Cloud Scheduler、Pub/Sub 和 Cloud Run 函式等產品，自行建構自動匯出系統，類似於這篇 自動備份文章。

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

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

解決方法：在初始傾印階段，請勿對來源資料庫執行 DDL 陳述式。執行任何 DDL 陳述式前，請先重新啟動遷移作業，並等待初始傾印階段完成。

其中一個可能的原因是來源資料庫已定義複製標記，導致部分或所有資料庫變更未複製過來。

請確認複製旗標 (例如 binlog-do-db、binlog-ignore-db、replicate-do-db 或 replicate-ignore-db) 未以衝突的方式設定。

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

建議做法：

• 在 Google Cloud 控制台的 Cloud Monitoring 專區中，查看副本執行個體的 複寫指標。
• MySQL IO 執行緒或 SQL 執行緒的錯誤會顯示在 Cloud Logging 的 mysql.err 記錄檔中。
• 連線至副本執行個體時，也可能會發現這個錯誤。 執行 SHOW REPLICA STATUS 指令，並檢查輸出內容中是否有下列欄位：
  • Replica_IO_Running
  • Replica_SQL_Running
  • Last_IO_Error
  • Last_SQL_Error

如果看到 Unknown database DATABASE_NAME on query. Error_code: MY-001049 錯誤，表示複製的 SQL 陳述式嘗試參照未選取遷移的資料庫，導致複製失敗。如要復原複寫，請根據訊息判斷錯誤是否是由下列其中一個物件的 DDL 所造成：

• 活動或日常安排。您可以在副本上執行 CALL mysql.skipReplicationError()，防止複製事件或常式，並繼續複製。
• 外鍵限制或檢視畫面。判斷陳述式修改的物件位於哪個資料庫後，您有兩種復原方式。您可以從要遷移的資料庫中移除資料庫，也可以在副本上執行 CALL mysql.skipReplicationError()，繼續進行複製作業，同時略過限制條件或將檢視區塊傳播至副本。

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

使用正確的旗標設定建立新的傾印檔案，並使用該檔案設定外部副本

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

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

   瞭解詳情。

3. 確認剛建立的 dump 檔案包含 SET @@GLOBAL.GTID_PURGED='...' 行。
4. 將傾印檔案上傳至 Cloud Storage 值區，並 使用傾印檔案設定副本。

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

關閉未使用的作業。檢查 Cloud SQL 執行個體的 CPU 和記憶體用量，確保有充足的可用資源。如要確保匯入作業有最多資源可用，最好的方法就是在開始作業前重新啟動執行個體。

重新啟動：

• 關閉所有連線。
• 終止可能消耗資源的任何工作。

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

建議做法：

在傾印檔案開頭加上以下這一行：

SET FOREIGN_KEY_CHECKS=0;
  

此外，請在傾印檔案結尾處加上以下這行：

SET FOREIGN_KEY_CHECKS=1;
  

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

EXEC sp_serveroption
    @server='LINKED_SERVER_NAME',
    @optname='data access',
    @optvalue='TRUE'

將 LINKED_SERVER_NAME 替換為連結伺服器的名稱。

EXEC master.dbo.sp_addlinkedserver
   @server = N'LINKED_SERVER_NAME',
   @srvproduct= N'',
   @provider= N'MSOLEDBSQL',
   @datasrc= N'TARGET_SERVER_ID',
   @provstr= N'Encrypt=yes;TrustServerCertificate=yes;User ID=USER_ID'

取代下列項目：

• 將 LINKED_SERVER_NAME 替換為連結伺服器的名稱。
• TARGET_SERVER_ID，並提供目標伺服器的名稱，或目標伺服器的 IP 位址和連接埠號碼。
• USER_ID 使用者登入。

舉例來說，使用者遭到刪除，但您無法找出刪除者。 記錄會顯示作業已啟動，但不會提供任何其他資訊。您必須啟用稽核記錄，才能記錄這類詳細的個人識別資訊 (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
    

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

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
   

1. 從終端機連線至資料庫：

   gcloud sql connect INSTANCE_NAME
         

2. 執行下列指令來建立擴充功能：

   CREATE EXTENSION pgaudit;
         

3. 退出資料庫，然後在終端機執行下列指令：

   gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql.enable_pgaudit=on,pgaudit.log=all
        

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

建議做法：

• 您可以在 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 執行個體，效果會比使用單個大型的執行個體更好。

SELECT datname, username, application_name as appname, client_addr, state, now() - backend_start as conn_age, now() - xact_start as xact_age, now() - query_start as query_age, now() - state_change as last_activity_age, wait_event_type, wait_event, query FROM pg_stat_activity WHERE state <> 'idle' ORDER BY 8 DESC LIMIT 20;

SELECT name, setting, unit FROM pg_settings WHERE name = 'FIELD_NAME'。

SHOW SETTING_NAME;

執行 SHOW ALL; 即可查看所有設定。

執行下列指令：

1.       GRANT pg_signal_backend TO USERNAME;
         

2. 找出遭封鎖或停滯程序的程序 ID：

         SELECT pid, username, state, query FROM pg_stat_activity;
         

3. 使用下列指令停止執行中或閒置的程序：