Aracılığıyla paylaş

AzCopy’yi kullanmaya başlama

  • Makale

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'yi indirmenize, depolama hesabınıza bağlanmanıza ve ardından verileri aktarmanıza yardımcı olur.

Not

AzCopy V10 , azCopy'nin şu anda desteklenen sürümüdür.

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.

Bu videoda AzCopy yardımcı programını indirme ve çalıştırma işlemi gösterilmektedir.

Videodaki adımlar aşağıdaki bölümlerde de açıklanmıştır.

AzCopy için kullanım örnekleri

AzCopy, verilerinizi Azure depolama hesaplarına, buradan veya azure depolama hesapları arasında kopyalamak için kullanılabilir. 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

Bu kullanım örneklerinin her biri benzersiz seçeneklere sahiptir. Örneğin, AzCopy'nin verileri kopyalamak ve/veya eşitlemek için yerel komutları vardır. Bu, AzCopy'nin tek seferlik kopyalama etkinlikleri ve devam eden eşitleme senaryoları için kullanılabilecek esnek bir araç olmasını sağlar. AzCopy ayrıca Azure Blob Depolama veya Azure Dosyalar gibi belirli depolama hizmetlerini hedeflemenizi sağlar. Bu, verileri blobdan dosyaya, dosyadan bloba, dosyadan dosyaya vb. kopyalamanızı sağlar.

Bu senaryolar hakkında daha fazla bilgi edinmek için bkz:

Not

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

Paket yöneticisi kullanarak Linux'a AzCopy yükleme

AzCopy'yi, Microsoft Ürünleri için Linux Yazılım Deposu'nda barındırılan bir Linux paketi kullanarak yükleyebilirsiniz.

  1. Depo yapılandırma paketini indirin.

    Önemli

    Dağıtımı ve sürümü uygun dizelerle değiştirdiğinden emin olun.

    curl -sSL -O https://packages.microsoft.com/config/<distribution>/<version>/packages-microsoft-prod.rpm

  2. Depo yapılandırma paketini yükleyin.

    sudo rpm -i packages-microsoft-prod.rpm

  3. Depo yapılandırma paketini yükledikten sonra silin.

    rm packages-microsoft-prod.rpm

  4. Paket dizini dosyalarını güncelleştirin.

    sudo dnf update

  5. AzCopy'yi yükleyin.

    sudo dnf install azcopy

AzCopy taşınabilir ikili dosyasını indirme

Paket yüklemeye alternatif olarak, AzCopy V10 yürütülebilir dosyasını bilgisayarınızdaki herhangi bir dizine indirebilirsiniz.

Bu dosyalar zip dosyası (Windows ve Mac) 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 sürümleri hakkında ayrıntılı bilgi için AzCopy yayın sayfasına bakın.

Not

Azure Tablo depolama hizmetinize ve azuredan veri kopyalamak istiyorsanız AzCopy sürüm 7.3'ü yükleyin.

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 sisteminizdeki herhangi bir dizinden yazabilirsiniz azcopy .

AzCopy dizinini yolunuza eklememeyi seçerseniz dizinleri AzCopy yürütülebilir dosyanızın konumuna değiştirmeniz ve Windows PowerShell komut istemlerini yazmanız azcopy gerekir .\azcopy .

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.

AzCopy'ye yetki ver

Yetkilendirme kimlik bilgilerini Microsoft Entra Id veya Paylaşılan Erişim İmzası (SAS) belirteci kullanarak sağlayabilirsiniz.

Seçenek 1: Microsoft Entra Id kullanma

Microsoft Entra Id kullanarak, her komuta bir SAS belirteci eklemek yerine kimlik bilgilerini bir kez sağlayabilirsiniz.

Seçenek 2: SAS belirteci kullanma

AzCopy komutlarınızda kullanılan her kaynak veya hedef URL'ye bir SAS belirteci ekleyebilirsiniz.

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.

Not

Depolama hesabının Güvenli aktarım gerekli ayarı, 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 SAS belirteci aldıktan sonra veri aktarmaya başlayabilirsiniz.

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

Hizmet Makale
Azure Blob Storage Dosyalarını Azure Blob Depolama'ya yükleme
Azure Blob Storage blobları Azure Blob Depolama'dan indirme
Azure Blob Storage Blobları farklı Azure depolama hesaplarına kopyalama
Azure Blob Storage Azure Blob Depolama ile eşitleme
Azure Dosyaları AzCopy ve dosya depolama ile verileri 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

