Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Gambaran Umum
File WorkloadManifest.xml
dan Item.xml
diperlukan untuk definisi beban kerja di Fabric. Mereka memegang pengaturan konfigurasi Workload dan Workload Items dasar untuk penyiapan dan mereka bertindak sebagai panduan untuk penyiapan dan manajemen beban kerja, membantu menentukan, berbagi, dan merekam detail beban kerja penting untuk integrasi yang lancar ke Fabric.
Di repositori .nupkg
sampel kami, file dihasilkan dari file XML yang terletak di src/Packages/manifest
folder selama proses build. File paket ini menyimpan semua informasi yang diperlukan tentang beban kerja Anda.
workload-dev-mode.json
Dalam file, ada bidang yang disebut ManifestPackageFilePath
yang harus menunjuk ke file yang baru dibuat .nupkg
ini.
Proses Unggah dan Pendaftaran
- Autentikasi Pengguna: Selama pengembangan, setelah menjalankan sampel, autentikasi Anda memulai proses pengunggahan dan pendaftaran. Ini memastikan asosiasi beban kerja yang benar dengan identitas Anda.
- Penguraian Manifes: Manifes yang diunggah mengalami penguraian untuk memvalidasi struktur dan kontennya. Langkah ini memastikan bahwa manifes diformat dengan benar dan siap untuk diproses lebih lanjut.
- Pendaftaran Beban Kerja: Jika penguraian berhasil, beban kerja terdaftar di Fabric. Detail konfigurasi penting, seperti ID beban kerja, disimpan dalam database Fabric, memungkinkan manajemen beban kerja yang efektif.
Manifes Beban Kerja - Komponen Manifes Kunci
Manifes, yang strukturnya didefinisikan oleh WorkloadDefinition.xsd, menguraikan atribut inti beban kerja, seperti nama, aplikasi, dan titik akhir.
Atribut SchemaVersion
Mewakili versi yang diterbitkan WorkloadDefinition.xsd Fabric.
Atribut WorkloadName
Pengidentifikasi unik beban kerja Anda. Perhatikan bahwa diperlukan untuk memiliki 'Org.' awalan untuk workloadName seperti nama tersebut terdiri dari dua kata dengan pemisah '.', misalnya 'Org.MyWorkload'. Awalan lain tidak valid dan akan menyebabkan kegagalan unggahan. Ini akan diberlakukan dalam skenario berikut: koneksi pengembang, unggahan uji.
Elemen Versi
Versi manifes Anda, harus sesuai dengan SemVer .
Elemen CloudServiceConfiguration
Konfigurasi layanan beban kerja Anda, saat ini hanya satu konfigurasi yang didukung.
Microsoft Entra ID [Azure Active Directory (AAD)] Konfigurasi Aplikasi
Bagian ini <AADApp>
menyiapkan aplikasi Microsoft Entra ID [Azure Active Directory (AAD)] untuk proses autentikasi dan otorisasi.
AppId
mewakili pengidentifikasi unik untuk aplikasi Anda, RedirectUri
menentukan URI tempat ID Microsoft Entra akan mengirim respons autentikasi, dan ResourceId
poin ke pengidentifikasi unik untuk sumber daya yang diakses aplikasi. Untuk konteks selengkapnya tentang apa , ResourceId
, AppId
dan RedirectUri
representasikan, Anda dapat merujuk ke dokumentasi autentikasi.
<AADApp>
<AppId>YourApplicationId</AppId>
<RedirectUri>YourRedirectUri</RedirectUri>
<ResourceId>YourResourceId</ResourceId>
</AADApp>
Lihat dokumentasi autentikasi untuk pemahaman yang lebih mendalam tentang AppId
, ResourceId
, dan RedirectUri
signifikansinya dalam konteks proses autentikasi.
Elemen ServiceEndpoint
Mewakili konfigurasi dari titik akhir logis tertentu, misalnya, titik akhir backend yang mencakup implementasi untuk item CRUD dan API tugas.
- Konfigurasi untuk titik akhir backend beban kerja menyatakan URL backend beban kerja Anda.
<ServiceEndpoint>
<Name>Workload</Name>
<Url>YourWorkloadBackendUrl</Url>
<IsEndpointResolutionService>...
<EndpointResolutionContext>...
</ServiceEndpoint>
-
<IsEndpointResolutionService>
dan<EndpointResolutionContext>
ditetapkan berdasarkan apakah titik akhir Anda mengimplementasikan API beban kerja atau hanya resolusi titik akhir. - Titik akhir yang telah ditentukan yang dikembalikan dari layanan harus memenuhi persyaratan berikut:
- Domain titik akhir yang diselesaikan harus cocok dengan domain ID sumber daya yang ditemukan di WorkloadManifest.xml.
- URL titik akhir yang diselesaikan mungkin memiliki hingga enam subdomain tambahan sebelum domain utama.
- Subdomain apa pun setelah segmen pertama harus termasuk dalam daftar domain terverifikasi penyewa penerbit.
Contoh
URL ID Sumber Daya:https://contoso.com/fe/be/Org.WorkloadSample
(di mana domainnya contoso.com
)
Domain terverifikasi di penyewa:contoso.com
, be.contoso.com
, eastus.be.contoso.com
Titik akhir terselesaikan yang valid:
api.eastus.be.contoso.com
be.contoso.com
api.be.contoso.com
Titik akhir yang diselesaikan tidak valid:
-
api.eastus.fe.contoso.com
(tidak valid karenaeastus.fe.contoso.com
bukan domain terverifikasi) -
contoso-dev.com
(tidak valid karenacontoso-dev.com
bukan domain terverifikasi, dan juga tidak cocok dengan domain utama ID sumber daya)
- Untuk informasi selengkapnya tentang menggunakan API klien beban kerja untuk resolusi titik akhir, lihat Resolusi Titik Akhir.
Catatan
Resolusi titik akhir untuk Frontend tidak didukung.
Manifes Item - Komponen Manifes Kunci
Manifes, yang strukturnya didefinisikan oleh ItemDefinition.xsd, menguraikan atribut inti item beban kerja, seperti nama dan definisi pekerjaan.
Atribut SchemaVersion
Mewakili versi yang diterbitkan ItemDefinition.xsd Fabric.
Atribut TypeName
Pengidentifikasi unik item Anda.
Konfigurasi Penjadwal Pekerjaan
Bagian ini <JobScheduler>
mencakup berbagai elemen yang menentukan perilaku dan pengaturan penjadwalan, pelacakan, dan manajemen pekerjaan.
-
<OnDemandJobDeduplicateOptions>
dan<ScheduledJobDeduplicateOptions>
: Tentukan opsi deduplikasi untuk pekerjaan item sesuai permintaan dan terjadwal, masing-masing. Opsi termasukNone
(tidak ada deduplikasi),PerItem
(satu pekerjaan berjalan untuk item dan jenis pekerjaan yang sama), danPerUser
(satu pekerjaan berjalan untuk pengguna dan item yang sama). -
<ItemJobTypes>
: Berisi konfigurasi untuk jenis pekerjaan item yang berbeda. -
<ItemJobType>
: Menjelaskan jenis pekerjaan tertentu. -
<Name>
: Nama jenis pekerjaan. Harus menggunakan nama Item sebagai awalan.
Misalnya, mari kita pertimbangkan beban kerja sampel kita, yang mencakup tiga pekerjaan tertentu yang ditentukan dalam bagian <ItemJobTypes>
:
<JobScheduler>
<OnDemandJobDeduplicateOptions>PerItem</OnDemandJobDeduplicateOptions>
<ScheduledJobDeduplicateOptions>PerItem</ScheduledJobDeduplicateOptions>
<ItemJobTypes>
<ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.ScheduledJob" />
<ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsText" />
<ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsParquet" />
</ItemJobTypes>
</JobScheduler>
-
CalculateAsText Job : Jenis pekerjaan ini menangani perhitungan berbasis teks, mengambil
Operand1
danOperand2
, melakukan operasi yang dipilih, dan menyimpan hasilnya di lakehouse. -
CalculateAsParquet Job : Khusus disesuaikan untuk bekerja dengan data Parquet, jenis pekerjaan ini juga mengambil
Operand1
danOperand2
, melakukan operasi yang dipilih, dan menyimpan hasilnya di lakehouse, mengikuti format data Parquet. Lihat panduan hub pemantauan untuk informasi selengkapnya tentang pekerjaan dan konfigurasi terkait.
Singkatnya, Beban Kerja dan Manifes Item berfungsi sebagai dokumen dasar untuk menambahkan beban kerja kustom ke Fabric. Proses autentikasi memicu urutan tindakan yang mudah: mengunggah, mengurai, dan mendaftar, menjamin konfigurasi yang tepat dan manajemen beban kerja yang efisien dalam ekosistem Azure.