Windows üzerinde AzCopy v8.1 ile veri aktarma

  • Makale

AzCopy, en iyi performans için tasarlanmış basit komutları kullanarak Microsoft Azure Blob, Dosya ve Tablo depolama alanına/depolamadan veri kopyalamak için tasarlanmış bir komut satırı yardımcı programıdır. Bir dosya sistemi ile depolama hesabı arasında veya depolama hesapları arasında verileri kopyalayabilirsiniz.

Önemli

Bu makalede AzCopy'nin eski bir sürümü açıklanmaktadır. AzCopy'nin en son sürümünü yüklemek için bkz. AzCopy v10.

AzCopy'nin eski sürümünü (AzCopy v8.1) yüklemeyi seçerseniz, indirebileceğiniz birden çok sürüm vardır. Windows üzerinde AzCopy, Windows stili komut satırı seçenekleri sunar. Linux üzerinde AzCopy , POSIX stili komut satırı seçenekleri sunan Linux platformlarını hedefler. Bu makale, Windows üzerinde AzCopy'i kapsar.

Windows'da AzCopy 'yi (v8.1) indirme ve yükleme

Windows'da AzCopy'yi (v8.1) indirin.

Windows 8.1 Sürüm Notlarında AzCopy

  • Tablo hizmeti artık en son sürümde desteklenmiyor. Tablo dışarı aktarma özelliğini kullanıyorsanız AzCopy 7.3 sürümünü indirin.
  • .NET Core 2.1 ile derlenir ve tüm .NET Core bağımlılıkları artık yüklemede paketlenir.
  • OAuth kimlik doğrulaması desteği eklendi. Azure Active Directory kullanarak oturum açmak için kullanın azcopy login .

Tablo desteğiyle Azcopy (v7.3)

Tablo desteği ile AzCopy 7.3'i indirin.

Yükleme Sonrası Adımı

Yükleyiciyi kullanarak AzCopy'yi Windows'a yükledikten sonra bir komut penceresi açın ve yürütülebilir dosyanın bulunduğu AzCopy.exe bilgisayarınızda AzCopy yükleme dizinine gidin. İsterseniz AzCopy yükleme konumunu sistem yolunuza ekleyebilirsiniz. Varsayılan olarak, AzCopy veya %ProgramFiles%\Microsoft SDKs\Azure\AzCopyöğesine %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy yüklenir.

İlk AzCopy komutunuzu yazma

AzCopy komutlarının temel söz dizimi şu şekildedir:

AzCopy /Source:<source> /Dest:<destination> [Options]

Aşağıdaki örneklerde Microsoft Azure Blobları, Dosyalar ve Tablolar'a veri kopyalamaya yönelik çeşitli senaryolar gösterilmektedir. Her örnekte kullanılan parametrelerin ayrıntılı açıklaması için AzCopy Parametreleri bölümüne bakın.

Blob depolamadan blob indirme

Şimdi AzCopy kullanarak blob indirmenin çeşitli yollarını inceleyelim.

Tek bir blob indirme

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

Klasör C:\myfolder yoksa AzCopy tarafından oluşturulur ve yeni klasöre indirilir abc.txt .

İkincil bölgeden tek bir blob indirme

AzCopy /Source:https://myaccount-secondary.blob.core.windows.net/mynewcontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

İkincil bölgeye erişmek için okuma erişimli coğrafi olarak yedekli depolamanın etkinleştirilmiş olması gerektiğini unutmayın.

Kapsayıcıdaki tüm blobları indirme

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /S

Aşağıdaki blobların belirtilen kapsayıcıda yer aldığını varsayalım:

abc.txt
abc1.txt
abc2.txt
vd1\a.txt
vd1\abcd.txt

İndirme işleminden sonra dizin C:\myfolder aşağıdaki dosyaları içerir:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\vd1\a.txt
C:\myfolder\vd1\abcd.txt

seçeneğini /Sbelirtmezseniz, hiçbir blob indirılmaz.

Belirli bir ön eke sahip blobları indirme

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:a /S

Aşağıdaki blobların belirtilen kapsayıcıda yer aldığını varsayalım. Ön ek a ile başlayan tüm bloblar indirilir:

abc.txt
abc1.txt
abc2.txt
xyz.txt
vd1\a.txt
vd1\abcd.txt

İndirme işleminden sonra klasör C:\myfolder aşağıdaki dosyaları içerir:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

Ön ek, blob adının ilk bölümünü oluşturan sanal dizine uygulanır. Yukarıda gösterilen örnekte, sanal dizin belirtilen ön ek ile eşleşmediğinden indirilmez. Ayrıca, seçenek /S belirtilmezse AzCopy herhangi bir blob indirmez.

Dışarı aktarılan dosyaların son değiştirme zamanını kaynak bloblarla aynı olacak şekilde ayarlama

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT

Blobları son değiştirme zamanına göre indirme işleminin dışında tutabilirsiniz. Örneğin, son değiştirme zamanı hedef dosyayla aynı veya daha yeni olan blobları dışlamak istiyorsanız şu seçeneği ekleyin /XN :

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XN

Son değiştirme zamanı hedef dosyayla aynı veya daha eski olan blobları dışlamak istiyorsanız şu seçeneği ekleyin /XO :

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XO

Blobları Blob depolamaya yükleme

Şimdi AzCopy kullanarak blobları karşıya yüklemenin çeşitli yollarını inceleyelim.

Tek bir blobu karşıya yükleme

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:"abc.txt"

Belirtilen hedef kapsayıcı mevcut değilse, AzCopy bu kapsayıcıyı oluşturur ve dosyayı kapsayıcıya yükler.

Sanal dizine tek bir blob yükleme

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer/vd /DestKey:key /Pattern:abc.txt

Belirtilen sanal dizin yoksa, AzCopy sanal dizini adına eklemek için dosyayı karşıya yükler (örneğin, vd/abc.txt yukarıdaki örnekte).

Klasördeki tüm blobları karşıya yükleme

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /S

Seçeneğin /S belirtilmesi, belirtilen dizinin içeriğini Yinelemeli olarak Blob depolamaya yükler; bu da tüm alt klasörlerin ve dosyalarının da karşıya yüklendiği anlamına gelir. Örneğin, aşağıdaki dosyaların klasöründe C:\myfolderyer aldığını varsayalım:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

Karşıya yükleme işleminden sonra kapsayıcı aşağıdaki dosyaları içerir:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

