DataWorks:Debug node dan alur kerja

Debug satu node

1. Buka halaman DataStudio. 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.

   Catatan

   Jika Anda tidak memiliki izin untuk 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 Run	Deskripsi	Kasus penggunaan
   Run ( icon)	Opsi ini memungkinkan Anda menetapkan nilai ke 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 menetapkan nilai konstan ke 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 menetapkan nilai konstan ke variabel untuk skenario pengujian dan menentukan kelompok sumber daya.	Gunakan opsi ini ketika Anda perlu mengubah nilai 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 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 DataStudio. 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) di bilah alat panel alur kerja untuk menjalankan semua task dalam alur kerja secara berurutan berdasarkan dependensi.

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

   Eksekusi melalui bilah alat dan eksekusi melalui klik kanan memiliki mekanisme yang berbeda:

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

   • Right-click Run Node and Downstream Nodes: Dimulai dari node yang dipilih dan menjalankannya bersama node-node downstream-nya menggunakan logika penjadwalan dependensi. Metode ini memvalidasi status eksekusi dan data keluaran node hulu, yang berbeda dengan menjalankan node secara langsung di tab editornya (mode debug mandiri).

   Jika terjadi error saat Anda mengklik kanan untuk menjalankan node dan node downstream-nya, tetapi SQL yang sama berjalan tanpa error di tab editor node, penyebabnya adalah eksekusi klik kanan menerapkan logika penjadwalan dependensi dan memvalidasi status eksekusi serta data keluaran node hulu, sedangkan eksekusi langsung hanya menjalankan kode SQL node saat ini. Lakukan 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. Periksa 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 penetapan parameter penjadwalan sesuai ekspektasi. Di halaman pengaturan penjadwalan node, periksa apakah tabel output hulu sesuai dengan tabel input node saat ini.

   • Klik kanan node yang gagal, pilih View Run Logs, dan temukan informasi error spesifik. Error dalam log biasanya mencantumkan penyebab spesifik (misalnya tabel tidak ditemukan, izin tidak mencukupi, atau kesalahan sintaksis).

   • Periksa apakah terdapat masalah sintaksis komentar dalam SQL. Beberapa mesin mengurai komentar secara berbeda dalam mode penjadwalan dibandingkan mode eksekusi langsung, yang dapat menyebabkan kesalahan sintaksis. Untuk memecahkan masalah, hapus komentar blok (/* */) dari SQL terlebih dahulu dan biarkan hanya komentar baris (--) untuk melihat apakah error masih terjadi.

   • Periksa apakah data keluaran 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 menetapkan nilai ke parameter tersebut. Kemudian, jalankan alur kerja untuk melihat hasil penetapan dan status eksekusi task manual.

   • Hanya beberapa tipe node yang mendukung parameter alur kerja. Lihat antarmuka aktual untuk detailnya.

   • Setelah eksekusi selesai, Anda dapat mengklik kanan node tertentu di panel alur kerja untuk melihat log waktu prosesnya.

Lihat Operating history

Anda dapat membuka halaman Operating history di Data Studio untuk melihat semua catatan eksekusi task akun saat ini selama 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 ad hoc query

Proses hasil kueri