選擇連線至 Cloud SQL 的方式

MySQL | PostgreSQL | SQL Server

本頁面提供總覽，說明如何連線至 Cloud SQL 執行個體。

連線至 Cloud SQL 執行個體前，您必須決定如何部署及設定 Cloud SQL 執行個體和支援的網路資源。如果 Cloud SQL 執行個體已設定及部署，這個頁面可協助您瞭解如何透過不同方式，將用戶端連線至現有執行個體。

IP 位址類型：私人或公開

首次建立 Cloud SQL 執行個體時，您可以選擇為執行個體設定公開 IP 位址、私人 IP 位址，或兩者皆設定。

您可以根據應用程式需求，選擇執行個體的 IP 位址設定。設定執行個體後，您可以在用戶端連線字串中指定公開 IP 位址、私人 IP 位址，或在某些情況下指定 DNS 名稱。

	私人 IP 位址	公開 IP 位址
說明	內部、僅限虛擬私有雲 (VPC) 網路 (私人) IP 位址	可透過網際網路存取的外部 (公開) IP 位址
決策點	您是否需要從虛擬私有雲網路內 Cloud de Confiance by S3NS 或可存取這些虛擬私有雲網路的用戶端連線？如果是，請為執行個體選擇私人 IP 位址。	是否需要透過公開網際網路，從 Cloud de Confiance虛擬私有雲網路外部的用戶端連線？如果是，請為執行個體選擇公開 IP 位址。
設定選項	支援下列類型的私人網路設定： Private Service Connect：從屬於不同群組、專案或機構的多個虛擬私有雲網路連線至 Cloud SQL 執行個體。Private Service Connect 是新專案的預設私人 IP 連線選項。私人服務連線：根據虛擬私有雲網路對等互連，從單一虛擬私有雲網路連線至 Cloud SQL 執行個體。如要進一步瞭解如何選擇私人網路設定，請參閱「私人 IP 設定選項」。	使用公開 IP 位址直接連線至執行個體時，必須設定授權網路。如要連線至使用公開 IP 的 Cloud SQL 執行個體，另一個更安全的替代方案是使用 Cloud SQL 連接器 (例如 Cloud SQL Auth Proxy 或其中一個 Cloud SQL 語言連接器)。如需為執行個體新增公開 IP 的操作說明，請參閱「設定公開 IP」。如要使用公開 IP 位址連線至 Cloud SQL 執行個體，您可以使用 `psql` 用戶端或其他可用的用戶端。
摘要	建議：為提升安全性，建議您為執行個體設定私人 IP 位址類型，除非您對可透過網際網路存取的 Cloud SQL 執行個體有特定需求，或從不符合虛擬私有雲要求的用戶端連線。

連線類型：Cloud SQL 連接器或直接連線

連線至 Cloud SQL 執行個體時，您可以使用 Cloud SQL 連接器，也可以直接連線。

Cloud SQL 連接器可以是 Cloud SQL Auth Proxy，也可以是 Cloud SQL 語言連接器。

	Cloud SQL 連接器	直接連結
說明	Cloud SQL Auth Proxy (用戶端 Proxy) 和 Cloud SQL 語言連接器 (用戶端程式庫) 可簡化 Cloud SQL 執行個體的存取程序，並確保存取安全，特別是透過公開 IP 位址連線至執行個體時。	從用戶端直接連線至 Cloud SQL 執行個體，可提供延遲時間較短的連線。您可以透過公開或私人 IP 位址直接連線。
決策點	在下列情況中，Cloud SQL 連接器非常實用：您想使用公開 IP 位址連線至 Cloud SQL 執行個體，但不想設定授權網路。您想透過伺服器和用戶端身分驗證，自動加密進出資料庫的流量，但不想管理 SSL 憑證。使用 IAM 資料庫驗證機制，且想自動重新整理 OAuth 2.0 存取權杖。從使用動態指派或臨時 IP 位址的用戶端或應用程式連線時。平台即服務 (PaaS) 應用程式通常會使用動態 IP 設定。	使用直接連線有下列好處：與使用 Cloud SQL 連接器的連線相比，延遲時間較短。與 Cloud SQL 連接器不同，您不必新增任何套件或程式庫依附元件。使用直接連線時，您必須自行設定 SSL/TLS。
設定選項	Cloud SQL Auth Proxy，或 Cloud SQL 語言連接器，包括 Cloud SQL Java 連接器 Cloud SQL Python 連接器 Cloud SQL Go 連接器 Cloud SQL Node.js 連接器如果您透過公開 IP 位址連線至 Cloud SQL 執行個體，下列 Cloud de Confiance by S3NS 服務會使用內嵌的 Cloud SQL Auth Proxy： Cloud Run App Engine 彈性環境 App Engine 標準環境	如要在 Cloud SQL 執行個體和用戶端上設定 SSL/TLS 憑證，請按照下列步驟操作：為執行個體選擇伺服器 CA 模式。設定執行個體，強制對執行個體上的連線進行 SSL/TLS 加密。建立用戶端憑證。下載伺服器和用戶端憑證。
摘要	連線至 Cloud SQL 執行個體時，您可以使用 Cloud SQL 連接器，或直接從用戶端連線。一般建議：如果您是透過私人 IP 位址連線至執行個體，請使用直接連線。此外，建議您強制執行 SSL，並為連線設定 SSL/TLS 憑證。如果透過公開 IP 位址連線至執行個體，請使用 Cloud SQL 連接器 (Cloud SQL Auth Proxy 或其中一個 Cloud SQL 語言連接器)。

