Koneksi ke Microsoft OneLake

  • Artikel

Microsoft OneLake menyediakan akses terbuka ke semua item Fabric Anda melalui API dan SDK Azure Data Lake Storage (ADLS) Gen2 yang ada. Anda dapat mengakses data Anda di OneLake melalui API, SDK, atau alat apa pun yang kompatibel dengan ADLS Gen2 hanya dengan menggunakan OneLake URI sebagai gantinya. Anda dapat mengunggah data ke lakehouse melalui Azure Storage Explorer, atau membaca tabel delta melalui pintasan dari Azure Databricks.

Karena OneLake adalah software as a service (SaaS), beberapa operasi, seperti mengelola izin atau memperbarui item, harus dilakukan melalui pengalaman Fabric alih-alih API ADLS Gen2. Untuk daftar lengkap perubahan pada API ini, lihat Paritas API OneLake.

Sintaks URI

Karena OneLake ada di seluruh penyewa Microsoft Fabric, Anda dapat merujuk ke apa pun di penyewa Anda dengan ruang kerja, item, dan jalurnya:

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

Catatan

Karena Anda dapat menggunakan kembali nama item di beberapa jenis item, Anda harus menentukan jenis item dalam ekstensi. Misalnya, .lakehouse untuk lakehouse dan .datawarehouse untuk gudang.

OneLake juga mendukung referensi ruang kerja dan item dengan pengidentifikasi unik global (GUID). OneLake menetapkan GUID dan GUID tidak berubah, meskipun ruang kerja atau nama item berubah. Anda dapat menemukan GUID terkait untuk ruang kerja atau item Anda di URL di portal Fabric. Anda harus menggunakan GUID untuk ruang kerja dan item, dan tidak memerlukan jenis item.

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

Saat mengadopsi alat untuk digunakan melalui OneLake alih-alih ADLS Gen2, gunakan pemetaan berikut:

  • Nama akun selalu onelake.
  • Nama kontainer adalah nama ruang kerja Anda.
  • Jalur data dimulai pada item. Sebagai contoh: /mylakehouse.lakehouse/Files/.

OneLake juga mendukung driver Azure Blob Filesystem (ABFS) untuk kompatibilitas lebih lanjut dengan ADLS Gen2 dan Azure Blob Storage. Driver ABFS menggunakan pengidentifikasi abfs skemanya sendiri dan format URI yang berbeda untuk mengatasi file dan direktori di akun ADLS Gen2. Untuk menggunakan format URI ini melalui OneLake, tukar ruang kerja untuk sistem file dan sertakan item dan jenis item.

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

Authorization

Anda dapat mengautentikasi API OneLake menggunakan ID Microsoft Entra dengan melewati header otorisasi. Jika alat mendukung pengelogan ke akun Azure Anda untuk mengaktifkan passthrough token, Anda dapat memilih langganan apa pun. OneLake hanya memerlukan token pengguna Anda dan tidak peduli dengan langganan Azure Anda.

Saat memanggil OneLake melalui API DFS secara langsung, Anda dapat mengautentikasi dengan token pembawa untuk akun Microsoft Entra Anda. Untuk mempelajari selengkapnya tentang meminta dan mengelola token pembawa untuk organisasi Anda, lihat Pustaka Autentikasi Microsoft.

Untuk pengujian OneLake yang cepat dan ad-hoc menggunakan panggilan API langsung, berikut adalah contoh sederhana menggunakan PowerShell untuk masuk ke akun Azure Anda, mengambil token cakupan penyimpanan, dan menyalinnya ke clipboard Anda untuk digunakan dengan mudah di tempat lain. Untuk informasi selengkapnya tentang mengambil token akses menggunakan PowerShell, lihat Get-AzAccessToken.

Catatan

OneLake hanya mendukung token di Storage audiens. Dalam contoh berikut, kami mengatur audiens melalui ResourceTypeName parameter .

az login --allow-no-subscriptions
$testToken = Get-AzAccessToken -ResourceTypeName Storage
$testToken.Token | Set-Clipboard

Residensi data

OneLake saat ini tidak menjamin residensi data di wilayah tertentu saat menggunakan titik akhir global (https://onelake.dfs.fabric.microsoft.com). Saat Anda mengkueri data di wilayah yang berbeda dari wilayah ruang kerja Anda, ada kemungkinan data dapat meninggalkan wilayah Anda selama proses resolusi titik akhir. Jika Anda khawatir tentang residensi data, menggunakan titik akhir regional yang benar untuk ruang kerja Anda memastikan data Anda tetap berada di wilayahnya saat ini dan tidak melewati batas regional apa pun. Anda dapat menemukan titik akhir regional yang benar dengan memeriksa wilayah kapasitas tempat ruang kerja dilampirkan.

Semua titik akhir regional OneLake mengikuti format yang sama: https://<region>-onelake.dfs.fabric.microsoft.com. Misalnya, ruang kerja yang melekat pada kapasitas di wilayah US Barat 2 akan dapat diakses melalui titik https://westus-onelake.dfs.fabric.microsoft.comakhir regional .

Masalah umum

Jika alat atau paket yang kompatibel dengan ADLS Gen2 tidak berfungsi melalui OneLake, masalah yang paling umum adalah validasi URL. Karena OneLake menggunakan titik akhir yang berbeda (dfs.fabric.microsoft.com) daripada ADLS Gen2 (dfs.core.windows.net), beberapa alat tidak mengenali titik akhir OneLake dan memblokirnya. Beberapa alat memungkinkan Anda menggunakan titik akhir kustom (seperti PowerShell). Jika tidak, sering kali merupakan perbaikan sederhana untuk menambahkan titik akhir OneLake sebagai titik akhir yang didukung. Jika Anda menemukan masalah validasi URL atau memiliki masalah lain saat menyambungkan ke OneLake, beri tahu kami.

Sampel

Membuat file

Permintaan MENEMPATKAN https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Header Authorization: Bearer <userAADToken>
Respons ResponseCode:201 Created
Header:
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
Isi:

Konten terkait