seçeneğini /Sbelirtmezseniz, AzCopy özyinelemeli olarak karşıya yüklemez. Karşıya yükleme işleminden sonra kapsayıcı aşağıdaki dosyaları içerir:

abc.txt
abc1.txt
abc2.txt

Belirli bir desenle eşleşen blobları karşıya yükleme

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:a* /S

Aşağıdaki dosyaların klasöründe C:\myfolderyer aldığını varsayalım:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\xyz.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

Karşıya yükleme işleminden sonra kapsayıcı aşağıdaki dosyaları içerir:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

seçeneğini /Sbelirtmezseniz, AzCopy yalnızca sanal dizinde bulunmayan blobları karşıya yükler:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

Hedef blobun MIME içerik türünü belirtme

Varsayılan olarak, AzCopy hedef blobun içerik türünü olarak application/octet-streamayarlar. 3.1.0 sürümünden başlayarak, seçeneği /SetContentType:[content-type]aracılığıyla içerik türünü açıkça belirtebilirsiniz. Bu söz dizimi, karşıya yükleme işlemindeki tüm bloblar için içerik türünü ayarlar.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType:video/mp4

Değer olmadan belirtirseniz /SetContentType , AzCopy her blob veya dosyanın içerik türünü dosya uzantısına göre ayarlar.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType

Blob depolamada blobları kopyalama

Şimdi AzCopy kullanarak blobları bir konumdan diğerine kopyalamanın çeşitli yollarını inceleyelim.

Aynı depolama hesabındaki tek bir blobu bir kapsayıcıdan diğerine kopyalama

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceKey:key /DestKey:key /Pattern:abc.txt

Depolama hesabı içindeki bir blobu kopyaladığınızda, sunucu tarafı kopyalama işlemi gerçekleştirilir.

Tek bir blobu bir depolama hesabından diğerine kopyalama

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

Depolama hesapları arasında bir blob kopyaladığınızda, sunucu tarafı kopyalama işlemi gerçekleştirilir.

tek bir blobu ikincil bölgeden birincil bölgeye kopyalama

AzCopy /Source:https://myaccount1-secondary.blob.core.windows.net/mynewcontainer1 /Dest:https://myaccount2.blob.core.windows.net/mynewcontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

İkincil depolamaya erişmek için okuma erişimli coğrafi olarak yedekli depolamanın etkinleştirilmiş olması gerektiğini unutmayın.

Tek bir blobu ve anlık görüntülerini bir depolama hesabından diğerine kopyalama

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt /Snapshot

Kopyalama işleminden sonra hedef kapsayıcı blobu ve anlık görüntülerini içerir. Yukarıdaki örnekteki blob iki anlık görüntüye sahip olduğu varsayıldığında kapsayıcı aşağıdaki blobu ve anlık görüntüleri içerir:

abc.txt
abc (2013-02-25 080757).txt
abc (2014-02-21 150331).txt

Kapsayıcıdaki tüm blobları başka bir depolama hesabına kopyalama

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 
/Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /S

/S seçeneği belirtildiğinde belirtilen kapsayıcının içeriği yinelemeli olarak karşıya yüklenir. Daha fazla bilgi ve örnek için bkz. Klasördeki tüm blobları karşıya yükleme .

Blobları bir depolama hesabından diğerine zaman uyumlu olarak kopyalama

AzCopy varsayılan olarak verileri iki depolama uç noktası arasında zaman uyumsuz olarak kopyalar. Bu nedenle, kopyalama işlemi bir blobun ne kadar hızlı kopyalandığı açısından SLA'sı olmayan yedek bant genişliği kapasitesi kullanılarak arka planda çalışır ve AzCopy, kopyalama tamamlanana veya başarısız olana kadar düzenli aralıklarla kopyalama durumunu denetler.

seçeneği /SyncCopy , kopyalama işleminin tutarlı hıza sahip olmasını sağlar. AzCopy, belirtilen kaynaktan yerel belleğe kopyalanacak blobları indirip blob depolama hedefine yükleyerek zaman uyumlu kopyayı gerçekleştirir.

AzCopy /Source:https://myaccount1.blob.core.windows.net/myContainer/ /Dest:https://myaccount2.blob.core.windows.net/myContainer/ /SourceKey:key1 /DestKey:key2 /Pattern:ab /SyncCopy

/SyncCopy zaman uyumsuz kopyaya kıyasla ek çıkış maliyeti oluşturabilir. Önerilen yaklaşım, çıkış maliyetini önlemek için bu seçeneği kaynak depolama hesabınızla aynı bölgede yer alan bir Azure VM'de kullanmaktır.

Dosyaları Dosya depolama alanından indirme

Şimdi AzCopy kullanarak dosya indirmenin çeşitli yollarını inceleyelim.

Tek bir dosya indirme

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/myfolder1/ /Dest:C:\myfolder /SourceKey:key /Pattern:abc.txt

Belirtilen kaynak bir Azure dosya paylaşımıysa, tek bir dosyayı indirmek için tam dosya adını (örneğinabc.txt) belirtmeniz veya paylaşımdaki tüm dosyaları özyinelemeli olarak indirme seçeneğini /S belirtmeniz gerekir. Hem dosya deseni hem de seçeneği /S birlikte belirtme girişimi hatayla sonuçlanır.

Dizindeki tüm dosyaları indirme

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/ /Dest:C:\myfolder /SourceKey:key /S

Boş klasörlerin indirilmediğini unutmayın.

Azure dosya paylaşımına dosya yükleme

Şimdi AzCopy kullanarak dosyaları karşıya yüklemenin çeşitli yollarını inceleyelim.

Tek bir dosyayı karşıya yükleme

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:abc.txt

Klasördeki tüm dosyaları karşıya yükleme

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /S

Boş klasörlerin karşıya yüklenmediğini unutmayın.

Belirli bir desenle eşleşen dosyaları karşıya yükleme

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:ab* /S

Dosya depolamadaki dosyaları kopyalama

Şimdi AzCopy kullanarak Azure dosya paylaşımındaki dosyaları kopyalamanın çeşitli yollarını inceleyelim.

Bir dosya paylaşımından diğerine kopyalama

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S

Bir dosyayı dosya paylaşımları arasında kopyaladığınızda, sunucu tarafı kopyalama işlemi gerçekleştirilir.

