Melihat pratinjau kueri SQL

Dokumen ini menunjukkan cara melihat pratinjau output kueri SQL di ruang kerja Dataform sebelum menjalankan kueri ke BigQuery.

Tentang pratinjau kueri di Dataform

Saat Anda mengembangkan kueri dalam file SQLX atau JavaScript dengan inti Dataform, Dataform akan mengompilasi kueri ke SQL secara real time. Untuk menguji output kueri SQL yang dikompilasi sebelum menjalankannya ke BigQuery, Anda dapat menjalankan pratinjau kueri di ruang kerja Dataform.

Saat Anda menjalankan pratinjau kueri, Dataform akan menjalankan tugas di BigQuery untuk mengeksekusi kueri yang dikompilasi di tabel tujuan sementara dan menampilkan hasil kueri di ruang kerja Anda. Anda dapat memeriksa output kueri sebelum memicu eksekusi untuk memublikasikan tabel ke BigQuery. Tabel sementara dengan kueri yang dipratinjau akan otomatis dihapus dalam waktu maksimal 24 jam. Untuk mengetahui informasi selengkapnya tentang tugas BigQuery, lihat Pengantar tugas BigQuery.

Menjalankan pratinjau kueri di Dataform akan menimbulkan penagihan di BigQuery. Untuk mengetahui informasi selengkapnya tentang harga BigQuery, lihat Harga BigQuery.

Selama pratinjau kueri, Dataform menggunakan kredensial pengguna Anda untuk menjalankan tugas di BigQuery. Namun, selama eksekusi alur kerja, Dataform menggunakan kredensial akun layanan Anda untuk membuat atau memperbarui aset di BigQuery.

Dataform menampilkan hasil semua kueri yang dilihat pratinjaunya selama sesi browser saat ini di panel Hasil kueri di ruang kerja Anda. Di panel Query results, Anda dapat melihat informasi berikut tentang setiap kueri yang dilihat pratinjaunya selama sesi browser saat ini:

  • Informasi lowongan
    • ID tugas BigQuery
    • Pengguna yang menjalankan pratinjau
    • Lokasi tempat tugas dijalankan, diambil dari file setelan alur kerja Anda
    • Waktu pembuatan, mulai, dan akhir tugas BigQuery
    • Durasi tugas BigQuery
    • Byte yang diproses
    • Byte yang ditagih di BigQuery
    • Prioritas tugas
    • Penggunaan legacy SQL dalam kueri
    • Tabel tujuan sementara kueri
  • Hasil kueri
  • Representasi JSON dari output kueri

Selain itu, di panel Hasil kueri, Anda dapat membuka file sumber setiap kueri yang dipratinjau, dan membuka BigQuery Studio untuk melihat tugas pratinjau.

Sebelum memulai

  1. Di konsol Google Cloud, buka halaman Dataform.

    Buka halaman Dataform

  2. Pilih atau buat repositori.

  3. Pilih atau buat ruang kerja pengembangan.

  4. Buat kueri SQL, misalnya, menentukan tabel.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna melihat pratinjau kueri, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

  • Dataform Editor (roles/dataform.editor) - ruang kerja
  • BigQuery Job User (roles/bigquery.jobUser) - 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.

Melihat pratinjau kueri

Untuk memeriksa hasil kueri di Dataform sebelum dieksekusi, jalankan pratinjau kueri di ruang kerja Anda. Jika file yang saat ini diedit berisi beberapa kueri, pilih kueri yang ingin Anda lihat pratinjaunya. Anda dapat melihat pratinjau satu kueri dalam satu waktu.

Menjalankan pratinjau sedikit berbeda untuk tabel dengan pernyataan. Untuk informasi selengkapnya, lihat Melihat pratinjau tabel dengan pernyataan.

Untuk melihat pratinjau kueri SQL dan melihat hasil kueri di ruang kerja Dataform, ikuti langkah-langkah berikut:

  1. Di panel Files, luaskan definitions/.
  2. Pilih file SQLX atau JavaScript.
  3. Klik Run.
    1. Jika file berisi beberapa kueri, di menu drop-down, pilih kueri yang ingin Anda lihat pratinjaunya.
  4. Periksa hasil pratinjau di panel Query results.
    1. Untuk memeriksa detail tugas, pilih tab Informasi tugas.
    2. Untuk memeriksa hasil kueri, pilih tab Hasil.
    3. Untuk melihat output JSON kueri, pilih tab JSON.
    4. Untuk melihat tugas pratinjau di ruang kerja SQL, klik menu Lainnya > Lihat tugas di ruang kerja SQL.

Melihat pratinjau tabel dengan pernyataan

Dalam file definisi tabel SQLX dengan pernyataan, Anda dapat melihat pratinjau kueri pembuatan tabel dan kueri pernyataan yang ditentukan.

Dataform memperlakukan kueri definisi tabel sebagai kueri default. Untuk melihat pratinjau kueri pembuatan tabel, klik Jalankan di ruang kerja Anda. Untuk melihat pratinjau kueri pernyataan, Anda harus memilihnya di menu drop-down di samping tombol Run. Anda dapat melihat pratinjau satu kueri dalam satu waktu.

Untuk melihat pratinjau kueri dalam file definisi tabel dengan pernyataan di ruang kerja Dataform, ikuti langkah-langkah berikut:

  1. Di panel Files, luaskan definitions/.
  2. Pilih file definisi tabel dengan pernyataan.
  3. Menjalankan pratinjau:
    • Untuk melihat pratinjau kueri pembuatan tabel, klik Run.
    • Untuk melihat pratinjau kueri pernyataan, klik ikon drop-down di samping Jalankan, lalu pilih kueri yang ingin Anda lihat pratinjaunya.
  4. Periksa hasil pratinjau di panel Query results.
    1. Untuk memeriksa detail tugas, pilih tab Informasi tugas.
    2. Untuk memeriksa hasil kueri, pilih tab Hasil.
    3. Untuk melihat output JSON kueri, pilih tab JSON.
    4. Untuk melihat tugas pratinjau di ruang kerja SQL, klik menu Lainnya > Lihat tugas di ruang kerja SQL.

Langkah selanjutnya