OneLake ve Azure Data Lake Depolama (ADLS) 2. Nesil API eşliği

  • Makale

OneLake, Azure Data Lake Depolama (ADLS) 2. Nesil ile aynı API'leri destekler ve kullanıcıların bugün zaten kullandıkları araçlarla OneLake'te verilerini okumasına, yazmasına ve yönetmesine olanak tanır. OneLake yönetilen, mantıksal bir veri gölü olduğundan, bazı özellikler Azure Depolama'dan farklı yönetilir ve tüm davranışlar OneLake üzerinden desteklenmez. Bu sayfada OneLake tarafından yönetilen klasörler, API farklılıkları ve açık kaynak uyumluluğu dahil olmak üzere bu farklılıklar ayrıntılı olarak verilmiştir.

Yönetilen OneLake klasörleri

Doku kiracınızdaki çalışma alanları ve veri öğeleri OneLake'in yapısını tanımlar. Çalışma alanlarını ve öğeleri yönetme işlemi Doku deneyimleri aracılığıyla yapılır- OneLake, ADLS 2. Nesil API'leri aracılığıyla çalışma alanları veya öğelerin oluşturulmasını, güncelleştirilmesini veya silinmesini desteklemez. Doku yönetim portalında kiracıda ve çalışma alanlarında değişiklik yapmanız gerektiğinden, OneLake yalnızca çalışma alanı (kapsayıcı) düzeyinde ve kiracı (hesap) düzeyinde HEAD çağrılarına izin verir.

OneLake ayrıca Yapı öğeleri için bir klasör yapısı uygulayarak öğeleri ve bunların yönetilen alt klasörlerini ADLS 2. Nesil API'leri aracılığıyla oluşturma, silme veya yeniden adlandırmaya karşı korur. Doku tarafından yönetilen klasörler, bir öğedeki en üst düzey klasörü (örneğin, /MyLakehouse.lakehouse) ve içindeki ilk klasör düzeyini (örneğin, /MyLakehouse.lakehouse/Files ve /MyLakehouse.lakehouse/Tables) içerir.

Bu yönetilen klasörlerde oluşturulan herhangi bir klasörde veya dosyada CRUD işlemleri gerçekleştirebilir ve çalışma alanı ve öğe klasörleri üzerinde salt okunur işlemler gerçekleştirebilirsiniz.

Desteklenmeyen istek üst bilgileri ve parametreleri

Kullanıcı tarafından oluşturulan dosya ve klasörlerde bile OneLake, ADLS 2. Nesil API'leri aracılığıyla bazı Doku yönetim işlemlerini kısıtlar. İzinleri güncelleştirmek veya öğeleri ve çalışma alanlarını düzenlemek için Doku deneyimlerini kullanmanız gerekir ve Doku, erişim katmanları gibi diğer seçenekleri yönetir.

OneLake, ADLS 2. Nesil ile aynı üst bilgilerin neredeyse tümünü kabul eder ve yalnızca OneLake'te kaydedilmemiş eylemlerle ilgili bazı üst bilgileri yoksayır. Bu üst bilgiler çağrının tamamının davranışını değiştirmediğinden, OneLake yasaklanmış üst bilgileri yoksayar, bunları yeni bir 'x-ms-rejected-headers' yanıt üst bilgisinde döndürür ve çağrının geri kalanına izin verir. Örneğin OneLake, Put çağrısında 'x-ms-owner' parametresini yoksayar çünkü Fabric ve OneLake, Azure Depolama ile aynı kullanıcı sahibi olma kavramına sahip değildir.

Sorgu parametreleri çağrının tamamının davranışını değiştirdiğinden OneLake, izin verilmeyen sorgu parametreleri içeren istekleri reddeder. Örneğin, OneLake Azure Depolama API'leri aracılığıyla erişim denetimini ayarlamayı hiçbir zaman desteklemediğinden 'setAccessControl' parametresine sahip UPDATE çağrıları engellenir.

OneLake aşağıdaki davranışlara ve ilişkili istek üst bilgilerine ve URI parametrelerine izin vermez:

  • Erişim denetimini ayarlama
    • URI Parametresi:
      • eylem: setAccessControl (İstek reddedildi)
      • eylem: setAccessControlRecursive (İstek reddedildi)
    • İstek üst bilgileri:
      • x-ms-owner (Üst bilgi yoksayıldı)
      • x-ms-group (Üst bilgi yoksayıldı)
      • x-ms-permissions (Üst bilgi yoksayıldı)
      • x-ms-group (Üst bilgi yoksayıldı)
      • x-ms-acls (Üst bilgi yoksayıldı)
  • Şifreleme kapsamını ayarlama
    • İstek üst bilgileri:
      • x-ms-encryption-key (Üst bilgi yoksayıldı)
      • x-ms-encryption-key (Üst bilgi yoksayıldı)
      • x-ms-encryption-algorithm:AES256 (Üst bilgi yoksayıldı)
  • Erişim katmanını ayarlama
    • İstek üst bilgileri:
      • x-ms-access-tier (Üst bilgi yoksayıldı)

Yanıt üst bilgisi farklılıkları

OneLake ADLS 2. Nesil'den farklı bir izin modeli kullandığından, izinlerle ilgili yanıt üst bilgileri farklı şekilde işlenir:

  • OneLake'in sahip kullanıcıları veya grupları olmadığından 'x-ms-owner' ve 'x-ms-group' her zaman '$superuser' döndürür
  • OneLake'in sahip olduğu kullanıcılar, gruplar veya genel erişim izinleri olmadığından 'x-ms-permissions' her zaman '---------' döndürür
  • 'x-ms-acl', 'rwx' biçiminde posix erişim denetim listesine (ACL) dönüştürülen çağıran kullanıcının Doku izinlerini döndürür

Açık Kaynak Tümleştirmesi

OneLake, ADLS 2. Nesil ile aynı API'leri desteklediğinden, ADLS 2. Nesil ile uyumlu birçok açık kaynak kitaplığı ve paketi OneLake ile sorunsuz bir şekilde çalışır. Diğer kitaplıklar, OneLake uç noktalarını veya diğer uyumluluk sorunlarını karşılamak için küçük güncelleştirmeler gerektirebilir. Son değişiklikler nedeniyle aşağıdaki kitaplıkların OneLake ile uyumlu olduğu onaylanır. Bu liste kapsamlı değildir:

Örnekler

Çalışma alanı içindeki öğeleri listeleme

GET https://onelake.dfs.fabric.microsoft.com/myWorkspace?resource=filesystem&recursive=false

Göl evinde klasör oluşturma

PUT https://onelake.dfs.fabric.microsoft.com/myWorkspace/myLakehouse.Lakehouse/Files/newFolder/?resource=directory

İlgili içerik