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 yang memiliki hak 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. 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 PostgreSQL.

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.

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 STATEMENT_TIMEOUT tidak didukung.
  • 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 akan menghentikan eksekusi kueri di Cloud SQL Studio. Kueri akan berjalan hingga selesai atau waktu habis.
  • Jika Anda menjalankan beberapa pernyataan di editor kueri secara bersamaan dan satu atau beberapa pernyataan menghasilkan error, eksekusi semua pernyataan akan dibatalkan dan error pertama yang ditemui akan ditampilkan.
  • Saat Cloud SQL Studio mendeteksi sintaksis kueri yang tidak valid, Cloud SQL Studio akan membuat a log di postgres.log. Entri ini muncul sebagai entri cloudsqladmin, dan berisi kueri yang tidak valid, posisi error sintaksis, dan pesan error yang sesuai. Untuk menghapus log ini dari tampilan Anda, konfigurasikan filter log untuk mengecualikan database cloudsqladmin, pengguna cloudsqladmin, atau keduanya.
  • Skrip SQL dan respons eksekusinya mungkin transit melalui lokasi perantara antara klien Anda dan lokasi instance target.

Langkah berikutnya