Azure dosya paylaşımından Blob depolamaya kopyalama

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare/ /Dest:https://myaccount2.blob.core.windows.net/mycontainer/ /SourceKey:key1 /DestKey:key2 /S

Bir dosyayı dosya paylaşımından bloba kopyaladığınızda, sunucu tarafı kopyalama işlemi gerçekleştirilir.

Blob depolamadan Azure dosya paylaşımına blob kopyalama

AzCopy /Source:https://myaccount1.blob.core.windows.net/mycontainer/ /Dest:https://myaccount2.file.core.windows.net/myfileshare/ /SourceKey:key1 /DestKey:key2 /S

Bir blobdan dosya paylaşımına dosya kopyaladığınızda, sunucu tarafı kopyalama işlemi gerçekleştirilir.

Dosyaları zaman uyumlu olarak kopyalama

Dosya Depolama'dan Dosya Depolama'ya, Dosya Depolama'dan Blob Depolama'ya ve Blob Depolama'dan Dosya Depolama'ya zaman uyumlu olarak veri kopyalama seçeneğini belirtebilirsiniz /SyncCopy , AzCopy bunu kaynak verileri yerel belleğe indirip yeniden hedefe yükleyerek yapar. Standart çıkış maliyeti geçerlidir.

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S /SyncCopy

Dosya depolamadan Blob depolamaya kopyalarken varsayılan blob türü blok blobudur; kullanıcı hedef blob türünü değiştirme seçeneğini /BlobType:page belirtebilir.

/SyncCopy Zaman uyumsuz kopyaya kıyasla ek çıkış maliyetleri oluşturabileceğini unutmayın. Önerilen yaklaşım, çıkış maliyetini önlemek için kaynak depolama hesabınızla aynı bölgede yer alan Azure VM'de bu seçeneği kullanmaktır.

Tablo depolamadan verileri dışarı aktarma

Şimdi AzCopy kullanarak Azure Tablo depolamadan verileri dışarı aktarmaya göz atalım.

Tabloyu dışarı aktarma

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key

AzCopy belirtilen hedef klasöre bir bildirim dosyası yazar. Bildirim dosyası, gerekli veri dosyalarını bulmak ve veri doğrulama gerçekleştirmek için içeri aktarma işleminde kullanılır. Bildirim dosyası varsayılan olarak aşağıdaki adlandırma kuralını kullanır:

<account name>_<table name>_<timestamp>.manifest

Kullanıcı bildirim dosyası adını ayarlama seçeneğini /Manifest:<manifest file name> de belirtebilir.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /Manifest:abc.manifest

Tablo depolamadan dışarı aktarmayı birden çok dosyaya bölme

AzCopy /Source:https://myaccount.table.core.windows.net/mytable/ /Dest:C:\myfolder /SourceKey:key /S /SplitSize:100

AzCopy, birden çok dosyayı ayırt etmek için bölünmüş veri dosyası adlarında birim dizini kullanır. Birim dizini iki bölümden oluşur: bölüm anahtarı aralığı dizini ve bölünmüş dosya dizini. Her iki dizin de sıfır tabanlıdır.

Kullanıcı seçeneğini /PKRSbelirtmezse bölüm anahtarı aralığı dizini 0 olur.

Örneğin, AzCopy'nin kullanıcı seçeneğini /SplitSizebelirtdikten sonra iki veri dosyası oluşturacağı varsayılır. Sonuçta elde edilen veri dosyası adları şu olabilir:

myaccount_mytable_20140903T051850.8128447Z_0_0_C3040FE8.json
myaccount_mytable_20140903T051850.8128447Z_0_1_0AB9AC20.json

Seçenek /SplitSize için mümkün olan en düşük değerin 32 MB olduğunu unutmayın. Belirtilen hedef Blob depolama ise, Kullanıcı tarafından seçenek /SplitSize belirtilip belirtilmediğinden bağımsız olarak AzCopy, boyutları blob boyutu sınırlamasına (200 GB) ulaştığında veri dosyasını böler.

Tabloyu JSON veya CSV veri dosyası biçimine aktarma

Varsayılan olarak, AzCopy tabloları JSON veri dosyalarına aktarır. Tabloları JSON veya CSV olarak dışarı aktarma seçeneğini /PayloadFormat:JSON|CSV belirtebilirsiniz.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PayloadFormat:CSV

AzCopy, CSV yük biçimini belirtirken her veri dosyası için dosya uzantısına .schema.csv sahip bir şema dosyası da oluşturur.

Tablo varlıklarını eşzamanlı olarak dışarı aktarma

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PKRS:"aa#bb"

Kullanıcı seçeneğini /PKRSbelirttiğinde AzCopy varlıkları dışarı aktarmak için eşzamanlı işlemler başlatır. Her işlem bir bölüm anahtarı aralığını dışarı aktarır.

Eşzamanlı işlem sayısının seçeneğiyle /NCde denetlendiğini unutmayın. AzCopy, belirtilmemiş olsa /NC bile tablo varlıklarını kopyalarken varsayılan değeri /NC olarak çekirdek işlemci sayısını kullanır. Kullanıcı seçeneğini /PKRSbelirttiğinde, AzCopy başlatacak eşzamanlı işlemlerin sayısını belirlemek için iki değerin küçük olan bölüm anahtarı aralıklarını örtük veya açıkça belirtilen eşzamanlı işlemlere karşı kullanır. Daha fazla ayrıntı için komut satırına yazın AzCopy /?:NC .

Tabloyu Blob depolamaya aktarma

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:https://myaccount.blob.core.windows.net/mycontainer/ /SourceKey:key1 /Destkey:key2

AzCopy, blob kapsayıcısına aşağıdaki adlandırma kuralına sahip bir JSON veri dosyası oluşturur:

<account name>_<table name>_<timestamp>_<volume index>_<CRC>.json

Oluşturulan JSON veri dosyası, en az meta veri için yük biçimini izler. Bu yük biçimiyle ilgili ayrıntılar için bkz. Tablo Hizmeti İşlemleri için Yük Biçimi.

