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 Dataform core, Dataform akan mengompilasi kueri tersebut ke SQL secara real time. Untuk menguji output kueri SQL yang dikompilasi sebelum mengeksekusinya ke BigQuery, Anda dapat menjalankan pratinjau kueri di ruang kerja Dataform.

Saat Anda menjalankan pratinjau kueri, Dataform akan menjalankan tugas di BigQuery untuk menjalankan kueri yang dikompilasi dalam 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 hingga 24 jam. Untuk mengetahui informasi lebih lanjut tentang tugas BigQuery, lihat Pengantar tugas BigQuery.

Menjalankan pratinjau kueri di Dataform akan menimbulkan penagihan di BigQuery. Untuk mengetahui informasi lebih lanjut 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 dipratinjau selama sesi browser saat ini di panel Query results di ruang kerja Anda. Di panel Query results, Anda dapat melihat informasi berikut tentang setiap kueri yang dipratinjau selama sesi browser saat ini:

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

Selain itu, di panel Query results, 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 diperlukan untuk melihat pratinjau kueri di ruang kerja Dataform, minta administrator untuk memberi Anda peran IAM berikut:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

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 diedit saat ini 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 mengetahui 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 pekerjaan.
    2. Untuk memeriksa hasil kueri, pilih tab Hasil.
    3. Untuk melihat output JSON dari 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 dari 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. Jalankan pratinjau:
    • Untuk melihat pratinjau kueri pembuatan tabel, klik Jalankan.
    • Untuk melihat pratinjau kueri pernyataan, klik ikon drop-down di samping Run, lalu pilih kueri yang ingin Anda lihat pratinjaunya.
  4. Periksa hasil pratinjau di panel Query results.
    1. Untuk memeriksa detail tugas, pilih tab Informasi pekerjaan.
    2. Untuk memeriksa hasil kueri, pilih tab Hasil.
    3. Untuk melihat output JSON dari kueri, pilih tab JSON.
    4. Untuk melihat tugas pratinjau di ruang kerja SQL, klik menu Lainnya > Lihat tugas di ruang kerja SQL.

Langkah selanjutnya