แชร์ผ่าน


ข้อจํากัดของ Microsoft Fabric API สําหรับ GraphQL

บทความนี้แสดงรายละเอียดข้อจํากัดปัจจุบันใน Microsoft Fabric API สําหรับ GraphQL

ขีด จำกัด

ข้อจํากัดผลิตภัณฑ์ทั่วไปปัจจุบันสําหรับ API สําหรับ GraphQL ใน Microsoft Fabric จะแสดงอยู่ในบทความนี้ เรากําลังปรับปรุง API สําหรับ GraphQL อย่างต่อเนื่องด้วยคุณลักษณะใหม่ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับอนาคตของ Microsoft Fabric โปรดดูที่ Fabric Roadmap

  • แหล่งข้อมูลใด ๆ ที่ใช้จุดสิ้นสุด SQL Analytics สําหรับการเข้าถึงสนับสนุนเฉพาะการดําเนินการอ่านเท่านั้น ตัวอย่างเช่น การกลายพันธุ์ไม่พร้อมใช้งานสําหรับเลคเฮ้าส์หรือฐานข้อมูลที่มิเรอร์
  • ขนาดหน้าเริ่มต้นปัจจุบันคือ 100 ซึ่งหมายความว่าทุกคําขอจะส่งกลับองค์ประกอบสูงสุด 100 รายการในการตอบกลับ ถ้าชุดผลลัพธ์ของคุณมีขนาดใหญ่กว่า 100 ให้ทําซ้ําผ่านผลลัพธ์โดยใช้ การแบ่งหน้า GraphQL
  • ขนาดการแบ่งหน้าสูงสุดคือ 100,000 ซึ่งหมายความว่ามีจํานวนองค์ประกอบสูงสุดที่คําขอจะส่งกลับและคุณสามารถทําซ้ําได้ หากคุณต้องการส่งคืนองค์ประกอบมากกว่า 100K สําหรับแอปพลิเคชันของคุณ ให้ออกคําขอหลายรายการ ทําความเข้าใจว่ารูปแบบนี้ไม่ธรรมดาใน GraphQL
  • ขนาดการตอบกลับสูงสุดที่เราสนับสนุนคือ 64MB ซึ่งหมายความว่าคําขอ API ใด ๆ ที่มีขนาดการตอบกลับมากกว่า 64MB จะส่งกลับข้อผิดพลาด ในการแก้ปัญหาข้อจํากัดนี้ คุณสามารถออกคําขอที่กรองแล้วหลายรายการ
  • ข้อจํากัดสําหรับ Stored Procedure (ใช้กับ Azure SQL, SQL Database ใน Fabric และ Data Warehouses):
    • API จะใช้เฉพาะชุดผลลัพธ์ชุดแรกที่ส่งกลับโดย Stored Procedure สําหรับ GraphQL
    • เฉพาะขั้นตอนที่เก็บไว้ซึ่งมีเมตาดาต้าสําหรับชุดผลลัพธ์แรกที่อธิบายโดย sys.dm_exec_describe_first_result_set เท่านั้นที่ได้รับการสนับสนุน
    • เมื่อมีการระบุพารามิเตอร์ Stored Procedure ทั้งในไฟล์การกําหนดค่าและในสตริงแบบสอบถาม URL พารามิเตอร์ในสตริงแบบสอบถาม URL จะมีความสําคัญกว่า
    • เอนทิตีที่ได้รับการสนับสนุนโดยกระบวนงานที่เก็บไว้ไม่มีความสามารถทั้งหมดที่มีให้โดยอัตโนมัติสําหรับเอนทิตีที่ได้รับการสนับสนุนจากตารางหรือมุมมอง
    • เอนทิตีที่เก็บไว้สํารองไม่สนับสนุนการแบ่งหน้า การเรียงลําดับ หรือการกรอง หรือเอนทิตีดังกล่าวจะสนับสนุนการแสดงรายการที่ระบุโดยค่าคีย์หลัก
  • การหมดเวลาของคําขอในขณะนี้คือ 100 วินาที ซึ่งหมายความว่าถ้าคุณส่งคําขอที่สร้างคิวรีแหล่งข้อมูลที่ใช้เวลานานกว่า 100 วินาทีในการดําเนินการให้เสร็จสมบูรณ์ คําขอของคุณอาจล้มเหลวและเกิดข้อผิดพลาด

ปัญหาที่ทราบแล้ว

สําหรับปัญหาที่ทราบแล้วใน API สําหรับ GraphQL โปรดเยี่ยมชม ปัญหาที่ทราบของ Microsoft Fabric