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 範圍。

分配新範圍時，請注意不要建立與任何現有分配項目重疊的分配項目。

建立新的 IP 範圍後，請使用下列指令更新虛擬私有雲對接：

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 範圍後，請使用下列指令更新虛擬私有雲對接：

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。如果您在嘗試將私人 IP 位址指派給 Cloud SQL 執行個體時看到這則錯誤訊息，且您使用的是 Shared VPC，則也需要為託管專案啟用 Service Networking API。

在專案中啟用 Service Networking API。如果您在嘗試將私人 IP 位址指派給 Cloud SQL 執行個體時看到這則錯誤訊息，且您使用的是 Shared VPC，則也需要為託管專案啟用 Service Networking API。

請等待前一項作業完成，再開始另一項作業。

透過Cloud de Confiance 控制台申請提高配額。

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

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

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

• 使用者可能不具備所有必要的 Cloud Storage 權限。
• 資料庫資料表可能不存在。

試試這些做法 ...

• 請確認您至少具備值區的 WRITER 權限和匯出檔案的 READER 權限。如要進一步瞭解如何在 Cloud Storage 中設定存取控管，請參閱「建立及管理存取控管清單」
• 請確認資料表存在。如果資料表確實存在，請確認您具備儲存空間 bucket 的適當權限。

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

• 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。
• 平行執行個體建立指令碼只會成功建立其中一個執行個體。修改指令碼，讓系統等待每個執行個體建立作業完成，再繼續執行下一個作業。
• 分配新範圍。

請檢查 Cloud Logging 中的記錄，找出實際錯誤。

如果錯誤是 set Service Networking service account as servicenetworking.serviceAgent role on consumer project，請按照「建立服務代理並授予角色」中的操作說明，手動建立必要的服務帳戶。

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