Tabloları bloblara aktarırken AzCopy'nin Tablo varlıklarını yerel geçici veri dosyalarına indirdiğini ve ardından bu varlıkları bloba yüklediğini unutmayın. Bu geçici veri dosyaları" varsayılan yolu%LocalAppData%\Microsoft\Azure\AzCopy ile günlük dosyası klasörüne konur, günlük dosyası klasörünün konumunu değiştirmek ve böylece geçici veri dosyalarının konumunu değiştirmek için /Z:[journal-file-folder] seçeneğini belirtebilirsiniz. Geçici veri dosyalarının boyutu tablo varlıklarınızın boyutuna ve /SplitSize seçeneğiyle belirttiğiniz boyuta göre belirlenir, ancak yerel diskteki geçici veri dosyası bloba yüklendikten sonra anında silinir, ancak silinmeden önce bu geçici veri dosyalarını depolamak için yeterli yerel disk alanınız olduğundan emin olun.

Tablo depolama alanına veri aktarma

Şimdi AzCopy kullanarak Azure Tablo depolama alanına veri aktarmaya göz atalım.

Tabloyu içeri aktarma

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.table.core.windows.net/mytable1/ /DestKey:key /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:InsertOrReplace

seçeneği /EntityOperation , tabloya varlıkların nasıl ekleyebileceğinizi gösterir. Olası değerler şunlardır:

  • InsertOrSkip: Varolan bir varlığı atlar veya tabloda yoksa yeni bir varlık ekler.
  • InsertOrMerge: Varolan bir varlığı birleştirir veya tabloda yoksa yeni bir varlık ekler.
  • InsertOrReplace: Varolan bir varlığı değiştirir veya tabloda yoksa yeni bir varlık ekler.

İçeri aktarma senaryosunda seçeneği /PKRS belirtemeyeceğinizi unutmayın. Eşzamanlı işlemleri başlatma seçeneğini /PKRS belirtmeniz gereken dışarı aktarma senaryosundan farklı olarak, tabloyu içeri aktardığınızda AzCopy varsayılan olarak eşzamanlı işlemleri başlatır. Başlatılan varsayılan eş zamanlı işlem sayısı, çekirdek işlemci sayısına eşittir; ancak, seçeneğiyle /NCfarklı sayıda eş zamanlı belirtebilirsiniz. Daha fazla ayrıntı için komut satırına yazın AzCopy /?:NC .

AzCopy'nin CSV için değil yalnızca JSON için içeri aktarmayı desteklediğini unutmayın. AzCopy, kullanıcı tarafından oluşturulan JSON ve bildirim dosyalarından tablo içeri aktarmayı desteklemez. Bu dosyaların her ikisi de AzCopy tablosu dışarı aktarma işlemiyle alınmalıdır. Hataları önlemek için lütfen dışarı aktarılan JSON veya bildirim dosyasını değiştirmeyin.

Blob depolamadan bir tabloya varlık aktarma

Blob kapsayıcısının aşağıdakileri içerdiğini varsayın: Azure Tablosunu ve buna eşlik eden bildirim dosyasını temsil eden bir JSON dosyası.

myaccount_mytable_20140103T112020.manifest
myaccount_mytable_20140103T112020_0_0_0AF395F1DC42E952.json

Bu blob kapsayıcısındaki bildirim dosyasını kullanarak varlıkları tabloya aktarmak için aşağıdaki komutu çalıştırabilirsiniz:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:https://myaccount.table.core.windows.net/mytable /SourceKey:key1 /DestKey:key2 /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:"InsertOrReplace"

Diğer AzCopy özellikleri

Şimdi diğer Bazı AzCopy özelliklerine göz atalım.

Yalnızca hedefte mevcut olmayan verileri kopyalama

/XO ve /XN parametreleri, sırasıyla eski veya daha yeni kaynak kaynaklarını kopyalanmaktan dışlamanıza olanak sağlar. Yalnızca hedefte mevcut olmayan kaynak kaynakları kopyalamak istiyorsanız, AzCopy komutunda her iki parametreyi de belirtebilirsiniz:

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /XO /XN

/Source:C:\myfolder /Dest:http://myaccount.file.core.windows.net/myfileshare /DestKey:<destkey> /S /XO /XN

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:http://myaccount.blob.core.windows.net/mycontainer1 /SourceKey:<sourcekey> /DestKey:<destkey> /S /XO /XN

Kaynak veya hedef bir tablo olduğunda bunun desteklenmediğini unutmayın.

Komut satırı parametrelerini belirtmek için yanıt dosyası kullanma

AzCopy /@:"C:\responsefiles\copyoperation.txt"

Yanıt dosyasına herhangi bir AzCopy komut satırı parametresi ekleyebilirsiniz. AzCopy, komut satırında belirtilmiş gibi dosyasındaki parametreleri işler ve dosyanın içeriğiyle doğrudan değiştirme gerçekleştirir.

aşağıdaki satırları içeren adlı copyoperation.txtbir yanıt dosyası varsayın. Her AzCopy parametresi tek bir satırda belirtilebilir

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

veya ayrı satırlarda:

/Source:http://myaccount.blob.core.windows.net/mycontainer
/Dest:C:\myfolder
/SourceKey:<sourcekey>
/S
/Y

Parametre için burada /sourcekey gösterildiği gibi, parametreyi iki satıra bölerseniz AzCopy başarısız olur:

http://myaccount.blob.core.windows.net/mycontainer
 C:\myfolder
/sourcekey:
<sourcekey>
/S
/Y

Komut satırı parametrelerini belirtmek için birden çok yanıt dosyası kullanma

Kaynak kapsayıcıyı belirten adlı source.txt bir yanıt dosyası varsayın:

/Source:http://myaccount.blob.core.windows.net/mycontainer

Dosya sistemindeki bir hedef klasörü belirten adlı dest.txt bir yanıt dosyası:

/Dest:C:\myfolder

Ve AzCopy seçeneklerini belirten adlı options.txt bir yanıt dosyası:

/S /Y

AzCopy'yi bir dizinde C:\responsefilesbulunan bu yanıt dosyalarıyla çağırmak için şu komutu kullanın:

AzCopy /@:"C:\responsefiles\source.txt" /@:"C:\responsefiles\dest.txt" /SourceKey:<sourcekey> /@:"C:\responsefiles\options.txt"

AzCopy, komut satırına tek tek tüm parametreleri eklediğinizde olduğu gibi bu komutu işler:

AzCopy /Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

Paylaşılan erişim imzası (SAS) belirtme

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceSAS:SAS1 /DestSAS:SAS2 /Pattern:abc.txt

Kapsayıcı URI'sinde bir SAS de belirtebilirsiniz:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1/?SourceSASToken /Dest:C:\myfolder /S

Journal dosya klasörü

AzCopy'ye her komut yayımladığınızda, bir günlük dosyasının varsayılan klasörde mi yoksa bu seçenekle belirttiğiniz bir klasörde mi var olduğunu denetler. Günlük dosyası herhangi bir yerde yoksa, AzCopy işlemi yeni olarak ele alır ve yeni bir günlük dosyası oluşturur.

Günlük dosyası varsa, AzCopy girdiğiniz komut satırının günlük dosyasındaki komut satırıyla eşleşip eşleşmediğini denetler. İki komut satırı eşleşiyorsa, AzCopy tamamlanmamış işlemi sürdürür. Eşleşmiyorsa, yeni bir işlem başlatmak veya geçerli işlemi iptal etmek için günlük dosyasının üzerine yazmanız istenir.

Günlük dosyası için varsayılan konumu kullanmak istiyorsanız:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z

yukarıda gösterildiği gibi, seçeneğini /Zatlarsanız veya klasör yolu olmadan seçeneği /Z belirtirseniz, AzCopy günlük dosyasını varsayılan konumda (olan %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy) oluşturur. Günlük dosyası zaten varsa, AzCopy günlük dosyasını temel alarak işlemi sürdürür.

Günlük dosyası için özel bir konum belirtmek istiyorsanız:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z:C:\journalfolder\

Bu örnek, henüz yoksa günlük dosyasını oluşturur. Varsa, AzCopy işlemi günlük dosyasına göre sürdürür.

AzCopy işlemini sürdürmek istiyorsanız:

AzCopy /Z:C:\journalfolder\

Bu örnek, tamamlanamamış olabilecek son işlemi sürdürür.

Günlük dosyası oluşturma

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V

Ayrıntılı günlüğe dosya yolu sağlamadan seçeneği /V belirtirseniz, AzCopy günlük dosyasını varsayılan konumda (olan %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy) oluşturur.

Aksi takdirde, özel bir konumda günlük dosyası oluşturabilirsiniz:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V:C:\myfolder\azcopy1.log

gibi bir seçeneğini /V/V:test/azcopy1.logizleyen göreli bir yol belirtirseniz, ayrıntılı günlüğün adlı testbir alt klasör içindeki geçerli çalışma dizininde oluşturulduğunu unutmayın.

Başlatılacak eşzamanlı işlemlerin sayısını belirtin

Seçenek /NC , eşzamanlı kopyalama işlemlerinin sayısını belirtir. Varsayılan olarak AzCopy, veri aktarımı aktarım hızını artırmak için belirli sayıda eşzamanlı işlem başlatır. Tablo işlemleri için eşzamanlı işlemlerin sayısı sahip olduğunuz işlemci sayısına eşittir. Blob ve Dosya işlemleri için eş zamanlı işlem sayısı sahip olduğunuz işlemci sayısının 8 katına eşittir. AzCopy'yi düşük bant genişliğine sahip bir ağda çalıştırıyorsanız, kaynak rekabeti nedeniyle oluşan hataları önlemek için /NC için daha düşük bir sayı belirtebilirsiniz.

AzCopy'yi Azure Depolama Öykünücüsü'ne karşı çalıştırma

Bloblar için Azure Depolama Öykünücüsü'ne karşı AzCopy çalıştırabilirsiniz:

AzCopy /Source:https://127.0.0.1:10000/myaccount/mycontainer/ /Dest:C:\myfolder /SourceKey:key /SourceType:Blob /S

Bunu tablolar için de çalıştırabilirsiniz:

AzCopy /Source:https://127.0.0.1:10002/myaccount/mytable/ /Dest:C:\myfolder /SourceKey:key /SourceType:Table

Blobun İçerik Türünü otomatik olarak belirleme

AzCopy, dosya uzantısı eşlemesine içerik türünü depolayan bir JSON dosyasını temel alarak blobun içerik türünü belirler. Bu JSON dosyası AzCopyConfig.json olarak adlandırılır ve AzCopy dizininde bulunur. Listede olmayan bir dosya türünüz varsa eşlemeyi JSON dosyasına ekleyebilirsiniz:

{
  "MIMETypeMapping": {
    ".myext": "text/mycustomtype",
    .
    .
  }
}

AzCopy Parametreleri

AzCopy parametreleri aşağıda açıklanmıştır. AzCopy'yi kullanmayla ilgili yardım için komut satırından aşağıdaki komutlardan birini de yazabilirsiniz:

  • AzCopy ile ilgili ayrıntılı komut satırı yardımı için: AzCopy /?
  • Herhangi bir AzCopy parametresiyle ilgili ayrıntılı yardım için: AzCopy /?:SourceKey
  • Komut satırı örnekleri için: AzCopy /?:Sample

/Source:"source"

Kopyalanacak kaynak verileri belirtir. Kaynak bir dosya sistemi dizini, blob kapsayıcısı, blob sanal dizini, depolama dosya paylaşımı, depolama dosyası dizini veya Azure tablosu olabilir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/Dest:"destination"

Kopyalanacak hedefi belirtir. Hedef bir dosya sistemi dizini, blob kapsayıcısı, blob sanal dizini, depolama dosya paylaşımı, depolama dosyası dizini veya Azure tablosu olabilir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/Pattern:"file-pattern"

Kopyalanacak dosyaları gösteren bir dosya deseni belirtir. /Pattern parametresinin davranışı, kaynak verilerin konumuna ve özyinelemeli mod seçeneğinin varlığına göre belirlenir. Özyinelemeli mod /S seçeneğiyle belirtilir.

Belirtilen kaynak dosya sistemindeki bir dizinse, standart joker karakterler etkindir ve sağlanan dosya deseni dizindeki dosyalarla eşleştirilir. /S seçeneği belirtilirse, AzCopy dizininin altındaki alt klasörlerdeki tüm dosyalarda belirtilen desenle de eşleşir.

Belirtilen kaynak bir blob kapsayıcısı veya sanal dizinse joker karakterler uygulanmaz. /S seçeneği belirtilirse, AzCopy belirtilen dosya desenini blob ön eki olarak yorumlar. /S seçeneği belirtilmezse, AzCopy dosya desenini tam blob adlarından eşleştirir.

Belirtilen kaynak bir Azure dosya paylaşımıysa, tek bir dosyayı kopyalamak için tam dosya adını (örneğin abc.txt) belirtmeniz veya paylaşımdaki tüm dosyaları yinelemeli olarak kopyalamak için /S seçeneğini belirtmeniz gerekir. Hem dosya deseni hem de /S seçeneğinin birlikte belirtilmesi hatayla sonuçlanır.

