cloud sql jdbc socket factory

Konektor Cloud SQL untuk Java

Konektor Cloud SQL untuk Java adalah perpustakaan yang menyediakan otorisasi dan enkripsi berbasis IAM saat terhubung ke instance Cloud SQL. Itu tidak dapat memberikan jalur jaringan ke instance Cloud SQL jika belum ada. Lihat halaman Ringkasan Penghubung untuk informasi lebih lanjut tentang cara menghubungkan ke instance Cloud SQL.

Penggunaan

Untuk informasi penggunaan khusus untuk mesin database dan driver Anda, lihat halaman di bawah:

• Menghubungkan ke Cloud SQL menggunakan JDBC

• Menghubungkan ke Cloud SQL menggunakan R2DBC

Untuk contoh perpustakaan ini yang digunakan dalam konteks aplikasi, lihat contoh aplikasi yang ada di sini.

Otentikasi

Pustaka ini menggunakan strategi Kredensial Default Aplikasi (ADC) untuk menyelesaikan kredensial. Silakan lihat petunjuk ini untuk mengetahui cara menyetel ADC Anda (Aplikasi Google Cloud vs Pengembangan Lokal, kredensial akun pengguna vs layanan IAM).

---

Membangun Penggerak

Untuk membuat JAR gemuk yang berisi driver JDBC dengan bundel dependensi Socket Factory, Anda dapat mengeluarkan perintah Maven berikut dari lokasi yang berisi proyek pom.xml:

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

Ini akan membuat sub-folder target di setiap direktori modul. Dalam direktori target ini Anda akan menemukan file driver JDBC.

Contoh:

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

Pencatatan Debug

Konektor Java mendukung pencatatan debug opsional untuk membantu mendiagnosis masalah dengan penyegaran sertifikat latar belakang. Untuk mengaktifkannya, tambahkan yang berikut ke file /src/main/resources/application.yml :

logging.level.root=DEBUG

---

Konfigurasi firewall

Proxy Cloud SQL membuat koneksi ke instance Cloud SQL menggunakan port 3307. Aplikasi yang dilindungi oleh firewall mungkin perlu dikonfigurasi untuk mengizinkan koneksi keluar pada port TCP 3307. Koneksi yang diblokir oleh firewall biasanya menghasilkan error yang menyatakan kegagalan koneksi ( misalnya com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure ).

Terhubung dengan IntelliJ

Untuk menghubungkan IntelliJ ke instance Cloud SQL, Anda perlu menambahkan perpustakaan ini sebagai jar dengan dependensi di bagian "File Tambahan" pada halaman pengaturan driver. Stoples lemak bawaan tidak lagi disediakan (sejak v1.14.0).

Pemecahan masalah

Berikut beberapa tip pemecahan masalah untuk mengatasi masalah umum yang muncul saat menggunakan Java Connector:

1. Pastikan Anda menggunakan Cloud SQL Connector dan driver database Anda versi terbaru untuk menghindari ketidakcocokan. Beberapa driver versi lama tidak didukung.

2. Konektor Java memberikan otorisasi untuk koneksi, namun tidak menyediakan jalur baru menuju konektivitas. Misalnya, untuk terhubung ke instance Cloud SQL menggunakan alamat IP Pribadi, aplikasi Anda harus sudah memiliki akses VPC.

Kebijakan dukungan

Siklus hidup versi utama

Proyek ini menggunakan versi semantik, dan menggunakan siklus hidup berikut mengenai dukungan untuk versi utama:

Aktif - Versi aktif mendapatkan semua fitur baru dan perbaikan keamanan (yang tidak akan menimbulkan perubahan besar). Versi mayor baru dijamin "aktif" minimal 1 tahun. Tidak berlaku lagi - Versi yang tidak berlaku lagi terus menerima perbaikan keamanan dan bug penting, tetapi tidak menerima fitur baru. Versi yang tidak digunakan lagi akan didukung secara publik selama 1 tahun. Tidak didukung - Versi utama apa pun yang tidak digunakan lagi selama >=1 tahun dianggap tidak didukung secara publik.

Versi JDK yang didukung

Kami menguji dan mendukung minimal versi LTS JDK apa pun yang didukung publik. Perubahan pada versi yang didukung akan dianggap sebagai perubahan kecil, dan akan dicantumkan dalam catatan realease.

Lepaskan irama

Proyek ini bertujuan untuk irama rilis bulanan minimum. Jika tidak ada fitur atau perbaikan baru yang ditambahkan, versi PATCH baru dengan dependensi terbaru akan dirilis.