Terhubung ke Google Cloud SQL untuk MySQL

Anda dapat menghubungkan database Cloud SQL untuk MySQL ke Data Studio menggunakan konektor Cloud SQL untuk MySQL. Gunakan tabel database atau kueri kustom untuk membuat laporan dan dasbor interaktif. Kemudian, Anda dapat membagikan hasil analisis ini kepada pemangku kepentingan atau anggota tim yang tidak memiliki akses langsung ke database.

Versi yang didukung

Konektor Cloud SQL untuk MySQL diuji pada versi MySQL berikut:

  • 5.6
  • 5.7
  • 8.0

Jika Anda mengalami masalah saat menggunakan versi yang didukung, beri tahu kami di Komunitas Data Studio. Anda juga dapat menambahkan dan memberi suara untuk permintaan fitur di issue tracker.

Cara terhubung ke Cloud SQL untuk MySQL

Sumber data Data Studio dapat terhubung ke satu tabel database Cloud SQL untuk MySQL, atau ke kueri kustom yang Anda berikan.

Untuk terhubung ke database Cloud SQL untuk MySQL, ikuti langkah-langkah berikut:

  1. Login ke Data Studio.
  2. Di halaman beranda Data Studio, klik Buat, lalu pilih Sumber Data.
  3. Pilih konektor Cloud SQL untuk MySQL.
  4. Konfigurasi akses ke database Anda menggunakan salah satu opsi koneksi.
  5. Klik AUTHENTICATE. Anda akan melihat daftar tabel dalam database tersebut.
  6. Pilih tabel dari daftar atau masukkan kueri kustom.
  7. Klik CONNECT.

Anda kini dapat mengakses semua kolom dalam tabel sebagai kolom dalam laporan Anda.

Opsi koneksi

Menghubungkan menggunakan nama host atau alamat IP

Di panel koneksi, pilih DASAR. Masukkan detail koneksi:

  • Nama Koneksi Instance
  • Database
  • Nama pengguna
  • Sandi

Menghubungkan menggunakan URL JDBC

Di panel koneksi, pilih URL JDBC. Masukkan detail koneksi:

  • URL JDBC

    • Contoh jdbc:google:mysql://INSTANCE_CONNECTION_NAME/DATABASE

  • Nama pengguna
  • Sandi

Untuk terhubung menggunakan alamat literal IPv6, masukkan alamat di antara tanda kurung siku. Contoh: jdbc:google:mysql://[2001:db8:1:1:1:1:1:1]/your_db

Kueri kustom

Pilih opsi KUERI KUSTOM untuk memberikan kueri SQL dan bukan menghubungkan ke satu tabel. Data Studio menggunakan SQL kustom ini sebagai pernyataan pemilihan dalam untuk setiap kueri yang dibuat pada database.

Kueri SQL kustom hanya boleh memiliki satu pernyataan. Misalnya, kode berikut tidak akan berfungsi karena memiliki beberapa pernyataan SQL:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

Kueri di Data Studio dapat habis waktu tunggunya setelah tiga hingga lima menit. Jika waktu tunggu kueri kustom habis, coba pendekatan berikut untuk menyelesaikan masalah tersebut:

  • Sederhanakan kueri agar berjalan lebih cepat.
  • Jalankan kueri di database Anda dan simpan hasilnya dalam tabel terpisah. Hubungkan tabel baru di sumber data Anda.

Catatan

Tinjau bagian berikut untuk mengetahui detail tentang cara menemukan nama koneksi instance, mengonfigurasi izin yang diperlukan, dan menyiapkan konektivitas jaringan.

Menemukan nama koneksi instance

Nama koneksi instance mengidentifikasi instance Anda di Google Cloud. Anda bisa mendapatkannya dari konsol Google Cloud , atau dengan menggunakan command line.

Menggunakan konsol

  1. Buka https://console.cloud.google.com/sql/instances.
  2. Klik ID Instance yang ingin dihubungkan.
  3. Di sebelah kiri, Anda akan menemukan Nama koneksi di bagian "Hubungkan ke instance ini".

Menggunakan command line

Untuk menemukan nama koneksi menggunakan antarmuka command line Cloud, gunakan perintah berikut:

gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

Izin

Anda setidaknya harus memiliki izin cloudsql.client di project Cloud SQL untuk MySQL untuk membuat koneksi. Jika tidak memiliki (atau tidak dapat memperoleh) akses ini, Anda dapat menggunakan konektor MySQL sebagai gantinya.

Konektivitas jaringan

Konektor Cloud SQL untuk MySQL mendukung koneksi ke instance Cloud SQL untuk MySQL dengan konektivitas IP publik dan konektivitas IP pribadi.

Anda harus mengonfigurasi konektivitas IP publik atau konektivitas IP pribadi untuk instance Cloud SQL untuk MySQL sebelum menggunakan konektor Cloud SQL untuk MySQL.

Untuk mengizinkan Data Studio mengakses data di Cloud SQL dan membuat kueri terhadap data ini melalui koneksi pribadi, pilih opsi Jalur pribadi untuk layanan Google Cloud di setelan instance Cloud SQL untuk MySQL Anda.

Jenis data yang didukung

Data Studio memetakan jenis data bawaan database Anda ke kumpulan jenis data yang terpadu. Jika Data Studio menemukan kolom dalam tabel atau kueri Anda dari jenis yang tidak didukung, kolom tersebut tidak akan dibuat menjadi kolom.

Akses database dan firewall

Agar Data Studio dapat terhubung ke dan melakukan kueri database yang berada di belakang firewall, Anda perlu membuka akses ke salah satu alamat IP berikut. Anda mungkin juga perlu mengonfigurasi database untuk menerima traffic dari alamat tersebut. Lihat dokumentasi untuk database spesifik Anda guna mengetahui petunjuk tentang cara melakukannya.

Alamat IP

Alamat berikut dicadangkan untuk infrastruktur global Data Studio:

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (Opsional, untuk platform yang mendukung IPv6)

Jika Anda telah mengaktifkan residensi data untuk langganan Data Studio Pro, gunakan alamat berikut:

  • 142.251.56.0/24

  • 2001:4860:4815::/48 (Opsional, untuk platform yang mendukung IPv6)

Batas konektor Cloud SQL untuk MySQL

  • Data Studio tidak mendukung Ekstensi Data Spasial MySQL.
  • Anda dapat mengajukan kueri maksimum 150 ribu baris per kueri menggunakan konektor ini. Jika Anda melebihi batas ini, data akan terpotong.
  • Header kolom (nama kolom) hanya boleh menggunakan karakter ASCII. Karakter non-ASCII tidak didukung.

Pemecahan masalah

Lihat panduan pemecahan masalah Data Studio untuk mengetahui daftar pesan error umum dan langkah-langkah untuk mengatasinya.