ตัวตรวจสอบความถูกต้องของ Microsoft Fabric Extensibility Toolkit

Microsoft Fabric Extensibility Toolkit Validator เป็นเครื่องมือตรวจสอบความถูกต้องที่ครอบคลุมสําหรับปริมาณงาน Microsoft Fabric ช่วยให้ผู้เผยแพร่ตรวจสอบปริมาณงานของตนตามข้อกําหนดของ Microsoft Fabric ก่อนที่จะส่งเพื่อรับการรับรองอย่างเป็นทางการ

เครื่องมือนี้เป็น เครื่องมือตรวจสอบความถูกต้องสาธารณะ สําหรับคู่ค้าภายนอกและลูกค้าที่พัฒนาปริมาณงาน Fabric

Overview

เครื่องมือตรวจสอบความถูกต้องช่วยให้ผู้สร้างปริมาณงานสามารถตรวจสอบปริมาณงาน Microsoft Fabric ของตนได้ด้วยตนเอง ได้รับการออกแบบมาเพื่อช่วยระบุปัญหาที่อาจเกิดขึ้นตั้งแต่เนิ่นๆ ในกระบวนการพัฒนา ทําให้กระบวนการตรวจสอบอย่างเป็นทางการมีแนวโน้มที่จะประสบความสําเร็จมากขึ้น

สําคัญ

การตรวจสอบตนเองที่ประสบความสําเร็จไม่ได้รับประกันว่าจะผ่านการตรวจสอบอย่างเป็นทางการ แต่จะเพิ่มโอกาสในการประสบความสําเร็จอย่างมากโดยการตรวจจับปัญหาทั่วไปตั้งแต่เนิ่นๆ

ข้อกําหนดเบื้องต้น

• Node.js (เวอร์ชัน 14 หรือสูงกว่า)
• บัญชี Microsoft Fabric ที่สามารถเข้าถึง Fabric Workload Hub
• เบราว์เซอร์ Chrome/Chromium (สําหรับการดาวน์โหลดรายการอัตโนมัติ)
• แพคเกจปริมาณงาน ที่สร้างขึ้นโดยใช้ Microsoft Fabric Extensibility Toolkit
• ปริมาณงานที่เผยแพร่ - ปริมาณงานของคุณต้องเผยแพร่ไปยังผู้เช่าก่อนจึงจะสามารถเริ่มการตรวจสอบความถูกต้องได้

เคล็ดลับ

ใช้ผู้เช่าอื่นสําหรับการตรวจสอบความถูกต้องจากผู้เช่าที่ใช้สําหรับการเผยแพร่ สิ่งนี้ช่วยให้คุณได้สัมผัสกับสิ่งที่ผู้ใช้ปลายทางจะเห็นและให้สภาพแวดล้อมการตรวจสอบความถูกต้องที่สมจริงยิ่งขึ้น

เริ่มต้นใช้งาน

1. สร้างภาระงานของคุณ

ขั้นแรก ให้สร้างภาระงานของคุณโดยใช้ชุดเริ่มต้นอย่างเป็นทางการ:

1. โคลน Fabric Extensibility Toolkit (ชุดเริ่มต้น)
2. ทําตามเอกสารประกอบของชุดเครื่องมือเพื่อสร้างปริมาณงานของคุณ

2. ติดตั้งการพึ่งพา

ไปที่ไดเร็กทอรีตัวตรวจสอบความถูกต้องและติดตั้งการขึ้นต่อกัน:

cd fabric-extensibility-toolkit-validator/validator
npm install

3. การตรวจสอบขั้นพื้นฐาน

เรียกใช้การตรวจสอบความถูกต้องที่สมบูรณ์สําหรับปริมาณงานของคุณ:

คําสั่งการตรวจสอบความถูกต้องพื้นฐาน

node index.js --workload-name "YourPublisher.YourWorkload" --workload-stage "Preview"

ตัวอย่างที่มีปริมาณงานจริง

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "Preview"

สําหรับเวิร์กโหลดขั้นตอน GA

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "GA"

Note

