All Products
Search
Document Center

DataWorks:Aktifkan langganan pesan

Last Updated:Jun 21, 2026

Modul OpenEvent di DataWorks menggunakan EventBridge untuk langganan dan pengiriman pesan event. Setelah membuat event bus kustom di EventBridge, Anda harus mengonfigurasi saluran distribusi event di DataWorks agar event dapat diterbitkan. Selanjutnya, Anda dapat membuat aturan di EventBridge untuk mengelola event tersebut. Topik ini menjelaskan cara mengaktifkan langganan pesan event dan mengonfigurasi event bus kustom.

Catatan penggunaan

  • Edition: DataWorks Enterprise Edition saja.

  • Regions: Didukung di Tiongkok (Beijing), Tiongkok (Hangzhou), Tiongkok (Shenzhen), Tiongkok (Shanghai), Tiongkok (Zhangjiakou), Tiongkok (Chengdu), AS (Silicon Valley), AS (Virginia), Jerman (Frankfurt), Jepang (Tokyo), Tiongkok (Hong Kong), dan Singapura.

  • Access control: Hanya Open Platform Administrator, Tenant Administrator, Akun Alibaba Cloud, atau Pengguna RAM dengan izin Aliyundataworksfullaccess yang memiliki izin baca dan tulis untuk Konsol developer. Administrator Open Platform. Berikan izin AliyunDataWorksFullAccess kepada Pengguna RAM.

  • Dependency: OpenEvent menggunakan EventBridge untuk langganan dan konsumsi pesan. Aktifkan EventBridge terlebih dahulu sebelum memulai.

Peringatan

Jika langganan DataWorks Enterprise Edition Anda kedaluwarsa, semua ekstensi menjadi tidak valid dan tidak dapat lagi memicu pemeriksaan event. Sistem secara otomatis melewati semua pemeriksaan yang dipicu namun belum mencapai status terminal.

Cara kerja

DataWorks mengekspos pesan perubahan status untuk proses inti. Di modul OpenEvent pada DataWorks Open Platform, Anda dapat memetakan ruang kerja DataWorks ke event bus EventBridge. Konfigurasi ini mendorong semua pesan yang diterbitkan dari ruang kerja ke event bus yang ditentukan. Anda kemudian dapat mengelola pesan-pesan tersebut di EventBridge. Misalnya, Anda dapat menyaring pesan yang dikirim dari DataWorks untuk menemukan pesan yang dibutuhkan oleh sistem downstream serta menentukan cara dan lokasi pengirimannya.

Penting

Pesan yang dihasilkan oleh operasi di modul tingkat tenant secara otomatis didorong ke event bus default bernama Default di EventBridge. Untuk daftar event tingkat tenant yang didukung, lihat Event tingkat tenant.

Konfigurasi DataWorks

Anda harus mengonfigurasi saluran distribusi event di DataWorks untuk mendorong pesan event ke event bus EventBridge. Ikuti langkah-langkah berikut untuk memberikan otorisasi DataWorks mengakses EventBridge dan menentukan event bus tempat DataWorks dapat mendorong pesan yang diterbitkan.

Langkah 1: Berikan otorisasi layanan

Jika Anda menggunakan layanan OpenEvent untuk pertama kalinya, gunakan Akun Alibaba Cloud atau Pengguna RAM yang memiliki izin AliyunDataWorksFullAccess untuk memberikan otorisasi DataWorks mengakses sumber daya EventBridge.

  1. Masuk ke Konsol DataWorks. Di wilayah target, klik More > Open Platform di panel navigasi kiri. Klik Go to Open Platform untuk membuka halaman Developer Backend.

  2. Di halaman Developer Backend, klik OpenEvent di panel navigasi kiri untuk membuka halaman OpenEvent.

  3. Berikan otorisasi DataWorks untuk mengakses sumber daya EventBridge.

    Jika ini pertama kali Anda menggunakan layanan ini, tombol Authorize akan muncul. Ikuti petunjuk di layar untuk memberikan izin DataWorks mengakses sumber daya EventBridge. Tindakan ini secara otomatis membuat role service-linked bernama AliyunServiceRoleForDataWorksOpenPlatform di RAM console di bawah Identities > > Roles.

