Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Microsoft OneLake menyediakan akses terbuka ke semua item Fabric Anda melalui Azure Data Lake Storage (ADLS) dan API Blob dan SDK yang ada. Anda dapat mengakses data Anda di OneLake melalui API, SDK, atau alat apa pun yang kompatibel dengan ADLS atau Azure Blob Storage hanya dengan menggunakan URI OneLake 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, dan tidak dapat dilakukan melalui API ADLS. Untuk daftar lengkap perubahan pada API ini, lihat Paritas API OneLake.
Sintaks URI
Karena OneLake ada di seluruh tenant Microsoft Fabric Anda, Anda dapat merujuk ke apa pun di tenant Anda berdasarkan 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 rumah tepi danau dan .warehouse untuk gudang.
OneLake juga mendukung referensi ruang kerja dan item dengan pengidentifikasi unik global (GUID). OneLake menetapkan GUID dan GUID tidak berubah meski nama area 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, serta tidak perlu menggunakan jenis item.
https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>
Saat mengadopsi alat untuk digunakan melalui OneLake alih-alih ADLS, gunakan pemetaan berikut:
- Nama akun selalu
onelake. - Nama kontainer adalah nama ruang kerja Anda.
- Jalur data dimulai pada item. Misalnya:
/mylakehouse.lakehouse/Files/.
OneLake juga mendukung driver Azure Blob Filesystem (ABFS) untuk kompatibilitas lebih lanjut dengan ADLS dan Azure Blob Storage. Driver ABFS menggunakan pengidentifikasi skema abfs miliknya sendiri dan format URI yang berbeda untuk mengakses file dan direktori di akun Azure Data Lake Storage (ADLS). Untuk menggunakan format URI ini melalui OneLake, gantilah "ruang kerja" dengan "sistem file" dan sertakan item serta jenis itemnya.
abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>
URI driver abfs tidak mengizinkan karakter khusus, seperti spasi, dalam nama ruang kerja. Dalam kasus ini, Anda dapat mereferensikan ruang kerja dan item dengan pengidentifikasi unik global (GUID) seperti yang dijelaskan sebelumnya di bagian ini.
Otorisasi
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 audiens Storage. Dalam contoh berikut, kami mengatur audiens melalui ResourceTypeName parameter .
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
Lokasi Penyimpanan Data
Jika Anda menggunakan titik akhir global (https://onelake.dfs.fabric.microsoft.com) untuk 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 tepat dengan memeriksa wilayah kapasitas tempat workspace tersebut terhubung.
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 akan dapat diakses melalui titik akhir regional https://westus-onelake.dfs.fabric.microsoft.com.
Titik akhir OneLake tambahan
OneLake juga mendukung FQDN umum (https://api.onelake.fabric.microsoft.com), bersama dengan versi regional (https://<region>-api.onelake.fabric.microsoft.com) dan ruang kerja (https://<wsid>.z<xy>.onelake.fabric.microsoft.com). FQDN ini berfungsi identik dengan varian blob dan DFS, tetapi mungkin tidak kompatibel dengan beberapa alat Azure Storage yang mengandalkan varian blob dan DFS untuk menggunakan API Azure Storage yang benar.
Masalah umum
Jika alat atau paket yang kompatibel dengan ADLS tidak berfungsi melalui OneLake, masalah yang paling umum adalah validasi URL. Karena OneLake menggunakan titik akhir yang berbeda (dfs.fabric.microsoft.com) dari ADLS (dfs.core.windows.net), beberapa alat tidak mengenali titik akhir OneLake dan memblokirnya. Beberapa alat memungkinkan Anda menggunakan titik akhir kustom (seperti PowerShell). Sering kali, cukup dengan menambahkan titik akhir OneLake sebagai titik akhir yang dapat didukung. Jika Anda menemukan masalah validasi URL atau memiliki masalah lain saat menyambungkan ke OneLake, beri tahu kami.
Sumber daya
OneLake dapat diakses melalui API dan SDK yang sama dengan ADLS. Untuk mempelajari selengkapnya tentang menggunakan API ADLS, silakan lihat halaman berikut:
- Referensi API ADLS Gen2
- ADLS Gen2 Filesystem SDK
Sampel
Membuat file
| Permintaan |
MELETAKKAN https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file |
|---|---|
| Header | Authorization: Bearer <userAADToken> |
| Respons |
ResponseCode:201 CreatedHeader: x-ms-version : 2021-06-08x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67bx-ms-content-crc64 : OAJ6r0dQWP0=x-ms-request-server-encrypted : trueETag : 0x8DA58EE365Isi: |