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>
Not
Öğ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>
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.
Not
OneLake yalnızca Storage
hedef kitlesindeki belirteçleri destekler. Aşağıdaki örnekte, ResourceTypeName
parametresi aracılığıyla izleyiciyi ayarlıyoruz.
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.com
dfs.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:
Örnekler
Dosya oluşturma
İstek |
KOYMAK https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file |
---|---|
Üst bilgiler | Authorization: Bearer <userAADToken> |
Response |
ResponseCode:201 Created Başlıklar: 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 Gövde: |