แชร์ผ่าน


ภาพรวมของ OneLake table API

OneLake มีจุดสิ้นสุด REST API สําหรับการโต้ตอบกับตารางใน Microsoft Fabric ปลายทางนี้สามารถใช้กับไคลเอ็นต์และไลบรารีที่เข้ากันได้กับมาตรฐานแบบเปิดของ Iceberg REST Catalog (IRC) API หรือมาตรฐานแบบเปิดของ Unity Catalog API

สําคัญ

คุณลักษณะนี้อยู่ใน แสดงตัวอย่าง

ข้อกําหนดเบื้องต้น

การใช้ API เหล่านี้จะตรงไปตรงมาเมื่อคุณระบุข้อมูลสองสามชิ้นและเลือกโฟลว์การรับรองความถูกต้อง Microsoft Entra ID ที่คุณต้องการ

การรวบรวมข้อมูลพื้นฐาน

หากต้องการใช้ API เหล่านี้ ก่อนอื่นคุณต้องรวบรวมข้อมูลต่อไปนี้:

  • รหัสผู้เช่า Fabric ของคุณ

    รหัสผู้เช่าเป็น GUID และสามารถพบได้ในการ์ด โปรไฟล์ หรือเมนู **วิธีใช้เกี่ยวกับ Fabric ใน Fabric

  • พื้นที่ทํางานและรหัสรายการข้อมูลของรายการข้อมูล (เช่น เลคเฮาส์) ที่มีไดเรกทอรีตารางระดับบนสุด

    รหัสเหล่านี้เป็น GUID สามารถพบได้ภายใน URL ของ OneLake ของตารางใดก็ได้ใน OneLake อีกทางหนึ่งสามารถพบได้ภายใน URL ที่เห็นในเบราว์เซอร์ของคุณเมื่อคุณเปิดรายการข้อมูลใน Fabric

  • ข้อมูลประจําตัวของผู้ใช้หรือบริการหลักใน Microsoft Entra ID ที่มีสิทธิ์ในการอ่านตารางในรายการข้อมูลที่คุณเลือก

การเตรียมการรับรองความถูกต้อง

  1. ตัดสินใจว่าคุณต้องการรับรองความถูกต้องด้วย Microsoft Entra ID อย่างไรเพื่อรับโทเค็นการเข้าถึงสําหรับข้อมูลประจําตัว Microsoft Entra ที่คุณเลือก

    คุณสามารถตรวจสอบคู่มือนี้เพื่อเรียนรู้เกี่ยวกับวิธีต่างๆ ในการรับโทเค็นการเข้าถึงด้วย Microsoft Entra ID Microsoft มีไลบรารีการรับรองความถูกต้องที่สะดวกในหลายภาษา

  2. หากคุณกําลังพัฒนาแอปพลิเคชันใหม่ที่จะอนุญาตให้ผู้ใช้ลงชื่อเข้าใช้หรือลงชื่อเข้าใช้เป็นแอปพลิเคชันแบบสแตนด์อโลน ให้ลงทะเบียนแอปพลิเคชันของคุณด้วย Microsoft Entra ID

  3. ให้สิทธิ์ API สําหรับผู้ชมโทเค็นที่เก็บข้อมูล Azure (https://storage.azure.com/) ให้กับแอปพลิเคชัน Microsoft Entra ID ของคุณ การให้สิทธิ์นี้ช่วยให้แน่ใจว่าแอปพลิเคชันของคุณสามารถรับโทเค็นสําหรับใช้กับตําแหน่งข้อมูลตาราง OneLake ได้

    Note

    ตําแหน่งข้อมูล API ตาราง OneLake ยอมรับผู้ชมโทเค็นเดียวกันกับตําแหน่งข้อมูลระบบไฟล์ OneLake

    หากคุณกําลังพัฒนาแอปพลิเคชัน คุณอาจทราบวิธีรับรองความถูกต้องด้วย Microsoft Entra ID เพื่อโต้ตอบกับ REST API ของระบบไฟล์ OneLake อยู่แล้ว ถ้าเป็นเช่นนั้น คุณสามารถใช้วิธีการเดียวกันนี้เพื่อรับรองความถูกต้องกับตําแหน่งข้อมูลตาราง OneLake ใหม่

การดําเนินการ API ของ Iceberg REST Catalog (IRC) บน OneLake

เรียนรู้วิธีเริ่มต้นใช้งานตําแหน่งข้อมูล API ตาราง OneLake เพื่อโต้ตอบกับตาราง Iceberg ใน OneLake ในขั้นต้น รองรับการดําเนินการตารางข้อมูลเมตาแบบอ่านอย่างเดียว และเราวางแผนที่จะเพิ่มการดําเนินการเพิ่มเติมในเร็วๆ นี้

Note

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

การดําเนินการ Delta Lake REST API บน OneLake

เรียนรู้วิธีเริ่มต้นใช้งานตําแหน่งข้อมูล API ตาราง OneLake เพื่อโต้ตอบกับตารางเดลต้าใน OneLake