DataWorks:Debug node dan alur kerja

Debug satu node

1. Buka halaman Data Studio. Di panel navigasi kiri, di bawah Data Development atau Manually Triggered Workflow, temukan alur kerja target dan klik ganda node yang ingin Anda edit.

2. Jalankan node untuk melakukan debug.

   Di tab editor node, gunakan Run atau Run with Parameters dari bilah alat untuk melakukan debug logika kode. Anda juga dapat menggunakan Quick run untuk melakukan debug potongan kode. Tabel berikut menjelaskan setiap opsi tersebut.

   Catatan

   Jika Anda tidak memiliki izin atas data yang ingin dikueri saat menjalankan node, lihat Ikhtisar pengelolaan izin untuk mesin komputasi dan data untuk memahami kontrol izin pada berbagai mesin komputasi di DataWorks.

   Opsi Jalankan	Deskripsi	Kasus Penggunaan
   Run ( icon)	Opsi ini memungkinkan Anda memberikan nilai pada variabel dan menentukan kelompok sumber daya untuk pengujian. Pengaturan ini disimpan untuk eksekusi berikutnya. Catatan Saat pertama kali menjalankan node yang baru dibuat, dialog konfigurasi akan muncul. Anda harus secara manual memberikan nilai konstan pada variabel dalam kode. DataWorks menyimpan nilai yang Anda tetapkan. Saat menjalankan node berikutnya, konfigurasi yang tersimpan akan digunakan secara default.	Gunakan opsi ini ketika Anda perlu sering melakukan debug kode.
   Run with Parameters ( icon)	Setiap kali menjalankan node, Anda harus memberikan nilai konstan pada variabel untuk skenario pengujian dan menentukan kelompok sumber daya.	Gunakan opsi ini ketika Anda perlu mengubah nilai yang diberikan pada variabel dalam kode atau mengganti kelompok sumber daya yang digunakan oleh task.
   Quick run ( icon)	Opsi ini memungkinkan Anda melakukan debug potongan kode di area kode pada tab editor node.	Gunakan opsi ini ketika Anda hanya perlu melakukan debug potongan kode dalam suatu node. Catatan Fitur ini hanya digunakan untuk memverifikasi kebenaran potongan kode. Untuk melakukan debug logika kode secara lengkap, gunakan Run atau Run with Parameters.

Debug alur kerja

1. Buka halaman Data Studio. Di panel navigasi kiri, di bawah Data Development atau Manually Triggered Workflow, klik ganda alur kerja target untuk membuka panelnya.

2. Lakukan debug alur kerja.

   Klik tombol Run ( icon) pada bilah alat panel alur kerja untuk menjalankan semua task dalam alur kerja secara berurutan sesuai dependensinya.

   Anda juga dapat mengklik kanan suatu node di panel alur kerja dan memilih Run Node and Downstream Nodes untuk menjalankan node tersebut beserta semua node downstream-nya berdasarkan dependensi.

   Opsi Run dari bilah alat dan Run Node and Downstream Nodes dari klik kanan bekerja secara berbeda:

   • Toolbar run: Menjalankan semua node secara berurutan dari hulu ke hilir berdasarkan DAG lengkap alur kerja. Setiap node dikirimkan untuk dijalankan secara independen, yang setara dengan menjalankan masing-masing node secara individual dari tab editornya.

   • Right-click Run Node and Downstream Nodes: Dimulai dari node yang dipilih dan menjalankan node tersebut beserta node downstream-nya dengan menerapkan logika penjadwalan dependensi. Opsi ini memvalidasi status eksekusi dan data keluaran dari node hulu, yang berbeda dari menjalankan node langsung dari tab editornya (mode debugging standalone).

   Jika terjadi error saat menggunakan Run Node and Downstream Nodes tetapi SQL yang sama berhasil dijalankan dari tab editor node, hal ini karena eksekusi klik kanan menerapkan logika penjadwalan dependensi untuk memvalidasi status eksekusi dan data keluaran dari node hulu, sedangkan eksekusi langsung hanya menjalankan kode SQL dari node saat ini. Anda dapat melakukan pemecahan masalah sebagai berikut:

   • Periksa status eksekusi node hulu. Eksekusi klik kanan memvalidasi dependensi hulu. Jika node hulu belum dijalankan atau gagal, node saat ini akan melaporkan error. Lihat ikon status eksekusi node hulu di panel alur kerja untuk memastikan semua node hulu telah berhasil dijalankan.

   • Periksa konfigurasi dependensi antar node. Pastikan penerusan parameter input dan output antar node benar dan penugasan parameter penjadwalan sesuai ekspektasi Anda. Di halaman pengaturan penjadwalan node, periksa apakah tabel output hulu sesuai dengan tabel input node saat ini.

   • Klik kanan node yang melaporkan error, pilih opsi untuk melihat log waktu proses, dan temukan pesan error spesifik. Error dalam log biasanya mencantumkan penyebab spesifik, seperti tabel tidak ada, izin tidak mencukupi, atau kesalahan sintaksis.

   • Periksa masalah sintaksis komentar dalam kode SQL. Beberapa mesin mengurai komentar secara berbeda dalam mode penjadwalan dibandingkan eksekusi langsung, yang dapat menyebabkan kesalahan sintaksis. Untuk memecahkan masalah, coba hapus komentar blok (/* */) dari kode SQL dan hanya pertahankan komentar baris (--), lalu periksa apakah error masih terjadi.

   • Periksa apakah data keluaran dari node hulu sudah siap. Eksekusi klik kanan bergantung pada tabel data yang dihasilkan oleh node hulu sebagai input. Jika node hulu telah berhasil dijalankan tetapi data keluarannya belum siap atau telah dibersihkan, node saat ini akan melaporkan error karena tidak dapat membaca tabel input.

   Catatan

   • Jika node dalam alur kerja yang dipicu secara manual memiliki variabel dengan nama yang sama dan variabel tersebut dapat ditetapkan secara seragam, Anda dapat mendefinisikan parameter alur kerja di panel alur kerja dan memberikan nilai pada parameter tersebut. Kemudian, jalankan alur kerja untuk melihat hasil penugasan dan status eksekusi task manual.

   • Hanya beberapa jenis node yang mendukung parameter alur kerja. Rujuk antarmuka aktual untuk detailnya.

   • Setelah eksekusi selesai, Anda dapat mengklik kanan suatu node di panel alur kerja untuk melihat log waktu proses node tersebut.

Lihat riwayat operasi

Anda dapat membuka halaman Operating history di Data Studio untuk melihat semua catatan task yang telah dijalankan oleh akun login saat ini di Data Studio dalam tiga hari terakhir.

Setelah task dijalankan di Data Studio, task tersebut dikirimkan ke mesin yang sesuai untuk dieksekusi. Bahkan jika Anda tidak sengaja menutup task selama eksekusi, task tersebut tetap berjalan. Anda dapat membuka halaman Operating history untuk melihat log waktu proses atau menghentikan task yang telah dikirimkan untuk dieksekusi.

Buat file kueri ad hoc

Proses hasil kueri