PostgreSQL 適用的 Cloud SQL 錯誤訊息

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

您需要 修改私人連線。請使用下列指令，並務必使用 --force 引數：

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force

針對 Illegal Argument，請檢查要求，確認每個引數皆可使用，且每個引數的值皆有效。如有其他原因，請檢查記錄檔案，看看是否有其他資訊。

您需要修改私人連線。請使用下列指令，並務必使用 --force 引數：

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force

如果您嘗試執行匯出作業，但 Cloud Storage 在特定時間範圍內未收到任何資料，系統就會重設連線。

請嘗試使用 pg_dump 手動匯出。

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

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

編輯主要執行個體，將其升級為較大的磁碟大小。

在已分配的 IP 範圍中找不到可用的區塊。請為這位服務供應商分配新的範圍。

已分配的 IP 範圍中沒有可用的位址。

請考慮以下可能的情況：

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

針對上述每種情況，您可以選擇擴充現有私人服務連線，或 分配額外的 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 \
--force

目前不支援從 Cloud Shell 連線至僅有私人 IP 位址的執行個體。

如要修復服務權限，請停用 Service Networking API，等待五分鐘後再重新啟用。

在專案中啟用 Service Networking API。如果您嘗試將私人 IP 位址指派給 Cloud SQL 執行個體，且使用共用虛擬私有雲，則也需要為主機專案啟用 Service Networking API。

在專案中啟用 Service Networking API。如果您嘗試將私人 IP 位址指派給 Cloud SQL 執行個體，且使用共用虛擬私有雲，則也需要為主機專案啟用 Service Networking API。

請等待先前作業完成，再開始其他作業。

編輯目標執行個體，以增加儲存空間。

請透過 Google Cloud 主控台要求提高配額。

提高 max_connections 旗標的值。請參閱「設定資料庫旗標」。

確認您存在 GOOGLE_APPLICATION_CREDENTIALS 環境變數中的位置具有有效的服務帳戶金鑰 JSON 檔案，且該變數指向正確的位置。

建立新的伺服器憑證並輪替。

• 使用者可能沒有所需的所有 Cloud Storage 權限。
• 資料庫表格可能不存在。

請嘗試下列操作 ...

• 請確認您在值區上至少擁有 WRITER 權限，以及匯出檔案的 READER 權限。如要進一步瞭解如何設定 Cloud Storage 中的存取權控管，請參閱「建立及管理存取權控管清單」
• 確認資料表是否存在。如果資料表確實存在，請確認您對儲存值區擁有正確的權限。

如果您在匯出作業期間使用下列陳述式，則傾印交易可能會失敗：

• ALTER TABLE
• CREATE TABLE
• DROP TABLE
• RENAME TABLE
• TRUNCATE TABLE

從傾印作業中移除任何這些陳述式。

放大 temp_file_limit 的大小。請參閱「設定資料庫旗標」。

使用 CSV 格式並執行多個較小的匯出作業，以縮減每項作業的大小和長度。

降低 max_connections 標記值，或與 客戶服務團隊聯絡，要求移除標記，並接著使用 hard drain。這會強制執行個體在不同主機上重新啟動，並使用新的設定，而不會使用旗標或設定。

• 在資料庫層級，資料庫使用者必須存在，且密碼必須相符
• 在專案層級，使用者可能沒有正確的 IAM 權限，包括 serviceusage.services.use 或 cloudsql.instances.connect 權限。
• 在網路層級，如果 Cloud SQL 執行個體使用公開 IP，連線的來源 IP 必須位於已授權網路中。

請嘗試下列操作 ...

• 確認使用者存在且密碼相符。
• 將 Service Usage Consumer 角色指派給使用者帳戶。這個角色具備 serviceusage.services.use 權限。
• 如果使用公開 IP，請確認來源 IP 位於已授權的網路中。

在修正之前，請參閱 GitHub 上的這篇討論串，其中包含解決方法。

• 當您嘗試重複使用最近刪除的執行個體名稱時，就可能會發生這種情況。
• 連線不穩定也可能導致這類問題。
• 記錄可能會顯示專案未啟用 Service Networking API。
• 嘗試同時建立多個例項時，也會發生這個錯誤。舉例來說，Terraform 指令碼可讓您嘗試這麼做。
• 另一個原因可能是特定資源用盡或超出配額限制。在記錄中尋找類似 Quota 'INTERNAL_FORWARDING_RULES_WITH_TARGET_INSTANCE_PER_NETWORK' exceeded. Limit: 100.0 globally 的項目
• 如果 IP 範圍中沒有其他可用的位址，則無法建立子網路，並且可能會發生這個錯誤。

• 刪除執行個體後，大約一週內無法重複使用該執行個體的名稱。
• 如果是間歇性連線問題，唯一的解決方法就是重試。
• 為專案啟用 Service Networking API。
• 並行執行的執行個體建立指令碼只會成功建立其中一個執行個體。修改指令碼，讓系統等待每個建立作業完成後，再繼續執行下一個作業。
• 分配新的範圍。

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

如果錯誤為 The instance creation failed due to a permission error with the CMEK key defined，請檢查關鍵設定和位置。