API ตาราง OneLake สําหรับเดลต้า

OneLake มีจุดสิ้นสุด REST API สําหรับการโต้ตอบกับตารางใน Microsoft Fabric บทความนี้อธิบายวิธีการเริ่มต้นใช้งานปลายทางนี้เพื่อโต้ตอบกับ Delta API ที่พร้อมใช้งานที่ปลายทางนี้สําหรับการดําเนินการอ่านข้อมูลเมตา การดําเนินการเหล่านี้เข้ากันได้กับ มาตรฐานแบบเปิดของ Unity Catalog API

สําหรับคําแนะนํา API ตาราง OneLake โดยรวมและคําแนะนําเบื้องต้น โปรดดู ภาพรวม API ตาราง OneLake

สําหรับเอกสารประกอบ API โดยละเอียด โปรดดูคู่มือการเริ่มต้นใช้งาน

ปลายทาง API ตารางเดลต้า

จุดสิ้นสุด API ตาราง OneLake คือ:

https://onelake.table.fabric.microsoft.com

ที่ตําแหน่งข้อมูล API ตาราง OneLake API เดลต้าจะพร้อมใช้งานภายใต้<BaseUrl>

https://onelake.table.fabric.microsoft.com/delta

การดําเนินการ API ตารางเดลต้า

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

• รายการสคีมา

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas?catalog_name=<ItemName or ItemID>

  การดําเนินการนี้ยอมรับรหัสพื้นที่ทํางานและรหัสรายการข้อมูล (หรือชื่อที่จําง่ายที่เทียบเท่าหากไม่มีอักขระพิเศษ)

  การดําเนินการนี้จะส่งกลับรายการของ Schema ภายในรายการข้อมูล ถ้ารายการข้อมูลไม่สนับสนุน Schema จะมีการส่งกลับ Schema คงที่ที่ชื่อdbo

• แสดงรายการตาราง

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables?catalog_name=<ItemName or ItemID>&schema_name=<SchemaName>

  การดําเนินการนี้จะส่งคืนรายการของตารางที่พบภายใน Schema ที่กําหนด

• รับตาราง

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

  การดําเนินการนี้ส่งคืนรายละเอียดข้อมูลเมตาสําหรับตารางภายใน Schema หากพบตาราง

• มีสคีมา

  HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas/<SchemaName>

  การดําเนินการนี้จะตรวจสอบการมีอยู่ของ Schema ภายในรายการข้อมูล และส่งคืนความสําเร็จหากพบ Schema

• มีตาราง

  HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

  การดําเนินการนี้จะตรวจสอบการมีอยู่ของตารางภายใน Schema และส่งคืนความสําเร็จหากพบ Schema

ข้อ จํากัด ข้อควรพิจารณาในปัจจุบัน

การใช้ API ตาราง OneLake สําหรับเดลต้าอยู่ภายใต้ข้อจํากัดและข้อควรพิจารณาต่อไปนี้:

• บางรายการข้อมูลอาจไม่รองรับ Schema

  ขึ้นอยู่กับชนิดของรายการข้อมูลที่คุณใช้ เช่น เลคเฮาส์ Fabric ที่ไม่ได้เปิดใช้งาน Schema อาจไม่มี Schema ภายในไดเรกทอรี ตาราง ในกรณีดังกล่าว เพื่อความเข้ากันได้กับไคลเอ็นต์ API ตาราง OneLake จะจัดเตรียม Schema แบบคงที่ dbo (หรือเนมสเปซ) เริ่มต้นเพื่อบรรจุตารางทั้งหมดภายในรายการข้อมูล

• พารามิเตอร์สตริงคิวรีเพิ่มเติมที่จําเป็นหากชื่อสคีมาหรือชื่อตารางของคุณมีจุด

  หากสคีมาหรือชื่อตารางของคุณมีจุด (.) และรวมอยู่ใน URL คุณต้องระบุพารามิเตอร์การค้นหาเพิ่มเติมด้วย ตัวอย่างเช่น เมื่อชื่อ Schema มีจุด ให้รวม catalog_name เป็นพารามิเตอร์การสืบค้นเพิ่มเติมในการเรียก API เพื่อตรวจสอบว่ามี Schema อยู่หรือไม่

• การดําเนินการเขียนข้อมูลเมตา การดําเนินการอื่นๆ

  เฉพาะการดําเนินการที่แสดงใน การดําเนินการ API ตารางเดลต้า เท่านั้นที่ได้รับการสนับสนุนในปัจจุบัน การดําเนินการที่จัดการการดําเนินการเขียนข้อมูลเมตายังไม่ได้รับการสนับสนุนโดยตําแหน่งข้อมูล API เดลต้าของตาราง OneLake

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

• เรียนรู้เพิ่มเติมเกี่ยวกับ API ตาราง OneLake
• ดูคําแนะนําโดยละเอียดและรายละเอียด API