AzCopy, /Source bir blob kapsayıcısı veya blob sanal dizini olduğunda büyük/küçük harfe duyarlı eşleştirme kullanır ve diğer tüm durumlarda büyük/küçük harfe duyarlı olmayan eşleştirme kullanır.

Hiçbir dosya düzeni belirtilmediğinde kullanılan varsayılan dosya deseni, bir dosya sistemi konumu için veya Azure Depolama konumu için boş bir ön ek için şeklindedir. Birden çok dosya deseni belirtilmesi desteklenmez.

Geçerli olan: Bloblar, Dosyalar

/DestKey:"storage-key"

Hedef kaynağın depolama hesabı anahtarını belirtir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/DestSAS:"sas-token"

Hedef için OKUMA ve YAZMA izinlerine sahip bir Paylaşılan Erişim İmzası (SAS) belirtir (varsa). ÖZEL komut satırı karakterleri içerebileceği için SAS'yi çift tırnak içine alın.

Hedef kaynak bir blob kapsayıcısı, dosya paylaşımı veya tabloysa, bu seçeneği ve ardından SAS belirtecini belirtebilir veya SAS'yi bu seçenek olmadan hedef blob kapsayıcısının, dosya paylaşımının veya tablonun URI'sinin bir parçası olarak belirtebilirsiniz.

Kaynak ve hedef her ikisi de blobsa, hedef blob kaynak blobla aynı depolama hesabında bulunmalıdır.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/SourceKey:"storage-key"

Kaynak kaynağın depolama hesabı anahtarını belirtir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/SourceSAS:"sas-token"

Kaynak için READ ve LIST izinlerine sahip bir Paylaşılan Erişim İmzası belirtir (varsa). ÖZEL komut satırı karakterleri içerebileceği için SAS'yi çift tırnak içine alın.

Kaynak kaynak bir blob kapsayıcısıysa ve anahtar veya SAS sağlanmazsa blob kapsayıcısı anonim erişim aracılığıyla okunur.

Kaynak bir dosya paylaşımı veya tabloysa bir anahtar veya SAS sağlanmalıdır.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/S

Kopyalama işlemleri için özyinelemeli modu belirtir. Özyinelemeli modda AzCopy, alt klasörlerdekiler de dahil olmak üzere belirtilen dosya düzeniyle eşleşen tüm blobları veya dosyaları kopyalar.

Geçerli olan: Bloblar, Dosyalar

/BlobType:"block" | "page" | "ekleme"

Hedef blob'un blok blobu mu, sayfa blobu mu yoksa ekleme blobu mu olduğunu belirtir. Bu seçenek yalnızca bir blobu karşıya yüklerken geçerlidir. Aksi takdirde bir hata oluşturulur. Hedef bir blob ise ve bu seçenek belirtilmezse, AzCopy varsayılan olarak bir blok blobu oluşturur.

Geçerli olan: Blob

/CheckMD5

İndirilen veriler için bir MD5 karması hesaplar ve blobda veya dosyanın Content-MD5 özelliğinde depolanan MD5 karması ile hesaplanan karmanın eşleşip eşleşmediğini doğrular. Değerler eşleşmezse AzCopy verileri indiremeyebilir. MD5 denetimi varsayılan olarak kapalıdır, bu nedenle verileri indirirken MD5 denetimini gerçekleştirmek için bu seçeneği belirtmeniz gerekir.

Azure Depolama'nın blob veya dosya için depolanan MD5 karması'nın güncel olduğunu garanti etmediğini unutmayın. Blob veya dosya her değiştirildiğinde MD5'i güncelleştirmek istemcinin sorumluluğundadır. Disk görüntüleri (yönetilen veya yönetilmeyen diskler) söz konusu olduğunda, Disk içeriği değiştikçe Azure VM'leri MD5 değerini güncelleştirmez, bu nedenle /CheckMD5 disk görüntülerini indirirken bir hata oluşturur.

AzCopy v8, azure blobunu veya dosyasını hizmete yükledikten sonra her zaman Content-MD5 özelliğini ayarlar.

Geçerli olan: Bloblar, Dosyalar

/An -lık görüntü

Anlık görüntülerin aktarılıp aktarılmayacağını gösterir. Bu seçenek yalnızca kaynak bir blob olduğunda geçerlidir.

Aktarılan blob anlık görüntüleri şu biçimde yeniden adlandırılır: blob-name (anlık görüntü zamanı).extension

Varsayılan olarak, anlık görüntüler kopyalanmaz.

Geçerli olan: Blob

/V:[verbose-log-file]

Ayrıntılı durum iletilerini bir günlük dosyasına aktarır.

Varsayılan olarak, ayrıntılı günlük dosyası içindeki %LocalAppData%\Microsoft\Azure\AzCopyAzCopyVerbose.log olarak adlandırılır. Bu seçenek için mevcut bir dosya konumu belirtirseniz, ayrıntılı günlük bu dosyanın sonuna eklenir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/Z:[journal-file-folder]

bir işlemi devam ettiren bir günlük dosyası klasörünü belirtir.

AzCopy, bir işlem kesintiye uğradıysa her zaman devam etme işlemini destekler.

Bu seçenek belirtilmezse veya klasör yolu olmadan belirtilirse, AzCopy günlük dosyasını varsayılan konumda (%LocalAppData%\Microsoft\Azure\AzCopy) oluşturur.

AzCopy'ye her komut verişinizde, bir günlük dosyasının varsayılan klasörde mi yoksa bu seçenekle belirttiğiniz bir klasörde mi bulunduğunu denetler. Günlük dosyası her iki yerde de yoksa, AzCopy işlemi yeni olarak ele alır ve yeni bir günlük dosyası oluşturur.

Günlük dosyası varsa, AzCopy girdiğiniz komut satırının günlük dosyasındaki komut satırıyla eşleşip eşleşmediğini denetler. İki komut satırı eşleşirse, AzCopy tamamlanmamış işlemi sürdürür. Eşleşmiyorsa, yeni bir işlem başlatmak veya geçerli işlemi iptal etmek için günlük dosyasının üzerine yazmanız istenir.

İşlem başarıyla tamamlandıktan sonra günlük dosyası silinir.

