Konektor Cloud SQL adalah library yang menyediakan enkripsi dan otorisasi berbasis Identity and Access Management (IAM) saat terhubung ke instance Cloud SQL. Klien tidak dapat menyediakan jalur jaringan ke instance Cloud SQL jika belum ada.
Cara lain untuk terhubung ke instance Cloud SQL mencakup menggunakan klien database atau Proxy Auth Cloud SQL. Lihat halaman Tentang opsi koneksi untuk mengetahui informasi selengkapnya tentang cara terhubung ke instance Cloud SQL.
Halaman ini membahas Konektor Cloud SQL berikut:
- Konektor Java Cloud SQL
- Konektor Python Cloud SQL (Buka di Colab)
- Konektor Go Cloud SQL
- Konektor Node.js Cloud SQL
Manfaat
Menggunakan konektor Cloud SQL memberikan manfaat berikut:
- Otorisasi IAM: Menggunakan izin IAM untuk mengontrol siapa atau apa yang dapat terhubung ke instance Cloud SQL Anda.
- Kepraktisan: Menghapus persyaratan untuk mengelola sertifikat SSL, mengonfigurasi aturan firewall, atau mengaktifkan jaringan yang diizinkan.
Sebelum memulai
- Aktifkan Cloud SQL Admin API.
- Buat instance Cloud SQL, termasuk mengonfigurasi pengguna default.
Untuk mengetahui informasi selengkapnya tentang cara membuat instance, lihat Membuat instance.
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi pengguna default, lihat Menyetel sandi untuk akun pengguna default.
- Konfigurasi peran dan izin yang diperlukan untuk terhubung ke instance Cloud SQL.
Penyiapan
Java
Konektor Java Cloud SQL adalah library yang memberikan otorisasi dan enkripsi berbasis IAM saat terhubung ke instance Cloud SQL. Kode ini tidak dapat menyediakan jalur jaringan ke instance Cloud SQL jika belum ada.
Penginstalan
Guna mengetahui petunjuk tentang cara mem-build dan menggunakan driver untuk JDBC dan R2DBC dengan Konektor Java Cloud SQL, lihat link berikut:
Untuk contoh library ini yang digunakan dalam konteks aplikasi, lihat aplikasi sampel ini.
Authentication
Library ini menggunakan Kredensial Default Aplikasi untuk mengautentikasi koneksi ke server Cloud SQL.
Untuk mengaktifkan kredensial secara lokal, gunakan perintah gcloud berikut:
gcloud auth application-default login
Hubungkan dengan Intellij
Untuk menghubungkan IntelliJ ke instance Cloud SQL Anda, Anda akan perlu untuk menambahkan library sebagai jar dengan dependensi di bagian File Tambahan pada halaman setelan driver. Misalnya, fat jar bawaan dapat ditemukan di halaman Rilis Konektor Java Cloud SQL untuk tujuan ini.
Python
Konektor Python Cloud SQL adalah library yang dapat digunakan bersama driver database agar pengguna dengan izin yang memadai dapat terhubung ke database Cloud SQL tanpa harus memasukkan IP ke daftar yang diizinkan secara manual atau mengelola sertifikat SSL.
Untuk contoh interaktif penggunaan Konektor Python Cloud SQL, buka notebook Konektor Python Cloud SQL.
Driver yang saat ini didukung untuk MySQL adalah pymysql .
Penginstalan
Untuk menginstal rilis terbaru, ikuti petunjuk ini.
Authentication
Library ini menggunakan Kredensial Default Aplikasi untuk mengautentikasi koneksi ke server Cloud SQL.
Untuk mengaktifkan kredensial secara lokal, gunakan perintah gcloud berikut:
gcloud auth application-default login
Go
Konektor Go Cloud SQL adalah konektor Cloud SQL yang dirancang untuk digunakan dengan bahasa Go. Untuk meningkatkan keamanan, konektor ini menggunakan enkripsi TLS 1.3 yang tangguh dan diautentikasi secara manual antara konektor klien dan proxy sisi server, terlepas dari protokol database.
Penginstalan
Anda dapat menginstal repo ini dengan go get
:
go get cloud.google.com/go/cloudsqlconn
Node.js
Node.js Connector adalah library yang dirancang untuk digunakan bersama runtime Node.js yang memungkinkan Anda untuk terhubung dengan aman ke instance Cloud SQL Anda.
Penginstalan
Anda dapat menginstal library dengan npm install
:
npm install @google-cloud/cloud-sql-connector
Penggunaan
Java
Untuk menemukan cuplikan ini dalam konteks aplikasi web, lihat README pada GitHub.
Python
Lihat Cara menggunakan Konektor ini untuk petunjuk mendetail tentang menggunakan library. Lihat contoh kode pengujian koneksi di GitHub.
Go
Lihat Penggunaan untuk mengetahui petunjuk mendetail tentang cara menggunakan library. Lihat contoh kode pengujian koneksi di GitHub.
Node.js
Untuk petunjuk mendetail tentang penggunaan library, lihat Penggunaan.
Memecahkan masalah
Versi driver
Pastikan Anda menggunakan versi terbaru Konektor Cloud SQL dan driver database Anda untuk menghindari ketidakcocokan. Beberapa versi driver lama tidak didukung
Jalur koneksi
Konektor Cloud SQL memberikan otorisasi untuk koneksi, tetapi tidak menyediakan jalur baru ke konektivitas. Misalnya, agar dapat terhubung ke instance Cloud SQL menggunakan alamat IP Pribadi, aplikasi Anda harus sudah memiliki akses VPC.
Men-debug masalah koneksi
Untuk mendapatkan bantuan tambahan terkait masalah koneksi, lihat halaman Memecahkan masalah dan Men-debug masalah koneksi.
Langkah selanjutnya
- Lihat halaman beranda Konektor Java Cloud SQL di GitHub.
- Lihat halaman beranda Konektor Python Cloud SQL di GitHub.
- Pelajari lebih lanjut tentang Proxy Auth Cloud SQL.
- Pelajari lebih lanjut tentang IAM.
- Pelajari tentang opsi untuk dukungan.