雲sql jdbc套接字工廠

適用於 Java 的 Cloud SQL 連接器

Cloud SQL Connector for Java 是一個函式庫，可在連接到 Cloud SQL 實例時提供基於 IAM 的授權和加密。如果 Cloud SQL 實例尚不存在，則它無法提供網路路徑。 有關連接到 Cloud SQL 實例的更多信息，請參閱連接概述頁面。

用法

有關特定於您的資料庫引擎和驅動程式的使用信息，請參閱以下頁面：

• 使用 JDBC 連線到 Cloud SQL

• 使用 R2DBC 連線到 Cloud SQL

有關在應用程式上下文中使用該庫的範例，請查看此處的範例應用程式。

驗證

該程式庫使用應用程式預設憑證 (ADC) 策略來解析憑證。請參閱這些說明，了解如何設定 ADC（Google Cloud 應用程式與本機開發、IAM 使用者與服務帳戶憑證）。

---

建構驅動程式

要建立包含 JDBC 驅動程式和捆綁包 Socket Factory 依賴項的 fat JAR，您可以從包含項目 pom.xml 的位置發出以下 Maven 命令：

mvn -P jar-with-dependencies clean package -DskipTests

這將在每個模組目錄中建立一個目標子資料夾。在這些目標目錄中，您將找到 JDBC 驅動程式檔案。

例子：

mysql-socket-factory-connector-j-8–1.8.0-jar-with-dependencies.jar
postgres-socket-factory-1.8.0-jar-with-dependencies.jar

調試日誌記錄

Java 連接器支援可選的偵錯日誌記錄，以協助診斷後台憑證刷新的問題。要啟用它，請將以下內容新增至檔案/src/main/resources/application.yml ：

logging.level.root=DEBUG

---

防火牆配置

Cloud SQL 代理程式使用連接埠 3307 建立與 Cloud SQL 執行個體的連線com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure ）。

與 IntelliJ 連接

為了將 IntelliJ 連接到您的 Cloud SQL 實例，您需要將此程式庫作為具有相依性的 jar 新增至驅動程式設定頁面上的「其他檔案」部分。不再提供預先建構的 fat jar（自 v1.14.0 起）。

故障排除

以下是一些故障排除提示，用於解決使用 Java 連接器時出現的常見問題：

1. 確保您使用的是最新版本的 Cloud SQL Connector 和資料庫驅動程序，以避免不相容。不支援某些舊版本的驅動程式。

2. Java 連接器提供連線授權，但不提供新的連線路徑。例如，為了使用私人 IP 位址連線到 Cloud SQL 實例，您的應用程式必須已經具有 VPC 存取權。

支持政策

主要版本生命週期

該專案使用語義版本控制，並使用以下有關主要版本支援的生命週期：

活動- 活動版本獲得所有新功能和安全修復（否則不會引入重大變更）。新的主要版本保證“有效”至少一年。已棄用- 已棄用的版本繼續接收安全性和關鍵錯誤修復，但不接收新功能。已棄用的版本將公開支援 1 年。不受支援- 任何已棄用超過 1 年的主要版本都被視為不受公開支援。

支援的 JDK 版本

我們至少測試並支援任何公開支援的 LTS JDK 版本。支援版本的更改將被視為較小的更改，並將在發行說明中列出。

發布節奏

該專案的目標是最低每月發布頻率。如果沒有新增功能或修復，則會發布具有最新依賴項的新 PATCH 版本。