İş Yükü Bildirimi

Genel bakış

WorkloadManifest.xml ve Item.xml dosyaları, Doku'daki iş yükü tanımı için gereklidir. Kurulum için temel İş Yükü ve İş Yükü Öğeleri yapılandırma ayarlarını barındırır ve dokuyla sorunsuz tümleştirme için temel iş yükü ayrıntılarını tanımlamaya, paylaşmaya ve kaydetmeye yardımcı olarak iş yükü kurulumu ve yönetimi için bir kılavuz görevi görürler.

Örnek depomuzda, derleme işlemi sırasında klasörde bulunan .nupkg XML dosyalarından bir src/Packages/manifest dosya oluşturulur. Bu paketlenmiş dosya, iş yükünüzle ilgili tüm gerekli bilgileri barındırıyor. workload-dev-mode.json dosyasında, ManifestPackageFilePath adlı alan, bu yeni oluşturulan .nupkg dosyasını işaret etmelidir.

Karşıya Yükleme ve Kayıt İşlemi

1. Kullanıcı Kimlik Doğrulaması: Geliştirme sırasında örneği yürütürken, kimlik doğrulamanız karşıya yükleme ve kayıt işlemini başlatır. Bu, iş yükünün kimliğiniz ile doğru ilişkilendirmesini sağlar.
2. Bildirim Ayrıştırma: Karşıya yüklenen bildirim, yapısını ve içeriğini doğrulamak için ayrıştırmaya tabi tutulur. Bu adım bildirimin doğru biçimlendirilmesini ve daha fazla işlemeye hazır olmasını sağlar.
3. İş Yükü Kaydı: Ayrıştırma başarılı olursa, iş yükü Fabric'e kaydedilir. İş yükü kimliği gibi temel yapılandırma ayrıntıları Doku veritabanında depolanır ve etkili iş yükü yönetimi sağlar.

İş Yükü Bildirimi - Önemli Bildirim Bileşenleri

Yapısı WorkloadDefinition.xsd tarafından tanımlanan bildirim, bir iş yükünün ad, uygulama ve uç noktalar gibi temel özniteliklerini özetler.

SchemaVersion Özniteliği

Fabric'in WorkloadDefinition.xsd yayımlanmış sürümünü temsil eder.

WorkloadName Özniteliği

İş yükünüzün benzersiz tanımlayıcısı. 'Kuruluş'un olması gerektiğini unutmayın. workloadName için ön ek, adı '.' ayırıcıyla ayrılmış iki kelimeden oluşur, örneğin 'Org.MyWorkload'. Diğer ön ekler geçersizdir ve karşıya yükleme hatasına neden olur. Bu, aşağıdaki senaryolarda uygulanacaktır: geliştirme bağlantısı, test yüklemesi.

Sürüm Öğesi

Bildiriminizin sürümü SemVer uyumlu olmalıdır.

CloudServiceConfiguration Öğesi

İş yükünüzün hizmet yapılandırması, şu anda yalnızca bir yapılandırma desteklenir.

Microsoft Entra Id [Azure Active Directory (AAD)] Uygulama Yapılandırması

Bölümünde, <AADApp> kimlik doğrulaması ve yetkilendirme işlemleri için Microsoft Entra Id [Azure Active Directory (AAD)] uygulaması ayarlanmaktadır. AppId, uygulamanızın benzersiz tanımlayıcısını temsil eder, RedirectUri Microsoft Entra Kimliğinin kimlik doğrulama yanıtını göndereceği URI'yi ve ResourceId uygulamanın eriştiği kaynağın benzersiz tanımlayıcısına işaret eder. Neyin ResourceId, AppId ve RedirectUri temsil ettiğine ilişkin daha fazla bağlam için kimlik doğrulama dökümantasyonuna başvurabilirsiniz.

<AADApp>
    <AppId>YourApplicationId</AppId>
    <RedirectUri>YourRedirectUri</RedirectUri>
    <ResourceId>YourResourceId</ResourceId>
</AADApp>

Kimlik doğrulama belgelerine danışarak AppId, ResourceId ve RedirectUri değerlerinin kimlik doğrulama süreçlerindeki önemini daha iyi anlayabilirsiniz.

ServiceEndpoint Öğeleri

Öğe CRUD ve iş API'leri için uygulama içeren arka plan uç noktası gibi belirli bir mantıksal uç noktanın yapılandırmasını gösterir.

