Topik ini menjelaskan jenis-jenis acara, format pesan acara, serta arti setiap bidang dalam pesan acara di DataWorks.
Informasi Latar Belakang
Di DataWorks, acara diklasifikasikan menjadi acara reguler dan acara titik ekstensi berdasarkan apakah proses operasi terkait dengan suatu acara dapat diblokir dan apakah hasil pemrosesan pesan acara dapat dikembalikan setelah layanan yang dikelola sendiri berlangganan pesan acara tersebut.
Acara reguler: Anda dapat berlangganan jenis pesan acara ini. Namun, operasi yang menghasilkan jenis pesan acara ini tidak dapat diblokir. Anda dapat menggunakan modul OpenEvent untuk berlangganan jenis pesan acara ini. Untuk informasi lebih lanjut, lihat OpenEvent.
Acara titik ekstensi: Anda dapat berlangganan jenis pesan acara ini. Anda dapat menggunakan modul Extensions dari DataWorks Open Platform untuk mengonfigurasi respons kustom terhadap jenis pesan acara ini. Sebagai contoh, jika Anda mengaktifkan ekstensi kustom untuk memeriksa acara titik ekstensi di DataWorks dan Anda melakukan operasi yang memicu pemeriksaan ekstensi kustom di DataWorks, operasi tersebut akan diblokir hingga ekstensi mengembalikan hasil pemrosesan pesan acara.
Tabel berikut menjelaskan acara yang didukung oleh setiap layanan DataWorks, apakah suatu acara merupakan acara reguler atau acara titik ekstensi, tipe acara yang ditentukan untuk suatu acara di EventBridge, dan kode acara yang ditentukan untuk suatu acara di DataWorks Extensions.
Tipe: Tipe suatu acara. Bidang ini digunakan untuk menyaring pesan acara di EventBridge. Untuk informasi lebih lanjut, lihat Aktifkan Langganan Pesan Acara.
eventCode: Kode acara suatu acara. Selama pengembangan di tempat, Anda dapat menentukan tipe acara berdasarkan kode acara dalam pesan acara. Pesan acara dikirim dari DataWorks ke EventBridge.
Peristiwa tingkat ruang kerja
Layanan tingkat ruang kerja menghasilkan acara tingkat ruang kerja. Sebagai contoh, acara yang dihasilkan setelah Anda menjalankan node di DataStudio adalah acara tingkat ruang kerja. Acara yang dihasilkan karena perubahan status instance yang dipicu otomatis di Pusat Operasi juga merupakan acara tingkat ruang kerja. Anda dapat melihat pada tabel berikut acara yang didukung oleh setiap layanan DataWorks, apakah suatu acara merupakan acara reguler atau acara titik ekstensi, serta format pesan suatu acara.
Pada tab Format Pesan bagian ini, hanya sebagian isi format pesan acara yang ditampilkan. Untuk melihat pesan acara lengkap yang dikirim ke EventBridge atau Function Compute, lihat bagian Lampiran: Format Pesan dalam topik ini.
Peristiwa DataStudio
Peristiwa
Kategori Peristiwa | Peristiwa dan operasi pembangkit peristiwa | Peristiwa Reguler | Peristiwa Titik Ekstensi | Tipe Peristiwa di EventBridge | Kode Peristiwa di Ekstensi |
Peristiwa Perubahan Node | Buat sebuah node
|
|
|
|
|
Perbarui sebuah node
|
|
|
|
| |
Peristiwa Perubahan Berkas
| Prakejadian untuk Penghapusan Node (menghapus node di lingkungan pengembangan) Catatan File yang dihapus dipindahkan ke tempat sampah. |
|
|
|
|
Prakejadian untuk Node Commit |
|
|
|
| |
Pra-kejadian untuk Penyebaran Node |
|
|
|
| |
Pra-event untuk Pelaksanaan Kode |
|
|
|
| |
Peristiwa Perubahan Tabel | Prakarsa untuk Komitmen Tabel |
|
|
|
|
Pra-kejadian untuk Penyebaran Tabel |
|
|
|
|
Format Pesan
Peristiwa perubahan node (membuat dan memperbarui)
Peristiwa perubahan file (commit, deploy, jalankan, dan hapus)
Peristiwa perubahan tabel (commit tabel ke lingkungan pengembangan dan deploy tabel ke lingkungan produksi)
Peristiwa Data Integration
Peristiwa
Kategori Peristiwa | Peristiwa dan operasi pembuatan peristiwa | Peristiwa reguler | Peristiwa titik ekstensi | Tipe peristiwa di EventBridge
| Kode peristiwa di Ekstensi |
Perubahan Node | Pre-event untuk Di-Job Running |
|
|
|
|
Pre-event untuk Di-Job Batch Running |
|
|
|
|
Format pesan
Perubahan node - Pre-event untuk Di-Job running
Perubahan node - Pre-event untuk Di-Job batch running
Peristiwa Pusat Operasi
Peristiwa
Kategori peristiwa | Peristiwa dan operasi pembangkit peristiwa | Peristiwa reguler | Peristiwa titik ekstensi | Tipe peristiwa di EventBridge
| Kode peristiwa di Ekstensi |
Peristiwa Perubahan Node | Hapus sebuah node
|
|
|
|
|
Peristiwa Pra-undeploy Node (mengundeploy node yang dipicu otomatis di lingkungan produksi) Catatan Operasi ini menghapus node di DataStudio dan memindahkan node ke tempat sampah. |
|
|
|
| |
Peristiwa Sebelum Node Dibekukan |
|
|
|
| |
Peristiwa Sebelum Node Dibuka dari Pembekuan |
|
|
|
| |
Acara Operasi Pengisian Ulang Data | Prakejadian untuk Pengisian Ulang Data |
|
|
|
|
Perubahan status node | Ubah status node yang dipicu otomatis |
|
|
|
|
Peristiwa Perubahan Instans | Bekukan instance |
|
|
|
|
Buka pembekuan instance |
|
|
|
| |
Hentikan instance |
|
|
|
| |
Jalankan ulang instance
|
|
|
|
| |
Setel status instance menjadi Berhasil |
|
|
|
| |
Hapus instance leluhur tertentu dari sebuah instance |
|
|
|
| |
Peristiwa Sebelum Pembekuan Instance |
|
|
|
| |
Peristiwa Sebelum Instance Dibuka dari Pembekuan |
|
|
|
| |
Peristiwa Pra-eksekusi untuk Instance Rerun |
|
|
|
| |
Peristiwa Sebelum Pengaturan Instansi Sukses |
|
|
|
| |
Pra-kejadian untuk Instance Kill |
|
|
|
| |
Hapus instance yang kedaluwarsa |
|
|
|
| |
Perubahan status alur kerja | Ubah status alur kerja
|
|
|
|
|
Pemantauan dan peringatan | Monitor objek dan kirim notifikasi peringatan |
|
|
|
|
Format pesan
Peristiwa perubahan node (hapus, hapus penyebaran, bekukan, dan buka pembekuan)
Pengisian ulang data untuk node
Perubahan status node
Peristiwa perubahan instance (membekukan, membuka pembekuan, menghentikan tugas dan menjalankan ulang instance, serta menetapkan status instance menjadi success)
Peristiwa pra-perubahan instance (membekukan, membuka pembekuan, menghentikan, dan menjalankan ulang instance, serta menyetel status instance menjadi sukses)
Perubahan instance - Hapus instance kedaluwarsa
Peristiwa menghapus instance leluhur tertentu dari sebuah instance
Perubahan status alur kerja
Pemantauan dan peringatan
Peristiwa Pusat Keamanan
Peristiwa
Kategori Peristiwa | Peristiwa dan operasi pembuatan peristiwa | Peristiwa reguler | Peristiwa titik ekstensi | Tipe peristiwa di EventBridge
| Kode peristiwa di Ekstensi |
Pusat Persetujuan | Peristiwa sebelum Pembuatan Pesanan Persetujuan |
|
|
|
|
Menyelesaikan pesanan pemrosesan permintaan izin |
|
|
|
| |
Pusat Keamanan (permintaan izin tabel) | Meminta izin pada tabel (pra-peristiwa) |
|
|
|
|
Format Pesan
Pusat Persetujuan (membuat dan menyelesaikan pesanan pemrosesan permintaan izin)
Pusat Keamanan (Pra-peristiwa untuk permintaan izin tabel)
Lampiran: Konten yang Diotorisasi (MaxCompute)
Lampiran: Konten yang Diotorisasi (DataService)
Peristiwa Kualitas Data
Peristiwa
Kategori acara | Peristiwa dan operasi pembuatan peristiwa | Acara rutin | Titik ekstensi acara | Event type in EventBridge
| Kode acara di Extensions |
Pemeriksaan kualitas data | Berikan umpan balik mengenai hasil pemeriksaan kualitas data
|
|
|
| |
Laporkan bahwa pemeriksaan kualitas data telah selesai
|
|
|
|
| |
Peristiwa sebelum aturan pemantauan | Peristiwa sebelum Pembuatan Batch Aturan Kualitas Data |
|
|
|
|
Pra-kejadian untuk Pembaruan Batch Aturan Kualitas Data |
|
|
|
| |
Prakejadian untuk Penghapusan Batch Aturan Kualitas Data |
|
|
|
| |
Pra-kejadian untuk Pembaruan Aturan Kualitas Data |
|
|
|
| |
Prakejadian untuk monitor | Peristiwa sebelumnya untuk Pembuatan Tugas Evaluasi Kualitas Data |
|
|
|
|
Pra-kejadian untuk Pembaruan Tugas Evaluasi Kualitas Data |
|
|
|
| |
Pre-event untuk Tugas Evaluasi Kualitas Data Clone |
|
|
|
| |
Praproses untuk Penghapusan Batch Tugas Evaluasi Kualitas Data |
|
|
|
| |
Prakejadian untuk langganan memantau informasi peringatan | Peristiwa sebelumnya untuk Pembuatan Notifikasi Tugas Evaluasi Kualitas Data |
|
|
| create-data-quality-evaluation-task-notification |
Pemberitahuan Pembaruan Tugas Evaluasi Kualitas Data Pra-kejadian |
|
|
|
| |
Notifikasi Tugas Evaluasi Kualitas Data Pra-kejadian Hapus |
|
|
|
|
Format Pesan
Pemeriksaan kualitas data
Peristiwa sebelum aturan pemantauan (membuat, memperbarui, dan menghapus beberapa aturan pemantauan sekaligus, serta memperbarui aturan pemantauan)
Peristiwa pra-pemantauan (membuat, memperbarui, dan mengkloning pemantauan, serta menghapus beberapa pemantauan sekaligus)
Pra-peristiwa untuk langganan pemantauan informasi peringatan (membuat, memperbarui, dan menghapus notifikasi tugas evaluasi kualitas data)
Peristiwa tingkat penyewa
Layanan tingkat penyewa menghasilkan acara tingkat penyewa. Sebagai contoh, acara yang dihasilkan ketika ruang kerja dihapus di konsol DataWorks adalah acara tingkat penyewa. Anda dapat melihat pada tabel berikut acara yang didukung oleh setiap layanan DataWorks, apakah suatu acara merupakan acara reguler atau acara titik ekstensi, serta format pesan suatu acara.
Pada tab Format Pesan bagian ini, hanya sebagian isi format pesan acara yang ditampilkan. Untuk melihat pesan acara lengkap yang dikirim ke EventBridge atau Function Compute, lihat bagian Lampiran: Format Pesan dalam topik ini.
Peristiwa Konsol DataWorks
Peristiwa
Kategori Peristiwa | Peristiwa dan operasi pembuatan peristiwa | Peristiwa reguler | Peristiwa titik ekstensi | Tipe Peristiwa di EventBridge | Kode Peristiwa di Ekstensi |
Penghapusan Ruang Kerja | Peristiwa pra untuk Penghapusan Proyek |
|
|
|
|
Hapus ruang kerja (pasca-peristiwa) |
|
|
|
|
Format Pesan
Badan Pesan untuk Peristiwa Penghapusan Ruang Kerja
Peristiwa Unggah dan Unduh
Peristiwa
Kategori Peristiwa | Peristiwa dan operasi pembuatan peristiwa | Peristiwa reguler | Peristiwa titik ekstensi | Tipe Peristiwa di EventBridge | Kode Peristiwa di Ekstensi |
Unduhan dan unggahan data | Peristiwa pra untuk Pembuatan Sumber Daya |
|
| dataworks:ResourcesDownload:DownloadResources | download-resources |
Peristiwa pra untuk Unduhan Sumber Daya |
|
| dataworks:ResourcesDownload:DownloadResourcesExecute | download-resources-execute | |
Peristiwa pra untuk Unggahan Sumber Daya |
|
| dataworks:ResourcesUpload:UploadDataToTable | upload-data-to-table |
Format Pesan
Unduhan dan unggahan data
Lampiran: Format pesan
Format pesan acara yang dikirim ke EventBridge
Setelah Anda mengonfigurasi saluran distribusi acara di OpenEvent, pesan acara yang dikirim ke EventBridge dapat difilter berdasarkan nilai bidang Type ketika acara tingkat workspace-level atau tenant-level dipicu di DataWorks. Contoh format pesan acara yang dikirim ke EventBridge menggunakan saluran distribusi acara:
{
"datacontenttype": "application/json;charset=utf-8",// Format konten data. datacontenttype hanya mendukung application/json.
"data": {
// Konten pesan bervariasi berdasarkan tipe pesan. Dua bidang berikut tetap ada di setiap pesan. Untuk informasi tentang konten pesan dari setiap jenis acara, lihat informasi sebelumnya.
"tenantId": 28378****10656,// ID penyewa. Setiap akun Alibaba Cloud di DataWorks sesuai dengan satu penyewa. Setiap penyewa memiliki ID penyewa sendiri. Untuk melihat ID penyewa, klik akun saat ini di pojok kanan atas halaman DataStudio. Di panel yang muncul, klik Info Pengguna di bagian Menu. Anda dapat melihat ID penyewa di pesan Info Pengguna.
"eventCode": "xxxx"//
},
"id": "539fd8f4-4ea1-4625-aa8b-6c906674****",// ID acara. ID ini adalah pengenal unik suatu acara.
"source": "acs.dataworks",// Sumber acara. Dalam contoh ini, acara didorong oleh DataWorks.
"specversion": "1.0",
"subject": "",
"time": "2020-11-19T21:04:41+08:00",// Waktu pembuatan acara.
"type": "dataworks:InstanceStatusChanges:InstanceStatusChanges",// Jenis acara. Bidang Type digunakan di konsol EventBridge untuk menyaring semua pesan acara yang didorong oleh DataWorks. Setiap acara memiliki nilai tipe acara yang berbeda. Anda dapat merujuk pada informasi sebelumnya untuk mendapatkan tipe acara.
"aliyunaccountid": "123456789098****",// ID akun Alibaba Cloud.
"aliyunpublishtime": "2020-11-19T21:04:42.179PRC",// Waktu ketika EventBridge menerima acara.
"aliyuneventbusname": "default",// Nama bus acara EventBridge yang digunakan untuk menerima pesan acara DataWorks.
"aliyunregionid": "cn-hangzhou",// Wilayah tempat acara diterima.
"aliyunpublishaddr": "172.25.XX.XX"
}Pesan acara lengkap berisi informasi seperti isi, ID, sumber, dan waktu pembuatan pesan acara. Tabel berikut menjelaskan bidang utama dalam kode sampel sebelumnya.
Bidang | Tipe | Deskripsi |
data | objek | Isi pesan acara. Struktur isi pesan dan bidang yang terkandung dalam isi pesan bervariasi berdasarkan jenis acara. Untuk informasi lebih lanjut, lihat bagian berikut dalam topik ini: Untuk informasi tentang format pesan acara di DataStudio, lihat bagian Acara DataStudio dalam topik ini. Untuk informasi tentang format pesan acara di Data Integration, lihat bagian Acara Data Integration dalam topik ini. Untuk informasi tentang format pesan acara di Pusat Operasi, lihat bagian Acara Pusat Operasi dalam topik ini. Untuk informasi tentang format pesan acara di Security Center, lihat bagian Acara Security Center dalam topik ini. Untuk informasi tentang format pesan acara di Kualitas Data, lihat bagian Acara Kualitas Data dalam topik ini. |
id | String | ID unik pesan acara. Anda dapat mengidentifikasi pesan acara berdasarkan ID pesan acara tersebut. |
type | String | Jenis acara. Bidang ini digunakan untuk menggambarkan jenis acara dari sumber acara. Contoh nilai:
Bidang Type digunakan di konsol EventBridge untuk menyaring semua pesan acara yang didorong oleh DataWorks. Setiap acara memiliki nilai tipe acara yang berbeda. Anda dapat merujuk pada informasi sebelumnya untuk mendapatkan tipe acara. |
Format pesan acara yang dikirim ke Function Compute
Jika Anda mengembangkan dan menerapkan ekstensi di DataWorks berdasarkan Function Compute, pesan acara terkait dikirim ke Function Compute sebagai data JSON ketika acara titik ekstensi yang ditentukan dalam ekstensi dipicu. Contoh format pesan acara yang dikirim ke Function Compute:
{
"blockBusiness": true,
"eventCategoryType": "resources-download",// Kategori acara.
"eventType": "upload-data-to-table",// Jenis acara.
"extensionBizId": "job_6603***070",
"messageBody": {
// Konten pesan bervariasi berdasarkan tipe pesan. Dua bidang berikut tetap ada di setiap pesan. Untuk informasi tentang konten pesan dari setiap jenis acara, lihat informasi sebelumnya.
"tenantId": 28378****10656,// ID penyewa. Setiap akun Alibaba Cloud di DataWorks sesuai dengan satu penyewa. Setiap penyewa memiliki ID penyewa sendiri. Untuk melihat ID penyewa, klik akun saat ini di pojok kanan atas halaman DataStudio. Di panel yang muncul, klik Info Pengguna di bagian Menu. Anda dapat melihat ID penyewa di pesan Info Pengguna.
"eventCode": "xxxx"//
},
"messageId": "52d44ee7-b51f-4d4d-afeb-*******"// ID acara. ID ini adalah pengenal unik suatu acara.
}Tabel berikut menjelaskan bidang dalam kode sampel sebelumnya.
Bidang | Tipe | Deskripsi | |
messageId | String | ID acara. ID ini adalah pengenal unik suatu acara. | |
messageBody | Pesan acara spesifik yang didorong oleh DataWorks. Bidang ini digunakan ketika ekstensi dikembangkan. Nilai bidang bervariasi berdasarkan tipe pesan. | ||
tenantId | ID penyewa. Setiap akun Alibaba Cloud di DataWorks sesuai dengan satu penyewa. Setiap penyewa memiliki ID penyewa sendiri. Untuk melihat ID penyewa, klik akun saat ini di pojok kanan atas halaman DataStudio. Di panel yang muncul, klik Info Pengguna di bagian Menu. Anda dapat melihat ID penyewa di pesan Info Pengguna. | ||
eventCode | Kode acara. Digunakan untuk mengidentifikasi jenis pesan acara. Untuk informasi tentang kode acara untuk setiap jenis acara, lihat kolom Kode Acara di Ekstensi di setiap tabel Acara dalam topik ini. | ||