Modul OpenEvent dari DataWorks Open Platform memungkinkan Anda untuk berlangganan dan mengonsumsi pesan acara menggunakan EventBridge. Setelah membuat bus kustom di EventBridge, Anda harus mengonfigurasi saluran distribusi acara di DataWorks sebelum dapat membuat aturan acara dan menerbitkan acara di EventBridge. Topik ini menjelaskan cara mengaktifkan fitur langganan pesan acara di DataWorks dan mengonfigurasi bus kustom di EventBridge.
Prasyarat
DataWorks Enterprise Edition telah diaktifkan di salah satu wilayah berikut:
Cina (Beijing), Cina (Hangzhou), Cina (Shenzhen), Cina (Shanghai), Cina (Zhangjiakou), Cina (Chengdu), AS (Silicon Valley), AS (Virginia), Jerman (Frankfurt), Jepang (Tokyo), Cina (Hong Kong), dan Singapura. Modul OpenEvent dari DataWorks Open Platform hanya tersedia untuk pengguna DataWorks Enterprise Edition di wilayah-wilayah ini.
EventBridge telah diaktifkan. Modul OpenEvent dari DataWorks Open Platform bergantung pada kemampuan distribusi pesan EventBridge untuk berlangganan dan mengonsumsi pesan. Oleh karena itu, Anda harus mengaktifkan EventBridge. Untuk informasi lebih lanjut tentang EventBridge, lihat Apa itu EventBridge?
Peringatan
Hanya Open Platform administrator, tenant administrator, akun Alibaba Cloud, dan pengguna RAM yang memiliki kebijakan AliyunDataWorksFullAccess yang memiliki izin baca dan tulis pada backend pengembang. Untuk informasi lebih lanjut tentang manajemen izin, lihat Kelola izin pada layanan tingkat global dan Kelola izin pada layanan DataWorks dan entitas di konsol DataWorks menggunakan kebijakan RAM.
Jika DataWorks Enterprise Edition kedaluwarsa, ekstensi menjadi tidak valid dan tidak dapat dipicu untuk memeriksa titik perluasan acara. Jika ekstensi dipicu untuk memeriksa suatu acara dan tidak menyelesaikan pemeriksaan sebelum DataWorks Enterprise Edition kedaluwarsa, pemeriksaan dihentikan dan hasil Pemeriksaan Berhasil dikembalikan.
Cara kerjanya
DataWorks mendukung langganan ke pesan acara perubahan status proses utama. Di modul OpenEvent dari DataWorks Open Platform, Anda dapat mengonfigurasi pemetaan antara ruang kerja DataWorks dan bus acara EventBridge. Dengan cara ini, semua pesan terbuka di ruang kerja DataWorks dapat didorong ke bus acara EventBridge yang ditentukan. Kemudian, Anda dapat pergi ke konsol EventBridge untuk manajemen pesan lebih lanjut. Sebagai contoh, Anda dapat mencari pesan acara yang ingin Anda konsumsi dari semua pesan acara yang dikirim dari DataWorks ke EventBridge dan menentukan jenis layanan yang ingin Anda gunakan untuk menerima pesan acara atau bagaimana pesan acara dikonsumsi.
Pesan yang dihasilkan oleh operasi yang dilakukan pada layanan tingkat penyewa secara otomatis didorong ke bus acara default EventBridge.
DataWorks
Di DataWorks, Anda harus mengonfigurasi saluran distribusi acara untuk mendorong pesan acara ke bus acara EventBridge. Anda harus melakukan langkah-langkah berikut di DataWorks untuk memberi otorisasi DataWorks mengakses EventBridge dan menentukan bus acara EventBridge yang digunakan untuk menerima pesan terbuka yang didorong ke EventBridge dari ruang kerja DataWorks.
Langkah 1: Otorisasi DataWorks untuk mengakses EventBridge
Pertama kali Anda menggunakan modul OpenEvent, Anda harus menggunakan akun Alibaba Cloud atau pengguna RAM yang memiliki kebijakan AliyunDataWorksFullAccess untuk melakukan langkah-langkah berikut agar DataWorks dapat mengakses EventBridge:
Pergi ke tab Backend Pengembang.
Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi sisi kiri, pilih . Di halaman yang muncul, klik Go to Open Platform. Tab Developer Backend muncul.
Pergi ke halaman OpenEvent.
Di panel navigasi sisi kiri halaman Backend Pengembang, klik OpenEvent. Halaman OpenEvent muncul.
Otorisasi DataWorks untuk mengakses sumber daya EventBridge Anda.
Pertama kali Anda menggunakan EventBridge, tombol Authorize Now ditampilkan di bagian Langganan Pesan Acara Menggunakan EventBridge. Untuk menggunakan EventBridge, ikuti petunjuk di layar untuk memberi otorisasi DataWorks mengakses sumber daya EventBridge Anda. Setelah otorisasi selesai, peran terhubung layanan AliyunServiceRoleForDataWorksOpenPlatform dibuat. Anda dapat masuk ke Konsol RAM dan memilih di panel navigasi sisi kiri untuk melihat peran terhubung layanan. Untuk informasi lebih lanjut tentang peran terhubung layanan, lihat bagian Lihat izin peran AliyunServiceRoleForDataWorksOpenPlatform dalam topik "Lampiran: Peran terhubung layanan DataWorks".
Langkah 2: Konfigurasikan saluran distribusi acara
Saluran distribusi acara memetakan ruang kerja DataWorks ke bus acara EventBridge. Anda dapat menggunakan saluran distribusi acara untuk mendorong semua pesan terbuka di ruang kerja DataWorks ke bus acara EventBridge.
Pergi ke halaman OpenEvent.
Di panel navigasi sisi kiri halaman Backend Pengembang, klik OpenEvent. Halaman OpenEvent muncul.
Konfigurasikan saluran distribusi acara.
Di bagian Langganan Pesan Acara Menggunakan EventBridge, klik Add Event Distribution Channel. Di kotak dialog Tambah Saluran Distribusi Acara, konfigurasikan parameter Workspace for Distribution of Event Messages dan Specify Custom Event Bus in EventBridge for Distribution of Event Messages.
CatatanJika tidak ada bus acara yang tersedia di EventBridge, Anda dapat mengklik Create Custom Event Bus di kotak dialog untuk pergi ke konsol EventBridge untuk membuat bus acara kustom. Anda juga dapat mengklik Quickly Create Custom Event Bus with Same Name as Your Workspace di kotak dialog untuk dengan cepat menghasilkan bus acara kustom.
Pesan yang dihasilkan oleh operasi yang dilakukan pada layanan tingkat penyewa secara otomatis didorong ke bus acara
defaultdariEventBridge. Jika Anda ingin menerima pesan acara yang dihasilkan oleh operasi yang dilakukan pada layanan tingkat penyewa, lewati langkah ini.

Langkah 3: Aktifkan saluran distribusi acara
Setelah mengonfigurasi saluran distribusi acara, Anda dapat melihat saluran distribusi acara yang dibuat di halaman OpenEvent. Anda dapat menemukan saluran distribusi acara yang dibuat dan mengklik Delete, Enable, atau Disable di kolom Tindakan untuk melakukan operasi terkait pada saluran distribusi acara.
Enable: Setelah mengaktifkan saluran distribusi acara, pesan acara dari ruang kerja didorong ke bus acara EventBridge yang dipetakan.
Di konsol EventBridge, Anda dapat melihat semua pesan acara yang didorong dari DataWorks ke EventBridge, mencari pesan acara yang ingin Anda konsumsi, dan menentukan jenis layanan yang ingin Anda gunakan untuk menerima pesan acara atau bagaimana pesan acara dikonsumsi.
Disable: Setelah menonaktifkan saluran distribusi acara, pesan acara dari ruang kerja tidak lagi didorong ke bus acara EventBridge yang dipetakan. Anda tidak dapat menerima pesan acara menggunakan EventBridge.
Delete: Setelah menghapus saluran distribusi acara, pesan acara dari ruang kerja tidak lagi didorong ke bus acara EventBridge yang dipetakan. Anda tidak dapat menerima pesan acara menggunakan EventBridge.
Setelah mengklik Enable di kolom Tindakan saluran distribusi acara, saluran distribusi acara diaktifkan. Pesan yang didistribusikan ke bus acara yang dipetakan menggunakan saluran distribusi acara didorong ke target acara yang dikonfigurasi berdasarkan aturan acara tertentu.
EventBridge
Setelah mengaktifkan saluran distribusi acara di DataWorks, DataWorks secara otomatis mendorong pesan terbuka ke bus acara EventBridge yang dipetakan. Di EventBridge, Anda harus mengonfigurasi filter untuk mencari pesan acara yang ingin Anda konsumsi dari semua pesan acara yang dikirim dari DataWorks ke EventBridge dan menentukan jenis layanan yang ingin Anda gunakan untuk menerima pesan acara atau bagaimana pesan acara dikonsumsi.
Langkah 1: (Opsional) Buat bus acara kustom
Jika Anda mengklik Cepat Buat Bus Acara Kustom dengan Nama Sama dengan Ruang Kerja Anda di Langkah 2: Konfigurasikan saluran distribusi acara untuk membuat bus acara kustom, langsung gunakan bus acara kustom yang dibuat. Jika Anda mengklik Create Custom Event Bus, Anda akan dialihkan ke EventBridge untuk membuat bus acara kustom. Dalam kasus ini, lakukan langkah-langkah berikut: Untuk informasi lebih lanjut tentang EventBridge, lihat Ikhtisar.
Masuk ke Konsol EventBridge. Di panel navigasi sisi kiri, klik Bus Acara.
Di sudut kanan atas halaman Bus Acara, klik Cepat Buat untuk membuat bus acara kustom. Dalam topik ini, bus acara kustom bernama
DataWorks2023dibuat.
Di panel Buat Bus Acara Kustom, setelah mengonfigurasi parameter Name dan Description untuk bus acara kustom, Anda dapat melewati langkah Event Source, Event Rule, dan Event Target untuk dengan cepat membuat bus acara.
Pesan yang dihasilkan oleh operasi yang dilakukan pada layanan tingkat penyewa secara otomatis didorong ke bus acara
defaultdariEventBridge. Jika Anda ingin menerima pesan acara yang dihasilkan oleh operasi yang dilakukan pada layanan tingkat penyewa, lewati langkah ini.
Langkah 2: Konfigurasikan aturan acara
Setelah membuat bus acara kustom, Anda dapat secara manual mengonfigurasi aturan acara untuk bus acara tersebut. Dengan cara ini, pesan acara DataWorks dapat didorong ke layanan yang sesuai.
Masuk ke Konsol EventBridge.
Konfigurasikan aturan acara.
Di panel navigasi sisi kiri, klik Event Buses. Di halaman Bus Acara, temukan bus acara EventBridge untuk mana Anda ingin mengonfigurasi penyaringan data dan tentukan jenis layanan yang ingin Anda gunakan untuk menerima pesan acara, dan klik Event Rules di kolom Actions.
Konfigurasikan informasi dasar
Di sudut kiri atas halaman yang muncul, klik Buat Aturan. Di langkah Konfigurasikan Info Dasar panel Buat Aturan, konfigurasikan parameter dan klik Langkah Berikutnya.
Name: Nama aturan acara.
Description: Deskripsi aturan acara.
Konfigurasikan pola acara
Di langkah Konfigurasikan Pola Acara panel Buat Aturan, konfigurasikan pola acara untuk mencari pesan acara yang ingin Anda konsumsi. Contoh konfigurasi:
Tipe Sumber Acara: Pilih Sumber Acara Kustom.
Sumber Acara: Pertahankan nilai default.
Konten Pola: Gunakan data JSON untuk mengonfigurasi tipe pesan acara. Di DataWorks, setiap pesan acara memiliki tipe tetap. Anda dapat merujuk ke Referensi Pengembangan: Pesan acara dan format pesan acara untuk mendapatkan tipe pesan acara yang dihasilkan oleh operasi yang sesuai yang dilakukan di DataWorks dan mengonfigurasi tipe pesan acara sebagai nilai kunci tipe dalam data JSON.
{ "source": [ "acs.dataworks" ], "type": [ "dataworks:InstanceStatusChanges:InstanceStatusChanges" ] }
Debug pola acara untuk memeriksa apakah pola tersebut memenuhi harapan Anda.
Setelah menyelesaikan Langkah 3: Aktifkan saluran distribusi acara di DataWorks, pesan acara DataWorks dapat dikirim ke EventBridge. Di halaman Pelacakan Acara EventBridge, Anda dapat menemukan acara dan mengklik Detail Acara di kolom Tindakan, menyalin konten di pesan Detail Acara, dan kemudian menempelkan konten tersebut di editor kode di bawah Debugging Pola Acara. Kemudian, klik Uji untuk memeriksa apakah tipe pesan acara yang dikonfigurasi di Konten Pola konsisten dengan tipe pesan acara di editor kode.
Jika tipe pesan acara tidak konsisten, pesan Match failed. ditampilkan setelah Anda mengklik Uji.
Jika tipe pesan acara konsisten, pesan Match succeeded. The event can be triggered as expected. ditampilkan setelah Anda mengklik Uji.
Konfigurasikan target acara
Pesan acara dapat didorong tidak hanya ke layanan yang dikelola sendiri, tetapi juga ke layanan lain untuk dikonsumsi. Untuk informasi lebih lanjut, lihat Ikhtisar.
CatatanGambar di atas menunjukkan bahwa pesan acara didorong ke layanan HTTPS yang ditentukan. Jika Anda ingin ekstensi menerima pesan acara, Anda harus menyetel parameter Jenis Layanan ke HTTPS dan parameter URL ke alamat penyebaran ekstensi.
Klik Buat. Setelah membuat aturan acara, Anda dapat menggunakan EventBridge untuk mendistribusikan dan merutekan pesan acara DataWorks. Fitur langganan pesan acara juga menyediakan dukungan untuk modul Ekstensi DataWorks Open Platform.
Praktik terbaik
Langganan pesan acara oleh layanan lokal: Praktik terbaik untuk mengonfigurasi pengaturan di DataWorks Open Platform untuk melakukan penguncian
Lampiran: Lihat pesan acara yang didorong
Setelah mengaktifkan saluran distribusi acara di DataWorks, ketika acara dipicu di ruang kerja yang dikonfigurasi di saluran distribusi acara, Anda dapat menemukan bus acara yang memetakan ke ruang kerja dan melihat pesan acara berdasarkan jenis acara di halaman Pelacakan Acara EventBridge. Untuk informasi tentang jenis acara, lihat Referensi Pengembangan: Pesan acara dan format pesan acara.
