หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
OneLake มี API สําหรับทํางานกับเมตาดาต้าของตารางและอ่านแถวของตารางใน Fabric API เมตาดาต้าของแคตตาล็อกทํางานร่วมกับไคลเอนต์และไลบรารีที่เข้ากันได้กับมาตรฐานเปิด Iceberg REST Catalog (IRC) API หรือมาตรฐานเปิดของ Unity Catalog API REST API ทั่วไปจะอ่านและเขียนคําอธิบายและแท็กเพิ่มเติมสําหรับตารางและคอลัมน์ API อ่านตารางที่ไม่ขึ้นกับรูปแบบจะคืนแถวตารางเป็นข้อมูล Apache Arrow ในขณะที่บังคับใช้ความปลอดภัยของ OneLake
ทํางานกับเมตาดาต้าของตาราง
ใช้ API เมตาดาต้าเพื่อค้นหาสคีมา ตาราง และเมตาดาต้าของตาราง การอ่านและเขียนที่รองรับจะแตกต่างกันไปตามโปรโตคอล
ใช้ API เมตาดาต้าตารางเพิ่มเติม (พรีวิว) เพื่ออ่านและเขียนคําอธิบายตารางและคอลัมน์ รวมถึงแท็กโดยไม่ต้องใช้ API แคตตาล็อกเฉพาะรูปแบบ
| API | โปรโตคอล | รูปแบบตาราง |
|---|---|---|
| API เมตาดาต้า Iceberg | API แคตตาล็อก REST ของ Iceberg | ข้อมูลเมตา Iceberg สําหรับตาราง OneLake ที่รองรับ |
| API เมตาดาต้า Delta | REST API ที่เข้ากันได้กับ Unity Catalog | ข้อมูลเมตาเดลต้า |
อ่านข้อมูลตาราง
ใช้ API อ่านตารางเพื่อดึงแถวที่ปลอดภัยจากตาราง OneLake ที่รองรับ
| API | โปรโตคอลและเวิร์กโฟลว์ | รูปแบบตาราง |
|---|---|---|
| API อ่านตาราง (ตัวอย่าง) | จัดสรรสตรีมที่มี POST /readและดึงสตรีมแต่ละสตรีมด้วย GET /readStream/{streamId} |
ตาราง Delta Lake และ Apache Iceberg ที่ถูกต้อง |
ข้อกําหนดเบื้องต้น
ก่อนที่คุณจะใช้ API เหล่านี้ ให้ระบุข้อมูลบางส่วนและเลือกกระบวนการยืนยันตัวตน Microsoft Entra ID ที่คุณต้องการ
รวบรวมข้อมูลพื้นฐาน
รวบรวมข้อมูลดังต่อไปนี้:
รหัสผู้เช่า Fabric ของคุณ
รหัสผู้เช่าเป็น GUID ค้นหาได้ในการ์ดโปรไฟล์หรือในความช่วยเหลือ>เกี่ยวกับ Fabric
พื้นที่ทํางานและรหัสรายการข้อมูลของรายการข้อมูล (เช่น เลคเฮาส์) ที่มีไดเรกทอรีตารางระดับบนสุด
รหัสเหล่านี้เป็น GUID สามารถพบได้ภายใน URL ของ OneLake ของตารางใดก็ได้ใน OneLake อีกทางหนึ่งสามารถพบได้ภายใน URL ที่เห็นในเบราว์เซอร์ของคุณเมื่อคุณเปิดรายการข้อมูลใน Fabric
ชื่อสคีมาและชื่อตารางสําหรับตารางที่คุณต้องการเข้าถึง สําหรับ API การอ่านตาราง ตารางต้องเป็นตาราง Delta Lake หรือ Apache Iceberg ที่ถูกต้อง
ตัวตนผู้ใช้หรือบริการหลักใน Microsoft Entra ID ที่มีสิทธิ์ที่จําเป็นสําหรับการดําเนินการที่คุณวางแผนจะใช้
- การดําเนินการอ่านต้องได้รับสิทธิ์ในการอ่านตารางเป้าหมาย API การอ่านตารางใช้สิทธิ์และนโยบายความปลอดภัยของข้อมูลสําหรับตัวตนนี้เมื่อคืนค่าแถวและคอลัมน์
- การดําเนินการเขียนต้องมีสิทธิ์เขียนข้อมูลเป้าหมายและตําแหน่ง OneLake ขึ้นอยู่กับประเภทของรายการและรูปแบบการเข้าถึง ให้มอบบทบาทรายการหรือพื้นที่ทํางานที่อนุญาตให้เขียน หรือมอบสิทธิ์ ReadWrite ผ่านบทบาทการเข้าถึงข้อมูล OneLake สําหรับข้อมูลเพิ่มเติม โปรดดู เริ่มต้นใช้งานการรักษาความปลอดภัย OneLake
เตรียมความพร้อมสําหรับการตรวจสอบสิทธิ์
วางแผนวิธีการตรวจสอบตัวตนด้วย API
ตัดสินใจว่าคุณต้องการรับรองความถูกต้องด้วย Microsoft Entra ID อย่างไรเพื่อรับโทเค็นการเข้าถึงสําหรับข้อมูลประจําตัว Microsoft Entra ที่คุณเลือก
คุณสามารถตรวจสอบคู่มือนี้เพื่อเรียนรู้เกี่ยวกับวิธีต่างๆ ในการรับโทเค็นการเข้าถึงด้วย Microsoft Entra ID Microsoft มีไลบรารีการรับรองความถูกต้องที่สะดวกในหลายภาษา
หากคุณกําลังพัฒนาแอปพลิเคชันใหม่ที่จะอนุญาตให้ผู้ใช้ลงชื่อเข้าใช้หรือลงชื่อเข้าใช้เป็นแอปพลิเคชันแบบสแตนด์อโลน ให้ลงทะเบียนแอปพลิเคชันของคุณด้วย Microsoft Entra ID
ให้สิทธิ์ API สําหรับผู้ชมโทเค็นที่เก็บข้อมูล Azure (
https://storage.azure.com/) ให้กับแอปพลิเคชัน Microsoft Entra ID ของคุณ การให้สิทธิ์นี้ช่วยให้แน่ใจว่าแอปพลิเคชันของคุณสามารถรับโทเค็นสําหรับใช้กับตําแหน่งข้อมูลตาราง OneLake ได้Note
ตําแหน่งข้อมูล API ตาราง OneLake ยอมรับผู้ชมโทเค็นเดียวกันกับตําแหน่งข้อมูลระบบไฟล์ OneLake
หากคุณกําลังพัฒนาแอปพลิเคชัน คุณอาจรู้วิธีตรวจสอบสิทธิ์ด้วย Microsoft Entra ID เพื่อโต้ตอบกับ REST API ของระบบไฟล์ OneLake อยู่แล้ว ถ้าใช่ คุณสามารถใช้วิธีเดียวกันนี้เพื่อยืนยันตัวตนกับปลายทางตาราง OneLake
เนื้อหาที่เกี่ยวข้อง
- เรียนรู้เพิ่มเติมเกี่ยวกับเมตาดาต้าตารางเพิ่มเติม
- เรียนรู้เพิ่มเติมเกี่ยวกับ API เมตาดาต้า Iceberg
- เรียนรู้เพิ่มเติมเกี่ยวกับ API เมตาดาต้าของ Delta
- เรียนรู้เพิ่มเติมเกี่ยวกับการอ่านข้อมูลตารางของ OneLake
- ตั้งค่าการแปลงรูปแบบ Delta Lake เป็น Iceberg อัตโนมัติ