แชร์ผ่าน


Fabric API สําหรับคําถามที่ถามบ่อยเกี่ยวกับ GraphQL

ค้นหาคําตอบของ Fabric API ที่ถามบ่อยสําหรับคําถามของ GraphQL

GraphQL คืออะไร

GraphQL เป็นภาษาคิวรีสําหรับ API ที่ช่วยให้แอปสามารถร้องขอข้อมูลที่ต้องการได้ตามต้องการ ประโยชน์สําคัญได้แก่:

  • ระบบประเภทที่แข็งแกร่ง - อธิบายข้อมูลที่มีอยู่อย่างชัดเจน
  • การดึงข้อมูลที่แม่นยํา - ลดการดึงข้อมูลมากเกินไปโดยอนุญาตคําขอเฉพาะ
  • ความเข้ากันได้แบบย้อนหลัง - ทําให้การอัปเดต API ง่ายขึ้นโดยไม่ทําลายโค้ดที่มีอยู่
  • เครื่องมือที่หลากหลาย - เปิดใช้งานชุด developer tools ที่หลากหลาย

ซึ่งเป็นวิธีที่มีประสิทธิภาพมากขึ้นสําหรับแอปพลิเคชันในการสื่อสารกับเซิร์ฟเวอร์และฐานข้อมูล

Microsoft Fabric API สําหรับ GraphQL คืออะไร

Microsoft Fabric API สําหรับ GraphQL เป็นบริการที่มีการจัดการที่ช่วยให้คุณสามารถสร้าง GraphQL API ได้ในไม่กี่วินาที

แหล่งข้อมูลที่รองรับ:

  • คลังข้อมูล Microsoft Fabric
  • Microsoft Fabric เลคเฮาส์
  • ฐานข้อมูลมิเรอร์ Microsoft Fabric
  • ฐานข้อมูล Microsoft Fabric SQL
  • ฐานข้อมูล Azure SQL

ซึ่งมีเลเยอร์ API แบบรวมสําหรับการสอบถามและกลายข้อมูลจากแหล่งข้อมูลที่ได้รับการสนับสนุนเหล่านี้

การดําเนินการ GraphQL ใดบ้างที่ได้รับการสนับสนุนใน Fabric API สําหรับ GraphQL

เฉพาะคิวรี GraphQL (อ่าน) และกลายพันธุ์ (เขียน) เท่านั้นที่ได้รับการสนับสนุนในปัจจุบัน แหล่งข้อมูลที่เปิดเผยผ่านจุดสิ้นสุด SQL Analytics เป็นแบบอ่านอย่างเดียว ดังนั้นจึงสนับสนุนเฉพาะคิวรีเท่านั้น สําหรับคลังข้อมูล จําเป็นต้องกําหนดคีย์หลักสําหรับการสร้างการกลายพันธุ์โดยอัตโนมัติ

ฉันจะดูและแก้ไขตัวแก้ไขใน Fabric API สําหรับ GraphQL ได้อย่างไร

ตัวแก้ไขเป็นคอมโพเนนต์ GraphQL ที่มีตรรกะทางธุรกิจเพื่อแก้ไขเขตข้อมูลใน API และดําเนินการกับข้อมูลที่อยู่ในแหล่งข้อมูล

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

การปรับแต่ง: ขณะนี้ คุณไม่สามารถปรับแต่งตัวแก้ไขได้โดยตรง สําหรับตรรกะทางธุรกิจที่กําหนดเองใน API สําหรับ GraphQL คุณสามารถสร้าง กระบวนงานที่จัดเก็บไว้ใน แหล่งข้อมูลและแสดงใน GraphQL API

API สําหรับแอปพลิเคชันไคลเอ็นต์ GraphQL จําเป็นต้องมี access ไปยังแหล่งข้อมูลเพื่อดําเนินการสืบค้นหรือการกลายพันธุ์หรือไม่

Microsoft Entra ID authentication: API สําหรับ GraphQL กําหนดให้แอปพลิเคชันต้องใช้ Microsoft Entra ID สําหรับการตรวจสอบสิทธิ์ แอปพลิเคชันไคลเอ็นต์ของคุณต้องลงทะเบียนและกําหนดค่าเพื่อดําเนินการเรียก API กับ Fabric

สิทธิ์ที่จําเป็น:

  • แอปที่ลงทะเบียนใน Microsoft Entra ต้องมีสิทธิ์ GraphQLApi.Execute.All สําหรับ Power BI service สําหรับข้อมูลเพิ่มเติม โปรดดู สร้างแอป Microsoft Entra ใน Azure

การกําหนดค่าการลงชื่อเพียงครั้งเดียว (SSO):หากกําหนดค่า API ให้ใช้ SSO ผู้ใช้หรือบริการหลักที่ผ่านการตรวจสอบสิทธิ์ ต้องใช้ access สําหรับทั้ง 2 รายการต่อไปนี้

  • GraphQL API (สิทธิ์เรียกใช้การสืบค้นและการกลายพันธุ์ )
  • แหล่งข้อมูล (อ่านหรือเขียน access ตามต้องการ)

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

การกําหนดค่าข้อมูลประจําตัวที่บันทึกไว้:หาก API ได้รับการกําหนดค่าให้ใช้ข้อมูลประจําตัวที่บันทึกไว้ ผู้ใช้หรือบริการหลักที่ได้รับการรับรองความถูกต้องจะต้อง access API เท่านั้น (เลือกตัวเลือก เรียกใช้การสืบค้นและการกลายพันธุ์ เมื่อเพิ่มสิทธิ์ access โดยตรงไปยัง API)

ตัวอย่าง: คุณสามารถค้นหาตัวอย่างแบบ end-to-end พร้อมโค้ดตัวอย่างสําหรับทั้งผู้ใช้หลักและบริการหลักได้ที่ เชื่อมต่อแอปพลิเคชัน

How do I เปิดตั๋วสนับสนุนสําหรับ API สําหรับ GraphQL ได้อย่างไร

หากต้องการรับความช่วยเหลือจาก Microsoft Support ในปัญหาใดๆ ที่เกี่ยวข้องกับ Fabric API สําหรับ GraphQL โปรดไปที่เว็บไซต์สนับสนุน Fabric และเลือกตัวเลือก วิศวกรรมข้อมูล

API สําหรับ GraphQL รองรับเฉพาะ ระดับผู้เช่า Private Link ในขณะนี้

ทําไมคําขอของฉันจึงดําเนินการได้ไม่ดีในครั้งแรกที่ฉันออกคําขอ จากนั้นจึงทํางานได้ดีกับคําขอในภายหลัง

มีสาเหตุหลักสองประการสําหรับพฤติกรรม "สตาร์ทเย็น" นี้:

การอุ่นเครื่องแหล่งข้อมูล:

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

การเริ่มต้นตําแหน่งข้อมูล API:

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

คุณสามารถค้นหาข้อมูลเพิ่มเติมในแนวทางปฏิบัติที่ดีที่สุดเพื่อประสิทธิภาพการทํางาน

ฉันสามารถให้คําติชมหรือคําแนะนําสําหรับ API สําหรับ GraphQL ได้อย่างไร

เรายินดีรับคําติชมและคําแนะนําของคุณ! คุณสามารถให้คําติชมผ่าน Fabric Ideas ทีมของเราติดตามคําติชมและคําแนะนําที่ส่งผ่านแพลตฟอร์มนี้อย่างแข็งขัน คุณยังสามารถติดต่อเราผ่านทาง Microsoft Fabric Support สําหรับข้อสงสัยหรือข้อกังวลเฉพาะใดๆ

Microsoft Fabric API สําหรับ GraphQL คืออะไร