แชร์ผ่าน

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

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

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

ไวยากรณ์ URI

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

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

หมายเหตุ

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

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

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

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

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

OneLake ยังรองรับ ไดรเวอร์ระบบไฟล์ Azure Blob (ABFS) เพื่อความเข้ากันได้กับ ADLS และ Azure Blob Storage มากขึ้น ไดรเวอร์ ABFS ใช้ตัว abfs ระบุโครงร่างของตัวเองและรูปแบบ URI ที่แตกต่างกันเพื่อระบุไฟล์และไดเรกทอรีในบัญชี ADLS หากต้องการใช้รูปแบบ 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 -AsSecureString -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 ไม่ทํางานผ่าน OneLake ปัญหาที่พบบ่อยที่สุดคือการตรวจสอบความถูกต้องของ URL เนื่องจาก OneLake ใช้ปลายทาง (dfs.fabric.microsoft.com) ที่แตกต่างจาก ADLS (dfs.core.windows.net) เครื่องมือบางอย่างไม่รู้จักปลายทาง OneLake และบล็อก เครื่องมือบางอย่างช่วยให้คุณสามารถใช้จุดสิ้นสุดแบบกําหนดเอง (เช่น PowerShell) ได้ มิฉะนั้น มักจะเป็นการแก้ไขอย่างง่ายเมื่อต้องเพิ่มจุดสิ้นสุดของ OneLake เป็นจุดสิ้นสุดที่ได้รับการสนับสนุน ถ้าคุณพบปัญหาการตรวจสอบ URL หรือมีปัญหาอื่นๆ ในการเชื่อมต่อกับ OneLake โปรดแจ้งให้เราทราบ

ทรัพยากร

OneLake สามารถเข้าถึงได้ผ่าน API และ SDK เดียวกันกับ ADLS หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการใช้ ADLS API โปรดดูหน้าต่อไปนี้:

  • อ้างอิง ADLS Gen2 API
  • SDK ระบบไฟล์ ADLS Gen2

ตัวอย่าง

สร้างไฟล์

ส่งคำขอ วาง 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
ร่างกาย:

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

  • Last updated on