GetSemanticJobDetail - DataWorks - Alibaba Cloud Documentation Center

Mengkueri status pelaksana dan konfigurasi runtime dengan menggunakan ExecutorJobId yang dikembalikan oleh RunSemanticJob atau ListSemanticJobRuns.

Deskripsi operasi

Skenario

Mengkueri status detail dan informasi runtime dari eksekusi pekerjaan semantik di sisi pelaksana. Ini digunakan untuk mem-polling progres eksekusi atau memecahkan masalah kegagalan eksekusi.

Prosedur

Panggil RunSemanticJob atau ListSemanticJobRuns untuk mendapatkan ExecutorJobId.
Gunakan ProjectId yang dikembalikan oleh definisi pekerjaan sebagai ProjectId untuk operasi ini.
Tentukan status saat ini berdasarkan detail pelaksana di Data. Jika pekerjaan masih berjalan, lanjutkan mem-polling operasi ini.

Operasi terkait

Untuk mengambil log, panggil GetSemanticJobLog. Untuk menghentikan eksekusi, panggil KillSemanticJob.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
ExecutorJobId	string	Yes	ID pekerjaan pelaksana. Gunakan Data.ExecutorJobId dari tanggapan RunSemanticJob atau ExecutorJobId dari catatan ListSemanticJobRuns.	exec-job-demo
ProjectId	integer	Yes	ID ruang kerja DataWorks tempat pekerjaan berada. Gunakan ProjectId dari tanggapan CreateSemanticJob atau item daftar ListSemanticJobs.	100

Susun parameter permintaan berdasarkan deskripsi setiap bidang permintaan.

Elemen respons

Element	Type	Description	Example
	object	Tanggapan standar untuk mengkueri detail eksekusi pelaksana. Data berisi detail pelaksana yang saat ini dikembalikan untuk ExecutorJobId yang ditentukan.
RequestId	string	ID permintaan. Digunakan untuk melacak log dan memecahkan masalah.	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	Apakah permintaan berhasil.
Data	object	Detail pekerjaan yang dikembalikan oleh pelaksana. Digunakan untuk menentukan status eksekusi dan melihat konfigurasi runtime aktual.
ExecutorJobId	string	ID pekerjaan pelaksana.	exec-job-demo
FileType	integer	Kode tipe node pelaksana. Pekerjaan semantik menggunakan kode node Shell 6.	6
ProjectId	integer	ID ruang kerja DataWorks yang terkait dengan pekerjaan pelaksana.	100
Datasource	string	Identifikasi sumber data yang digunakan oleh pekerjaan pelaksana.	maxcompute
CodeParameters	string	Informasi parameter kode yang dikembalikan oleh pelaksana. Digunakan untuk memecahkan masalah konfigurasi runtime eksekusi ini.	--limit 100
Env	string	Identifikasi lingkungan runtime yang dikembalikan oleh pelaksana.	PROD
CustomerName	string	Identifikasi pelanggan dari pekerjaan pelaksana.	meta_semantic
CurrentSqlIndex	integer	Indeks fragmen SQL yang sedang diproses oleh pelaksana.	0
ExecTypes	array	Daftar kode tipe eksekusi yang dikembalikan oleh pelaksana.
	integer	Daftar kode tipe eksekusi yang dikembalikan oleh pelaksana.	6
Statuses	array	Daftar kode status yang dikembalikan oleh pelaksana. Digunakan untuk menentukan status saat ini atau akhir dari pekerjaan.
	integer	Daftar kode status pekerjaan yang dikembalikan oleh pelaksana. Status sukses mencakup 3.	3
AdvanceSettings	object	Pengaturan runtime lanjutan yang dikembalikan oleh pelaksana.
ResourceUrls	array<object>	Daftar URL Sumber daya yang terkait dengan pekerjaan pelaksana.
	object	Daftar URL Sumber daya yang dikembalikan oleh pelaksana.
ResourceGroupId	string	ID kelompok sumber daya yang sebenarnya mengeksekusi pekerjaan.	rg-demo

Untuk arti bidang tanggapan dan hubungannya dengan panggilan berikutnya, lihat deskripsi setiap bidang.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "ExecutorJobId": "exec-job-demo",
    "FileType": 6,
    "ProjectId": 100,
    "Datasource": "maxcompute",
    "CodeParameters": "--limit 100",
    "Env": "PROD",
    "CustomerName": "meta_semantic",
    "CurrentSqlIndex": 0,
    "ExecTypes": [
      6
    ],
    "Statuses": [
      3
    ],
    "AdvanceSettings": {
      "test": "test",
      "test2": 1
    },
    "ResourceUrls": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "ResourceGroupId": "rg-demo"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.