全部产品
Search
文档中心

DataWorks:Node pemicu HTTP

更新时间:Dec 19, 2025

DataWorks menyediakan node pemicu HTTP yang memungkinkan Anda memicu eksekusi node pemicu HTTP dan node turunannya dalam suatu alur kerja dari lingkungan eksternal (seperti lingkungan lokal atau lintas penyewa) dengan memanggil operasi OpenAPI. Fitur ini membantu Anda mengimplementasikan pemicuan tugas lokal atau memenuhi persyaratan eksekusi ketergantungan tugas di lingkungan lintas penyewa.

Pengenalan Produk

Node pemicu HTTP adalah node beban nol khusus yang memungkinkan Anda menggunakan DataWorks OpenAPI TriggerSchedulerTaskInstance untuk memicu penjadwalan node ini dan node turunannya.

Mekanisme Pemicuan

image

Node pemicu HTTP hanya dapat memicu node turunannya setelah node leluhurnya dijalankan sesuai harapan dan node tersebut menerima instruksi penjadwalan dari sistem penjadwalan eksternal. Untuk informasi tentang cara memicu node pemicu HTTP, lihat Diagram penggunaan node pemicu.

Diagram penggunaan node pemicu

Node pemicu HTTP umumnya digunakan untuk komunikasi antara lingkungan eksternal dan sistem penjadwalan DataWorks.

image

Deskripsi diagram:

  1. Di Data Development, buat alur kerja yang berisi node pemicu HTTP, konfigurasikan ketergantungan antar node, lalu publikasikan alur kerja ke Operation Center.

  2. Sistem secara otomatis menghasilkan instans berulang berdasarkan waktu penjadwalan. Anda dapat memperoleh informasi tentang node pemicu HTTP (seperti ID node dan waktu pemicu) dari instans-instans tersebut.

  3. Gunakan informasi ini dan panggil operasi OpenAPI melalui kode Java atau Python, atau halaman debugging API, untuk memicu node tersebut. Untuk memicu hanya instans tertentu beserta alur kerja selanjutnya, atur parameter TriggerTime ke bidang statis. Untuk memicu semua instans secara dinamis, atur TriggerTime ke variabel dinamis. Setelah node pemicu HTTP menerima dan memverifikasi perintah pemicu, node tersebut menjalankan node turunannya secara berurutan.

Kondisi Pemicuan

Node Pemicu HTTP hanya dapat dijalankan jika persyaratan berikut terpenuhi:

  • Node pemicu HTTP telah menghasilkan instans berulang. Anda dapat menemukan instans ini di halaman Auto Triggered Instances di Operation Center. Sebelum instans berhasil dipicu oleh API TriggerSchedulerTaskInstance, instans berada dalam status Waiting for Trigger. Node turunannya diblokir hingga API TriggerSchedulerTaskInstance dipanggil untuk memicu node pemicu HTTP. Setelah node pemicu HTTP dijalankan, node turunannya dijalankan secara berurutan.

  • Semua node induk yang menjadi ketergantungan node pemicu HTTP telah berhasil dieksekusi (instans berada dalam status sukses).

  • Waktu penjadwalan telah tiba untuk instans berulang yang dihasilkan oleh node pemicu HTTP.

  • Kelompok sumber daya penjadwalan yang digunakan oleh node pemicu HTTP memiliki sumber daya yang cukup pada saat pemicuan.

  • Node pemicu HTTP tidak dalam status beku.

  • Hanya node pemicu HTTP dalam status Waiting for Trigger yang dapat dipicu (node yang telah berhasil dipicu tidak akan dieksekusi ulang meskipun dipicu kembali).

Catatan

  • Node pemicu HTTP hanya dapat memicu node turunannya setelah node leluhurnya dijalankan sesuai harapan dan node tersebut menerima instruksi penjadwalan dari lingkungan eksternal.

  • Jika lingkungan eksternal mengirim instruksi penjadwalan lebih awal, tetapi node leluhur belum selesai dijalankan, node pemicu HTTP tidak akan memicu node turunannya. Sistem akan menyimpan instruksi penjadwalan dari lingkungan eksternal dan memicu node turunannya melalui node pemicu HTTP setelah node leluhur selesai dijalankan.

    Catatan

    Instruksi pemicu dari lingkungan eksternal hanya disimpan selama 24 jam. Jika node leluhur tidak selesai dijalankan dalam waktu 24 jam, instruksi pemicu akan hilang, dan instruksi penjadwalan yang dikirim kali ini menjadi tidak valid.

  • Setelah instans node pemicu HTTP saat ini berhasil dipicu dan dieksekusi, instans tersebut tidak dapat dipicu untuk kedua kalinya.

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 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 Workspace Administrator. 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 dalam direktori Use serverless resource groups.

  • Sebelum mengembangkan node pemicu HTTP, Anda perlu membuat node pemicu HTTP yang sesuai. Untuk informasi lebih lanjut, lihat Create a recurring task.

Batasan

  • Fitur node pemicu HTTP hanya tersedia di DataWorks Enterprise Edition dan versi yang lebih tinggi. Untuk informasi lebih lanjut tentang versi DataWorks, lihat Editions of DataWorks.

  • Node pemicu HTTP hanya digunakan untuk memicu tugas dan tidak dapat digunakan sebagai tugas komputasi-teroptimalkan. Anda perlu mengatur node tugas agar dijalankan sebagai node turunan dari node pemicu HTTP untuk mengimplementasikan pemicuan dan eksekusi tugas.

Buat node pemicu HTTP

Buat node pemicu HTTP baru

Untuk informasi tentang cara membuat node baru, lihat Create an HTTP trigger node.

Konfigurasi node pemicu HTTP

Setelah membuat node pemicu HTTP baru, konfigurasikan parameter berikut di bagian Scheduling di sisi kanan halaman pengeditan node pemicu HTTP. Untuk konfigurasi parameter lainnya, lihat Node scheduling.

Parameter

Deskripsi

Resource Group

Pilih kelompok sumber daya arsitektur tanpa server yang telah Anda kaitkan.

Instance Generation Mode

Anda dapat memilih T+1 Next Day atau Generate Immediately After Publishing.

Catatan
  • Node pemicu HTTP adalah node beban nol dan tidak memerlukan konten node yang ditulis.

  • Jika tidak ada node hulu dari node pemicu HTTP, node hulu default-nya adalah node akar alur bisnis.

Publikasikan node pemicu HTTP

  1. Setelah menyelesaikan konfigurasi penjadwalan, Anda dapat mengirim dan mempublikasikan node pemicu HTTP yang telah selesai ke lingkungan produksi. Untuk informasi lebih lanjut, lihat Publish nodes/workflows.

  2. Tugas yang dipublikasikan akan berjalan secara berkala sesuai jadwal yang Anda konfigurasikan. Anda dapat melihat tugas berulang yang dipublikasikan di Operation Center > Node O&M > Auto Triggered Node O&M > Auto Triggered Nodes dan melakukan operasi O&M pada tugas tersebut. Untuk informasi lebih lanjut, lihat Get started with Operation Center.

Konfigurasi pemicu di lingkungan penjadwalan lain

Saat Anda mengonfigurasi pemicu di lingkungan penjadwalan eksternal, Anda harus mengonfigurasi parameter instans node pemicu HTTP yang diambil dengan salah satu cara berikut dan memanggil operasi TriggerSchedulerTaskInstance untuk memicu node pemicu HTTP.

Dapatkan parameter instans node pemicu HTTP

Anda dapat melihat dan mencatat informasi parameter instans HTTP di Operation Center berdasarkan mode pembuatan instans yang dipilih saat mengonfigurasi node pemicu HTTP.

Catatan
  • T+1 Next Day: Anda perlu membuka Operation Center keesokan harinya untuk melihat dan mencatat informasi parameter instans HTTP.

  • Generate Immediately After Publishing: Anda dapat langsung membuka Operation Center untuk melihat dan mencatat informasi parameter instans HTTP.

  1. Buka halaman Operation Center.

    Login ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi kiri, pilih Data Development and O&M > Operation Center. Di halaman yang muncul, pilih ruang kerja yang diinginkan dari daftar drop-down dan klik Go to Operation Center.

  2. Di bilah navigasi kiri, klik Auto Triggered Node O&M > Auto Triggered Instances untuk membuka halaman Auto Triggered Instances.

  3. Temukan instans node pemicu HTTP yang Anda buat dalam daftar dan catat Task ID dan Scheduled Time instans tersebut.

    Catatan

    Arahkan kursor mouse ke nama instans node pemicu HTTP untuk melihat Task ID instans tersebut.

Metode 1: Pemanggilan Java

  1. Instal SDK Java. Untuk informasi lebih lanjut, lihat Use Alibaba Cloud SDK for Java in an IDE.

    Tentukan konfigurasi Project Object Model (POM) berikut untuk menggunakan DataWorks SDK untuk Java:

    <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>dataworks_public20240518</artifactId>
      <version>6.2.0</version>
    </dependency>
  2. Kode contoh

    Anda dapat membuka halaman debugging TriggerSchedulerTaskInstance dan melihat contoh lengkap Java di tab SDK Sample.

    package com.example.demo;
    
    import com.aliyun.dataworks_public20240518.Client;
    import com.aliyun.dataworks_public20240518.models.TriggerSchedulerTaskInstanceRequest;
    import com.aliyun.dataworks_public20240518.models.TriggerSchedulerTaskInstanceResponse;
    import com.aliyun.teaopenapi.models.Config;
    import com.aliyun.teautil.models.RuntimeOptions;
    
    import java.text.SimpleDateFormat;
    import java.util.Calendar;
    
    public class CrossTenantTriggerSchedulerTaskTo {
        // Method to trigger DataWorks node execution
        public static TriggerSchedulerTaskInstanceResponse runTriggerScheduler(com.aliyun.dataworks_public20240518.Client client, Long nodeId, String EnvType, Long TriggerTime) throws Exception {
            TriggerSchedulerTaskInstanceRequest request = new TriggerSchedulerTaskInstanceRequest(); // Create API request object
            request.setTaskId(nodeId); // Set the node ID to trigger
            request.setEnvType(EnvType); // Set the project environment
            request.setTriggerTime(TriggerTime); // Set the scheduled trigger time (millisecond timestamp)
            RuntimeOptions runtime = new RuntimeOptions(); // Initialize runtime configuration
            return client.triggerSchedulerTaskInstanceWithOptions(request, runtime); // Execute API call and return response
        }
    
        public static void main(String[] args) throws Exception {
            // Initialize node ID (example value)
            String nodeId = "xxx";
            // Initialize project environment (example value)
            String EnvTypeStr = "xxx";
            // Initialize scheduled time (example value)
            String cycTimeStr = "xxx";
            // Set service endpoint
            String endpoint = "xxx";
            // Convert string to Long type node ID
            Long nodeId1 = Long.parseLong(nodeId);
            // Output program usage instructions
            System.out.println("Usage: java -jar test-1.0-SNAPSHOT.jar nodeId EnvTypeStr cycTimeParam");
            // Parse scheduled time and convert to timestamp
            SimpleDateFormat sdft = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            Calendar calendar = Calendar.getInstance();
            calendar.setTime(sdft.parse(cycTimeStr)); // Parse time string
            Long cycTime = calendar.getTimeInMillis(); // Get millisecond timestamp
            // Output debug information (timestamp)
            System.out.println("Scheduled timestamp: " + cycTime);
            // Initialize OpenAPI configuration object
            Config config = new Config();
            config.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")); // Get AccessKey ID from environment variable
            config.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")); // Get AccessKey Secret from environment variable
            config.setEndpoint(endpoint);
            // Create Alibaba Cloud client instance
            Client client = new Client(config);
            // Execute node trigger operation
            TriggerSchedulerTaskInstanceResponse response = runTriggerScheduler(client, nodeId1,EnvTypeStr, cycTime);
            // Output API response result (JSON format)
            System.out.println(com.aliyun.teautil.Common.toJSONString(com.aliyun.teautil.Common.toMap(response)));
        }
    }

    Ganti parameter yang relevan dalam kode di atas dengan nilai aktual yang diperlukan untuk bisnis Anda sesuai deskripsi parameter berikut.

    Parameter

    Deskripsi

    nodeId

    Task ID dari node pemicu HTTP yang diperoleh pada langkah Dapatkan parameter instans node pemicu HTTP.

    EnvTypeStr

    Lingkungan proyek tempat node pemicu HTTP berada.

    Atur nilainya ke Prod untuk lingkungan produksi.

    Atur nilainya ke Dev untuk lingkungan pengembangan.

    cycTimeStr

    Scheduled Time dari tugas node pemicu HTTP yang Anda peroleh pada langkah Dapatkan parameter instans node pemicu HTTP. Waktu harus dalam format yyyy-MM-dd HH:mm:ss.

    endpoint

    Titik akhir ruang kerja tempat node pemicu HTTP target berada. Untuk informasi lebih lanjut, lihat Alibaba Cloud OpenAPI Developer Service Endpoints.

    ALIBABA_CLOUD_ACCESS_KEY_ID

    AccessKey ID dari Akun Alibaba Cloud tempat node pemicu HTTP tujuan berada.

    1. Dapatkan pasangan AccessKey.

      Login ke Konsol DataWorks. Arahkan kursor ke gambar profil Anda di pojok kanan atas dan klik AccessKey Management untuk mendapatkan AccessKey ID dan AccessKey secret.

    2. Konfigurasikan variabel lingkungan. Konfigurasikan AccessKey ID dan AccessKey Secret yang diperoleh sebagai variabel lingkungan untuk lingkungan saat ini. Nantinya, Anda dapat memperoleh Informasi AccessKey secara dinamis dengan membaca variabel lingkungan, sehingga menghindari risiko keamanan penyimpanan teks biasa. Untuk informasi lebih lanjut, lihat Manage access credentials.

    ALIBABA_CLOUD_ACCESS_KEY_SECRET

    AccessKey secret dari Akun Alibaba Cloud tempat node pemicu HTTP tujuan berada.

Metode 2: Pemanggilan Python

  1. Instal SDK Python. Untuk informasi lebih lanjut, lihat Integrate SDK.

    Jalankan perintah berikut untuk menginstal DataWorks SDK untuk Python:

    pip install alibabacloud_dataworks_public20240518==6.2.0
  2. Kode contoh.

    Anda dapat membuka halaman debugging TriggerSchedulerTaskInstance dan melihat contoh lengkap Python di tab SDK Sample.

    image

Metode 3: Alat debugging API

Anda dapat membuka halaman debugging TriggerSchedulerTaskInstance, atur parameter yang sesuai di area berikut, lalu klik Call API di bawahnya.

Parameter

Deskripsi

TaskId

Task ID dari node pemicu HTTP yang diperoleh pada langkah Dapatkan parameter instans node pemicu HTTP.

EnvType

Lingkungan proyek tempat node pemicu HTTP berada.

Atur nilainya ke Prod untuk lingkungan produksi.

Atur nilainya ke Dev untuk lingkungan pengembangan.

TriggerTime

Scheduled Time dari tugas node pemicu HTTP yang diperoleh pada langkah Dapatkan parameter instans node pemicu HTTP. Format waktu perlu dikonversi ke timestamp dalam satuan milidetik.

image

Referensi

DataWorks menyediakan fitur node pemicu HTTP yang dapat mengimplementasikan pemicuan dan eksekusi tugas dalam skenario lintas penyewa. Untuk informasi lebih lanjut, lihat Use HTTP trigger nodes to trigger node execution across tenants.