FABRIC API สําหรับมุมมอง Schema ของ GraphQL และตัวสํารวจ Schema

Schema GraphQL ซึ่งยึดตาม GraphQL Schema Definition Language (SDL) จะกําหนดรูปแบบของข้อมูลที่แสดงใน API เป็นเลเยอร์นามธรรมที่ให้ความยืดหยุ่นแก่ผู้บริโภคในขณะที่ซ่อนรายละเอียดการใช้งาน Backend Schema จะขึ้นอยู่กับคอลเลกชันของชนิดออบเจ็กต์ที่ประกอบด้วยเขตข้อมูล

มุมมอง Schema

คุณสามารถเข้าถึงมุมมอง Schema ได้โดยการเลือก Schema ที่มุมล่างซ้ายของหน้าจอการพัฒนาข้อมูล มุมมองแสดง GraphQL SDL เวอร์ชันข้อความพร้อมชนิด เขตข้อมูล และการดําเนินการที่สร้างขึ้น

รูปต่อไปนี้เป็นตัวอย่างของมุมมอง Schema รวมถึงรายการวัตถุมากมายที่พร้อมใช้งานใน Schema นี้

ตัวสํารวจเค้าร่าง

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

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

นอกเหนือจากชนิดแล้ว Fabric API สําหรับ GraphQL จะสร้างคิวรีและการกลายพันธุ์สําหรับวัตถุใหม่ใด ๆ ที่คุณเลือกที่จะแสดงโดยอัตโนมัติ

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

หากต้องการดูการกลายพันธุ์ที่สร้างขึ้นโดยอัตโนมัติโดย API ให้ขยายโหนดการกลายพันธุ์ในทรีของ Schema explorer

ปรับเปลี่ยนวัตถุโดยใช้ตัวสํารวจ Schema

คุณสามารถใช้ตัวสํารวจ Schema เพื่อปรับเปลี่ยนวัตถุหลังจากที่ API สร้างให้คุณ ในตัวอย่างต่อไปนี้ เราเลือกจุดไข่ปลาถัดจากชนิด SalesOrderDetail ที่มาจากฐานข้อมูล AdventureWorks ของเรา:

ตัวเลือกต่อไปนี้พร้อมใช้งานสําหรับชนิด:

• อัปเดต Schema - ช่วยให้คุณสามารถอัปเดต Schema ด้วยวัตถุใหม่จากแหล่งข้อมูลได้
• เปลี่ยนชื่อ - เปลี่ยนชื่อของวัตถุ โปรดทราบ: การเปลี่ยนแปลง นี้มีผลต่อ Schema ของ API เท่านั้น และจะไม่มีผลต่อวัตถุแหล่งข้อมูลต้นฉบับที่ได้รับมา
• เอาออกจาก schema - ลบวัตถุจาก Schema GraphQL อย่างมีประสิทธิภาพเพื่อให้คุณไม่สามารถอ้างอิงได้อีกต่อไป
• จัดการความสัมพันธ์ - นําคุณไปยังประสบการณ์การจัดการความสัมพันธ์ สําหรับข้อมูลเพิ่มเติม ดูจัดการความสัมพันธ์ใน Fabric API สําหรับ GraphQL
• คุณสมบัติ - แสดงข้อมูลเพิ่มเติมเกี่ยวกับวัตถุ

เปิดใช้งานและปิดใช้งานคิวรีและการกลายพันธุ์

คุณลักษณะเปิด/ปิดใช้งานสําหรับคิวรีและกลายพันธุ์ทําให้ผู้ดูแลระบบและนักพัฒนาสามารถควบคุมการเข้าถึงและการใช้งาน API ในระดับแยกย่อยได้ ซึ่งช่วยให้คุณสามารถเลือกเปิดใช้งานหรือปิดใช้งานคิวรีและการกลายพันธุ์ที่เฉพาะเจาะจงภายใน Schema GraphQL ได้ ซึ่งช่วยให้คุณจัดการความสามารถของ API แบบไดนามิกโดยไม่ต้องปรับเปลี่ยนโค้ดหรือปรับใช้การเปลี่ยนแปลง

คิวรีและการกลายพันธุ์ในตัวสํารวจเค้าร่างมีสองตัวเลือกเพิ่มเติม:

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

• เปิดใช้งาน - เปิดใช้งานคิวรีหรือการกลายพันธุ์ที่ปิดใช้งานก่อนหน้านี้อีกครั้ง การดําเนินการของรายการจะพร้อมใช้งานทันทีเมื่อดําเนินการโหลด Schema ที่เกิดขึ้นหลังจากเลือกตัวเลือกเปิดใช้งาน

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

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

• Fabric API สําหรับตัวแก้ไข GraphQL