Mengelola data menggunakan Cloud SQL Studio

Halaman ini menjelaskan cara menjelajahi dan mengelola data Cloud SQL menggunakan Cloud SQL Studio di Google Cloud Konsol.

Cloud SQL Studio memungkinkan pengguna yang diberi otorisasi berinteraksi langsung dengan database SQL dan menjalankan kueri SQL dari Google Cloud Konsol 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
  • Fungsi

Anda juga dapat menggunakan panel Explorer untuk mengisi kueri SELECT untuk tabel.

Cloud SQL Studio otomatis memvalidasi sintaksis saat Anda mengetik kueri atau memilih bagian kueri.

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 Pengguna Cloud SQL Studio (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 istimewa yang Anda gunakan.

Mengautentikasi 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. Menggunakan jenis autentikasi ini memungkinkan Anda login ke database dan Cloud SQL Studio tanpa harus mengelola sandi tambahan. Anda juga dapat memanfaatkan autentikasi grup IAM dan mengelola akses serta hak istimewa database untuk beberapa pengguna di organisasi Anda secara bersamaan.

  • Autentikasi database bawaan. Anda terhubung ke database di Cloud SQL Studio menggunakan akun dan kredensial pengguna MySQL.

Menjelajahi data Anda

Untuk mengakses panel Explorer, ikuti langkah-langkah berikut:

  1. Di Google Cloud Konsol, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Pilih instance dari daftar.
  3. Di menu navigasi, klik Cloud SQL Studio.
  4. Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda. Panel Explorer menampilkan daftar objek di database Anda.

Membuat, mengubah, dan membuat kueri data

Dengan menggunakan editor SQL, Anda dapat menjalankan kombinasi pernyataan DDL, DML, dan DQL. Anda dapat membuat kueri sendiri, atau mengisi editor kueri dengan template menggunakan explorer.

Untuk menyusun, mengubah, atau membuat kueri data, ikuti langkah-langkah berikut:

  1. Di Google Cloud Konsol, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Pilih instance dari daftar.
  3. Di menu navigasi, klik Cloud SQL Studio.
  4. Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda.
  5. Buat kueri menggunakan salah satu metode berikut:
    • Untuk membuat kueri Anda sendiri, ikuti langkah-langkah berikut:
      1. Buka tab baru dengan mengklik .
      2. Saat editor kueri muncul, tulis kueri Anda.
    • Untuk membuat kueri yang dimulai dengan template, ikuti langkah-langkah berikut:
      1. Di panel Explorer, di samping objek atau koleksi database, klik more_vert View actions. Satu atau beberapa tindakan yang tersedia akan muncul.
      2. Klik tindakan. Editor kueri akan diisi dengan template.
      3. Ganti placeholder apa pun dalam template.

  6. 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 Run selected.

  7. Hasil kueri Anda akan muncul di tab Results. Jika beberapa kumpulan hasil tersedia, pilih hasil dari daftar drop-down All results.

Memvalidasi sintaksis kueri

Saat Anda memasukkan kueri ke editor kueri, Cloud SQL Studio akan otomatis memvalidasi pernyataan untuk memeriksa error sintaksis.

Cloud SQL Studio memvalidasi kueri secara real time dari instance MySQL. Jika Anda telah mengaktifkan logging audit atau logging umum MySQL, sesi validasi akan dicatat seperti sesi lainnya. Untuk menghindari logging sesi validasi tersebut, Anda dapat menetapkan flag cloudsql_avoid_parse_session_logging ke on. Default-nya adalah off.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi flag database, lihat Mengonfigurasi flag database.

Batasan

  • Cloud SQL Studio mendukung kueri ringan. Jika respons SQL lebih dari 10 MB, respons akan dipangkas. 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. Menetapkan waktu tunggu kueri yang lebih tinggi menggunakan SET SESSION MAX_EXECUTION_TIME tidak didukung. Untuk Cloud SQL untuk MySQL 5.6 dan 5.7, pernyataan DDL yang berjalan lama dan mengalami waktu tunggu habis dapat menyebabkan file atau tabel yatim piatu yang tidak dapat di-roll back dengan aman. Berhati-hatilah dengan kueri seperti ALTER TABLE pada tabel besar.
  • Cloud SQL Studio tidak mempertahankan koneksi database tetap terbuka setelah eksekusi skrip SQL selesai. Demikian pula, tab editor tidak berbagi sesi yang sama 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 menghentikan eksekusi kueri di Cloud SQL Studio. Kueri akan berjalan hingga selesai atau waktu tunggu habis.
  • Cloud SQL Studio tidak mendukung menjalankan kueri SELECT pada data BLOB. Jika skrip SQL menghasilkan kolom BLOB 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 ditemui 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

  • Cloud SQL tidak memvalidasi bagian pernyataan SQL dari pernyataan yang disiapkan ( preparable_stmt ).

  • Skrip SQL dan respons eksekusinya mungkin transit melalui lokasi perantara antara klien Anda dan lokasi instance target.

Langkah berikutnya