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 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>

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 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.

Connect-AzAccount
$testToken = Get-AzAccessToken -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.

Örnekler

Dosya oluşturma

İlgili içerik

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