แชร์ผ่าน

การเชื่อมต่อกับ Microsoft OneLake

  • บทความ

Microsoft OneLake เปิดการเข้าถึงรายการ Fabric ทั้งหมดของคุณผ่าน Azure Data Lake Storage (ADLS) Gen2 API และ SDK ที่มีอยู่ คุณสามารถเข้าถึงข้อมูลของคุณใน OneLake ได้ผ่าน API, SDK หรือเครื่องมือที่เข้ากันได้กับ ADLS Gen2 เพียงแค่ใช้ OneLake URI แทน คุณสามารถอัปโหลดข้อมูลไปยังเลคเฮ้าส์ผ่าน Azure Storage Explorer หรืออ่านตาราง Delta ผ่านทางลัดจาก Azure Databricks ได้

เนื่องจาก OneLake เป็นซอฟต์แวร์ที่เป็นบริการ (SaaS) การดําเนินการบางอย่างเช่นการจัดการสิทธิ์หรือการอัปเดตรายการจะต้องทําผ่านประสบการณ์ Fabric แทน API ADLS Gen2 สําหรับรายการทั้งหมดของการเปลี่ยนแปลง API เหล่านี้ ดู พาริตีของ OneLake API

ไวยากรณ์ URI

เนื่องจาก OneLake มีอยู่ในผู้เช่า Microsoft Fabric ทั้งหมดของคุณ คุณสามารถอ้างอิงถึงสิ่งใด ๆ ในผู้เช่าของคุณโดยพื้นที่ทํางาน รายการ และเส้นทาง:

https://onelake.dfs.fabric.microsoft.com/<workspace>/<item>.<itemtype>/<path>/<fileName>

หมายเหตุ

เนื่องจากคุณสามารถใช้ชื่อสินค้าซ้ําในสินค้าหลายชนิด ได้คุณต้องระบุชนิดสินค้าในส่วนขยาย ตัวอย่างเช่น .lakehouse สําหรับเลคเฮ้าส์และ .datawarehouse สําหรับคลังสินค้า

OneLake ยังสนับสนุนการอ้างอิงพื้นที่ทํางานและรายการด้วยตัวระบุที่ไม่ซ้ํากันทั่วโลก (GUID) OneLake กําหนด GUID และ GUID ไม่ให้เปลี่ยนแปลง แม้ว่าชื่อพื้นที่ทํางานหรือรายการจะเปลี่ยนก็ตาม คุณสามารถค้นหา GUID ที่เกี่ยวข้องสําหรับพื้นที่ทํางานหรือรายการของคุณใน URL บนพอร์ทัล Fabric คุณต้องใช้ GUID สําหรับทั้งพื้นที่ทํางานและรายการ และไม่จําเป็นต้องมีชนิดรายการ

https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>

เมื่อนําเครื่องมือสําหรับใช้งานบน OneLake แทน ADLS Gen2 ให้ใช้การแมปต่อไปนี้:

  • ชื่อบัญชีจะเป็น เสมอonelake
  • ชื่อคอนเทนเนอร์คือชื่อพื้นที่ทํางานของคุณ
  • เส้นทางข้อมูลเริ่มต้นที่รายการ ตัวอย่างเช่น: /mylakehouse.lakehouse/Files/

OneLake ยังสนับสนุน โปรแกรมควบคุม ระบบไฟล์ Azure Blob (ABFS) เพื่อความเข้ากันได้เพิ่มเติมกับ ADLS Gen2 และ Azure Blob Storage ไดรเวอร์ ABFS ใช้ตัวระบุ abfs แบบของตัวเองและรูปแบบ URI ที่แตกต่างกันเพื่อจัดการไฟล์และไดเรกทอรีในบัญชี ADLS Gen2 หากต้องการใช้รูปแบบ URI นี้กับ OneLake ให้สลับพื้นที่ทํางานสําหรับระบบไฟล์และรวมรายการและประเภทรายการ

abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>

URI ของโปรแกรมควบคุม abfs ไม่อนุญาตให้มีอักขระพิเศษ เช่น ช่องว่างในชื่อพื้นที่ทํางาน ในกรณีเหล่านี้ คุณสามารถอ้างอิงพื้นที่ทํางานและรายการด้วยตัวระบุที่ไม่ซ้ํากันทั่วโลก (GUID) ตามที่อธิบายไว้ก่อนหน้าในส่วนนี้

