Microsoft OneLake'e Bağlan
Microsoft OneLake, mevcut Azure Data Lake Depolama (ADLS) 2. Nesil API'leri ve SDK'ları aracılığıyla tüm Doku öğelerinize açık erişim sağlar. OneLake'teki verilerinize ADLS 2. Nesil ile uyumlu herhangi bir API, SDK veya araç üzerinden yalnızca onelake URI'sini kullanarak erişebilirsiniz. Azure Depolama Gezgini aracılığıyla bir göle veri yükleyebilir veya Azure Databricks'ten bir kısayol aracılığıyla delta tablosunu okuyabilirsiniz.
OneLake hizmet olarak yazılım (SaaS) olduğundan, izinleri yönetme veya öğeleri güncelleştirme gibi bazı işlemler ADLS 2. Nesil API'leri yerine Doku deneyimleri aracılığıyla yapılmalıdır. Bu API'lerde yapılan değişikliklerin tam listesi için bkz . OneLake API eşliği.
URI Söz Dizimi
OneLake tüm Microsoft Fabric kiracınızda mevcut olduğundan, kiracınızdaki her şeye çalışma alanı, öğesi ve yoluna göre başvurabilirsiniz:
https://onelake.dfs.fabric.microsoft.com/<workspace>/<item>.<itemtype>/<path>/<fileName>
Dekont
Öğe adlarını birden çok öğe türü arasında yeniden kullanabileceğiniz için, uzantıda öğe türünü belirtmeniz gerekir. Örneğin, .lakehouse bir göl evi ve .datawarehouse bir depo için.
OneLake, genel olarak benzersiz tanımlayıcılara (GUID) sahip çalışma alanlarına ve öğelere başvurmayı da destekler. OneLake, çalışma alanı veya öğe adı değişse bile GUID'leri atar ve GUID'ler değişmez. Çalışma alanınızın veya öğenizin ilişkili GUID'sini Yapı portalındaki URL'de bulabilirsiniz. Hem çalışma alanı hem de öğe için GUID kullanmalısınız ve öğe türüne ihtiyacınız yoktur.
https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>
ADLS 2. Nesil yerine OneLake üzerinden kullanmak üzere bir araç benimserken aşağıdaki eşlemeyi kullanın:
- Hesap adı her zaman
onelakeşeklindedir. - Kapsayıcı adı çalışma alanı adınızdır.
- Veri yolu öğeden başlar. Örneğin:
/mylakehouse.lakehouse/Files/.
OneLake, ADLS 2. Nesil ve Azure Blob Depolama ile daha fazla uyumluluk için Azure Blob Dosya Sistemi sürücüsünü (ABFS) de destekler. ABFS sürücüsü, ADLS 2. Nesil hesaplarındaki dosya ve dizinleri ele almak için kendi düzen tanımlayıcısını abfs ve farklı bir URI biçimini kullanır. OneLake üzerinde bu URI biçimini kullanmak için dosya sistemi için çalışma alanını değiştirin ve öğe ve öğe türünü ekleyin.
abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>
Yetkilendirme
Yetkilendirme üst bilgilerinden geçerek Microsoft Entra Kimliğini kullanarak OneLake API'lerinin kimliğini doğrulayabilirsiniz. Bir araç, belirteç geçişini etkinleştirmek için Azure hesabınızda oturum açmayı destekliyorsa herhangi bir aboneliği seçebilirsiniz. OneLake yalnızca kullanıcı belirtecinizi gerektirir ve Azure aboneliğinizi umursamaz.
OneLake'i doğrudan DFS API'leri aracılığıyla çağırırken, Microsoft Entra hesabınız için taşıyıcı belirteçle kimlik doğrulaması yapabilirsiniz. Kuruluşunuz için taşıyıcı belirteçleri isteme ve yönetme hakkında daha fazla bilgi edinmek için Microsoft Kimlik Doğrulama Kitaplığı'na göz atın.
OneLake'in doğrudan API çağrıları kullanılarak hızlı ve geçici bir şekilde test edilmesi için Azure hesabınızda oturum açmak, depolama kapsamlı bir belirteç almak ve başka bir yerde kolayca kullanmak üzere panonuza kopyalamak için PowerShell'i kullanmanın basit bir örneği aşağıda verilmiştir. PowerShell kullanarak erişim belirteçlerini alma hakkında daha fazla bilgi için bkz . Get-AzAccessToken.
Dekont
OneLake yalnızca hedef kitledeki Storage belirteçleri destekler. Aşağıdaki örnekte, izleyiciyi parametresi aracılığıyla ResourceTypeName ayarlayacağız.
az login --allow-no-subscriptions
$testToken = Get-AzAccessToken -ResourceTypeName Storage
$testToken.Token | Set-Clipboard
Veri yerleşimi
OneLake şu anda genel uç noktayı (https://onelake.dfs.fabric.microsoft.com ) kullanırken belirli bir bölgede veri yerleşimi garantisi vermemektedir. Çalışma alanınızın bölgesinden farklı bir bölgedeki verileri sorguladığınızda, uç nokta çözümleme işlemi sırasında verilerin bölgenizden ayrılma olasılığı vardır. Veri yerleşimi konusunda endişeleriniz varsa, çalışma alanınız için doğru bölgesel uç noktayı kullanmak verilerinizin geçerli bölgede kalmasını ve bölgesel sınırları aşmamasını sağlar. Çalışma alanının bağlı olduğu kapasitenin bölgesini denetleyerek doğru bölgesel uç noktayı keşfedebilirsiniz.
OneLake bölgesel uç noktalarının tümü aynı biçimi izler: https://<region>-onelake.dfs.fabric.microsoft.com. Örneğin, Batı ABD 2 bölgesindeki bir kapasiteye bağlı çalışma alanına bölgesel uç nokta https://westus-onelake.dfs.fabric.microsoft.comüzerinden erişilebilir.
Genel sorunlar
ADLS 2. Nesil ile uyumlu bir araç veya paket OneLake üzerinde çalışmıyorsa en yaygın sorun URL doğrulamasıdır. OneLake, ADLS 2. Nesil' den farklı bir uç nokta (dfs.fabric.microsoft.comdfs.core.windows.net) kullandığından, bazı araçlar OneLake uç noktasını tanımaz ve bunu engellemez. Bazı araçlar özel uç noktaları (PowerShell gibi) kullanmanıza olanak sağlar. Aksi takdirde, OneLake'in uç noktasını desteklenen bir uç nokta olarak eklemek genellikle basit bir düzeltmedir. BIR URL doğrulama sorunu bulursanız veya OneLake'e bağlanırken başka sorunlarla karşılaşırsanız bize bildirin.
Örnekler
Dosya oluşturma
| İste | KOYMAK https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file |
|---|---|
| Üst bilgiler | Authorization: Bearer <userAADToken> |
| Yanıt | ResponseCode:201 CreatedBaşlıklar: x-ms-version : 2021-06-08x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67bx-ms-content-crc64 : OAJ6r0dQWP0=x-ms-request-server-encrypted : trueETag : 0x8DA58EE365Gövde: |
İlgili içerik
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin