共用方式為

工作負載資訊清單

  • 發行項

概觀

Fabric 中的工作負載定義需要 WorkloadManifest.xml 和 Item.xml 檔案。 它們會保存基本工作負載和工作負載項目組態設定以進行設定，並可作為工作負載設定和管理指南，協助定義、共用和記錄基礎工作負載詳細資訊，以順利整合至 Fabric。

在我們的範例存放庫中，會在建置過程中從位於 src/Packages/manifest 資料夾的 XML 檔案中產生 .nupkg 檔案。 此封裝檔案會保存工作負載的所有必要資訊。 在 workload-dev-mode.json 檔案中，有一個稱為 ManifestPackageFilePath 的欄位應該指向這個新建立的 .nupkg 檔案。

上傳和註冊程序

  1. 使用者驗證：在開發期間，一旦執行範例，您的驗證就會啟動上傳和註冊程序。 這可確保工作負載與身分識別的正確關聯。
  2. 資訊清單剖析：上傳的資訊清單會經過剖析來驗證其結構和內容。 此步驟可確保已正確格式化資訊清單，並準備好進一步處理。
  3. 工作負載註冊：如果剖析成功，會在 Fabric 中註冊工作負載。 基本設定詳細資訊，例如工作負載 ID，會儲存在 Fabric 資料庫中，以啟用有效的工作負載管理。

工作負載資訊清單 - 主要資訊清單元件

資訊清單的結構由 WorkloadDefinition.xsd 所定義，概述了工作負載的核心屬性，例如名稱、應用程式和端點。

SchemaVersion 屬性

代表 Fabric 的 WorkloadDefinition.xsd 已發佈版本。

WorkloadName 屬性

工作負載的唯一識別碼。 請注意，必須有 'Org'。 workloadName 的前置詞，其名稱由具有 '.' 分隔符號的兩個詞語所組成，例如 'Org.MyWorkload'。 其他前置詞無效，而且會導致上傳失敗。 這會在下列案例中強制執行 - 開發連線、測試上傳。

版本元素

資訊清單版本應符合 SemVer 規範。

CloudServiceConfiguration 元素

工作負載的服務組態，目前僅支援一個組態。

Microsoft Entra ID [Azure Active Directory (AAD)] 應用程式組態

<AADApp> 區段會設定 Microsoft Entra ID [Azure Active Directory (AAD)] 應用程式進行驗證和授權程序。 AppId 表示應用程式的識別碼，RedirectUri 指定 Microsoft Entra ID 將向其傳送驗證回應的 URI，ResourceId 指向應用程式所存取之資源的唯一識別碼。 如需有關 ResourceId、AppId 和 RedirectUri 所代表內容的詳細資訊，可以參閱驗證文件。

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

請參閱驗證文件，以深入了解 AppId、ResourceId 和 RedirectUri 及其在驗證過程環境中的重要性。

ServiceEndpoint 元素

代表特定邏輯端點的組態，例如後端端點，其中包含項目 CRUD 和工作 API 的實作。

  • 工作負載後端端點的組態會指出工作負載的後端 URL。
<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>
  • 根據您的端點是實作工作負載 API，還是僅實作端點解析來設定 <IsEndpointResolutionService> 和 EndpointResolutionContext。 請參閱端點解析，了解有關解析內容和回應的詳細資訊。

注意

不支援前端的端點解析。

項目資訊清單 - 主要資訊清單元件

資訊清單的結構由 ItemDefinition.xsd 所定義，會概述工作負載項目的核心屬性，例如名稱和工作定義。

SchemaVersion 屬性

代表 Fabric 的 ItemDefinition.xsd 已發佈版本。

TypeName 屬性

項目的唯一識別碼。

Job Scheduler 組態

<JobScheduler> 區段包含各種元素，它們可定義工作排程、追蹤和管理的行為和設定。

  • <OnDemandJobDeduplicateOptions> 和 <ScheduledJobDeduplicateOptions>：分別定義隨選和排程項目工作的重複資料刪除選項。 選項包括 None (無重複資料刪除)、PerItem (相同項目和工作類型的一個工作執行)，以及 PerUser (相同使用者和項目的一個工作執行)。
  • <ItemJobTypes>：包含不同項目工作類型的組態。
  • <ItemJobType>：描述特定工作類型。
  • <Name>：工作類型的名稱。 必須使用項目的名稱做為前置詞。

例如，讓我們考慮我們的範例工作負載，其中包含 <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 工作：此工作類型會處理以文字為基礎的計算，擷取 Operand1 和 Operand2，執行選取的操作，並將結果儲存在 Lakehouse 中。
  • CalculateAsParquet 工作：專為使用 Parquet 資料而量身打造，此工作類型也會擷取 Operand1 和 Operand2，執行選取的操作，將結果儲存在 Lakehouse 中，並遵循 Parquet 資料格式。 如需工作和相關組態的詳細資訊，請參閱監視中樞指南。

總而言之，工作負載和項目資訊清單可作為將自訂工作負載新增至 Fabric 的基礎文件。 驗證過程會觸發一連串直接的動作：上傳、剖析和註冊，保證 Azure 生態系統內的正確設定和高效工作負載管理。