Halaman ini menjelaskan cara menjelajahi dan mengelola data Cloud SQL menggunakan Cloud SQL Studio di konsol Google Cloud.
Cloud SQL Studio memungkinkan pengguna yang diberi otorisasi berinteraksi langsung dengan database SQL dan menjalankan kueri SQL dari konsol Google Cloud untuk mengakses dan memanipulasi data. Anda dapat melakukan berbagai tindakan yang akan Anda lakukan di klien command line SQL, seperti membuat tabel dan indeks, mengubah tabel, atau menyiapkan tampilan.
Cloud SQL Studio menyertakan panel Explorer yang terintegrasi dengan editor kueri dan tabel hasil kueri SQL. Anda dapat menjalankan pernyataan DDL, DML, dan DQL dari satu antarmuka ini. Misalnya, daripada mengonfigurasi alat kueri database pihak ketiga, Anda dapat membuat tabel dan membuat kueri data menggunakan editor kueri di Cloud SQL Studio.
Anda dapat menggunakan panel Explorer untuk melihat dan berinteraksi dengan objek database. Anda membuat, mengubah, dan menghapus objek database, seperti berikut:
- Tabel
- Kolom
- Indeks dan kunci
- Functions
Anda juga dapat menggunakan panel Explorer untuk membuat kueri SELECT
untuk tabel.
Jika Anda baru menggunakan Cloud SQL, lihat ringkasan Cloud SQL.
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk menyelesaikan tugas dalam dokumen ini,
minta administrator untuk memberi Anda
peran IAM Cloud SQL Studio User (roles/cloudsql.studioUser
) di project.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Untuk menggunakan Cloud SQL Studio, Anda harus memiliki izin berikut:
cloudsql.databases.list
cloudsql.instances.executeSql
cloudsql.instances.get
cloudsql.instances.login
(hanya diperlukan jika Anda menggunakan autentikasi database IAM)cloudsql.users.list
Selain itu, pastikan Anda memiliki izin tingkat database untuk database yang Anda gunakan untuk autentikasi, dan sandi untuk pengguna database berhak istimewa yang Anda gunakan.
Melakukan autentikasi ke Cloud SQL Studio
Sebelum dapat mengakses database di Cloud SQL Studio, Anda harus memilih metode autentikasi database terlebih dahulu. Untuk login ke database menggunakan Cloud SQL Studio, Anda dapat menggunakan salah satu jenis autentikasi berikut:
Autentikasi database IAM. Dengan menggunakan jenis autentikasi ini, Anda dapat login ke database dan Cloud SQL Studio tanpa harus mengelola sandi tambahan. Anda juga dapat memanfaatkan autentikasi grup IAM dan mengelola akses dan hak istimewa database untuk beberapa pengguna di organisasi Anda secara bersamaan.
Autentikasi database bawaan. Anda terhubung ke database di Cloud SQL Studio menggunakan akun pengguna MySQL dan kredensial Anda.
Jelajahi data Anda
Untuk mengakses panel Explorer, ikuti langkah-langkah berikut:
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih instance dari daftar.
- Di menu navigasi, klik Cloud SQL Studio.
- Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda. Panel Penjelajah menampilkan daftar objek di database Anda.
Membuat, mengubah, dan membuat kueri data
Dengan editor SQL, Anda dapat menjalankan kombinasi pernyataan DDL, DML, dan DQL. Anda dapat menulis kueri sendiri, atau mengisi editor kueri dengan template menggunakan penjelajah.
Untuk menyusun, memodifikasi, atau membuat kueri data Anda, ikuti langkah-langkah berikut:
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih instance dari daftar.
- Di menu navigasi, klik Cloud SQL Studio.
- Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda.
- Buat kueri menggunakan salah satu metode berikut:
- Untuk membuat kueri Anda sendiri, ikuti langkah-langkah berikut:
- Buka tab baru dengan mengklik .
- Saat editor kueri muncul, tulis kueri Anda.
- Untuk membuat kueri yang dimulai dengan template, ikuti langkah-langkah berikut:
- Di panel Explorer, di samping objek atau koleksi database, klik more_vert View actions. Satu atau beberapa tindakan yang tersedia akan muncul.
- Klik tindakan. Editor kueri akan diisi dengan template.
- Ganti placeholder apa pun dalam template.
- Untuk membuat kueri Anda sendiri, ikuti langkah-langkah berikut:
- Jalankan kueri Anda menggunakan salah satu pendekatan berikut:
- Untuk menjalankan semua pernyataan di editor kueri, klik Run.
- Untuk menjalankan pernyataan tertentu, pilih satu atau beberapa pernyataan, lalu klik Jalankan yang dipilih.
- Hasil kueri Anda akan muncul di tab Results. Jika ada beberapa set hasil yang tersedia, pilih hasil dari menu drop-down Semua hasil.
Batasan
- Cloud SQL Studio mendukung kueri ringan. Respons yang lebih dari 10 MB mungkin terpotong. Cloud SQL Studio menunjukkan kapan hasil sebagian ditampilkan.
- Anda hanya dapat menjalankan kueri untuk instance Cloud SQL yang sedang berjalan.
- Cloud SQL Studio tidak mendukung server eksternal.
- Permintaan yang memerlukan waktu lebih dari lima menit akan dibatalkan. Untuk Cloud SQL untuk MySQL 5.6 dan 5.7, waktu tunggu pernyataan DDL yang berjalan lama dapat menyebabkan file atau tabel yang tidak digunakan lagi dan tidak dapat di-roll back dengan aman. Berhati-hatilah dengan kueri seperti
ALTER TABLE
pada tabel besar. - Cloud SQL Studio tidak membiarkan koneksi database tetap terbuka setelah eksekusi skrip SQL selesai. Demikian pula, tab editor tidak berbagi sesi umum dan setiap eksekusi memulai sesi baru.
- Saat Anda menjalankan campuran pernyataan DML, DQL, dan DDL, hanya hasil dari kueri DQL yang akan ditampilkan.
- Menutup browser atau tab browser tidak akan menghentikan eksekusi kueri di Cloud SQL Studio. Kueri akan berjalan hingga selesai atau waktu tunggu habis.
- Cloud SQL Studio tidak mendukung kueri
SELECT
yang berjalan pada dataBLOB
. Jika skrip SQL menghasilkan kolomBLOB
dalam output, skrip SQL akan gagal dengan error. - Perintah klien Cloud SQL untuk MySQL tidak didukung dan tidak dapat dijalankan di Cloud SQL Studio.
- Pengguna
root
tidak didukung di Cloud SQL Studio. - Cloud SQL Studio selalu memerlukan database meskipun Cloud SQL untuk MySQL tidak memerlukan database untuk terhubung.
- Pengguna dengan sandi kosong tidak didukung di Cloud SQL Studio.
USE database
bersifat stateful hanya untuk eksekusi kueri aktif dan tidak berfungsi sama seperti di gcloud CLI.- Pengguna database harus memiliki izin untuk terhubung dari localhost.
Saat menjalankan beberapa kueri dan salah satunya gagal, error pertama yang ditemukan akan ditampilkan. Beberapa pernyataan dalam batch sebelum error mungkin telah berhasil dieksekusi. Anda dapat menggabungkan beberapa kueri dalam pernyataan
transaction
untuk mencegah masalah ini:START TRANSACTION; YOUR_SQL_STATEMENTS COMMIT;
Ganti kode berikut:
- YOUR_SQL_STATEMENTS: pernyataan yang ingin Anda jalankan sebagai bagian dari kueri ini