All Products
Search
Document Center

DataWorks:Buat dan kelola templat aturan kustom

Last Updated:Mar 27, 2026

Saat mengelola kualitas data dalam skala besar, menulis logika aturan yang sama berulang kali untuk setiap tabel rentan terhadap kesalahan dan sulit dipelihara. Templat aturan memungkinkan Anda mendefinisikan logika pemantauan SQL kustom sekali saja dan menggunakannya kembali di sebanyak mungkin tabel sesuai kebutuhan. Saat Anda memperbarui templat, hanya aturan yang secara aktif mereferensikannya yang terpengaruh—aturan pemantauan yang dibuat dari versi sebelumnya tetap tidak berubah.

Prasyarat

Sebelum memulai, pastikan Anda telah:

  • Mengaktifkan DataWorks Enterprise Edition atau edisi yang lebih tinggi.

Mengapa menggunakan templat aturan

RekomendasiManfaat
Definisikan logika SQL sekali dalam templatTerapkan aturan pemantauan yang sama ke beberapa tabel tanpa perlu menulis ulang SQL setiap kali
Kelola templat dalam folderKelompokkan templat terkait berdasarkan domain atau tim agar lebih mudah ditemukan dan digunakan kembali
Perbarui templat secara terpusatUbah logika templat di satu tempat; hanya aturan yang mereferensikan templat yang diubah yang terpengaruh

Buat templat aturan

  1. Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah target. Di panel navigasi kiri, pilih Data Governance > Data Quality, pilih ruang kerja dari daftar drop-down, lalu klik Go to Data Quality.

  2. Di panel navigasi kiri, pilih Assets > Rule Template Library.

  3. Klik ikon 新建 dan pilih Create Folder.

  4. Pada kotak dialog Create Folder, atur parameter Name dan Location, lalu klik OK.

  5. Di pohon direktori, klik kanan folder tersebut dan pilih Create Rule Template.

    Catatan: Anda juga dapat rename atau delete folder melalui menu klik kanan.
  6. Pada kotak dialog Create Rule Template, konfigurasikan parameter-parameter berikut.

    image.png

    ParameterDeskripsi
    Template NameNama templat aturan.
    FieldBidang yang akan dipantau. Tetap sebagai Custom SQL.
    Sampling MethodMetode pengambilan sampel. Tetap sebagai Custom SQL.
    Set FlagKlausa SET dari pernyataan SQL yang digunakan untuk mengkueri bidang yang dipantau. Pisahkan beberapa pernyataan dengan koma (,). Jangan tambahkan titik koma (;) di akhir setiap pernyataan.
    Check typeJenis ambang batas. Nilai yang valid: Numeric type dan Fluctuation.
    Verification MethodMetode perbandingan untuk hasil pemeriksaan. Opsi bergantung pada nilai Check type—lihat tabel di bawah ini.
    Custom SQLPernyataan SQL yang mengkueri bidang yang akan dipantau. Gunakan ${tableName} sebagai placeholder untuk nama tabel. Kueri harus mengembalikan satu nilai tunggal yang dapat dibandingkan terhadap ambang batas.
    LocationFolder tempat menyimpan templat.

    Metode verifikasi dan ambang batas yang diperlukan berdasarkan jenis pemeriksaan

    Opsi Verification Method dan ambang batas yang harus Anda definisikan saat menerapkan templat bergantung pada Check type yang Anda pilih.

    Check typeOpsi metode verifikasiAmbang batas yang diperlukan saat penerapan
    Numeric typeCompare with a specified value — kueri harus mengembalikan satu nilai COUNT atau SUM, yang kemudian dibandingkan dengan angka tetapAmbang batas Normal + ambang batas critical
    FluctuationBandingkan nilai saat ini dengan nilai rata-rata 7 hari terakhirAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationBandingkan nilai saat ini dengan nilai rata-rata 30 hari terakhirAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationBandingkan nilai saat ini dengan nilai 1 hari sebelumnyaAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationBandingkan nilai saat ini dengan nilai 7 hari sebelumnyaAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationBandingkan nilai saat ini dengan nilai 30 hari sebelumnyaAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationVarians antara nilai saat ini dan nilai 7 hari sebelumnyaAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationVarians antara nilai saat ini dan nilai 30 hari sebelumnyaAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationBandingkan dengan nilai 1, 7, dan 30 hari sebelumnyaAmbang batas Normal + ambang peringatan + ambang batas critical
    FluctuationBandingkan dengan nilai siklus sebelumnyaAmbang batas Normal + ambang peringatan + ambang batas critical

    Custom SQL dan placeholder `${tableName}`

    Gunakan ${tableName} dalam SQL Anda agar templat dapat digunakan kembali di berbagai tabel. DataWorks mengganti placeholder tersebut dengan nama tabel aktual pada waktu proses. Kueri harus mengembalikan satu nilai dalam satu baris. Untuk pemeriksaan Numeric type, nilai tersebut harus merupakan output dari fungsi COUNT atau SUM.

  7. Klik OK.

Kelola templat aturan

Klik nama templat di Rule Template Library untuk membuka halaman detailnya. Dari sana, Anda dapat melihat, mengedit, menghapus, atau menyalin templat tersebut.

TindakanLangkah-langkah
ViewTinjau pengaturan parameter templat, aturan yang mereferensikannya (tab Application List), dan riwayat operasinya (tab View Log). Tab View Log mencatat pengguna, cap waktu, dan detail setiap operasi.
EditKlik Edit di pojok kanan atas, perbarui parameter dalam kotak dialog Edit Rule Template, lalu klik OK.
DeleteKlik Delete di pojok kanan atas dan konfirmasi dalam pesan Delete Template.
CopyKlik Copy di pojok kanan atas. Dalam kotak dialog Clone Rule Template, atur Template Name dan Location baru, lalu klik OK.
Catatan: Perubahan pada aturan kustom hanya berlaku untuk tugas yang mereferensikan aturan kustom yang diubah tersebut. Tugas yang sudah ada dan menggunakan aturan kustom asli tidak terpengaruh.

Terapkan templat aturan ke aturan pemantauan

  1. Dari halaman Data Quality, pilih Configure Rules > Configure by Table di panel navigasi kiri.

  2. Di bagian Connection, pilih database tempat tabel yang ingin Anda konfigurasikan berada. Temukan tabel target dengan memfilter berdasarkan jenis database, database, dan nama tabel. Klik nama tabel atau klik Rule Management di kolom Actions untuk membuka halaman Table Quality Details. Halaman ini mencantumkan semua aturan yang dikonfigurasikan untuk tabel tersebut. Untuk aturan yang tidak terkait dengan monitor, Anda dapat langsung mengatur mode running dari halaman ini.

    image

  3. Di tab Rule Management, pilih monitor dan klik Create Rule. Panel Create Rule akan terbuka.

  4. Pilih templat aturan kustom Anda. Bidang FLAG parameter dan SQL akan diisi otomatis dari templat. Atur Rule Name dan konfigurasikan ambang batas berdasarkan jenis pemeriksaan templat:

    Check typeAmbang batas yang perlu dikonfigurasi
    Numeric typeAmbang batas Normal dan ambang batas critical
    FluctuationAmbang batas Normal, ambang peringatan, dan ambang batas critical

    image

  5. Klik Determine.

Langkah berikutnya