Langkah 2: Konfigurasi saluran distribusi event

Saluran distribusi event memetakan ruang kerja DataWorks ke event bus EventBridge. Hal ini memastikan bahwa semua pesan yang diterbitkan dari ruang kerja didorong ke bus tersebut.

  1. Klik Add Event Distribution Channel. Di kotak dialog yang muncul, konfigurasikan parameter Workspace for Event Distribution dan Distribute to Custom Event Bus in EventBridge.

  2. Jika tidak ada event bus yang tersedia di EventBridge, Anda dapat mengklik Create Custom Event Bus untuk membuka EventBridge console dan membuatnya. Atau, klik Quickly Create Custom Event Bus with Same Name as Your Workspace untuk segera membuat event bus.

    Di kotak dialog Add Event Distribution Channel, pilih ruang kerja untuk parameter Workspace for Event Distribution dan event bus kustom untuk parameter Distribute to Custom Event Bus in EventBridge, lalu klik OK.

Langkah 3: Aktifkan saluran distribusi event

Setelah Anda mengonfigurasi saluran distribusi event, Anda dapat melihatnya di halaman OpenEvent. Di kolom Actions, Anda dapat Delete, Enable, atau Disable saluran tersebut.

  • Enable: Setelah Anda mengaktifkan saluran, pesan event dari ruang kerja akan didorong ke event bus yang sesuai.

    Anda kemudian dapat membuka Konsol EventBridge untuk melihat semua pesan event yang didorong dari DataWorks, menyaring pesan yang dibutuhkan oleh konsumen downstream, dan menentukan cara serta layanan tujuan pengiriman pesan tersebut.

  • Disable/Delete: Jika Anda menonaktifkan atau menghapus saluran, DataWorks berhenti mendorong pesan event dari ruang kerja ke event bus yang sesuai. Anda tidak dapat lagi menerima pesan event tersebut melalui EventBridge.

Konfigurasi EventBridge

Setelah Anda mengaktifkan saluran distribusi event di DataWorks, pesan yang diterbitkan secara otomatis didorong ke event bus EventBridge yang ditentukan. Anda kemudian harus mengonfigurasi penyaringan di EventBridge untuk memilih pesan tertentu yang akan dikonsumsi dan menentukan target pengirimannya.

Langkah 1: Buat event bus kustom

Jika Anda telah membuat event bus kustom dengan nama yang sama seperti ruang kerja DataWorks di Langkah 2: Konfigurasi saluran distribusi event, Anda dapat langsung menggunakan bus tersebut. Jika Anda mengklik Create Custom Event Bus, ikuti langkah-langkah berikut untuk membuatnya. Untuk informasi lebih lanjut, lihat Ikhtisar event bus.

  1. Masuk ke Konsol EventBridge dan klik Event Bus di panel navigasi kiri.

  2. Di halaman Event Buses, buka tab Custom Event Buses dan klik Quickly Create. Contoh berikut membuat event bus kustom bernama DataWorks2023. Untuk membuat bus dengan cepat, Anda hanya perlu mengonfigurasi Name dan Description. Anda dapat melewatkan langkah Event Source, Rule, dan Target.

Langkah 2: Konfigurasi aturan event

Setelah membuat event bus, Anda dapat mengonfigurasi aturan event secara manual untuk mengarahkan pesan event DataWorks ke layanan target Anda.

  1. Di bilah navigasi kiri, klik Event Bus. Temukan event bus EventBridge target dan klik Actions > Event Rule untuk membuka halaman konfigurasi aturan event.

  2. Di halaman Event Rules, klik Create Rule di pojok kiri atas.

  3. Konfigurasi informasi dasar: Masukkan nama dan deskripsi untuk aturan event. Di langkah Configure basic information, Event bus diatur ke DataWorks2023 secara default dan tidak dapat diedit. Untuk Name, masukkan instanceStatusChanges (2 hingga 127 karakter, dapat berisi huruf, angka, atau tanda hubung). Untuk Description, masukkan deskripsi seperti "Aturan ini menyaring pesan 'perubahan status instans' dari semua pesan event di ruang kerja.".

  4. Configure event pattern : Pola peristiwa menyaring pesan berdasarkan isinya. Konfigurasikan parameter sebagai berikut:

    • Event Source Type: Pilih Custom Event Source.

    • Event Source: Gunakan nilai default.

    • Pattern Content: Gunakan format JSON untuk menentukan jenis pesan event. Setiap pesan event DataWorks memiliki jenis tetap. Anda dapat menemukan jenis pesan untuk setiap operasi di Referensi: Daftar event dan format pesan dan menggunakannya sebagai nilai kunci type dalam konten pola.

      {
        "source": [
          "acs.dataworks"
        ],
        "type": [
          "dataworks:InstanceStatusChanges:InstanceStatusChanges"
        ]
      }
  5. Debug event pattern : Setelah Anda mengonfigurasi pola peristiwa, Anda dapat melakukan debug untuk memverifikasi bahwa pola tersebut berfungsi sebagaimana mestinya.

    Jika Anda telah menyelesaikan Langkah 3: Aktifkan saluran distribusi event di DataWorks, pesan event sedang dikirim ke EventBridge. Untuk menguji pola Anda, buka halaman Event Tracking, temukan event dari DataWorks untuk bus Anda, lalu salin detailnya. Tempel detail tersebut ke bagian Event Pattern Debugging dan klik Test untuk memverifikasi filter.

    1. Jika jenis event tidak cocok, pesan "Match failed" ditampilkan.

    2. Jika jenis event cocok, pesan "Match succeeded. The event can be triggered as expected." ditampilkan.

  6. Konfigurasi target event: Selain layanan kustom, Anda dapat mendorong event ke berbagai target lain untuk dikonsumsi. Untuk informasi lebih lanjut, lihat Ikhtisar target event.

    Saat mengonfigurasi target event, atur Service Type ke HTTPS. Untuk URL, masukkan alamat layanan HTTPS, seperti https://example.com/eventBridge/dataworksEvent. Untuk Body, pilih Complete Event. Untuk Network Type, pilih Public Network.

    Catatan

    Konfigurasi pada gambar menunjukkan pesan yang didorong ke layanan HTTPS tertentu. Untuk memungkinkan ekstensi menerima pesan ini, pilih HTTPS sebagai tipe layanan dan masukkan alamat penerapan ekstensi di bidang URL.

  7. Setelah Anda mengonfigurasi dan menyimpan aturan event, EventBridge dapat mengarahkan pesan event DataWorks berdasarkan pengaturan Anda. Konfigurasi ini juga mendukung ekstensi.

Lihat pesan event yang didorong

Saat saluran distribusi event DataWorks diaktifkan dan event dipicu di DataWorks, Anda dapat melihat pesan event yang didorong di halaman Event Tracking untuk event bus terkait. Anda dapat menemukan pesan event berbeda berdasarkan jenisnya. Untuk daftar jenis event, lihat Referensi: Daftar event dan format pesan.

Di halaman Event Tracking, pilih Query by Time Range. Atur rentang waktu dan klik Query untuk melihat catatan event yang dipicu oleh DataWorks, seperti event dengan jenis dataworks:FileChange:DeployFile (penerapan file) atau dataworks:FileChange:CommitFile (komit file). Untuk melihat informasi lebih lanjut tentang suatu catatan, periksa event trajectory dan event details-nya.

Praktik terbaik

Berlangganan pesan dengan layanan lokal: Praktik Terbaik: Penguncian Penerapan Tugas Kustom.