API ตาราง OneLake สําหรับ Iceberg

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

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

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

ตําแหน่งข้อมูล API ตาราง Iceberg

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

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

ที่จุดสิ้นสุด API ตาราง OneLake API ของ Iceberg REST Catalog (IRC) จะพร้อมใช้งานภายใต้<BaseUrl> โดยทั่วไปคุณสามารถระบุเส้นทางนี้เมื่อเริ่มต้นไคลเอ็นต์ IRC หรือไลบรารีที่มีอยู่

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

ตัวอย่างของการกําหนดค่าไคลเอ็นต์ IRC ที่มีจุดสิ้นสุดตาราง OneLake จะครอบคลุมอยู่ในคู่มือการเริ่มต้นใช้งาน

การดําเนินการ API ตาราง Iceberg

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

• รับการกําหนดค่า

  GET <BaseUrl>/v1/config?warehouse=<Warehouse>

  การดําเนินการนี้ยอมรับรหัสพื้นที่ทํางานและรหัสรายการข้อมูล (หรือชื่อที่จําง่ายที่เทียบเท่าหากไม่มีอักขระพิเศษ) <Warehouse>โดยทั่วไป<WorkspaceID>/<dataItemID>

  การดําเนินการนี้ส่งกลับ Prefix สตริงที่ใช้ในการร้องขอที่ตามมา

• แสดงรายการเนมสเปซ

  GET <BaseUrl>/v1/<Prefix>/namespaces

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

• รับเนมสเปซ

  GET <BaseUrl>/v1/<Prefix>/namespaces/<SchemaName>

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

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

  GET <BaseUrl>/v1/<Prefix>/namespaces/<SchemaName>/tables

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

• รับตาราง

  GET <BaseUrl>/v1/<Prefix>/namespaces/<SchemaName>/tables/<TableName>

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

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

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

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

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

• ขอบเขตเนมสเปซปัจจุบัน

  ใน Fabric รายการข้อมูลประกอบด้วยรายการแบบเรียบของ Schema ซึ่งแต่ละรายการมีรายการตารางแบบเรียบ วันนี้ เนมสเปซระดับบนสุดที่ระบุโดย Iceberg API เป็นสคีมา ดังนั้นแม้ว่ามาตรฐาน Iceberg REST Catalog (IRC) จะรองรับเนมสเปซหลายระดับ แต่การใช้งาน OneLake ก็มีระดับเดียวในการแมปกับสคีมา

  เนื่องจากข้อจํากัดนี้ เราจึงยังไม่สนับสนุน parent พารามิเตอร์คิวรีสําหรับ list namespaces การดําเนินการ

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

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

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

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