การอนุญาต

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

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

สําหรับการทดสอบแบบเฉพาะกิจที่รวดเร็วของ OneLake โดยใช้การเรียกใช้ API โดยตรง นี่คือตัวอย่างง่ายๆ โดยใช้ PowerShell เพื่อลงชื่อเข้าใช้บัญชี Azure ของคุณ เรียกใช้โทเค็นที่กําหนดขอบเขตการจัดเก็บ และคัดลอกไปยังคลิปบอร์ดของคุณเพื่อให้ง่ายต่อการใช้งานในที่อื่น สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการเรียกโทเค็นการเข้าถึงโดยใช้ PowerShell ดูรับ-AzAccessToken

หมายเหตุ

OneLake สนับสนุนเฉพาะโทเค็นใน Storage ผู้ชมเท่านั้น ในตัวอย่างต่อไปนี้ เราตั้งค่าผู้ชมผ่าน ResourceTypeName พารามิเตอร์

Connect-AzAccount
$testToken = Get-AzAccessToken -ResourceTypeName Storage
# Retrieved token is of string type which you can validate with the "$testToken.Token.GetTypeCode()" command.
$testToken.Token | Set-Clipboard

ที่เก็บข้อมูล

หากคุณใช้จุดสิ้นสุดส่วนกลาง ('https://onelake.dfs.fabric.microsoft.com) เพื่อคิวรีข้อมูลในภูมิภาคที่แตกต่างจากภูมิภาคของพื้นที่ทํางานของคุณ มีความเป็นไปได้ที่ข้อมูลอาจออกจากภูมิภาคของคุณในระหว่างกระบวนการแก้ไขปลายทาง หากคุณกังวลเกี่ยวกับการเก็บข้อมูล ให้ใช้จุดสิ้นสุดภูมิภาคที่ถูกต้องสําหรับพื้นที่ทํางานของคุณเพื่อให้แน่ใจว่าข้อมูลของคุณจะอยู่ภายในภูมิภาคปัจจุบันและไม่ข้ามขอบเขตภูมิภาคใด ๆ คุณสามารถค้นหาจุดสิ้นสุดภูมิภาคที่ถูกต้องได้โดยการตรวจสอบภูมิภาคของความจุที่แนบมากับพื้นที่ทํางาน

จุดสิ้นสุดภูมิภาค OneLake ทั้งหมดเป็นไปตามรูปแบบเดียวกัน: https://<region>-onelake.dfs.fabric.microsoft.com ตัวอย่างเช่น พื้นที่ทํางานที่แนบมากับความจุในภูมิภาคสหรัฐอเมริกาตะวันตกจะสามารถเข้าถึงได้ผ่านจุด https://westus-onelake.dfs.fabric.microsoft.comสิ้นสุดภูมิภาค

ปัญหาทั่วไป

ถ้าเครื่องมือหรือแพคเกจที่เข้ากันได้กับ ADLS Gen2 ไม่ทํางานบน OneLake ปัญหาที่พบบ่อยที่สุดคือการตรวจสอบ URL เนื่องจาก OneLake ใช้จุดสิ้นสุด (dfs.fabric.microsoft.com) ที่แตกต่างจาก ADLS Gen2 (dfs.core.windows.net) เครื่องมือบางอย่างไม่รู้จักจุดสิ้นสุด OneLake และบล็อก เครื่องมือบางอย่างช่วยให้คุณสามารถใช้จุดสิ้นสุดแบบกําหนดเอง (เช่น PowerShell) ได้ มิฉะนั้น มักจะเป็นการแก้ไขอย่างง่ายเมื่อต้องเพิ่มจุดสิ้นสุดของ OneLake เป็นจุดสิ้นสุดที่ได้รับการสนับสนุน ถ้าคุณพบปัญหาการตรวจสอบ URL หรือมีปัญหาอื่นๆ ในการเชื่อมต่อกับ OneLake โปรดแจ้งให้เราทราบ

ตัวอย่าง

สร้างไฟล์

ส่งคำขอ วาง https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
ส่วนหัว Authorization: Bearer <userAADToken>
Response รหัสการตอบสนอง: 201 Created
ส่วนหัว:
x-ms-version : 2021-06-08
x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67b
x-ms-content-crc64 : OAJ6r0dQWP0=
x-ms-request-server-encrypted : true
ETag : 0x8DA58EE365
ร่างกาย:

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