• İş yükünün arka uç uç noktası yapılandırması, iş yükünüzün arka uç URL'sini belirtir.

<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>

• <IsEndpointResolutionService> ve <EndpointResolutionContext> uç noktanızın iş yükü API'sini mi yoksa yalnızca uç nokta çözümlemesini mi uyguladığına göre ayarlanır.
• Hizmetten döndürülen çözümlenmiş uç nokta aşağıdaki gereksinimleri karşılamalıdır:
  • Çözümlenen uç noktanın etki alanı, WorkloadManifest.xmliçinde bulunan kaynak kimliğinin etki alanıyla eşleşmelidir.
  • Çözümlenen uç nokta URL'sinin ana etki alanından önce en fazla altı alt etki alanı olabilir.
  • İlk kesimden sonraki tüm alt etki alanları yayımcı kiracısının doğrulanmış etki alanları listesine ait olmalıdır.

Örnek

Kaynak Kimliği URL'si:https://contoso.com/fe/be/Org.WorkloadSample (burada etki alanı contoso.com)

Kiracıda doğrulanmış alan adları:contoso.com, be.contoso.com, eastus.be.contoso.com

Geçerli çözümlenen uç noktalar:

• api.eastus.be.contoso.com
• be.contoso.com
• api.be.contoso.com

Geçersiz çözümlenen uç noktalar:

• api.eastus.fe.contoso.com (doğrulanmış bir etki alanı olmadığından geçersiz eastus.fe.contoso.com )
• contoso-dev.com (doğrulanmış bir etki alanı olmadığından ve kaynak kimliğinin ana etki alanıyla eşleşmediğinden geçersiz contoso-dev.com )

• Uç nokta çözümlemesi için iş yükü-istemci API'sini kullanma hakkında daha fazla bilgi için bkz. Uç Nokta Çözümlemesi.

Not

Ön Uç (Frontend) için uç nokta çözümlemesi desteklenmez.

Öğe Bildirimi - Anahtar Bildirim Bileşenleri

Yapısı ItemDefinition.xsd tarafından tanımlanan bildirim, bir iş yükü öğesinin ad ve iş tanımları gibi temel özniteliklerini ana hatlarıyla açıklar.

SchemaVersion Özniteliği

Fabric'in ItemDefinition.xsd yayımlanmış sürümünü temsil eder.

TypeName Özniteliği

Öğenizin benzersiz tanımlayıcısı.

İş Zamanlayıcı Yapılandırması

<JobScheduler> bölümü, iş zamanlama, izleme ve yönetiminin davranışını ve ayarlarını tanımlayan çeşitli öğeleri kapsar.

• <OnDemandJobDeduplicateOptions> ve <ScheduledJobDeduplicateOptions>: İsteğe bağlı ve zamanlanmış öğe işleri için sırasıyla yinelenenleri kaldırma seçeneklerini tanımlayın. Seçenekler arasında None (yinelenenleri kaldırma yok), PerItem (aynı öğe ve iş türü için bir iş çalıştırılır) ve PerUser (aynı kullanıcı ve öğe için bir iş çalıştırılır).
• <ItemJobTypes>: Farklı öğe iş türleri için yapılandırmalar içerir.
• <ItemJobType>: Belirli bir iş türünü açıklar.
• <Name>: İş türünün adı. Öğenin adını ön ek olarak kullanmalıdır.

Örneğin, bölümünde tanımlanan <ItemJobTypes> üç özel iş içeren örnek iş yükümüzü ele alalım:

<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 İşi : Bu iş türü, metin tabanlı hesaplamaları işler; Operand1 ve Operand2 alır, seçili işlemi gerçekleştirir ve sonucu lakehouse'a kaydeder.
• CalculateAsParquet İşi: Parquet verileriyle çalışmak için özel olarak uyarlanmış olan bu iş türü ayrıca Operand1 ve Operand2alır, seçilen işlemi gerçekleştirir ve sonucu Parquet veri biçimini izleyerek göl evinde depolar. İşler ve ilgili yapılandırma hakkında daha fazla bilgi için izleme hub'ı kılavuzuna bakın.

Özetle, İş Yükü ve Öğe Bildirimleri, Dokuya özel iş yükleri eklemek için temel belgeler görevi görür. Kimlik doğrulama işlemi, basit bir eylem dizisini tetikler: yükleme, ayrıştırma ve kayıt. Bu, Azure ekosisteminde uygun yapılandırmayı ve verimli iş yükü yönetimini garanti eder.