Aracılığıyla paylaş


AzCopy’yi kullanmaya başlama

AzCopy, depolama hesaplarından, depolama hesaplarına veya depolama hesapları arasında veri kopyalamak için kullanabileceğiniz bir komut satırı yardımcı programıdır. Bu makale AzCopy'yi indirmenize, depolama hesabınıza bağlanmanıza ve verileri aktarmanıza yardımcı olur.

AzCopy v10 , şu anda desteklenen AzCopy sürümüdür. Yalnızca resmi olarak bakımı yapılan Windows, Linux veya macOS sürümlerinde desteklenir. AzCopy'nin önceki bir sürümünü kullanmanız gerekiyorsa, bu makalenin AzCopy'nin önceki sürümünü kullanma bölümüne bakın.

AzCopy kullanım örnekleri

Verilerinizi Azure depolama hesaplarına, kaynak hesaplarına veya azure hesapları arasında kopyalamak için AzCopy kullanın. Yaygın kullanım örnekleri şunlardır:

  • Şirket içi kaynaktan Azure depolama hesabına veri kopyalama
  • Azure depolama hesabından şirket içi kaynağa veri kopyalama
  • Bir depolama hesabından başka bir depolama hesabına veri kopyalama

AzCopy, belirli komutlar ve seçeneklerle her kullanım örneğini destekler. Örneğin, AzCopy'nin verileri kopyalamaya ve eşitlemeye yönelik yerel komutları vardır ve bu da verileri tek seferlik kopyalama etkinlikleri ve devam eden eşitleme senaryoları için esnek bir araç haline getirir. Azure Blob Depolama veya Azure Dosyalar gibi belirli depolama hizmetlerini hedefleyebilir ve bunlar arasında kopyalama da yapabilirsiniz. Örneğin, Verileri Azure Blob Depolama kapsayıcılarından Azure Dosya paylaşımlarına veya tam tersi olarak kopyalayabilirsiniz.

Veri aktarımı kılavuzlarının tam listesi için bu makalenin Veri aktarımı bölümüne bakın.

AzCopy'i edinin

Linux makinesinde AzCopy kullanıyorsanız paket yöneticisini kullanabilirsiniz. Diğer tüm işletim sistemleri için taşınabilir bir ikili dosya indirin. AzCopy sürümleri hakkında ayrıntılı bilgi için AzCopy yayın sayfasına bakın.

Paket yöneticisi kullanma (yalnızca Linux)

Linux dağıtımınızın paket yöneticisi aracılığıyla AzCopy'yi yüklemek en kullanışlı ve sürdürülebilir yaklaşımdır. Paket yöneticisi yüklemesi otomatik bağımlılık çözümlemesi, basitleştirilmiş güncelleştirmeler ve sisteminizin yazılım yönetimiyle tümleştirme sağlar. Adım adım yönergeler için bkz. Paket yöneticisi kullanarak Linux'ta AzCopy'yi yükleme.

Taşınabilir bir ikili dosya indir

Yükleme paketi yalnızca Linux için kullanılabilir. Diğer tüm işletim sistemleri için AzCopy v10 yürütülebilir dosyasını bilgisayarınızdaki herhangi bir dizine indirin.

Bu dosyalar zip dosyası (Windows ve macOS) veya tar dosyası (Linux) olarak sıkıştırılır. Linux'ta tar dosyasını indirmek ve açmak için Linux dağıtımınızın belgelerine bakın.

AzCopy'yi sistem yolunuza ekleme

Kolaylık sağlamak için AzCopy yürütülebilir dosyasının dizin konumunu sistem yolunuza eklemeyi göz önünde bulundurun. Bu ekleme, sisteminizdeki herhangi bir dizinden yazmanızı azcopy sağlar. AzCopy dizinini çevre yolunuza eklemezseniz, AzCopy yürütülebilir dosyanızın bulunduğu dizine geçmeniz ve bir komut kabuğuna azcopy veya .\azcopy yazmanız gerekir.

AzCopy'ye yetki ver

Azure Depolama hesabınızın sahibi olarak verilere erişmek için size otomatik olarak izinler atanmıyor. AzCopy ile anlamlı bir şey yapabilmeniz için önce depolama hizmetine yetkilendirme kimlik bilgilerini nasıl sağlayacağınıza karar vermeniz gerekir. Kimlik bilgilerini Microsoft Entra Id veya SAS belirteci kullanarak sağlayabilirsiniz.

Microsoft Entra ID ile yetkilendirme

Microsoft Entra Id kullanarak, her komuta sas belirteci eklemek yerine kimlik bilgilerini bir kez sağlarsınız. Yetkilendirmek istediğiniz güvenlik sorumlusu türünü seçerek başlayın. Kılavuz olarak aşağıdaki tabloyu kullanın.

Güvenlik sorumlusu Guidance
Kullanıcı kimliği Kullanıcı kimliğiyle AzCopy erişimini yetkilendirme
İdare edilen kimlik Yönetilen kimlikle AzCopy erişimini yetkilendirme
Servis Principal Hizmet sorumlusuyla AzCopy için erişimi yetkilendirme

SAS belirteci ile yetkilendirme

AzCopy komutlarınızda kullandığınız her kaynak veya hedef URL'ye bir SAS belirteci ekleyin. Bu örnek komut, verileri yerel dizinden bir blob kapsayıcısına yinelemeli 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 edinebileceğiniz hakkında daha fazla bilgi edinmek için bkz . Paylaşılan erişim imzalarını (SAS) kullanma.

Veri aktarma

Kimliğinizi yetki verdikten veya SAS belirteci aldıktan sonra veri aktarmaya başlayabilirsiniz.

Örnek komutlar için bu makalelerden herhangi birine bakın.

Hizmet Makale
Azure Blob Depolama Azure Blob Depolama'ya dosya yükleme
Azure Blob Depolama Blobları Azure Blob Depolama'dan indirme
Azure Blob Depolama Blobları Azure depolama hesapları arasında kopyalama
Azure Blob Depolama Azure Blob Depolama ile senkronize et
Azure Dosyaları AzCopy ve dosya depolama ile veri aktarma
Amazon S3 Amazon S3'ten Azure Depolama'ya veri kopyalama
Google Cloud Storage Google Cloud Storage'dan Azure Depolama'ya veri kopyalama (önizleme)
Azure Stack depolama AzCopy ve Azure Stack depolama ile veri aktarma

AzCopy komutlarını etkileşimli olarak çalıştırabilirsiniz. AzCopy'yi toplu işlemler, zamanlanmış veri aktarımları veya sürekli tümleştirme işlem hatları için otomatik betiklere de dahil edebilirsiniz. Daha fazla bilgi için bkz. Betiklerde ve zamanlanmış aktarımlarda AzCopy kullanma.

Not

AzCopy, aktarım sırasında kaynağın veya hedefin etkin olarak değiştirildiği senaryoları desteklemez.

Komut yardımı 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 komut adını ekleyin (örneğin: azcopy list -h).

Satır içi yardım

Komut listesi

Aşağıdaki tabloda tüm AzCopy v10 komutları listelendi. Her komut bir başvuru makalesine bağlanır.

Komut Açıklama
azcopy bench (performans testi için kullanılan bir komut) Test verilerini belirtilen bir konuma yükleyerek veya indirerek performans karşılaştırması çalıştırır.
azcopy kopyala Kaynak verileri hedef konuma kopyalar.
azcopy dokümanı Araç için Markdown biçiminde belgeler oluşturur.
azcopy env AzCopy'nin davranışını yapılandırabilen ortam değişkenlerini gösterir.
azcopy işleri İşleri yönetmeyle ilgili alt komutlar.
azcopy görevlerini temizle Tüm işler için tüm günlük ve plan dosyalarını kaldırır.
azcopy iş listesini görüntüle Tüm işler hakkındaki bilgileri görüntüler.
azcopy jobs komutunu kaldır Verilen iş kimliğiyle ilişkili tüm dosyaları kaldırır.
azcopy işleri özgeçmişi Verilen iş kimliğiyle var olan işi sürdürür.
azcopy işlerini göster Verilen iş kimliği için ayrıntılı bilgileri gösterir.
azcopy listesi Belirli bir kaynaktaki varlıkları listeler.
azcopy login Azure Depolama kaynaklarına erişmek için Microsoft Entra Id'de oturum açar.
azcopy oturum açma durumu Belirli bir kaynaktaki varlıkları listeler.
azcopy çıkış Kullanıcının oturumunu kapatıp Azure Depolama kaynaklarına erişimi sonlandırır.
azcopy make Bir kapsayıcı veya dosya paylaşımı oluşturur.
azcopy remove komutu (verileri kaldırmak için) Azure depolama hesabından blobları veya dosyaları siler.
azcopy sync Kaynak yerini hedef yerine kopyalar.
azcopy set-properties Bir veya daha fazla blobun erişim katmanını değiştirir ve bir veya daha fazla blobun meta verilerini ve dizin etiketlerini değiştirir (üzerine yazar).

Not

AzCopy'nin dosyaları yeniden adlandırmak için bir komutu yoktur.

Yapılandırma, iyileştirme ve düzeltme

Aşağıdaki kaynaklardan herhangi birine bakın:

Sonraki adımlar

Sorularınız, sorunlarınız veya genel geri bildiriminiz varsa bunları GitHub'da gönderin.