All Products
Search
Document Center

DataWorks:Aktifkan langganan pesan event

Last Updated:Mar 27, 2026

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

Lingkup

  • Batasan versi: Hanya DataWorks Enterprise Edition yang didukung.

  • Batasan wilayah: Fitur ini hanya 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.

  • Kontrol akses: Hanya Open Platform Administrators, Tenant Administrators, Akun Alibaba Cloud, atau Pengguna RAM dengan izin AliyunDataWorksFullAccess yang memiliki izin baca dan tulis untuk latar belakang developer. Untuk informasi selengkapnya, lihat Kontrol akses tingkat modul global dan Detail kontrol akses produk dan konsol: Kebijakan RAM.

  • Produk terkait: OpenEvent menggunakan EventBridge untuk langganan dan konsumsi pesan. Anda harus terlebih dahulu mengaktifkan EventBridge.

Peringatan

Jika langganan DataWorks Enterprise Edition Anda kedaluwarsa, semua ekstensi menjadi tidak valid dan tidak dapat memicu pemeriksaan event. Pemeriksaan yang telah dipicu tetapi belum mencapai status terminal akan secara otomatis lolos.

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 dengan memfilter pesan yang dibutuhkan oleh sistem downstream serta menentukan cara dan lokasi pengirimannya.

image
Penting

Pesan dari operasi pada modul tingkat penyewa secara otomatis didorong ke event bus default bernama Default di EventBridge. Untuk daftar event tingkat penyewa yang didukung, lihat Event tingkat penyewa.

Konfigurasi di DataWorks

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

Langkah 1: Berikan otorisasi layanan

Jika Anda menggunakan layanan OpenEvent untuk pertama kalinya, gunakan Akun Alibaba Cloud atau Pengguna RAM dengan kebijakan AliyunDataWorksFullAccess untuk memberikan otorisasi kepada DataWorks agar dapat mengakses EventBridge.

  1. Buka tab Developer Backend.

    Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi kiri, pilih More > Open Platform. Di halaman yang muncul, klik Go to Open Platform. Tab Developer Backend akan muncul.

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

  3. Berikan otorisasi kepada DataWorks untuk mengakses resource EventBridge.

    Jika ini pertama kalinya Anda menggunakan layanan ini, tombol Authorize Now akan muncul. Ikuti petunjuk di layar untuk memberikan otorisasi kepada DataWorks agar dapat mengakses resource EventBridge. Otorisasi ini secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForDataWorksOpenPlatform. Anda dapat melihat peran ini di konsol Resource Access Management (RAM) di bawah Identities > Roles.

Langkah 2: Konfigurasi saluran distribusi event

Saluran distribusi event memetakan ruang kerja DataWorks ke event bus EventBridge, sehingga semua pesan yang diterbitkan dari ruang kerja tersebut didorong ke event bus tertentu.

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

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

    image

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, memfilter pesan tertentu, dan menentukan layanan mana yang menerimanya serta bagaimana cara pengirimannya.

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

Konfigurasi di EventBridge

Setelah Anda mengaktifkan saluran distribusi event di DataWorks, DataWorks secara otomatis mendorong pesan yang diterbitkan ke event bus EventBridge yang ditentukan. Anda kemudian harus mengonfigurasi filter di EventBridge untuk memilih pesan mana yang akan dikonsumsi dan menentukan cara serta lokasi 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 event bus tersebut. Jika Anda mengklik Create Custom Event Bus, ikuti langkah-langkah berikut untuk membuatnya. Untuk informasi selengkapnya, lihat Ikhtisar event bus.

  1. Masuk ke Konsol EventBridge dan klik Event Buses 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 event bus dengan cepat, Anda hanya perlu mengonfigurasi Name dan Description. Anda dapat melewati langkah Event Source, Event Rule, dan Event Target.

    image

Langkah 2: Konfigurasi aturan event

Setelah membuat event bus, Anda dapat mengonfigurasi aturan event secara manual agar pesan event DataWorks didorong ke layanan yang sesuai.

  1. Di panel navigasi kiri, klik Event Buses. Temukan event bus yang dituju dan klik Event > Rules di kolom Actions untuk membuka halaman konfigurasi aturan event.

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

  3. Configure basic information: Masukkan nama dan deskripsi untuk aturan event.image

  4. Configure event pattern: Pola peristiwa memfilter pesan berdasarkan isinya. Konfigurasikan parameter seperti pada contoh 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 yang tetap. Anda dapat menemukan jenis pesan yang sesuai untuk setiap operasi di Referensi: Daftar event dan format pesan dan menggunakannya sebagai nilai untuk kunci type dalam konten pola.

      {
        "source": [
          "acs.dataworks"
        ],
        "type": [
          "dataworks:InstanceStatusChanges:InstanceStatusChanges"
        ]
      }

      image

  5. Debug the event pattern: Setelah 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 event 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 akan ditampilkan saat Anda menjalankan pengujian.

    2. Jika jenis event cocok, pengujian akan menampilkan pesan Match successful, the event can be triggered normally.

  6. Konfigurasi target event: Selain layanan kustom, Anda dapat mendorong event ke berbagai target lainnya. Untuk informasi selengkapnya, lihat Ikhtisar target event.

    image

    Catatan

    Konfigurasi pada gambar menunjukkan pesan yang didorong ke layanan HTTPS tertentu. Jika Anda ingin ekstensi menerima pesan ini, pilih HTTPS sebagai jenis layanan dan masukkan alamat penerapan ekstensi di bidang URL.

  7. Setelah Anda mengonfigurasi dan menyimpan aturan event, EventBridge akan merutekan pesan event DataWorks. Hal ini juga mendukung fitur Ekstensi.

Lihat pesan event yang didorong

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

image

Praktik terbaik

Berlangganan pesan dari layanan lokal: Praktik terbaik: Penguncian penerapan tugas kustom.