ตรวจสอบให้แน่ใจว่าคุณได้เข้าสู่ระบบ Microsoft Fabric ในเบราว์เซอร์ของคุณก่อนที่จะเรียกใช้การตรวจสอบความถูกต้อง และตรวจสอบให้แน่ใจว่าปริมาณงานของคุณได้รับการเผยแพร่และเข้าถึงได้ในผู้เช่าเป้าหมาย

ตัวเลือกบรรทัดคําสั่ง

ตัวเลือก	คำอธิบาย	ตัวอย่าง
--workload-name	ชื่อปริมาณงานแบบเต็ม (Publisher.Product)	"Contoso.DataProcessor"
--workload-stage	ขั้นตอนการตรวจสอบความถูกต้อง	"Preview" หรือ "GA"
--help	แสดงข้อมูลวิธีใช้	(ธงเท่านั้น)

กระบวนการตรวจสอบความถูกต้อง

ตัวตรวจสอบความถูกต้องต้องดําเนินการผ่านหลายขั้นตอน:

1. Manifest Download - ดาวน์โหลดรายการปริมาณงานของคุณโดยอัตโนมัติจาก Fabric Workload Hub
2. Test Discovery - ระบุกรณีทดสอบที่เกี่ยวข้องตามชนิดปริมาณงานของคุณ
3. การดําเนินการทดสอบ - เรียกใช้การทดสอบการตรวจสอบความถูกต้องโดยใช้ตัวตรวจสอบความถูกต้องที่กําหนดค่าไว้ (ทั้งแบบอัตโนมัติและแบบแมนนวล)
4. การสร้างรายงาน - สร้างรายงานที่ครอบคลุมในหลายรูปแบบ

โครงสร้างเอาต์พุต

หลังจากการตรวจสอบความถูกต้อง คุณจะพบผลลัพธ์ใน Results ไดเรกทอรี:

Results/
├── YourPublisher.YourWorkload/
│   └── Preview/
│       └── [ValidationID]/
│           ├── YourPublisher.YourWorkload_Metadata.json
│           ├── YourPublisher.YourWorkload_Manifest.json
│           ├── YourPublisher.YourWorkload_Workload_Tests.json
│           ├── YourPublisher.YourWorkload.Item_Item_Tests.json
│           └── Reports/
│               ├── ValidationReport.md
│               ├── ValidationReport.html
│               └── ValidationReport.pdf

ผู้ตรวจสอบความถูกต้อง

เครื่องมือนี้ใช้ชุดตัวตรวจสอบความถูกต้องเฉพาะทางเพื่อตรวจสอบปริมาณงานของคุณในแง่มุมต่างๆ ผู้ตรวจสอบความถูกต้องบางตัวเป็นแบบอัตโนมัติ ในขณะที่บางตัวต้องการการโต้ตอบด้วยตนเอง

การแก้ไขปัญหา

ปัญหาเกี่ยวกับเบราว์เซอร์

• ตรวจสอบว่าได้ติดตั้งและเข้าถึง Chrome/Chromium แล้ว
• ตรวจสอบให้แน่ใจว่าคุณได้ลงชื่อเข้าใช้ Microsoft Fabric ในเบราว์เซอร์ของคุณ
• ตรวจสอบการเชื่อมต่อเครือข่ายกับบริการ Fabric

ปัญหาการดาวน์โหลดรายการ

• ตรวจสอบว่าชื่อปริมาณงานตรงกันทุกประการ (คํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่)
• ตรวจสอบให้แน่ใจว่ามีการปรับใช้ปริมาณงานและเข้าถึงได้ใน Fabric Workload Hub
• ตรวจสอบการรับรองความถูกต้องและสิทธิ์

ปัญหาการดําเนินการทดสอบ

• ตรวจทานบันทึกการตรวจสอบความถูกต้องในไดเรกทอรีผลลัพธ์
• ตรวจสอบเอกสารกรณีทดสอบแต่ละกรณีในvalidator/validators/
• ตรวจสอบว่าเนื้อหาปริมาณงานที่จําเป็นทั้งหมดสามารถเข้าถึงได้

เนื้อหาที่เกี่ยวข้อง

• Microsoft Fabric Extensibility Toolkit - ชุดเริ่มต้นอย่างเป็นทางการสําหรับการสร้างปริมาณงาน Fabric