Microsoft OneLake'e bağlanma

Microsoft OneLake, mevcut Azure Data Lake Storage (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 Doku deneyimleri aracılığıyla yapılmalıdır ve ADLS 2. Nesil API'leri aracılığıyla yapılamaz. 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ı, öğe ve yolu ile başvurabilirsiniz.

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

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>

Abfs sürücü URI'si, çalışma alanı adında boşluklar gibi özel karakterlere izin vermez. Bu gibi durumlarda, bu bölümün önceki bölümlerinde açıklandığı gibi genel olarak benzersiz tanımlayıcılara (GUID) sahip çalışma alanlarına ve öğelere başvurabilirsiniz.

Yetkilendirme

Yetkilendirme üst bilgisini geçirerek Microsoft Entra Kimliğini kullanarak OneLake API'lerini doğrulayabilirsiniz. Azure hesabınızda oturum açmayı destekleyen bir araç varsa ve token aktarımını etkinleştirmek istiyorsanız, 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'i hızlı ve geçici bir şekilde, doğrudan API çağrıları ile test etmek için, Azure hesabınıza PowerShell kullanarak oturum açmanın, depolama için belirlenmiş bir belirteç elde etmenin ve bunu başka bir yerde kolayca kullanmak üzere panoya kopyalamanı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.

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

Veri yerleşimi

Çalışma alanınızın bölgesinden farklı bir bölgedeki verileri sorgulamak için genel uç noktayı (https://onelake.dfs.fabric.microsoft.com'') kullanırsanız, 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 bölgesindeki bir kapasiteye bağlı bir ç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.

Kaynaklar

OneLake'e ADLS 2. Nesil ile aynı API'ler ve SDK'lar aracılığıyla erişilebilir. ADLS 2. Nesil API'lerini kullanma hakkında daha fazla bilgi edinmek için lütfen aşağıdaki sayfalara bakın:

• ADLS 2. Nesil API Başvurusu
• ADLS 2. Nesil Dosya Sistemi SDK'ları
  • .NET
  • Python
  • Java

Örnekler

Dosya oluşturma

İlgili içerik

• OneLake eşitlik ve entegrasyon
• Python ile OneLake'e bağlanma
• Azure Synapse Analytics ile OneLake tümleştirmesi