Aracılığıyla paylaş

Windows üzerinde AzCopy v8.1 ile veri aktarma

  • Makale

AzCopy, en iyi performansı sunacak şekilde tasarlanmış basit komutlar aracılığıyla Microsoft Azure Blob, Dosya ve Tablo depolamasını kaynak veya hedef olarak kullanıp veri kopyalayacak şekilde 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'de AzCopy Sürüm Notları

  • 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ğine sahip AzCopy (v7.3)

Tablo desteğiyle 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 şöyledir:

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

Aşağıdaki örneklerde Microsoft Azure Bloblarına, Dosyalarına ve Tablolarına 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 blobları 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 ayarlayın

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

Ayrıca blobları son değiştirme saatlerine göre indirme işleminin dışında tutabilirsiniz. Örneğin, son değiştirme zamanı hedef dosyadan 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 dosyadan 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.

Tek bir blobu sanal dizine 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 Blob depolamaya özyinelemeli olarak 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üklenmez. 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ı varsayın:

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 blobu 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ı içinde 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.

İkincil bölgeden birincil bölgeye tek bir blob 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ğinin belirtilmesi, belirtilen kapsayıcının içeriğini özyinelemeli olarak karşıya yükler. 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ığı konusunda 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.

Dosya depolamadan dosya 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ı (örn. abc.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 blob'a 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

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 uygulanır.

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

Dosya depolama alanından 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 depolama alanından 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 depolama alanından 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, bölüm anahtarı aralığı dizini ve bölünmüş dosya dizini olmak üzere iki bölümden oluşur. 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şturarak. Sonuçta elde edilen veri dosyası adları:

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, AzCopy seçeneğin kullanıcı tarafından belirtilip /SplitSize belirtilmediğinden bağımsız olarak, boyutları blob boyutu sınırlamasına (200 GB) ulaştığında veri dosyasını böler.

Tabloyu JSON veya CSV veri dosyası biçiminde dışarı 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

CSV yük biçimini belirtirken, AzCopy 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"

AzCopy, kullanıcı seçeneğini /PKRSbelirttiğinde 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 göre 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 düşük meta veriler 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 "%LocalAppData%\Microsoft\Azure\AzCopy" yolu ile günlük dosyası klasörüne konur, günlük dosyası klasörü 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çenek /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ı bir eşzamanlı sayı 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ı aktarmasından gelmelidir. 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 varsayalım: Azure Tablosunu ve beraberindeki 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 AzCopy özelliklerine göz atalım.

Yalnızca hedefte var olmayan verileri kopyalama

/XO ve /XN parametreleri, sırasıyla eski veya daha yeni kaynak kaynaklarının kopyalanmasını 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"

Herhangi bir AzCopy komut satırı parametresini bir yanıt dosyasına ekleyebilirsiniz. AzCopy, dosyadaki parametreleri komut satırında belirtilmiş gibi 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

Ve dosya sisteminde 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 eklediyseniz bu komutu aynı şekilde 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

Günlük dosyası klasörü

AzCopy'ye her komut verdiğinizde, bir günlük dosyasının varsayılan klasörde var olup olmadığını veya bu seçenek aracılığıyla belirttiğiniz bir klasörde olup olmadığını 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.

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 bir dosya yolu sağlamadan seçenek /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

seçeneğinin ardından /Vgöreli bir yol belirtirseniz , gibi /V:test/azcopy1.logayrı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ıdır. 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, içerik türünü dosya uzantısı eşlemesine 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: 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: Bloblar, Dosyalar, Tablolar

/Pattern:"file-pattern"

Hangi dosyaların kopyalandığını 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 de belirtilen deseni dizinin altındaki alt klasörlerdeki tüm dosyalarla eşleştirir.

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 duyarsız eşleştirme kullanır.

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

Geçerli: Bloblar, Dosyalar

/DestKey:"storage-key"

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

Geçerli: 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: Bloblar, Dosyalar, Tablolar

/SourceKey:"storage-key"

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

Geçerli: Bloblar, Dosyalar, Tablolar

/SourceSAS:"sas-token"

Kaynak için OKUMA ve LİSTE 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 yoluyla okunur.

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

Geçerli: 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: Bloblar, Dosyalar

/BlobType:"block" | "page" | "append"

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: Bloblar

/CheckMD5

İndirilen veriler için bir MD5 karması hesaplar ve blob 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şmiyorsa 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ı için 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 dosyayı hizmete yükledikten sonra her zaman Content-MD5 özelliğini ayarlar.

Geçerli: 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 (snapshot-time).extension

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

Geçerli: Bloblar

/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çinde %LocalAppData%\Microsoft\Azure\AzCopyAzCopyVerbose.log olarak adlandırılır. Bu seçenek için mevcut bir dosya konumu belirtirseniz, bu dosyaya ayrıntılı günlük eklenir.

Geçerli: Bloblar, Dosyalar, Tablolar

/Z:[journal-file-folder]

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

AzCopy, bir işlem kesintiye uğradığında 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 verdiğinizde, bir günlük dosyasının varsayılan klasörde var olup olmadığını veya bu seçenek aracılığıyla belirttiğiniz bir klasörde olup olmadığını 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 bir işlemin devam ettirilmesi desteklenmez.

Geçerli: 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: 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 olanak tanır.

Geçerli: 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 kopyalanıp kopyalanmadığını 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 /Desen'e göre de belirlenir.

AzCopy, bu seçeneği kullanırken bu kaynak konumun LIST ve READ iznini gerektirir.

Geçerli: Bloblar, Dosyalar

/MT

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

Geçerli: 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: 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: Bloblar, Dosyalar

/A

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

Geçerli: Bloblar, Dosyalar

/IA:[RASHCNETOI]

Yalnızca belirtilen özniteliklerden herhangi birine sahip 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: 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: 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: Bloblar

/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 ortamda çok sayıda eşzamanlı işlemin ağ bağlantısını bunaltabileceğini ve işlemlerin tamamen 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: 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: 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: 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: Tablolar

/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 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: Tablolar

/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: Tablolar

/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: Tablolar

/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 depolama içinde, Dosya depolamada veya Blob depolamadan Dosya depolamaya dosya kopyalarken veya tam tersi durumda bu seçeneği kullanabilirsiniz.

Geçerli: 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: Bloblar, Dosyalar

/PayloadFormat:"JSON" | "CSV"

Dışarı aktarılan tablo 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: Tablolar

Bilinen Sorunlar ve En İyi Yöntemler

Şimdi bilinen sorunlara ve en iyi yöntemlere göz atalım.

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

AzCopy ile blobları veya dosyaları kopyalarken, siz 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şkilendirilmiş 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ı engelleyemiyorsanız, 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ın", 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 gerektiren bazı güvenlik gereksinimleri vardır.

özelliğine AzureStorageUseV1MD5 sahip 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. Yerel Güvenlik İlkesi penceresini açmak için Çalıştır penceresine (Windows+R) secpol.msc yazı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: