此頁面提供最佳做法和特定程式設計語言的程式碼範例,幫助您建立應用程式,有效率地使用 Cloud SQL 資料庫連線。
這些範例是完整網頁應用程式的摘要,您可以在 GitHub 上取得。瞭解詳情。
如要瞭解如何逐步執行連線至 Cloud SQL 的範例網頁應用程式,請點選所需環境的連結:
- 從本機電腦連線的快速入門指南
- 從 Compute Engine 連線的快速入門
- 從 Cloud Run 連線的快速入門導覽課程
- 從 Cloud Run 函式連線的快速入門課程
- 從 Google Kubernetes Engine 連線的快速入門
連線集區
連線集區是資料庫連線的快取,系統會共用和重複使用此快取,藉此縮短連線延遲時間和改善連線效率。當您的應用程式需要資料庫連線時,會從集區暫時借出連線;使用完畢後,應用程式會將連線還給集區,以便下次需要資料庫連線時能重複使用。
開啟及關閉連線
您使用連線集區時,必須正確開啟和關閉連線,以確保連線在您每次使用完畢後都會回到集區。未回到集區的連線 (或稱「外洩」連線) 將無法重複使用,因而造成資源浪費,也可能導致應用程式效能瓶頸。
Python
Java
Node.js
C#
Go
Ruby
PHP
連線計數
每個資料庫連線都會使用用戶端和伺服器端資源。此外,Cloud SQL 會設有整體連線限制,不得超出此限制。建立和使用較少的連線可減少負擔,並協助您維持在連線限制以下。
指數輪詢
如果您的應用程式嘗試連線至資料庫卻未成功,原因可能是資料庫暫時無法提供服務。在這種情況下,重複傳送連線要求會浪費資源。建議您在傳送其他連線要求前稍待片刻,讓資料庫再次開放存取。使用指數輪詢或其他延遲機制即可達成此目標。
只有在首次連線或首次從集區取得連線時,才有必要重試。如果交易過程中發生錯誤,應用程式必須重試,且必須從交易開始處重試。因此,即使您已正確設定資源池,應用程式仍可能在連線中斷時發生錯誤。
連線逾時
嘗試連線失敗的原因有很多,例如網路通訊的不穩定,以及資料庫可能暫時無法回應。請務必確保應用程式能夠妥善處理中斷或連線失敗的情況。
連線持續時間
限制連線效期可避免捨棄的連線越積越多。您可以使用連線集區來限制您的連線效期。
Python
Java
Node.js
「node-mssql」Node.js 程式庫目前未提供任何可控制連線持續時間的功能。
C#
Go
Ruby
ActiveRecord 目前未提供任何可控制連線持續時間的功能。
PHP
PDO 目前未提供任何可控制連線持續時間的功能。
查看完整的應用程式
如要查看完整的應用程式,請按一下下方連結。
Python
查看以 Python 程式設計語言撰寫的完整應用程式。
Node.js
查看以 Node.js 程式設計語言撰寫的完整應用程式。
C#
查看以 C# 程式設計語言撰寫的完整應用程式。
Go
查看以 Go 程式設計語言撰寫的完整應用程式。
PHP
查看以 PHP 程式設計語言撰寫的完整應用程式。