Node penugasan SQL menjalankan pernyataan SELECT terhadap sebuah database dan menetapkan hasil kueri ke variabel output. Node downstream dalam alur tugas kemudian dapat mereferensikan variabel tersebut sebagai input. Bergantung pada jenis nodenya, variabel output dapat digunakan dengan cara yang berbeda:
Pada Single Instance SQL node, variabel dapat digunakan sebagai nama tabel atau dalam kondisi filter.
Pada Script node, variabel dapat digunakan sebagai parameter dalam skrip.
Pada Lindorm File Check node, variabel dapat digunakan sebagai nama file.
Tanpa node penugasan SQL, Anda harus menyematkan nilai secara langsung (hard-code) di setiap node downstream atau meneruskan data secara manual antar node. Dengan node ini, hasil kueri tunggal mengalir secara otomatis ke semua node yang membutuhkannya.
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
Akses ke Konsol DMS V5.0
Alur tugas yang sudah ada. Untuk membuatnya, lihat Ikhtisar
Izin baca pada database yang akan Anda kueri. Untuk mengajukan izin, lihat Ikhtisar
Batasan
Hanya pernyataan SELECT yang didukung di editor SQL.
Baris dan Kolom tidak dapat sekaligus diatur ke All Rows dan All Columns.
Nilai variabel output selalu berupa string.
Tambahkan node penugasan SQL ke alur tugas
Masuk ke Konsol DMS V5.0.
Di bilah navigasi atas, pilih DTS > Data Development > Task Orchestration.
Jika Anda menggunakan DMS dalam mode simple, klik ikon
di pojok kiri atas dan pilih All Features > DTS > Data Development > Task Orchestration.Klik nama alur tugas yang ingin Anda edit.
Di panel Task Type di sebelah kiri, seret node SQL Assignment for Single Instance ke kanvas.
Klik ganda node tersebut untuk membuka tab konfigurasinya.
Di kotak pencarian pada tab konfigurasi, masukkan kata kunci untuk mencari database Anda, lalu pilih dari daftar drop-down.
Klik tab Metadata di panel navigasi kanan untuk melihat skema tabel dalam database yang dipilih.
Klik tab Variable Setting di panel navigasi kanan untuk mengonfigurasi variabel dan konstanta.
Tip: Klik ikon
di pojok kanan atas panel Variable Setting untuk melihat petunjuk penggunaan.Panel ini berisi lima tab:
Tab Deskripsi Node Variable Variabel dengan cakupan node, termasuk variabel waktu. Lihat Konfigurasikan variabel waktu. Task Flow Constants Nilai tetap yang dibagikan di seluruh node dalam alur tugas. Referensikan dalam format ${name}.Task Flow Variable Variabel dengan cakupan alur tugas, termasuk variabel waktu. Lihat Konfigurasikan variabel waktu. Input Variables Variabel yang diteruskan dari node upstream (read-only). Output Variables Variabel yang dihasilkan oleh node ini untuk node downstream. Klik Increase Variable untuk menambahkannya. Pada tab Output Variables, klik Increase Variable dan konfigurasikan setiap variabel output:
Parameter Deskripsi Variable Nama dan deskripsi variabel. Row Baris mana yang disertakan: All Rows atau Specific Row. Column Kolom mana yang disertakan: All Columns atau Specific Column. Link Operator yang digunakan untuk menggabungkan nilai menjadi string. Ditampilkan ketika Row diatur ke All Rows atau Column diatur ke All Columns. Di editor SQL, tulis pernyataan SELECT menggunakan sintaksis database yang dipilih. Gunakan tombol di bilah alat untuk mengelola pernyataan Anda:
Preview — pratinjau SQL sebelum dijalankan.
Check — validasi sintaksis SQL.
Save — simpan pernyataan SQL.
Klik Try Run untuk menguji node.
Jika baris terakhir log eksekusi menampilkan
status SUCCEEDED, pengujian berhasil.Jika menampilkan
status FAILED, periksa log untuk mengidentifikasi node mana yang gagal dan alasannya, perbaiki konfigurasi, lalu coba lagi.
Langkah berikutnya
Untuk melihat contoh lengkap penggunaan node penugasan SQL dalam alur tugas nyata, lihat Gunakan fitur task orchestration untuk tagging e-commerce.
Untuk mempelajari cara node downstream menggunakan variabel output, seperti dalam nama tabel atau kondisi filter pada Single Instance SQL node, lihat Variabel.