全部产品
Search
文档中心

DataWorks:Node Merge

更新时间:Nov 15, 2025

Topik ini menjelaskan apa itu node merge, cara membuatnya, serta cara menentukan logika penggabungannya. Topik ini juga memberikan contoh konfigurasi properti penjadwalan untuk node merge dan cara melihat detail eksekusinya.

Pengenalan Node

  • Node merge adalah node kontrol logis di DataStudio yang menggabungkan status eksekusi dari node-node leluhurnya. Fitur ini membantu menyelesaikan masalah terkait ketergantungan (dependency attachment) dan pemicu eksekusi (run triggers) untuk node turunan dari sebuah node cabang.

  • Dalam definisi logika node merge, Anda tidak dapat memilih status eksekusi untuk node merge itu sendiri. Anda hanya dapat menentukan kondisi yang, jika terpenuhi, menghasilkan status berhasil untuk node merge tersebut. Hal ini memungkinkan node turunan bergantung langsung pada node merge.

    Sebagai contoh, asumsikan bahwa sebuah node cabang C memiliki dua cabang yang secara logis saling eksklusif, yaitu C1 dan C2. Cabang-cabang ini menggunakan logika berbeda untuk menulis data ke tabel MaxCompute yang sama. Jika sebuah node turunan B bergantung pada keluaran dari tabel MaxCompute tersebut, Anda harus menggunakan node merge J untuk menggabungkan kedua cabang terlebih dahulu. Kemudian, tetapkan node merge J sebagai dependensi hulu untuk node B. Jika Anda menghubungkan node B secara langsung ke cabang C1 dan C2, salah satu cabang tersebut akan selalu gagal memenuhi kondisinya, sehingga status instans-nya menjadi Branch Not Selected. Akibatnya, node B juga akan memiliki status Branch Not Selected karena salah satu dependensi hulunya dilewati. Node tersebut kemudian akan berada dalam keadaan dry-run dan tidak akan dieksekusi. Hal yang sama berlaku untuk semua node turunannya.

Prasyarat

  • Pengguna RAM yang ingin Anda gunakan telah ditambahkan ke ruang kerja Anda.

    Jika Anda ingin menggunakan Pengguna RAM untuk mengembangkan tugas, Anda harus menambahkan Pengguna RAM tersebut ke ruang kerja Anda sebagai anggota dan memberikan peran Develop atau Workspace Administrator kepada Pengguna RAM tersebut. Peran Workspace Administrator memiliki izin yang lebih luas daripada yang diperlukan. Berhati-hatilah saat memberikan peran ini. Untuk informasi lebih lanjut tentang cara menambahkan anggota dan memberikan peran, lihat Tambahkan anggota ke ruang kerja.

  • Kelompok sumber daya arsitektur tanpa server telah dikaitkan dengan ruang kerja Anda. Untuk informasi lebih lanjut, lihat topik-topik dalam direktori Gunakan kelompok sumber daya arsitektur tanpa server.

  • Anda harus membuat node merge sebelum dapat mengembangkannya. Untuk informasi lebih lanjut, lihat Buat Tugas yang dipicu otomatis.

Perhatian

Anda hanya dapat menggunakan node merge di DataWorks Edisi Standar atau edisi yang lebih tinggi. Untuk informasi lebih lanjut tentang cara membeli atau melakukan Peningkatan DataWorks, lihat Edisi DataWorks.

Langkah 1: Kembangkan node merge

Setelah membuat node merge, buka tab konfigurasi node untuk menentukan logika penggabungannya. Langkah-langkah berikut menjelaskan cara mengonfigurasi node tersebut:

  1. Di bagian definisi logika merge, cari dan tambahkan node yang ingin Anda gabungkan. Anda dapat mencari node cabang berdasarkan keluaran node, ID node, atau nama node.

  2. Setelah menemukan node yang akan digabungkan, klik ikon image untuk menambahkan node tersebut ke pengaturan kondisi merge.

    Catatan

    Untuk menggabungkan beberapa node cabang, ulangi langkah ini untuk setiap node.

  3. Di bagian Merge Condition Settings, konfigurasikan kondisi merge untuk node cabang tersebut.

    • Kondisi logika merge berikut tersedia:

      • AND: Node merge ditandai sebagai berhasil, sebagaimana ditentukan di bagian Result Settings, hanya jika semua node cabang hulu telah selesai dieksekusi dan memenuhi status eksekusi yang ditentukan.

      • OR: Node merge ditandai sebagai berhasil, sebagaimana ditentukan di bagian Result Settings, jika semua node hulu telah selesai dieksekusi dan setidaknya satu node cabang memenuhi status eksekusi yang ditentukan.

    • Status eksekusi berikut tersedia untuk node yang telah selesai:

      • Successful: Node berhasil dieksekusi.

      • Failed: Node gagal dieksekusi.

      • Branch Not Run: Node tidak dipilih untuk dieksekusi dan berada dalam keadaan dry-run. Dalam keadaan ini, node dianggap telah berhasil dieksekusi, meskipun tugas tersebut tidak dijalankan.

        Catatan

        Status ini hanya berlaku jika node leluhur merupakan node cabang.

  4. Di bagian Result Settings, tetapkan status eksekusi untuk node saat ini.

    Catatan

    Anda hanya dapat menetapkan status eksekusi node saat ini menjadi Successful.

    image

    Gambar berikut menunjukkan contoh dengan pengaturan sebagai berikut:

    • Node Branch 1 dan Branch 2 ditambahkan sebagai node leluhur dari node merge saat ini.

    • Kondisi untuk node Branch 1 terpenuhi jika statusnya adalah Successful, Branch Not Run, atau Failed. Artinya, kondisi tersebut terpenuhi selama node Branch 1 telah selesai dieksekusi, terlepas dari hasilnya.

    • Kondisi untuk node Branch 2 terpenuhi jika statusnya adalah Successful atau Branch Not Run. Artinya, node Branch 2 harus selesai dieksekusi tanpa mengalami kegagalan.

    • Kondisi logika merge diatur ke AND.

    Berdasarkan pengaturan ini, node merge saat ini ditandai sebagai Successful hanya jika node Branch 1 telah selesai dieksekusi dan node Branch 2 telah selesai dieksekusi tanpa mengalami kegagalan.

  5. Setelah mengonfigurasi logika merge, klik Scheduling Properties di panel kanan tab konfigurasi node untuk mengatur properti penjadwalan node tersebut. Untuk informasi lebih lanjut, lihat Konfigurasi properti penjadwalan.

Langkah 2: Deploy node dan lakukan O&M

  1. Setelah mengonfigurasi properti penjadwalan, kirim dan publikasikan node merge yang telah selesai ke lingkungan produksi. Untuk informasi lebih lanjut, lihat Deploy node atau alur kerja.

  2. Setelah tugas dipublikasikan, tugas tersebut akan berjalan secara berkala sesuai konfigurasi penjadwalan Anda. Anda dapat membuka Operation Center > Task O&M > Auto Triggered Task O&M > Auto Triggered Tasks untuk melihat tugas yang dipicu otomatis yang telah dipublikasikan dan melakukan operasi O&M. Untuk informasi lebih lanjut, lihat Memulai Operation Center.