資料庫驗證類型：IAM 或內建

連線至執行個體時，您必須以資料庫使用者的身分進行驗證。您可以選擇內建驗證或 IAM 資料庫驗證。

	IAM 資料庫驗證	內建驗證機制
說明	IAM 資料庫驗證機制可讓您使用 Cloud de Confiance IAM 使用者和服務帳戶，透過短期存取權杖 (而非密碼) 向資料庫進行驗證。您可以使用 IAM 主體 (例如使用者、服務帳戶和群組) 管理資料庫權限。	內建驗證機制會使用資料庫本機使用者名稱和密碼，驗證資料庫使用者。
決策點	您是否偏好使用 Cloud de Confiance中的 IAM，集中管理 Cloud de Confiance服務的使用者？如果是，請使用 IAM 資料庫驗證機制。	您是否有應用程式或工作流程仰賴內建資料庫驗證機制？如果是，請使用內建驗證。
設定選項	您可以為個別 IAM 使用者、個別服務帳戶和群組使用 IAM 資料庫驗證。詳情請參閱「使用 IAM 資料庫驗證機制管理使用者」。如果您使用 Cloud SQL 連接器，連接器會自動重新整理 IAM 存取權杖。詳情請參閱「自動 IAM 資料庫驗證」。	您可以使用內建資料庫驗證，並在執行個體和使用者層級設定密碼政策。詳情請參閱「內建驗證」。
摘要	建議：除非應用程式或工作流程需要內建資料庫驗證機制，否則請盡可能使用 IAM 資料庫驗證機制。

從執行個體移除網路選項

Cloud SQL 支援從執行個體中移除下列網路選項：

從同時具備私人服務存取權和公開 IP 的執行個體，取得公開 IP
具有公開 IP、私人服務連線和 Private Service Connect 的執行個體公開 IP
從同時具有 Private Service Connect 和私人服務存取權的執行個體使用 Private Service Connect
從具備 Private Service Connect、私人服務存取權和公開 IP 的執行個體，透過 Private Service Connect 連線

啟用執行個體的網路選項

Cloud SQL 支援為執行個體啟用下列連線選項：

僅具備公開 IP 的執行個體上的私人服務存取權
執行個體上的 Private Service Connect，僅限存取私人服務
在同時具備私人服務連線和公開 IP 的執行個體上，使用 Private Service Connect
僅具備私人服務連線的執行個體上有公開 IP

限制

您無法建立同時具有公開 IP 位址和 Private Service Connect 的執行個體。
如果執行個體同時使用私人服務連線和 Private Service Connect，就無法移除私人服務連線。
如果執行個體同時具備私人服務連線和公開 IP，就無法移除私人服務連線。
如果執行個體僅使用公開 IP，則無法同時啟用私人服務存取權和 Private Service Connect。請先啟用私人服務連線，再啟用 Private Service Connect。
您無法使用授權網路，為 Private Service Connect 執行個體建立 IP 位址許可清單。

連線至 Cloud SQL 的工具

下表列出連線至 Cloud SQL 的部分選項：

連線選項	更多資訊
Cloud SQL Auth Proxy	關於 Cloud SQL Auth Proxy 使用 Cloud SQL Auth Proxy 連線使用 Cloud SQL Auth Proxy Docker 映像檔連線
gcloud CLI	`gcloud sql connect`
Cloud SQL 語言連接器	使用 Java、Python 和 Go 適用的 Cloud SQL 連接器連線。
Cloud Shell	使用 Cloud Shell 連線
Cloud Code	在 JetBrains IDE 中使用 Cloud Code 連線
Google Cloud Data Agent Kit	查詢資料

使用第三方資料庫管理工具連線
pgAdmin	PostgreSQL 適用的 pgAdmin.org
Toad Edge	PostgreSQL 適用的 Toad Edge
Blendo	如何將 Google Cloud SQL PostgreSQL 與 Blendo 連結

疑難排解

如果無法順利連線，請查看下列頁面，瞭解如何偵錯或尋找已知問題的解決方案：

後續步驟

瞭解如何快速入門導覽課程：PostgreSQL 適用的 Cloud SQL。
瞭解管理資料庫連線的最佳做法。
瞭解 IAM 資料庫驗證。
瞭解如何從本機電腦或 Compute Engine 使用 psql 用戶端連線。
瞭解如何設定 IP 連線。
瞭解 Cloud SQL Auth Proxy。
瞭解支援的選項。