Dokumen ini menjelaskan jenis event DataWorks, format pesannya, serta makna masing-masing field. Gunakan dokumen ini untuk menemukan dan mengkueri informasi mengenai daftar event dan format pesan secara cepat.
Pendahuluan
Di DataWorks, event diklasifikasikan sebagai event standar atau event titik ekstensi berdasarkan kemampuannya membuat checkpoint di dalam DataWorks dan mengembalikan hasil pemrosesan setelah disubscribe oleh layanan yang dikelola sendiri.
-
Event standar: Anda dapat berlangganan pesan event ini, tetapi event ini tidak dapat memblokir operasi di dalam DataWorks. Berlangganan event ini menggunakan OpenEvent. Untuk informasi selengkapnya, lihat OpenEvent.
-
Event titik ekstensi: Setelah berlangganan pesan event ini, Anda dapat menyesuaikan respons terhadap pesan event menggunakan fitur Extensions di Open Platform DataWorks. Saat Anda menggunakan Extensions untuk mengelola operasi pada titik ekstensi, operasi yang dilakukan pengguna platform DataWorks pada titik tersebut akan dihentikan sementara hingga ekstensi kustom Anda mengembalikan hasil pemrosesan.
Daftar berikut mengkategorikan event yang didukung berdasarkan modul dan menunjukkan apakah masing-masing merupakan event standar atau event titik ekstensi. Daftar ini juga mencantumkan tipe event EventBridge (Type) dan kode event ekstensi (eventCode).
-
Tipe event EventBridge (Type): Field yang digunakan untuk memfilter pesan event. Untuk detailnya, lihat Aktifkan langganan pesan.
-
Kode event ekstensi (eventCode): Kode event yang sesuai dengan tipe event tersebut. Selama pengembangan lokal, peroleh kode ini dari konten pesan yang dikirim oleh DataWorks untuk mengidentifikasi tipe event target.
Event tingkat ruang kerja
Event yang dihasilkan oleh modul tingkat ruang kerja disebut event tingkat ruang kerja, seperti event dari eksekusi node di Data Development atau perubahan status instance berulang di Operation Center. Gunakan daftar event berikut untuk mengidentifikasi mana yang merupakan event standar dan mana yang merupakan event titik ekstensi, beserta format pesannya.
Tab format pesan berikut hanya berisi konten sebagian. Untuk pesan lengkap yang dikirim ke EventBridge atau Function Compute, lihat Lampiran: Format Pesan.
Daftar event Data Development
Daftar event
|
Tipe event |
Event (dan operasi pemicu) |
Event standar |
Event titik ekstensi |
Tipe event EventBridge (Type) |
Kode event ekstensi (eventCode) |
|
Perubahan node |
Buat node
|
|
|
|
|
|
Perbarui node
|
|
|
|
|
|
|
Perubahan file
|
Event pra-hapus file Hapus node di lingkungan pengembangan Catatan
File yang dihapus dipindahkan ke Keranjang daur ulang. |
|
|
|
|
|
Event pra-commit file |
|
|
|
|
|
|
Event pra-deploy file |
|
|
|
|
|
|
Event pra-eksekusi |
|
|
|
|
|
|
Perubahan tabel |
Event pra-submit tabel untuk pengembangan |
|
|
|
|
|
Event pra-deploy tabel ke lingkungan produksi |
|
|
|
|
Format pesan
Event perubahan node (buat, perbarui)
Event perubahan file (commit, deploy, run, delete)
Event perubahan tabel (commit tabel ke pengembangan, deploy tabel ke produksi)
Daftar event Data Integration
Daftar event
|
Tipe event |
Event (dan operasi pemicu) |
Event standar |
Event titik ekstensi |
Tipe event EventBridge (Type) |
Tipe event ekstensi (eventCode) |
|
Event perubahan node |
Mulai job |
|
|
|
|
|
Batch mulai job |
|
|
|
|
Format pesan
Event perubahan node-Mulai job
Event perubahan Node-Memulai Pekerjaan Batch
Daftar event Operation Center
Daftar event
Memodifikasi kelompok sumber daya penjadwalan atau pemilik akan memicu node-change-updated.
|
Tipe event |
Event (dan operasi pemicu) |
Event standar |
Extension point event |
Tipe event EventBridge (Type) |
Tipe event ekstensi (eventCode) |
|
Perubahan node |
Hapus node
|
|
|
|
|
|
Event pra-unpublish node Langsung batalkan publikasi node berulang di lingkungan produksi Catatan
Operasi ini secara sinkron menghapus node di Data Development dan memindahkannya ke Keranjang daur ulang. |
|
|
|
|
|
|
Event pra-bekukan node Penting
Event ini secara sinkron memicu event node-change-updated. |
|
|
|
|
|
|
Event pra-unfreeze node Penting
Event ini secara sinkron memicu event node-change-updated. |
|
|
|
|
|
|
Backfill data |
Event pra-backfill data |
|
|
|
|
|
Perubahan status tugas |
Perubahan status tugas penjadwalan |
|
|
|
|
|
Perubahan instance |
Bekukan instance |
|
|
|
|
|
Unfreeze instance |
|
|
|
|
|
|
Kill instance |
|
|
|
|
|
|
Rerun instance
|
|
|
|
|
|
|
Instance berhasil |
|
|
|
|
|
|
Hapus dependensi upstream yang ditentukan dari instance |
|
|
|
|
|
|
Event pra-bekukan instance |
|
|
|
|
|
|
Event pra-unfreeze instance |
|
|
|
|
|
|
Event pra-rerun instance |
|
|
|
|
|
|
Event pra-set instance success |
|
|
|
|
|
|
Event pra-kill instance |
|
|
|
|
|
|
Hapus instance kedaluwarsa |
|
|
|
|
|
|
Perubahan status alur kerja |
Perubahan status alur kerja
|
|
|
|
|
|
Monitoring dan alert |
Monitoring dan alert |
|
|
|
|
Format pesan
Event perubahan node (hapus, unpublish, bekukan, unfreeze)
Backfill data
Event perubahan status tugas
Event perubahan instans (membekukan, melepas pembekuan, menghentikan, menjalankan ulang, atur keberhasilan)
Event pra-perubahan instance (bekukan, unfreeze, rerun, set success, kill instance)
Event perubahan instans-Hapus instans yang kedaluwarsa
Event menghapus hubungan dependensi upstream yang ditentukan
Event perubahan status alur kerja
Monitoring dan alert
Daftar event Security Center
Daftar event
|
Jenis Peristiwa |
Event (dan operasi pemicu) |
Event standar |
Event titik ekstensi |
Tipe event EventBridge (Type) |
Tipe pesan ekstensi (eventCode) |
|
Approval Center |
Event pra-buat formulir permohonan izin |
|
|
|
|
|
Lengkapi formulir aplikasi |
|
|
|
|
|
|
Security Center (permohonan izin tabel) |
Event pra-permohonan izin tabel |
|
|
|
|
Format pesan
Approval Center (buat, lengkapi formulir aplikasi)
Security Center (Event pra-permohonan izin tabel)
Lampiran: Daftar konten otorisasi (MaxCompute)
Lampiran: Daftar konten otorisasi (DataService)
Daftar event Kualitas Data
Daftar event
|
Tipe event |
Event (dan operasi pemicu) |
Event standar |
Event titik ekstensi |
Tipe event EventBridge (Type) |
Tipe event ekstensi (eventCode) |
|
Validasi kualitas data |
Umpan balik hasil validasi
|
|
|
|
|
|
Validasi selesai
|
|
|
|
|
|
|
Pra-pemeriksaan Aturan Kualitas Data |
Event pra-buat batch aturan kualitas data |
|
|
|
|
|
Event pra-perbarui batch aturan kualitas data |
|
|
|
|
|
|
Event pra-hapus batch aturan kualitas data |
|
|
|
|
|
|
Event pra-perbarui aturan kualitas data |
|
|
|
|
|
|
Pra-operasi monitoring kualitas data |
Event pra-buat monitoring kualitas data |
|
|
|
|
|
Event pra-perbarui monitoring kualitas data |
|
|
|
|
|
|
Event pra-kloning monitoring kualitas data |
|
|
|
|
|
|
Event pra-hapus batch monitoring kualitas data |
|
|
|
|
|
|
Pra-operasi langganan alert monitoring kualitas data |
Event pra-buat langganan alert monitoring kualitas data |
|
|
|
create-data-quality-evaluation-task-notification |
|
Event pra-perbarui langganan alert monitoring kualitas data |
|
|
|
|
|
|
Event pra-hapus langganan alert monitoring kualitas data |
|
|
|
|
Format pesan
Validasi kualitas data
Event pra-operasi aturan kualitas data (buat batch, perbarui, hapus)
Event pra-operasi monitoring kualitas data (buat, perbarui, kloning, hapus batch)
Event pra-operasi langganan alert monitoring kualitas data (buat, perbarui, hapus)
Event tingkat penyewa
Modul tingkat penyewa menghasilkan event tingkat penyewa, seperti event yang dihasilkan saat menghapus ruang kerja di konsol manajemen. Gunakan daftar event berikut untuk mengidentifikasi mana yang merupakan event standar dan mana yang merupakan event titik ekstensi, beserta format pesannya.
Tab format pesan berikut hanya berisi konten sebagian. Untuk pesan lengkap yang dikirim ke EventBridge atau Function Compute, lihat Lampiran: Format Pesan.
Daftar event konsol manajemen
Daftar event
|
Tipe event |
Event (dan operasi pemicu) |
Event standar |
Event titik ekstensi |
Tipe event EventBridge (Type) |
Tipe event ekstensi (eventCode) |
|
Hapus ruang proyek |
Event pra-hapus ruang proyek |
|
|
|
|
|
Hapus spasi tambahan. |
|
|
|
|
Format pesan
Format payload pesan: Event hapus ruang proyek
Daftar event unggah dan unduh
Daftar event
|
Jenis peristiwa |
Event (dan operasi pemicu) |
Event standar |
Event titik ekstensi |
Tipe event EventBridge (Type) |
Tipe event ekstensi (eventCode) |
|
Unggah dan unduh data |
Event pra-unduh data - pembuatan file |
|
|
dataworks:ResourcesDownload:DownloadResources |
download-resources |
|
Event pra-unduh data - unduh file |
|
|
dataworks:ResourcesDownload:DownloadResourcesExecute |
download-resources-execute |
|
|
Event pra-unggah data |
|
|
dataworks:ResourcesUpload:UploadDataToTable |
upload-data-to-table |
Format pesan
Unggah dan unduh data
Lampiran: Format pesan
Format pesan untuk EventBridge
Setelah mengonfigurasi OpenEvent dan menambahkan saluran distribusi event, ketika event tingkat ruang kerja atau tingkat penyewa dipicu di DataWorks, pesan difilter berdasarkan tipe event (Type) yang dikonfigurasi di EventBridge. Berikut ini menunjukkan format pesan yang dikirim DataWorks ke EventBridge melalui saluran distribusi event.
{
"datacontenttype": "application/json;charset=utf-8",// Format konten parameter data. datacontenttype hanya mendukung format application/json.
"data": {
// Konten pesan bervariasi berdasarkan tipe pesan. Berikut ini adalah dua field tetap dalam semua pesan event. Untuk detail setiap pesan event, lihat di atas.
"tenantId": 28378****10656,// ID penyewa. Setiap akun Alibaba Cloud di DataWorks sesuai dengan satu penyewa, dan setiap penyewa memiliki ID penyewa sendiri. Anda dapat melihat nilai ini di informasi pengguna di pojok kanan atas DataWorks Data Development.
"eventCode": "xxxx"//
},
"id": "539fd8f4-4ea1-4625-aa8b-6c906674****",// ID event. Identifier unik untuk event.
"source": "acs.dataworks",// Sumber event, layanan yang menyediakan event, menunjukkan bahwa pesan ini didorong oleh DataWorks.
"specversion": "1.0",
"subject": "",
"time": "2020-11-19T21:04:41+08:00",// Waktu saat event terjadi.
"type": "dataworks:InstanceStatusChanges:InstanceStatusChanges",// Tipe event. Tipe event ini dapat digunakan untuk memfilter semua pesan yang didorong oleh DataWorks di konsol EventBridge. Setiap event memiliki nilai Type yang berbeda. Lihat di atas untuk tipe pesan event yang berbeda.
"aliyunaccountid": "123456789098****",// ID akun Alibaba Cloud
"aliyunpublishtime": "2020-11-19T21:04:42.179PRC",// Waktu saat EventBridge menerima event.
"aliyuneventbusname": "default",// Nama bus event EventBridge yang menerima pesan event DataWorks.
"aliyunregionid": "cn-hangzhou",// Wilayah yang menerima event.
"aliyunpublishaddr": "172.25.XX.XX"
}
Pesan event lengkap mencakup format payload pesan dan informasi dasar seperti ID pesan, sumber, dan waktu kejadian. Deskripsi field penting ditunjukkan pada tabel berikut.
|
Nama field |
Tipe bidang |
Deskripsi |
|
data |
object |
Format payload pesan. Format pesan dan makna field bervariasi berdasarkan tipe event. Untuk detailnya, lihat: Format pesan event Data Development: Daftar event Data Development. Format pesan event Data Integration: Daftar event Data Integration. Format pesan event Operation Center: Daftar event Operation Center. Format pesan event Security Center: Daftar event Security Center. Format pesan event Kualitas Data: Daftar event Kualitas Data. |
|
id |
String |
ID unik pesan event. Digunakan untuk menemukan pesan event. |
|
type |
String |
Tipe event. Menjelaskan tipe event yang terkait dengan sumber event. Contoh nilai:
Tipe event ini dapat digunakan untuk memfilter semua pesan yang didorong oleh DataWorks di konsol EventBridge. Setiap event memiliki nilai Type yang berbeda. Lihat di atas untuk tipe pesan event yang berbeda. |
Format pesan untuk Function Compute
Saat Anda mengonfigurasi Extensions di DataWorks menggunakan Function Compute, DataWorks mengirim pesan untuk event titik ekstensi yang sesuai ke Function Compute dalam format JSON. Berikut ini menunjukkan format pesan yang dikirim ke Function Compute.
{
"blockBusiness": true,
"eventCategoryType": "resources-download",// Kategori event
"eventType": "upload-data-to-table",// Tipe event
"extensionBizId": "job_6603***070",
"messageBody": {
// Konten pesan bervariasi berdasarkan tipe pesan. Berikut ini adalah dua field tetap dalam semua pesan event. Untuk detail setiap pesan event, lihat di atas.
"tenantId": 28378****10656,// ID penyewa. Setiap akun Alibaba Cloud di DataWorks sesuai dengan satu penyewa, dan setiap penyewa memiliki ID penyewa sendiri. Anda dapat melihat nilai ini di informasi pengguna di pojok kanan atas DataWorks Data Development.
"eventCode": "xxxx"//
},
"messageId": "52d44ee7-b51f-4d4d-afeb-*******"// ID event. Identifier unik untuk event.
}
Deskripsi field penting adalah sebagai berikut:
|
Nama field |
Tipe bidang |
Deskripsi |
|
|
messageId |
String |
ID event, identifier unik untuk event. |
|
|
messageBody |
Pesan event spesifik yang didorong oleh DataWorks, yang dapat Anda gunakan dalam pengembangan ekstensi. Konten pesan bervariasi berdasarkan tipe pesan. |
||
|
tenantId |
ID penyewa. Setiap akun Alibaba Cloud di DataWorks sesuai dengan satu penyewa, dan setiap penyewa memiliki ID penyewa sendiri. Anda dapat melihat nilai ini di informasi pengguna di pojok kanan atas DataWorks Data Development |
||
|
eventCode |
Kode event. Digunakan untuk mengidentifikasi tipe pesan event spesifik. Untuk nilai eventCode yang sesuai dengan setiap tipe event, lihat kolom Tipe event ekstensi (eventCode) dalam tabel Referensi Pengembangan: Daftar Event dan Format Pesan. |
||