Aracılığıyla paylaş


AzCopy

AzCopy, Azure Depolama hesapları arasında veri aktarımını kolaylaştırmak için tasarlanmış güçlü bir komut satırı yardımcı programıdır. Microsoft OneLake, Azure Depolama ile aynı API'leri, SDK'ları ve araçları desteklediğinden, OneLake'e ve OneLake'den veri yüklemek için AzCopy'yi de kullanabilirsiniz. Bu makale, yapıtlar arasında veri kopyalamadan verileri karşıya yüklemeye veya indirmeye kadar AzCopy'yi OneLake ile kullanmanıza yardımcı olur.

AzCopy ve OneLake neden kullanılır?

AzCopy, büyük ölçekli veri taşıma ve büyük ölçekli veri düzlemi işlemleri için iyileştirilmiştir. Verileri depolama hesapları (OneLake dahil) arasında kopyaladığınızda, veriler doğrudan depolama sunucusundan depolama sunucusuna taşınır ve performans sorunlarını en aza indirir. AzCopy ayrıca ağ kesintilerini ve yeniden denemeleri işlemek için yerleşik mekanizmalarla kullanımı kolay ve güvenilirdir. AzCopy ile verileri OneLake'e yüklemek veya mevcut kaynaklardan doğrudan Doku'daki öğelerinize veri yüklemek kolaydır!

Güvenilen çalışma alanı erişimi ve AzCopy

Güvenilen çalışma alanı erişimi, Azure Depolama hesabında bir kaynak örneği kuralı yapılandırarak güvenlik duvarı etkinleştirilmiş Azure Depolama hesaplarına güvenli bir şekilde erişmenizi sağlar. Bu kural, özel Doku çalışma alanınızın kısayollar, işlem hatları ve AzCopy gibi belirli Doku deneyimlerinden depolama hesabının güvenlik duvarına erişmesini sağlar. AzCopy, güvenilir çalışma alanı erişimini yapılandırarak güvenlik duvarı etkinleştirilmiş bir Azure Depolama hesabındaki verileri güvenlik duvarı korumalarını etkilemeden OneLake'e kopyalayabilir. Güvenilen çalışma alanı erişimi hakkında daha fazla bilgi edinin.

Getting Started

AzCopy'yi kullanmaya yeni başladıysanız AzCopy'yi indirmeyi ve kullanmaya başlamayı AzCopy'yi kullanmaya başlama bölümünden öğrenebilirsiniz.

AzCopy'yi OneLake ile kullandığınızda, anımsamanız gereken birkaç önemli nokta vardır:

  1. --trusted-microsoft-suffixes parametresini kullanarak "fabric.microsoft.com" öğesini güvenilen etki alanı olarak ekleyin.
  2. OneLake yalnızca kiracıyı önemsediği için Microsoft Entra Kimliğinizle oturum açarken kaynak Azure Depolama hesabınızın aboneliğini seçin.
  3. Komut isteminde AzCopy kullanırken çift tırnak, PowerShell'de ise tek tırnak kullanın.

Bu makaledeki örneklerde, Microsoft Entra Id'nizin hem kaynak hem de hedeflere erişmek için uygun izinlere sahip olduğu da varsayılır.

Son olarak, veri taşımanız için en az bir kaynak ve hedefe ihtiyacınız vardır. Bu sayfadaki örneklerde iki Fabric lakehouse ve bir ADLS hesabı kullanılır.

Örnek: Fabric çalışma alanları arasında veri kopyalama

Azcopy copy komutunu kullanarak bir çalışma alanında bulunan bir göl evinden farklı bir çalışma alanına dosya kopyalamak için bu örneği kullanın. önce komutunu çalıştırarak azcopy login kimlik doğrulamayı unutmayın.

Syntax


azcopy copy "https://onelake.dfs.fabric.microsoft.com/<source-workspace-name>/<source-item-name>/Files/<source-file-path>" "https://onelake.dfs.fabric.microsoft.com/<destination-workspace-name>/<destination-item-name>/Files/<destination-file-path>" --trusted-microsoft-suffixes "fabric.microsoft.com" 

Kopyalama işlemi zaman uyumlu olduğundan, komut döndürdüğünde tüm dosyalar kopyalanır.

Örnek: Paylaşılan erişim imzalarıyla (SAS) ADLS'den OneLake'e veri kopyalama

Paylaşılan erişim imzası (SAS), Azure Depolama ve OneLake'e kısa süreli, temsilci erişimi sağlar ve araçlara veya kullanıcılara tek seferlik karşıya yükleme veya indirme işlemleri için depolamaya geçici erişim sağlamak için harika bir seçenektir. Kiracılar farklıysa Entra yetkilendirmesi çalışmayacağı için, Azure Depolama hesabı OneLake'inizden farklı bir kiracıdaysa SAS de harika bir seçenektir.

Bu örnek, hem Azure Depolama'da hem de OneLake'de kimlik doğrulaması yapmak için benzersiz bir SAS belirteci kullanır. Azure Depolama ve OneLake ile SAS belirteçleri oluşturma ve kullanma hakkında daha fazla bilgi edinmek için aşağıdaki sayfalara göz atın:

Note

AzCopy'de OneLake'te kimlik doğrulaması yapmak için SAS belirteci kullanırken , '''-s2s-preserve-access-tier' parametresini false olarak ayarlamanız gerekir.


azcopy copy "https://<account-name>.blob.core.windows.net/<source-container-name>/<source-file-path>?<blob-sas-token>" "https://onelake.dfs.fabric.microsoft.com/<destination-workspace-name>/<destination-item-name>/Files/<destination-file-path>?<onelake-sas-token>" --trusted-microsoft-suffixes "fabric.microsoft.com" --s2s-preserve-access-tier=false

Limitations

OneLake yönetilen bir veri gölü olduğundan, bazı işlemler AzCopy ile desteklenmez. Örneğin, öğeleri veya çalışma alanlarının tamamını taşımak veya kopyalamak için AzCopy kullanamazsınız. Bunun yerine, bir Doku deneyimi (portal gibi) kullanarak hedef konumunuzdaki yeni öğeyi oluşturun ve mevcut öğenin içeriğini yeni öğeye taşımak için AzCopy kullanın.

Kiracılar arası işlemler

İşlemleri doğrudan iki Doku kiracısı arasında gerçekleştirmeye çalışırken dış veri paylaşımını kullanmanız gerekir. Bu, şu anda iki Fabric kiracısı arasında doğrudan veri aktarmak için AzCopy'yi kullanamayacağınız anlamına gelir, çünkü bu, doğrudan bir kiracılar arası işlem gerçekleştirir. Verileri yerel olarak veya Spark kümesine indirme ve ardından verileri yeni kiracıya yeniden yükleme gibi diğer veri yükleme yöntemleri çalışır.