All Products
Search
Document Center

DataWorks:Edit field and assign value

Last Updated:Feb 27, 2026

Di DataWorks, Anda dapat menggunakan komponen Edit Field and Assign Value dalam task sinkronisasi real-time satu tabel untuk menambahkan bidang baru dan menuliskannya ke destinasi.

Langkah 1: Konfigurasikan task integrasi data

  1. Buat sumber data. Untuk informasi selengkapnya, lihat Data source management.

  2. Buat task Data Integration. Untuk informasi selengkapnya, lihat Configure a single-table real-time synchronization task.

    Catatan

    Untuk task sinkronisasi real-time satu tabel di Data Integration, Anda dapat menyisipkan node pemrosesan data di antara node Source dan Destination. Untuk informasi selengkapnya, lihat Supported data sources and synchronization solutions.

Langkah 2: Tambahkan pengeditan dan penugasan bidang

  1. Pada konfigurasi task sinkronisasi real-time satu tabel, aktifkan sakelar Data Processing, klik +Add Node, lalu pilih komponen Edit Field and Assign Value.

  2. Konfigurasikan komponen Edit Field and Assign Value.

    image

    • Upstream fields

      • Field Name: Nama bidang dari output upstream.

      • Type: Tipe data bidang dari output upstream.

      • Value: Untuk bidang upstream yang sudah ada, nilai diwarisi dari output upstream. Untuk bidang baru, Anda menentukan cara menghasilkan nilainya dengan memilih salah satu dari tiga metode: Assignment, Variable, atau Function.

      • Actions: Menentukan apakah bidang tersebut diteruskan ke komponen downstream.

    • Custom fields: Klik Add field di pojok kiri bawah halaman Edit Field and Assign Value untuk menambahkan bidang baru.

      • Assignment: Menetapkan konstanta yang Anda masukkan ke bidang baru. Konstanta tersebut dikonversi ke tipe data yang ditentukan.

      • Variable: Menetapkan nilai variabel bawaan ke bidang baru saat runtime. Variabel bawaan yang didukung tercantum dalam tabel berikut.

        Catatan

        Dukungan variabel bergantung pada karakteristik spesifik dari Source dan Destination.

        Supported variables

        Variable name

        Description

        Source

        PROCESS_TIME

        Waktu ketika task sinkronisasi memproses catatan tersebut. Ini adalah Stempel waktu Milidetik 13 digit.

        DATASOURCE_NAME_SRC

        Nama Sumber Data Asal.

        DB_NAME_SRC

        Nama database Source.

        SCHEMA_NAME_SRC

        Nama skema Source.

        TABLE_NAME_SRC

        Nama tabel Source.

        TOPIC_NAME_SRC

        Nama topik Source.

        Destination

        TABLE_NAME_DEST

        Nama tabel Destination.

        TOPIC_NAME_DEST

        Nama topik Destination.

        SCHEMA_NAME_DEST

        Nama skema Destination.

        DB_NAME_DEST

        Nama database Destination.

        DATASOURCE_NAME_DEST

        Nama Destinasi Data Source.

      • Function: Melakukan perhitungan fungsi selama sinkronisasi dan menetapkan hasilnya ke bidang baru. Jika terjadi exception selama pemrosesan fungsi, catatan terkait dianggap sebagai dirty data, dimasukkan dalam statistik dirty data task sinkronisasi, dan task tersebut dapat dihentikan berdasarkan konfigurasi toleransi dirty data.

        Supported functions

        Function name

        Parameter

        Description

        DATE_FORMAT

        • Parameter 1: Bidang upstream bertipe numerik, yang dapat berupa stempel waktu UNIX 10 digit atau stempel waktu milidetik 13 digit.

        • Parameter 2: Jenis stempel waktu. unix menunjukkan stempel waktu UNIX 10 digit, dan millis menunjukkan stempel waktu milidetik 13 digit.

        • Parameter 3: Zona waktu yang digunakan untuk konversi.

        • Parameter 4: Format string tanggal target, misalnya, yyyy-MM-dd HH:mm:ss:SSS ZZ. yyyy merepresentasikan tahun, MM bulan, dd hari, HH jam (format 24 jam), mm menit, ss detik, SSS milidetik, dan ZZ zona waktu.

        Mengonversi stempel waktu menjadi string waktu dalam format tertentu.

        TO_TIMESTAMP

        • Parameter 1: Bidang upstream bertipe teks, merepresentasikan string waktu dalam format tertentu.

        • Parameter 2: Jenis stempel waktu target. unix menunjukkan stempel waktu UNIX 10 digit, dan millis menunjukkan stempel waktu milidetik 13 digit.

        • Parameter 3: Zona waktu yang digunakan untuk konversi.

        • Parameter 4: Format string waktu, misalnya, yyyy-MM-dd HH:mm:ss:SSS ZZ. yyyy merepresentasikan tahun, MM bulan, dd hari, HH jam (format 24 jam), mm menit, ss detik, SSS milidetik, dan ZZ zona waktu.

        Mengonversi string waktu menjadi stempel waktu 10 digit atau 13 digit.

        SUBSTRING

        • Parameter 1: Bidang upstream bertipe teks.

        • Parameter 2: Posisi awal substring (inklusif). Posisi awal minimum adalah 0.

        • Parameter 3: Panjang substring. Jika panjangnya kurang dari atau sama dengan 0, maka mengembalikan substring dari posisi awal hingga akhir.

        Mengambil substring dari sebuah string.

Langkah selanjutnya

Setelah mengonfigurasi sumber data serta mengedit dan menetapkan bidang, Anda dapat mengklik Data Output Preview untuk memverifikasi apakah data keluaran dari node saat ini sesuai dengan kebutuhan Anda. Bidang baru hanya dapat dituliskan ke tabel destinasi setelah dipetakan ke bidang pada tabel destinasi dalam pemetaan bidang.