AzCopy'nin önceki bir sürümü tarafından oluşturulan bir günlük dosyasından işlem devam ettirilmemektedir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/@:"parameter-file"

Parametreleri içeren bir dosya belirtir. AzCopy, dosyadaki parametreleri komut satırında belirtilmiş gibi işler.

Yanıt dosyasında, tek bir satırda birden çok parametre belirtebilir veya her parametreyi kendi satırında belirtebilirsiniz. Tek bir parametrenin birden çok satıra yayılamayacağını unutmayın.

Yanıt dosyaları# simgesiyle başlayan açıklama satırları içerebilir.

Birden çok yanıt dosyası belirtebilirsiniz. Ancak AzCopy'nin iç içe yanıt dosyalarını desteklemediğini unutmayın.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/Y

Tüm AzCopy onay istemlerini gizler. Bu seçenek, /XO ve /XN belirtilmediğinde veri yükleme senaryoları için yalnızca yazma SAS belirteçlerinin kullanılmasına da izin verir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/L

Yalnızca listeleme işlemini belirtir; hiçbir veri kopyalanır.

AzCopy, komut satırını /L seçeneği olmadan çalıştırmak için bu seçeneğin kullanılmasını benzetimi olarak yorumlar ve kopyalanan nesne sayısını sayar; ayrıntılı günlükte hangi nesnelerin kopyalandığı denetlemek için /V seçeneğini aynı anda belirtebilirsiniz.

Bu seçeneğin davranışı, kaynak verilerin konumuna ve özyinelemeli mod seçeneği /S ve dosya deseni seçeneği /Pattern'in varlığına göre de belirlenir.

AzCopy, bu seçenek kullanılırken bu kaynak konumun LIST ve READ iznini gerektirir.

Geçerli olan: Bloblar, Dosyalar

/MT

İndirilen dosyanın son değiştirme zamanını kaynak blob veya dosyanınkiyle aynı olacak şekilde ayarlar.

Geçerli olan: Bloblar, Dosyalar

/XN

Daha yeni bir kaynak kaynağını dışlar. Kaynağın son değiştirme zamanı hedeften aynı veya daha yeniyse kaynak kopyalanmaz.

Geçerli olan: Bloblar, Dosyalar

/XO

Eski bir kaynak kaynağını dışlar. Kaynağın son değiştirme zamanı hedeften aynı veya daha eskiyse kaynak kopyalanmaz.

Geçerli olan: Bloblar, Dosyalar

/A

Yalnızca Arşiv özniteliği ayarlanmış dosyaları karşıya yükler.

Geçerli olan: Bloblar, Dosyalar

/IA:[RASHCNETOI]

Yalnızca belirtilen özniteliklerden herhangi birinin ayarlandığı dosyaları karşıya yükler.

Kullanılabilir öznitelikler şunlardır:

  • R = Salt okunur dosyalar
  • A = Arşivleme için hazır dosyalar
  • S = Sistem dosyaları
  • H = Gizli dosyalar
  • C = Sıkıştırılmış dosyalar
  • N = Normal dosyalar
  • E = Şifrelenmiş dosyalar
  • T = Geçici dosyalar
  • O = Çevrimdışı dosyalar
  • I = Dizine alınan olmayan dosyalar

Geçerli olan: Bloblar, Dosyalar

/XA:[RASHCNETOI]

Belirtilen özniteliklerden herhangi birinin ayarlandığı dosyaları dışlar.

Kullanılabilir öznitelikler şunlardır:

  • R = Salt okunur dosyalar
  • A = Arşivleme için hazır dosyalar
  • S = Sistem dosyaları
  • H = Gizli dosyalar
  • C = Sıkıştırılmış dosyalar
  • N = Normal dosyalar
  • E = Şifrelenmiş dosyalar
  • T = Geçici dosyalar
  • O = Çevrimdışı dosyalar
  • I = Dizine alınan olmayan dosyalar

Geçerli olan: Bloblar, Dosyalar

/Sınırlayıcı:"sınırlayıcı"

Blob adındaki sanal dizinleri sınırlandırmak için kullanılan sınırlayıcı karakterini gösterir.

