Membuat kueri data Anda

Editor SQL terpadu ekstensi IDE Google Cloud Data Agent Kit memungkinkan Anda menjalankan kueri SQL terhadap data Google Cloud langsung dari IDE Anda.

Jika menggunakan plugin Data Agent Kit dengan agen coding yang didukung, Anda dapat menjalankan kueri SQL di agen atau menggunakan perintah bahasa alami untuk membuat kueri SQL.

Sumber data yang didukung

Data Agent Kit memungkinkan Anda membuat kueri tabel dan tampilan di layanan data Google Cloud berikut:

  • BigQuery
  • Spanner
  • AlloyDB untuk PostgreSQL
  • Cloud SQL untuk MySQL
  • Cloud SQL untuk PostgreSQL

Untuk Cloud SQL, kueri menggunakan autentikasi database Identity and Access Management (IAM) dan autentikasi database bawaan (dengan sandi yang disimpan sebagai secret regional di Secret Manager) didukung. Untuk mengetahui informasi selengkapnya tentang cara Cloud SQL mengautentikasi pengguna bawaan dengan Secret Manager, lihat artikel Menjalankan pernyataan SQL menggunakan Data API untuk Cloud SQL untuk MySQL dan Cloud SQL untuk PostgreSQL. Untuk AlloyDB, hanya kueri yang menggunakan autentikasi database IAM yang didukung.

Sebelum memulai

Sebelum membuat kueri data, lakukan hal berikut:

  1. Instal ekstensi.
  2. Mengonfigurasi setelan ekstensi.
  3. Tinjau panduan di Menemukan dan menjelajahi data.

Membuat file SQL baru

Anda dapat membuka editor SQL dengan beberapa cara.

Membuat file SQL baru dari menu File

  1. Di panel menu VS Code, klik File, lalu New Text File. File tanpa judul akan muncul di editor.
  2. Simpan file baru dengan ekstensi .sql.
  3. Klik Pilih Koneksi di tab editor.
  4. Selesaikan langkah-langkah di Mengonfigurasi setelan kueri.

Membuat kueri baru dari Katalog

  1. Di tab Google Cloud Data Agent Kit di panel aktivitas, luaskan Catalog untuk menemukan set data yang ingin Anda kueri.
  2. Klik kanan atau ctrl+klik nama set data, lalu pilih Query untuk membuka file SQL baru yang telah dikonfigurasi sebelumnya untuk set data tersebut.

Membuat kueri baru dari bagian BigQuery

  1. Di tab Google Cloud Data Agent Kit di panel aktivitas, luaskan BigQuery.
  2. Klik + Kueri Baru. File SQL tanpa judul yang dikonfigurasi dengan BigQuery sebagai sumber datanya akan muncul di editor.

Mengonfigurasi setelan kueri

Setelan yang diperlukan untuk kueri SQL Anda bervariasi menurut Google Cloud layanan.

AlloyDB

  1. Di SQL editor, klik Open Query Settings.
  2. Pilih Databases.
  3. Pilih AlloyDB.
  4. Pilih cluster.
  5. Pilih instance. Kueri Anda akan diarahkan ke instance ini.
  6. Pilih database.
  7. Klik Simpan.

BigQuery

  1. Di SQL editor, klik Open Query Settings.
  2. Pilih BigQuery.
  3. Klik Simpan.

Cloud SQL

  1. Di SQL editor, klik Open Query Settings.
  2. Pilih Databases.
  3. Pilih Cloud SQL.
  4. Pilih instance. Kueri Anda akan diarahkan ke instance ini.
  5. Pilih database yang akan dikueri.

  6. Di bagian Metode autentikasi, pilih cara melakukan autentikasi:

    • Autentikasi database IAM: Lakukan autentikasi menggunakan akun Google Cloud Anda.

    • Autentikasi database bawaan: Lakukan autentikasi sebagai pengguna database bawaan yang sandinya disimpan sebagai secret regional di Secret Manager.

      1. Di daftar Pengguna, pilih pengguna database. Jika daftar tidak dapat dimuat, masukkan nama pengguna di kolom Pengguna. Untuk Cloud SQL untuk MySQL, pengguna root default tidak didukung.
      2. Di daftar Password (stored in Secret Manager), pilih secret regional yang menyimpan sandi pengguna. Jika Anda belum memiliki secret, pilih Create new secret in region REGION, masukkan Name dan Password, lalu klik Create Secret. Secret dibuat di region yang sama dengan instance Anda.
      3. Opsional: Di daftar Secret version, pilih versi tertentu. Secara default, terbaru dipilih, yang selalu menggunakan versi secret terbaru.

      Untuk mengetahui informasi selengkapnya tentang persyaratan pengguna bawaan dan rahasia regional, lihat artikel Menjalankan pernyataan SQL menggunakan Data API untuk Cloud SQL untuk MySQL dan Cloud SQL untuk PostgreSQL.

  7. Klik Simpan.

Spanner

  1. Di SQL editor, klik Open Query Settings.
  2. Pilih Databases.
  3. Pilih Kunci pas.
  4. Pilih instance. Kueri Anda akan diarahkan ke instance ini.
  5. Pilih database yang akan dikueri.
  6. Klik Simpan.

Mengubah setelan kueri

Setelan kueri khusus untuk setiap file SQL. Setelah membuka file SQL, Anda dapat mengubah setelan.

  1. Di editor, klik sumber data yang ditampilkan. Editor Setelan Kueri akan muncul.
  2. Selesaikan langkah-langkah di Mengonfigurasi setelan kueri.

Menjalankan kueri

Setelah membuat file kueri dan menyusun kueri, klik ▷ Jalankan Kueri.

Tab Results di panel Query Results menampilkan hasil kueri.

Untuk menjalankan subset pernyataan SQL di editor kueri, tandai subset sebelum mengklik ▷ Run Query.

Fitur editor SQL

Tidak semua fitur editor SQL didukung untuk setiap jenis sumber data. Tabel berikut mencantumkan fitur editor SQL yang didukung per jenis sumber data selama Pratinjau.

Fitur

BigQuery

Spanner

Cloud SQL

AlloyDB untuk PostgreSQL

Tab panel hasil kueri

Hasil kueri

✅

✅

✅

✅

Informasi pekerjaan

✅

Tidak berlaku

Tidak berlaku

Tidak berlaku

Detail eksekusi

✅

❌

Tidak didukung

❌

Tidak didukung

❌

Tidak didukung

Visualisasi

✅

✅

✅

✅

Konfigurasi editor SQL

Setelan kueri

✅

✅

✅

✅

Fitur tambahan

Dukungan kueri multi-pernyataan

✅

✅

✅

✅

Katalog: Menyisipkan nama resource di editor

✅

✅

✅

✅

Langkah berikutnya