AzCopy’yi kullanmaya başlama
AzCopy, bir depolama hesabına iki yönlü blob veya dosya kopyalama işlemi gerçekleştirmenizi sağlayan bir komut satırı yardımcı programıdır. Bu makale AzCopy programını indirme, depolama hesabınıza bağlama ve dosyaları aktarma aşamalarında size yardımcı olur.
Not
AzCopy ile v10 arasındaki , şu anda desteklenen AzCopy sürümüdür.
AzCopy 'in önceki bir sürümünü kullanmanız gerekiyorsa, bu makalenin AzCopy 'in önceki sürümünü kullanma bölümüne bakın.
AzCopy indirin
İlk olarak, AzCopy Ile v10 arasındaki çalıştırılabilir dosyasını bilgisayarınızdaki herhangi bir dizine indirin. AzCopy Ile v10 arasındaki yalnızca yürütülebilir bir dosyadır, bu nedenle yüklenecek bir şey yoktur.
- Windows 64-bit (zip)
- Windows 32-bit (zip)
- Linux x86-64 (tar)
- MacOS (zip)
bu dosyalar bir zıp dosyası (Windows ve Mac) veya bir tar dosyası (Linux) olarak sıkıştırılır. IK dosyasını Linux üzerinde indirip sıkıştırmasını açmak için Linux dağıtımına yönelik belgelere bakın.
Not
Azure Tablo depolama hizmetinize veri kopyalamak Istiyorsanız, azcopy sürüm 7,3' yi de yükleyebilirsiniz.
AzCopy programını çalıştırma
Kolaylık sağlamak için AzCopy yürütülebilir dosyanızın bulunduğu dizini sistem yolunuza ekleyebilirsiniz. Bu şekilde, azcopy sisteminizdeki herhangi bir dizinden yazabilirsiniz.
yolunuza azcopy dizinini eklememayı seçerseniz, dizinleri azcopy yürütülebilir dosyanızın konumuyla değiştirmeniz ve azcopy .\azcopy Windows PowerShell komut istemleri yazmanız gerekir.
Azure Depolama hesabınızın sahibi olarak, verilere erişim için otomatik olarak izinler atanmamıştır. AzCopy ile anlamlı bir işlem yapabilmeniz için, depolama hizmetine yetkilendirme kimlik bilgilerini nasıl sağlayacağınıza karar vermeniz gerekir.
AzCopy yetkilendir
yetkilendirme kimlik bilgilerini Azure Active Directory (AD) kullanarak veya paylaşılan erişim imzası (SAS) belirteci kullanarak sağlayabilirsiniz.
Bu tabloyu kılavuz olarak kullan:
| Depolama türü | Şu anda desteklenen yetkilendirme yöntemi |
|---|---|
| Blob depolama | Azure AD ve SAS |
| BLOB depolama (hiyerarşik ad alanı) | Azure AD ve SAS |
| Dosya depolama | Yalnızca SAS |
Seçenek 1: Azure Active Directory kullanın
bu seçenek yalnızca blob Depolama için kullanılabilir. Azure Active Directory kullanarak, her komuta bir SAS belirteci eklemek yerine kimlik bilgilerini bir kez sağlayabilirsiniz.
Not
Geçerli sürümde, blob 'ları depolama hesapları arasında kopyalamayı planlıyorsanız, her kaynak URL 'ye bir SAS belirteci eklemeniz gerekir. SAS belirtecini yalnızca hedef URL 'den atlayabilirsiniz. Örnekler için bkz. depolama hesapları arasında blobları kopyalama.
Azure AD 'yi kullanarak erişim yetkisi vermek için bkz. AzCopy ve Azure Active Directory (Azure AD) ile bloblara erişim yetkisi verme.
2. seçenek: SAS belirteci kullanma
AzCopy komutlarınız içinde kullanılan her kaynak veya hedef URL 'ye bir SAS belirteci ekleyebilirsiniz.
Bu örnek komut, verileri bir yerel dizinden bir blob kapsayıcısına özyinelemeli olarak kopyalar. Kapsayıcı URL 'sinin sonuna kurgusal bir SAS belirteci eklenir.
azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true
SAS belirteçleri ve nasıl elde edileceği hakkında daha fazla bilgi edinmek için bkz. paylaşılan erişim Imzalarını kullanma (SAS).
Not
Depolama hesabının Güvenli aktarım gerekli ayarı, bir depolama hesabı bağlantısının aktarım katmanı GÜVENLIĞI (TLS) ile güvenli olup olmadığını belirler. Bu ayar varsayılan olarak etkindir.
Veri aktarma
Kimliğinizi yetkilendirdikten veya bir SAS belirteci elde ettikten sonra, veri aktarmaya başlayabilirsiniz.
Örnek komutları bulmak için Bu makalelerden birine bakın.
| Hizmet | Makale |
|---|---|
| Azure Blob Depolama | Dosyalarını Azure Blob Depolama'ya yükleme |
| Azure Blob Depolama | blob 'ları Azure Blob 'dan indir Depolama |
| Azure Blob Depolama | Blobları farklı Azure depolama hesaplarına kopyalama |
| Azure Blob Depolama | Azure Blob Depolama ile eşitleme |
| Azure Dosyaları | AzCopy ve dosya depolama ile verileri aktarma |
| Amazon S3 | Amazon S3 'ten Azure 'a veri kopyalama Depolama |
| Google Cloud Storage | Google Cloud Depolama 'den Azure Depolama 'a veri kopyalama (önizleme) |
| Azure Stack depolama | AzCopy ve Azure Stack Storage ile veri aktarımı |
Komut yardımını al
Komutların listesini görmek için yazın azcopy -h ve ENTER tuşuna basın.
Belirli bir komut hakkında bilgi edinmek için, yalnızca komutun adını ekleyin (örneğin: azcopy list -h ).
Komutların listesi
Aşağıdaki tabloda tüm AzCopy ile v10 arasındaki komutları listelenmektedir. Her komut bir başvuru makalesine bağlanır.
| Komut | Açıklama |
|---|---|
| azcopy ortamı | Belirli bir konumdan veya belirtilen bir konumdan test verilerini karşıya yükleyerek ya da indirerek bir performans kıyaslaması çalıştırır. |
| azcopy kopya | Kaynak verileri bir hedef konumuna kopyalar |
| azcopy belge | Markın biçimindeki araç için belgeler oluşturur. |
| azcopy ortamı | AzCopy 'in davranışını yapılandırabileceği ortam değişkenlerini gösterir. |
| azcopy işleri | İşlerin yönetimiyle ilgili alt komutlar. |
| azcopy işleri temizleme | Tüm işler için tüm günlük ve plan dosyalarını kaldırın. |
| azcopy iş listesi | Tüm işlere ilişkin bilgileri görüntüler. |
| azcopy işleri kaldırma | Verilen iş KIMLIĞIYLE ilişkili tüm dosyaları kaldırın. |
| azcopy işleri sürdürme | Verilen iş KIMLIĞI ile mevcut işi sürdürür. |
| azcopy işleri gösterme | Verilen iş KIMLIĞI için ayrıntılı bilgileri gösterir. |
| azcopy load | Belirli biçimlerde veri aktarmayla ilgili alt bilgiler. |
| azcopy load clfs | Yerel verileri bir Kapsayıcıya aktarır ve Microsoft'un Avere Cloud FileSystem (CLFS) biçiminde depolar. |
| azcopy listesi | Belirli bir kaynakta yer alan varlıkları listeler. |
| azcopy oturum açma | Azure kaynak Azure Active Directory erişmek için Depolama oturumlar. |
| azcopy oturumu kapatma | Kullanıcının günlüklerini günlüğe kaydeder ve Azure Depolama sonlandırılır. |
| azcopy oluşturma | Bir kapsayıcı veya dosya paylaşımı oluşturur. |
| azcopy kaldırma | Azure depolama hesabından blobları veya dosyaları silme. |
| azcopy eşitleme | Kaynak konumu hedef konuma çoğaltır. |
Not
AzCopy'nin dosyaları yeniden adlandırmak için bir komutu yok.
Betikte kullanma
Statik indirme bağlantısı alma
Zaman içinde, AzCopy indirme bağlantısı AzCopy'nin yeni sürümlerine işaret edilir. Betiğiniz AzCopy'i indirirse, azcopy'nin daha yeni bir sürümü betiğinizin bağlı olduğu özellikleri değişirse betik çalışmayı durdurabilir.
Bu sorunları önlemek için, AzCopy'nin geçerli sürümüne statik (değişmeyen) bir bağlantı alın. Bu şekilde, betiğiniz her çalıştırıla aynı AzCopy sürümünü indirir.
Bağlantıyı almak için şu komutu çalıştırın:
| İşletim sistemi | Komut |
|---|---|
| Linux | curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location |
| Windows | (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location |
Not
Linux için, komutta sürüm adını içeren üst düzey klasörü kaldırır ve bunun yerine ikili dosyayı --strip-components=1 tar doğrudan geçerli klasöre ayıklar. Bu, betiğin yeni bir sürümüyle güncelleştirilerek yalnızca azcopy URL'yi güncelleştirmesini wget sağlar.
URL, bu komutun çıkışında görünür. Betiğiniz daha sonra bu URL'yi kullanarak AzCopy'yi indirebilir.
| İşletim sistemi | Komut |
|---|---|
| Linux | wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1 |
| Windows | Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>> |
SAS belirteçleri içinde kaçış özel karakterleri
Uzantıya sahip toplu .cmd iş dosyalarında SAS belirteçleri içinde % görünen karakterlerden kaçış karakteri gerekir. Sas belirteci dizesinde var olan % karakterlerin yanına % ek bir karakter ekleyerek bunu yapabiliriz.
Jenkins kullanarak betikleri çalıştırma
Betikleri çalıştırmak için Jenkins kullanmayı planlıyorsanız, betiğin başına aşağıdaki komutu yer alan emin olun.
/usr/bin/keyctl new_session
Azure Depolama Gezgini'de kullanma
Depolama Gezgini tüm veri aktarımı işlemlerini gerçekleştirmek için AzCopy kullanır. AzCopy Depolama Gezgini nin performans avantajlarından faydalanmayı tercih ediyorsanız, ancak dosyalarınız ile etkileşim kurmak için komut satırı yerine grafik kullanıcı arabirimi kullanmayı tercih ediyorsanız bu komutu kullanabilirsiniz.
Depolama Gezgini işlemleri gerçekleştirmek için hesap anahtarınızı kullanır, bu nedenle Depolama Gezgini oturum Depolama Gezgini yetkilendirme kimlik bilgileri sağlamanız gerek yoktur.
Yapılandırma, iyileştirme ve düzeltme
Aşağıdaki kaynaklara bakın:
Önceki bir sürümü kullanma
AzCopy'nin önceki sürümünü kullanmak için aşağıdaki bağlantılardan birini kullanın:
Sonraki adımlar
Sorularınız, sorunlarınız veya genel geri bildirimleriniz varsa bunları GitHub gönderin.