หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทความนี้อธิบายถึงสถาปัตยกรรมของ Microsoft Fabric Extensibility Toolkit และวิธีที่ปริมาณงานแบบกําหนดเองรวมเข้ากับแพลตฟอร์ม Fabric อธิบายส่วนประกอบรันไทม์ โฟลว์ระหว่างส่วนหน้า Fabric ปริมาณงานของคุณ และบริการ Fabric และวิธีที่รายการและแบบจําลองรายการทําให้ปริมาณงานรู้สึกเหมือนดั้งเดิมใน Fabric
ส่วนประกอบทางสถาปัตยกรรม
ส่วนหน้าผ้า (โฮสต์)
ส่วนหน้าของ Fabric คือสภาพแวดล้อมโฮสต์ มันแสดงปริมาณงานของคุณเป็น iFrame และเปิดเผย API โฮสต์ที่ปลอดภัยไปยัง iFrame เพื่อให้ปริมาณงานสามารถโต้ตอบกับ Fabric ได้ในขณะที่ยังคงแยกอยู่ โฮสต์มีหน้าที่รับผิดชอบในการบูตโหลดงานตามรายการ (จุดเข้าใช้งาน เส้นทาง และความสามารถ) จัดการโทเค็นการรับรองความถูกต้องผ่าน Microsoft Entra ID และสื่อกลางการเรียกจากปริมาณงานไปยัง API สาธารณะของ Fabric และบริการแพลตฟอร์ม
เว็บแอปพลิเคชันปริมาณงาน
ปริมาณงานของคุณคือเว็บแอปพลิเคชัน (เช่น React หรือ Angular) ที่คุณโฮสต์ในระบบคลาวด์ของคุณ Fabric โหลดใน iFrame และจัดเตรียม API โฮสต์เพื่อรวมเข้ากับแพลตฟอร์ม แอปใช้เส้นทางและพื้นผิว UI ที่ประกาศไว้ในรายการ ใช้โทเค็น Microsoft Entra ID (จัดทําโดยโฮสต์) เพื่อเรียก API สาธารณะของ Fabric และหากจําเป็น บริการส่วนหลังของคุณเอง และปฏิบัติตามคําแนะนํา Fabric UX เพื่อให้มีลักษณะและทํางานเหมือนประสบการณ์ดั้งเดิม
บริการแฟบริคและ API สาธารณะ
บริการ Fabric แสดง API สาธารณะสําหรับการอ่านและเขียนข้อมูลเมตาและเนื้อหา ปริมาณงานเรียก API เหล่านี้โดยใช้โทเค็นที่มีขอบเขตที่ออกผ่าน Microsoft Entra ID ตัวอย่างเช่น เพื่อดําเนินการ CRUD ของรายการและการดําเนินการตามวงจรชีวิต เข้าถึงข้อมูลและเนื้อหาที่จัดเก็บไว้ใน OneLake และมีส่วนร่วมในคุณลักษณะพื้นที่ทํางาน เช่น การค้นหาและการค้นพบ สําหรับปลายทาง ขอบเขต และคําแนะนําข้อมูลประจําตัว โปรดดู Fabric Public REST API
Microsoft Entra (การรับรองความถูกต้อง)
การรับรองความถูกต้องและการอนุญาตได้รับการจัดการโดย Microsoft Entra ID รายการของปริมาณงานจะประกาศสิทธิ์ที่ต้องการ โฮสต์ Fabric จะได้รับโทเค็นที่เหมาะสมและบังคับใช้ความยินยอมและการเข้าถึงตามการประกาศเหล่านั้น
โมเดลปริมาณงานและรายการ
ปริมาณงานถูกกําหนดโดยรายการที่อธิบายข้อมูลประจําตัว ความสามารถ เส้นทาง จุดเข้าใช้งาน UI และสิทธิ์ที่จําเป็น รายการคือสัญญาระหว่างเว็บแอปของคุณและ Fabric สําหรับสคีมา ตัวอย่าง และคําแนะนําการตรวจสอบความถูกต้อง โปรดดู ภาพรวมรายการ
รายการและการมีส่วนร่วมของเจ้าของภาษา
โดยทั่วไปปริมาณงานจะสนับสนุนชนิดสินค้าอย่างน้อยหนึ่งชนิด รายการที่สร้างโดยปริมาณงานของคุณจะปรากฏในพื้นที่ทํางานและทํางานเหมือนรายการ Fabric ดั้งเดิม พวกเขามีส่วนร่วมในการทํางานร่วมกันและการแบ่งปัน สามารถค้นพบได้ในการค้นหา ติดตามการดําเนินงานและการกํากับดูแลวงจรชีวิต และจัดเก็บข้อมูลผ่าน OneLake ในขณะที่ใช้ Fabric public API สําหรับ CRUD
โฟลว์แบบ end-to-end
- ผู้ใช้เปิดพื้นที่ทํางานและนําทางไปยังรายการหรือจุดเข้าใช้งานที่ปริมาณงานของคุณให้มา
- ส่วนหน้า Fabric จะโหลดเว็บแอปพลิเคชันของคุณใน iFrame ตามรายการ
- โฮสต์ได้รับโทเค็น Microsoft Entra ที่มีขอบเขตที่ปริมาณงานของคุณต้องการ และแสดง API โฮสต์ไปยัง iFrame
- ปริมาณงานจะเรียก API สาธารณะของ Fabric (และบริการของคุณเอง (หากมี) โดยใช้โทเค็นเหล่านี้
- ข้อมูลรายการจะถูกเก็บไว้ใน OneLake และข้อมูลเมตาของรายการได้รับการจัดการผ่าน Fabric API เพื่อให้ทํางานเหมือนกับรายการ Fabric อื่นๆ
ขั้นตอนถัดไป
หากต้องการพัฒนาภายในเครื่องและเผยแพร่ปริมาณงานของคุณ โปรดดู เผยแพร่ปริมาณงานของคุณ สําหรับสคีมารายการและคําแนะนําในการพัฒนาภายในเครื่อง โปรดดู ภาพรวมรายการDevServer และ DevGateway สําหรับตําแหน่งข้อมูล API ขอบเขต และคําแนะนําข้อมูลประจําตัว โปรดดู Fabric Public REST API