本頁面概述 Cloud SQL 語言連接器,以及如何與執行個體搭配使用。
Cloud SQL 語言連接器是程式庫,可在連線至 Cloud SQL 執行個體時提供加密和 IAM 授權。Cloud SQL 語言連接器會代表使用者應用程式,建立與伺服器端 Proxy 的授權連線,並將該連線傳遞至應用程式的資料庫驅動程式。如果 Cloud SQL 執行個體沒有網路路徑,這些方法不會提供。
Cloud SQL 語言連接器會使用用戶端元件,連線至 Cloud SQL 執行個體上的 Proxy 伺服器。連接器會建立臨時憑證,授權持有者連線至伺服器端 Proxy。伺服器端 Proxy 會要求有效的 TLS 憑證才能連線,藉此限制對 Cloud SQL 資料庫的存取。
Cloud SQL 支援下列 Cloud SQL 語言連接器:
Cloud SQL 建議使用 Cloud SQL 語言連接器連線至 Cloud SQL 執行個體。您也可以使用資料庫用戶端或 Cloud SQL Auth Proxy 連線至 Cloud SQL 執行個體。如要進一步瞭解如何連線至 Cloud SQL 執行個體,請參閱「連線選項簡介」。
需求條件
如果 Cloud SQL 執行個體使用共用憑證授權單位 (CA) 做為 serverCaMode,請在用戶端確認您使用的 Cloud SQL 語言連接器符合下列版本需求:
- Cloud SQL Java 連接器:v1.21.0 以上版本
- Cloud SQL Go 連接器:v1.12.0 以上版本
- Cloud SQL Node.js 連接器:v1.4.0 以上版本
如果 Cloud SQL 執行個體使用客戶自行管理的 CA 做為 serverCaMode,請在用戶端確認您使用的 Cloud SQL 語言連接器符合下列版本需求:
- Cloud SQL Java 連接器:v1.22.0 以上版本
- Cloud SQL Go 連接器:v1.14.0 以上版本
- Cloud SQL Node.js 連接器:v1.6.0 以上版本
如果執行個體使用客戶自行管理的 CA 做為伺服器 CA 模式,您可以使用自訂 DNS 名稱設定執行個體。您可以在伺服器憑證的自訂主體別名 (SAN) 欄位中,提供自訂 DNS 名稱。
為執行個體設定自訂 DNS 名稱後,您可以使用 DNS 名稱,從 Cloud SQL 語言連接器連線至執行個體。
Cloud SQL 語言連接器的優點
Cloud SQL 語言連接器提供下列優點,可連線至 Cloud SQL 執行個體:
- IAM 授權:使用 Identity and Access Management (IAM) 權限,控管哪些使用者或項目可以連線至 Cloud SQL 執行個體。
- 便利性:不必管理 SSL 憑證、設定防火牆規則或啟用授權網路。
限制
如果您使用情境感知存取權和 IAM 資料庫驗證,就無法使用 Cloud SQL 語言連接器。嘗試登入執行個體時,IAM 驗證失敗。
強制使用 Cloud SQL 語言連接器
使用連接器強制執行,即可強制只使用 Cloud SQL Auth Proxy 或 Cloud SQL 語言連接器連線至 Cloud SQL 執行個體。強制執行連接器後,Cloud SQL 會拒絕直接連至資料庫。
如果使用已啟用 Private Service Connect 的執行個體,則會受到限制。如果執行個體已啟用連接器強制執行功能,就無法建立唯讀副本。同樣地,如果執行個體有唯讀副本,就無法啟用連接器強制執行功能。
如要進一步瞭解如何強制只使用 Cloud SQL Auth Proxy 或 Cloud SQL 語言連接器連線至執行個體,請參閱「使用 Cloud SQL 語言連接器連線」。