รายการปริมาณงาน

ภาพรวม

ไฟล์ WorkloadManifest.xml และ Item.xml จําเป็นสําหรับข้อกําหนดปริมาณงานใน Fabric พวกเขาถือการตั้งค่าการกําหนดค่าปริมาณงานและรายการปริมาณงานพื้นฐานสําหรับการตั้งค่าและทําหน้าที่เป็นคําแนะนําสําหรับการตั้งค่าปริมาณงานและการจัดการช่วยกําหนดแชร์และบันทึกรายละเอียดปริมาณงานที่จําเป็นสําหรับการรวมที่ราบรื่นลงใน Fabric

ในที่เก็บตัวอย่าง .nupkg ของเรา ไฟล์ถูกสร้างขึ้นจากไฟล์ XML ที่อยู่ใน src/Packages/manifest โฟลเดอร์ในระหว่างกระบวนการสร้าง ไฟล์ที่รวมแพคเกจนี้เก็บข้อมูลที่จําเป็นทั้งหมดเกี่ยวกับปริมาณงานของคุณ ใน workload-dev-mode.json ไฟล์ มีเขตข้อมูลที่เรียกว่า ManifestPackageFilePath ซึ่งควรชี้ไปยังไฟล์ที่สร้างขึ้น .nupkg ใหม่นี้

อัปโหลดและลงทะเบียนกระบวนการ

1. การรับรองความถูกต้องผู้ใช้: ในระหว่างการพัฒนาเมื่อดําเนินการตัวอย่างการรับรองความถูกต้องของคุณจะเริ่มต้นกระบวนการอัปโหลดและลงทะเบียน ซึ่งทําให้แน่ใจได้ว่าการเชื่อมโยงที่ถูกต้องของปริมาณงานด้วยข้อมูลประจําตัวของคุณ
2. การแยกวิเคราะห์ที่ปรากฏ: รายการที่ถูกอัปโหลดจะผ่านการแยกวิเคราะห์เพื่อตรวจสอบโครงสร้างและเนื้อหาของรายการ ขั้นตอนนี้ทําให้แน่ใจว่ามีการจัดรูปแบบรายการอย่างถูกต้องและพร้อมสําหรับการประมวลผลเพิ่มเติม
3. การลงทะเบียนปริมาณงาน: หากการแยกวิเคราะห์ประสบความสําเร็จปริมาณงานจะถูกลงทะเบียนใน Fabric รายละเอียดการกําหนดค่าที่จําเป็น เช่น ID ปริมาณงานจะถูกเก็บไว้ในฐานข้อมูล Fabric ซึ่งช่วยให้สามารถจัดการปริมาณงานที่มีประสิทธิภาพได้

รายชื่อแฟ้มปริมาณงาน - คอมโพเนนต์รายชื่อแฟ้มหลัก

รายชื่อแฟ้มซึ่งมีการกําหนดโครงสร้างโดย WorkloadDefinition.xsd แสดงแอตทริบิวต์หลักของปริมาณงาน เช่น ชื่อ แอปพลิเคชัน และจุดสิ้นสุด

แอตทริบิวต์ SchemaVersion

แสดงเวอร์ชันที่เผยแพร่ของ Fabric WorkloadDefinition.xsd

แอตทริบิวต์ WorkloadName

ตัวระบุที่ไม่ซ้ํากันของปริมาณงานของคุณ โปรดทราบว่าจําเป็นต้องมี 'องค์กร' คํานําหน้าสําหรับ workloadName ชื่อดังกล่าวประกอบด้วยสองคําที่มีตัวคั่น '.' เช่น 'Org.MyWorkload' คํานําหน้าอื่นไม่ถูกต้องและจะทําให้การอัปโหลดล้มเหลว ซึ่งจะถูกบังคับใช้ในสถานการณ์ต่อไปนี้ - การเชื่อมต่อ dev, ทดสอบการอัปโหลด

องค์ประกอบเวอร์ชัน

เวอร์ชันของไฟล์แสดงรายการควรเป็นไปตามข้อกําหนดของ SemVer

องค์ประกอบ CloudServiceConfiguration

การกําหนดค่าบริการของปริมาณงานของคุณ สนับสนุนเพียงการกําหนดค่าเดียวเท่านั้น

Microsoft Entra ID [Azure Active Directory (AAD)] การกําหนดค่าแอปพลิเคชัน

ส่วน <AADApp> นี้ตั้งค่าแอปพลิเคชัน Microsoft Entra ID [Azure Active Directory (AAD)] สําหรับกระบวนการรับรองความถูกต้องและการตรวจสอบ AppIdแสดงตัวระบุที่ไม่ซ้ํากันสําหรับแอปพลิเคชันRedirectUriของคุณ ระบุ URI ที่ Microsoft Entra ID จะส่งการตอบสนองการรับรองความถูกต้อง และResourceIdจุดไปยังตัวระบุที่ไม่ซ้ํากันสําหรับทรัพยากรที่แอปพลิเคชันกําลังเข้าถึง สําหรับบริบทเพิ่มเติมเกี่ยวกับ , ResourceIdAppIdและ RedirectUri แสดง คุณสามารถอ้างอิงถึงเอกสารประกอบการรับรองความถูกต้องได้

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

ดูเอกสารรับรองตัวตนสําหรับความเข้าใจอย่างลึกซึ้งเกี่ยวกับ AppIdResourceId, และRedirectUriนัยสําคัญของเอกสารดังกล่าวในบริบทของกระบวนการรับรองตัวตน

องค์ประกอบ ServiceEndpoint

แสดงการกําหนดค่าของจุดสิ้นสุดเชิงตรรกะเฉพาะ ตัวอย่างเช่น จุดสิ้นสุด Backend ซึ่งรวมถึงการใช้งานสําหรับ CRUD รายการและ API ของงาน

• การกําหนดค่าสําหรับจุดสิ้นสุด backend ของปริมาณงานจะระบุ URL backend ของปริมาณงานของคุณ

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

• <IsEndpointResolutionService> และ <EndpointResolutionContext> ได้รับการตั้งค่าตามตําแหน่งข้อมูลของคุณว่า จะใช้ API ของปริมาณงานหรือเฉพาะความละเอียดปลายทางเท่านั้น
• ปลายทางที่แก้ไขแล้วที่ส่งคืนจากบริการต้องเป็นไปตามข้อกําหนดต่อไปนี้:
  • โดเมนของปลายทางที่แก้ไขแล้วต้องตรงกับโดเมนของ รหัสทรัพยากร ที่พบใน WorkloadManifest.xml
  • URL จุดสิ้นสุดที่แก้ไขแล้วอาจมีโดเมนย่อยเพิ่มเติมสูงสุดหกโดเมนก่อนโดเมนหลัก
  • โดเมนย่อยใด ๆ หลังจากเซกเมนต์แรกต้องอยู่ในรายการ โดเมนที่ผ่านการตรวจสอบ ของผู้เช่าผู้เช่าผู้เผยแพร่

ตัวอย่าง

URL รหัสทรัพยากร:https://contoso.com/fe/be/Org.WorkloadSample (ซึ่งมีโดเมนเป็น contoso.com)

โดเมนที่ได้รับการยืนยันในผู้เช่า:contoso.com, be.contoso.comeastus.be.contoso.com

ปลายทางที่แก้ไขที่ถูกต้อง:

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

จุดสิ้นสุดที่แก้ไขไม่ถูกต้อง:

• api.eastus.fe.contoso.com (ไม่ถูกต้องเนื่องจาก eastus.fe.contoso.com ไม่ใช่โดเมนที่ได้รับการยืนยัน)
• contoso-dev.com (ไม่ถูกต้องเนื่องจาก contoso-dev.com ไม่ใช่โดเมนที่ได้รับการยืนยันแล้วและไม่ตรงกับโดเมนหลักของ ID ทรัพยากร)

• สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ปริมาณงานไคลเอ็นต์ API สําหรับความละเอียดจุดสิ้นสุด ดูความละเอียดจุดสิ้นสุด

รายการรายชื่อแฟ้ม - คอมโพเนนต์รายชื่อแฟ้มหลัก

รายชื่อแฟ้มซึ่งมีการกําหนดโครงสร้างโดย ItemDefinition.xsd จะอธิบายแอตทริบิวต์หลักของรายการของปริมาณงาน เช่น ชื่อและข้อกําหนดของงาน

แอตทริบิวต์ SchemaVersion

แสดง ItemDefinition.xsd ของ Fabric เวอร์ชันที่เผยแพร่

แอตทริบิวต์ TypeName

ตัวระบุที่ไม่ซ้ํากันของหน่วยข้อมูลของคุณ

การกําหนดค่าตัวจัดกําหนดการงาน

ส่วน <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 Job : ประเภทงานนี้จะจัดการการคํานวณโดยใช้ข้อความ การใช้ Operand1 และ Operand2การดําเนินการที่เลือก และการบันทึกผลลัพธ์ใน lakehouse
• งาน CalculateAsParquet : ปรับแต่งโดยเฉพาะสําหรับการทํางานกับข้อมูล Parquet ประเภทงานนี้ยังใช้ Operand1 และ Operand2ดําเนินการที่เลือกและจัดเก็บผลลัพธ์ในเลคเฮ้าส์ตามรูปแบบข้อมูล Parquet ดู คู่มือ การตรวจสอบฮับสําหรับข้อมูลเพิ่มเติมเกี่ยวกับงานและการกําหนดค่าที่เกี่ยวข้อง

โดยสรุป รายการปริมาณงานและรายการทําหน้าที่เป็นเอกสารพื้นฐานสําหรับการเพิ่มปริมาณงานแบบกําหนดเองไปยัง Fabric กระบวนการรับรองตัวตนจะทริกเกอร์ลําดับการดําเนินการที่ตรงไปตรงมา: การอัปโหลด การแยกวิเคราะห์ และการลงทะเบียน รับประกันการกําหนดค่าที่เหมาะสมและการจัดการปริมาณงานที่มีประสิทธิภาพภายในระบบนิเวศของ Azure