Komut yardımı alma

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 komutun adını eklemeniz (ö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 Test verilerini belirtilen bir konuma yükleyerek veya indirerek performans karşılaştırması çalıştırır.
azcopy copy Kaynak verileri hedef konuma kopyalar
azcopy belgesi 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 işleri temizleme Tüm işler için tüm günlük ve plan dosyalarını kaldırın.
azcopy işleri listesi Tüm işler hakkındaki 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 özgeçmişi Verilen iş kimliğiyle var olan işi sürdürür.
azcopy işleri 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 oturumu kapatma 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 Azure depolama hesabından blobları veya dosyaları silme.
azcopy sync Kaynak konumu hedef konuma çoğaltır.
azcopy set-properties Bir veya daha fazla blobun erişim katmanını değiştirin ve meta verileri ve bir veya daha fazla blobun dizin etiketlerini değiştirin (üzerine yazın).

Not

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

Betikte kullanma

Zaman içinde AzCopy indirme bağlantısı AzCopy'nin yeni sürümlerine işaret eder. Betiğinizin AzCopy'yi indirmesi halinde, AzCopy'nin daha yeni bir sürümü betiğinizin bağımlı olduğu özellikleri değiştirirse betik çalışmayı durdurabilir.

Bu sorunları önlemek için AzCopy'nin güncel sürümüne statik (değişmeyen) bir bağlantı alın. Bu şekilde, betiğiniz her çalıştırıldığında AzCopy'nin tam olarak aynı sürümünü indirir.

Bağlantıyı edinmek için şu komutu çalıştırın:

İşletim sistemi Komut
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux \| grep ^Location
Windows PowerShell (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue).headers.location
PowerShell 6.1+ (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue -SkipHttpErrorCheck).headers.location

Not

Linux için, --strip-components=1 komutunda tar sürüm adını içeren üst düzey klasörü kaldırır ve bunun yerine ikili dosyayı doğrudan geçerli klasöre ayıklar. Bu, betiğin yalnızca URL güncelleştirilerek yeni sürümüyle azcopy güncelleştirilmesini wget sağlar.

URL, bu komutun çıkışında görünür. Betiğiniz bu URL'yi kullanarak AzCopy'yi indirebilir.

Linux

wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1

Windows PowerShell

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\'
$AzCopy = (Get-ChildItem -path '.\' -Recurse -File -Filter 'azcopy.exe').FullName
# Invoke AzCopy 
& $AzCopy

PowerShell 6.1+

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
$AzCopy = (Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\' -PassThru | where-object {$_.Name -eq 'azcopy.exe'}).FullName
# Invoke AzCopy
& $AzCopy

SAS belirteçlerindeki kaçış özel karakterleri

Uzantıya sahip toplu iş dosyalarında .cmd SAS belirteçlerinde görünen karakterlerden kaçmanız % gerekir. SAS belirteci dizesindeki mevcut % karakterlerin yanına fazladan % bir karakter ekleyerek bunu yapabilirsiniz. Sonuçta elde edilen karakter dizisi olarak %%görünür. Karakter dizisini ^&oluşturmak için her & karakterden önce bir ek ^ eklediğinizden emin olun.

Jenkins kullanarak betik çalıştırma

Betikleri çalıştırmak için Jenkins kullanmayı planlıyorsanız betiğin başına aşağıdaki komutu yerleştirdiğinizden 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'nin performans avantajlarını uygulamak istiyorsanız Depolama Gezgini kullanabilirsiniz, ancak dosyalarınızla etkileşimde bulunmak için komut satırı yerine grafik kullanıcı arabirimi kullanmayı tercih edebilirsiniz.

Depolama Gezgini işlemleri gerçekleştirmek için hesap anahtarınızı kullandığı için Depolama Gezgini oturum açtığınızda ek yetkilendirme kimlik bilgileri sağlamanız gerekmez.

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

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

Önceki bir sürümü kullanma (kullanım dışı)

AzCopy'nin önceki sürümünü kullanmanız gerekiyorsa aşağıdaki bağlantılardan birini inceleyin:

Not

Bu AzCopy sürümleri kullanım dışı bırakılmıştır. Microsoft, AzCopy v10'un kullanılmasını önerir.

Sonraki adımlar

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