Varsayılan olarak, AzCopy sınırlayıcı karakteri olarak / kullanır. Ancak AzCopy, sınırlayıcı olarak herhangi bir ortak karakterin (@, #veya %) gibi) kullanılmasını destekler. Komut satırına bu özel karakterlerden birini eklemeniz gerekiyorsa, dosya adını çift tırnak içine alın.

Bu seçenek yalnızca blobları indirmek için geçerlidir.

Geçerli olan: Blob

/NC:"eşzamanlı işlem sayısı"

Eşzamanlı işlemlerin sayısını belirtir.

AzCopy, veri aktarımı aktarım hızını artırmak için varsayılan olarak belirli sayıda eşzamanlı işlem başlatır. Düşük bant genişliğine sahip bir ortamdaki çok sayıda eşzamanlı işlemin ağ bağlantısını zorlayıp işlemlerin tam olarak tamamlanmasını engelleyebileceğini unutmayın. Gerçek kullanılabilir ağ bant genişliğine göre eşzamanlı işlemleri kısıtlayın.

Eşzamanlı işlemler için üst sınır 512'dir.

Geçerli olan: Bloblar, Dosyalar, Tablolar

/SourceType:"Blob" | "Tablo"

Kaynağın source yerel geliştirme ortamında kullanılabilir ve depolama öykünücüsunda çalışan bir blob olduğunu belirtir.

Geçerli olan: Bloblar, Tablolar

/DestType:"Blob" | "Tablo"

Kaynağın destination yerel geliştirme ortamında kullanılabilir ve depolama öykünücüsunda çalışan bir blob olduğunu belirtir.

Geçerli olan: Bloblar, Tablolar

/PKRS:"key1#key2#key3#..."

Tablo verilerini paralel olarak dışarı aktarmayı etkinleştirmek için bölüm anahtarı aralığını böler ve bu da dışarı aktarma işleminin hızını artırır.

Bu seçenek belirtilmezse, AzCopy tablo varlıklarını dışarı aktarmak için tek bir iş parçacığı kullanır. Örneğin, kullanıcı /PKRS:"aa#bb" belirtirse AzCopy üç eşzamanlı işlem başlatır.

Her işlem, aşağıda gösterildiği gibi üç bölüm anahtarı aralığından birini dışarı aktarır:

[first-partition-key, aa)

[aa, bb)

[bb, last-partition-key]

Geçerli olan: Tablo

/SplitSize:"file-size"

Dışarı aktarılan dosya bölme boyutunu MB cinsinden belirtir; izin verilen en düşük değer 32'dir.

Bu seçenek belirtilmezse, AzCopy tablo verilerini tek bir dosyaya aktarır.

Tablo verileri bir bloba dışarı aktarılırsa ve dışarı aktarılan dosya boyutu blob boyutu için 200 GB sınırına ulaşırsa, bu seçenek belirtilmemiş olsa bile AzCopy dışarı aktarılan dosyayı böler.

Geçerli olan: Tablo

/EntityOperation:"InsertOrSkip" | "InsertOrMerge" | "InsertOrReplace"

Tablo verilerini içeri aktarma davranışını belirtir.

  • InsertOrSkip - Varolan bir varlığı atlar veya tabloda yoksa yeni bir varlık ekler.
  • InsertOrMerge - Varolan bir varlığı birleştirir veya tabloda yoksa yeni bir varlık ekler.
  • InsertOrReplace - Varolan bir varlığı değiştirir veya tabloda yoksa yeni bir varlık ekler.

Geçerli olan: Tablo

/Manifest:"manifest-file"

Tablo dışarı aktarma ve içeri aktarma işlemi için bildirim dosyasını belirtir.

Bu seçenek dışarı aktarma işlemi sırasında isteğe bağlıdır; bu seçenek belirtilmezse AzCopy önceden tanımlanmış ada sahip bir bildirim dosyası oluşturur.

Bu seçenek, veri dosyalarını bulmak için içeri aktarma işlemi sırasında gereklidir.

Geçerli olan: Tablo

/SyncCopy

blobların veya dosyaların iki Azure Depolama uç noktası arasında zaman uyumlu olarak kopyalanıp kopyalanmayacağını gösterir.

AzCopy varsayılan olarak sunucu tarafı zaman uyumsuz kopya kullanır. Blobları veya dosyaları yerel belleğe indiren ve ardından Azure Depolama'ya yükleyen zaman uyumlu bir kopya gerçekleştirmek için bu seçeneği belirtin.

Blob depolamadaki, Dosya depolamadaki veya Blob depolamadaki dosyaları Dosya depolama alanına kopyalarken veya tam tersi durumda bu seçeneği kullanabilirsiniz.

Geçerli olan: Bloblar, Dosyalar

/SetContentType:"content-type"

Hedef bloblar veya dosyalar için MIME içerik türünü belirtir.

AzCopy, blob veya dosyanın içerik türünü varsayılan olarak application/octet-stream olarak ayarlar. Bu seçenek için açıkça bir değer belirterek tüm bloblar veya dosyalar için içerik türünü ayarlayabilirsiniz.

Bu seçeneği bir değer olmadan belirtirseniz, AzCopy her blobu veya dosyanın içerik türünü dosya uzantısına göre ayarlar.

Geçerli olan: Bloblar, Dosyalar

/PayloadFormat:"JSON" | "CSV"

Tablo dışarı aktarılan veri dosyasının biçimini belirtir.

Bu seçenek belirtilmezse, AzCopy varsayılan olarak tablo veri dosyasını JSON biçiminde dışarı aktarır.

Geçerli olan: Tablo

Bilinen Sorunlar ve En İyi Yöntemler

Şimdi bilinen sorunlardan ve en iyi uygulamalardan bazılarını gözden alalım.

Verileri kopyalarken eşzamanlı yazmaları sınırlama

AzCopy ile blobları veya dosyaları kopyalarken, verileri kopyalarken başka bir uygulamanın verileri değiştirebileceğini unutmayın. Mümkünse, kopyalama işlemi sırasında kopyaladığınız verilerin değiştirilmediğinden emin olun. Örneğin, Bir Azure sanal makinesiyle ilişkili bir VHD'yi kopyalarken, şu anda VHD'ye başka hiçbir uygulamanın yazmadığından emin olun. Bunu yapmak için kopyalanacak kaynağı kiralamak iyi bir yoldur. Alternatif olarak, önce VHD'nin anlık görüntüsünü oluşturabilir ve ardından anlık görüntüyü kopyalayabilirsiniz.

Diğer uygulamaların kopyalanırken bloblara veya dosyalara yazmasını önleyemezseniz, iş bittiğinde kopyalanan kaynakların artık kaynak kaynaklarla tam eşliğe sahip olmayabileceğini unutmayın.

"Şifreleme, karma oluşturma ve imzalama için FIPS uyumlu algoritmaları kullan" seçeneğini kullandığınızda AzCopy için FIPS uyumlu MD5 algoritmalarını etkinleştirin.

AzCopy varsayılan olarak nesneleri kopyalarken MD5'i hesaplamak için .NET MD5 uygulamasını kullanır, ancak FIPS uyumlu MD5 ayarını etkinleştirmek için AzCopy'ye ihtiyaç duyan bazı güvenlik gereksinimleri vardır.

özelliğiyle AzureStorageUseV1MD5 bir app.config dosyası AzCopy.exe.config oluşturabilir ve AzCopy.exe ile bir kenara koyabilirsiniz.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="AzureStorageUseV1MD5" value="false"/>
  </appSettings>
</configuration>

"AzureStorageUseV1MD5" özelliği için:

  • True - Varsayılan değer olan AzCopy, .NET MD5 uygulamasını kullanır.
  • False – AzCopy, FIPS uyumlu MD5 algoritması kullanır.

FIPS uyumlu algoritmalar Windows'ta varsayılan olarak devre dışı bırakılır. Makinenizde bu ilke ayarını değiştirebilirsiniz. Çalıştır penceresine (Windows+R) secpol.msc yazarak Yerel Güvenlik İlkesi penceresini açın. Güvenlik Ayarları penceresinde Güvenlik Ayarları>Yerel İlkeler>Güvenlik Seçenekleri'ne gidin. Sistem şifrelemesi: Şifreleme, karma oluşturma ve imzalama ilkesi için FIPS uyumlu algoritmaları kullanın. Güvenlik Ayarı sütununda görüntülenen değeri görmek için ilkeye çift tıklayın.

Sonraki adımlar

Azure Depolama ve AzCopy hakkında daha fazla bilgi için aşağıdaki kaynaklara bakın:

Azure Depolama belgeleri:

Azure Depolama blog gönderileri: