Cara menggunakan Node HTTP Trigger di DataWorks - DataWorks

Gunakan Node HTTP Trigger di DataWorks untuk memicu tugas ketika suatu tugas di sistem penjadwalan eksternal selesai. Topik ini menjelaskan prosedur dan hal-hal yang perlu diperhatikan saat menggunakan Node HTTP Trigger dengan sistem eksternal.

Prasyarat

DataWorks Edisi Perusahaan atau versi yang lebih tinggi telah diaktifkan.
Alur kerja dan node komputasi target telah tersedia. Misalnya, untuk menggunakan MaxCompute SQL dalam perhitungan tugas, lihat Kembangkan tugas ODPS SQL untuk membuat node MaxCompute SQL.

Informasi latar belakang

Sistem penjadwalan eksternal memicu tugas dalam dua skenario:

Node HTTP Trigger tidak memiliki node hulu
Dalam skenario ini, buat Node HTTP Trigger, konfigurasikan pemicu di sistem eksternal, dan atur dependensi penjadwalan di DataWorks. Untuk informasi selengkapnya, lihat Buat Node HTTP Trigger dan Konfigurasi pemicu untuk sistem penjadwalan eksternal.
Node HTTP Trigger memiliki node hulu
Dalam skenario ini:
- Buat Node HTTP Trigger, konfigurasikan pemicu di sistem eksternal, dan atur dependensi penjadwalan di DataWorks. Untuk informasi selengkapnya, lihat Buat Node HTTP Trigger dan Konfigurasi pemicu untuk sistem penjadwalan eksternal.
- Secara default, node hulu adalah node akar alur kerja. Anda harus mengonfigurasi secara manual node hulu lainnya.
- Node HTTP Trigger hanya akan memicu node hilir setelah node hulu selesai dan sistem eksternal mengeluarkan perintah penjadwalan.
  Jika sistem eksternal mengeluarkan perintah sebelum node hulu selesai, Node HTTP Trigger tidak langsung memicu node hilir. DataWorks menyimpan perintah tersebut dan baru memicu node hilir setelah node hulu selesai.
  Penting
  Perintah pemicu eksternal berlaku selama 24 jam. Jika node hulu tidak selesai dalam periode tersebut, perintah akan kedaluwarsa.

Batasan

Node HTTP Trigger memerlukan DataWorks Edisi Perusahaan atau versi yang lebih tinggi. Untuk informasi selengkapnya tentang edisi DataWorks, lihat Detail fitur berdasarkan edisi DataWorks.
Node HTTP Trigger hanya mendukung pembuatan instans T+1 dan tidak dapat dipicu oleh instans pengisian ulang data. Oleh karena itu, sistem eksternal hanya dapat memicu node tersebut mulai dari hari setelah node tersebut diterapkan ke lingkungan produksi.
Node HTTP Trigger hanya berfungsi sebagai pemicu dan tidak dapat menjalankan tugas komputasi secara langsung. Anda harus mengonfigurasi node tugas yang ingin dijalankan sebagai node hilir dari Node HTTP Trigger.
Jika Anda ingin menjalankan ulang node pemicu setelah alur kerja dibuat dan berjalan normal, Anda harus menjalankan ulang node tersebut di DataWorks dan mengeluarkan perintah pemicu dari sistem penjadwalan eksternal. Menjalankan ulang Node HTTP Trigger tidak akan memicu node hilir yang sudah berhasil dijalankan sebelumnya.
Untuk mendapatkan hasil eksekusi historis node hilir, lakukan operasi pengisian ulang data (lihat O&M instans pengisian ulang data). Pengisian ulang data tidak memerlukan perintah pemicu eksternal; Node HTTP Trigger langsung memicu node hilir. Akibatnya, Anda tidak dapat menggunakan pengisian ulang data untuk menguji pemicuan eksternal.
Wilayah yang didukung: China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Chengdu), China (Hong Kong), Jepang (Tokyo), Singapura, Malaysia (Kuala Lumpur), Jerman (Frankfurt), dan AS (Silicon Valley).

Logika pemicu

Node HTTP Trigger hanya berjalan jika:

Terdapat Cycle Instance untuk node tersebut (dapat dicari di panel Cycle Instance pada Pusat Operasi). Instans tersebut tetap berada dalam status Pending Trigger hingga berhasil dipicu oleh API RunTriggerNode. Node hilir akan diblokir hingga API RunTriggerNode berhasil memicu Node HTTP Trigger.
Semua node induk telah berhasil dijalankan (instans berada dalam status success).
Waktu terjadwal dari Cycle Instance yang dihasilkan untuk Node HTTP Trigger telah tiba.
Resource Group penjadwalan memiliki sumber daya yang cukup pada saat pemicu dieksekusi.
Node HTTP Trigger tidak dalam status frozen.
Node HTTP Trigger hanya dapat dipicu saat berada dalam status Pending Trigger (node yang telah berhasil dipicu tidak dapat dipicu lagi).

Buat Node HTTP Trigger

Buka Data Studio.
Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi kiri, pilih Data Development and O&M > Data Development. Pada halaman yang muncul, pilih ruang kerja yang diinginkan dari daftar drop-down dan klik Go to Data Development.
Buka halaman DataStudio, arahkan kursor ke ikon , lalu pilih Create Node > General > HTTP Trigger.
Atau, buka alur kerja tertentu, klik kanan General, lalu pilih Create Node > HTTP Trigger.
Di kotak dialog Create Node, konfigurasikan parameter Path dan Name.
Klik Confirm.
Klik Properties di sisi kanan tab konfigurasi node untuk mengatur properti penjadwalan node tersebut. Untuk informasi selengkapnya, lihat Konfigurasi properti dasar.
Catatan
Secara default, node hulu adalah node akar alur kerja. Anda harus mengonfigurasi secara manual node hulu lainnya.
Simpan dan kirimkan node tersebut.
Penting
Anda harus mengonfigurasi parameter Rerun dan Parent Nodes di tab Properties sebelum melakukan commit node.
1. Klik ikon di bilah alat atas untuk menyimpan node.
2. Klik ikon di bilah alat.
3. Di kotak dialog, konfigurasikan parameter Change description.
4. Klik OK.
Jika ruang kerja yang Anda gunakan berada dalam mode standar, Anda harus mengklik Deploy di pojok kanan atas untuk menerapkan node tersebut setelah melakukan commit. Untuk informasi selengkapnya, lihat Deploy tasks.
Lakukan operasi O&M pada node tersebut. Untuk informasi selengkapnya, lihat Lakukan operasi O&M dasar pada node yang dipicu otomatis.

Konfigurasi pemicu untuk sistem penjadwalan eksternal

Untuk memicu Node HTTP Trigger dari sistem penjadwalan eksternal, gunakan salah satu metode berikut untuk memanggil API versi 2020 (RunTriggerNode):

Java
1. Instal Java SDK (lihat Memulai Alibaba Cloud SDK V1.0 untuk Java).
  Gunakan konfigurasi pom berikut untuk DataWorks SDK:
```
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>dataworks_public20200518</artifactId>
  <version>8.0.0</version>
</dependency>
```
2. Kode contoh
  Kunjungi atau halaman debug RunTriggerNode, lalu klik tab SDK Sample untuk melihat contoh lengkap.
Python
1. Instal Python SDK (lihat Integrasikan SDK).
  Jalankan perintah berikut untuk menginstal DataWorks SDK:
```
pip install aliyun-python-sdk-dataworks-public==2.1.2
```
2. Kode contoh
  Kunjungi atau halaman debug RunTriggerNode, lalu klik tab SDK Sample untuk melihat contoh lengkap.
API
Untuk informasi tentang cara memanggil API, lihat RunTriggerNode.

Dokumen terkait

DataWorks menyediakan fitur Node HTTP Trigger untuk memicu dan menjalankan tugas lintas penyewa. Untuk informasi selengkapnya, lihat Eksekusi tugas lintas penyewa menggunakan node HTTP trigger.