Bagikan melalui

Mentransfer data dengan AzCopy dan penyimpanan file

  • Artikel

AzCopy adalah utilitas baris perintah yang dapat Anda gunakan untuk menyalin file ke atau dari akun penyimpanan. Artikel ini berisi contoh perintah yang berfungsi dengan Azure Files.

Memulai

Lihat artikel Mulai menggunakan AzCopy untuk mengunduh AzCopy dan pelajari tentang cara memberikan informasi masuk otorisasi ke layanan penyimpanan.

Catatan

Contoh dalam artikel ini menunjukkan penggunaan token SAS untuk mengotorisasi akses. Namun, untuk perintah yang menargetkan file dan direktori, Anda sekarang dapat memberikan kredensial otorisasi dengan menggunakan ID Microsoft Entra dan menghilangkan token SAS dari perintah tersebut. Anda masih harus menggunakan token SAS dalam perintah apa pun yang hanya menargetkan berbagi file atau akun (Misalnya: 'azcopy make https://mystorageaccount.file.core.windows.net/myfileshare' atau 'azcopy copy 'https://mystorageaccount.file.core.windows.net'.

Untuk mempelajari lebih lanjut, lihat Mengotorisasi AzCopy.

Membuat berbagi file

Anda dapat menggunakan perintah azcopy make untuk membuat berbagi file. Contoh di bagian ini membuat berbagi file dengan nama myfileshare.

Tip

Contoh ini menyertakan argumen jalur dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').

Sintaks

azcopy make 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>'

Contoh

azcopy make 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D'

Untuk dokumen referensi mendetail, lihat azcopy make.

Unggah file

Anda dapat menggunakan perintah azcopy copy untuk mengunggah file dan direktori dari komputer lokal Anda.

Tip

Contoh dalam bagian ini mengapit argumen jalur dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').

Bagian ini berisi contoh-contoh berikut:

  • Mengunggah file
  • Mengunggah direktori
  • Mengunggah konten direktori
  • Mengunggah file tertentu

Tip

Anda dapat mengubah operasi unggahan menggunakan bendera opsional. Berikut adalah beberapa contohnya.

Skenario Bendera
Menyalin daftar kontrol akses (ACL) bersama dengan file. --preserve-smb-permissions=[true|false]
Menyalin informasi properti SMB beserta filenya. --preserve-smb-info=[true|false]

Untuk daftar lengkap, lihat opsi.

Catatan

AzCopy tidak secara otomatis menghitung dan menyimpan kode hash md5 file untuk file yang lebih besar dari 256 MB. Jika Anda ingin AzCopy melakukannya, tambahkan --put-md5 bendera ke setiap perintah salin. Dengan begitu, saat file diunduh, AzCopy menghitung hash MD5 untuk data yang diunduh dan memastikan bahwa hash MD5 yang disimpan dalam properti Content-md5 file cocok dengan hash terhitung.

Mengunggah file

Sintaks

azcopy copy '<local-file-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-name>'

Contoh

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --preserve-smb-permissions=true --preserve-smb-info=true

Anda juga dapat mengunggah file menggunakan simbol kartubebas (*) di mana saja di jalur file atau nama file. Misalnya: 'C:\myDirectory\*.txt', atau C:\my*\*.txt.

Mengunggah direktori

Contoh ini menyalin direktori (dan semua file dalam direktori tersebut) ke file bersama. Hasilnya adalah direktori dalam file bersama dengan nama yang sama.

Sintaks

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Contoh

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Untuk menyalin ke direktori dalam berbagi file, cukup tentukan nama direktori tersebut dalam untai (karakter) perintah Anda.

Contoh

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Jika Anda menentukan nama direktori yang tidak ada di berbagi file, AzCopy membuat direktori baru dengan nama tersebut.

Mengunggah konten direktori

Anda dapat mengunggah konten direktori tanpa menyalin direktori yang memuatnya dengan menggunakan simbol kartubebas (*).

Sintaks

azcopy copy '<local-directory-path>/*' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>'

Contoh

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --preserve-smb-permissions=true --preserve-smb-info=true

Catatan

Tambahkan bendera --recursive untuk mengunggah file di semua sub-direktori.

Mengunggah file tertentu

Anda dapat mengunggah file tertentu menggunakan nama file lengkap, nama parsial dengan karakter kartubebas (*), atau dengan menggunakan tanggal dan waktu.

Menentukan beberapa nama blob lengkap

Gunakan perintah azcopy copy dengan opsi --include-path. Pisahkan nama file tersendiri dengan menggunakan titik koma (;).

Sintaks

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-path <semicolon-separated-file-list>

Contoh

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-path 'photos;documents\myFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

Dalam contoh ini, AzCopy mentransfer direktori C:\myDirectory\photos dan file C:\myDirectory\documents\myFile.txt. Anda perlu menyertakan opsi --recursive untuk mentransfer semua file di direktori C:\myDirectory\photos.

Anda juga dapat mengecualikan file menggunakan opsi --exclude-path. Untuk mempelajari selengkapnya, lihat dokumen referensi azcopy copy.

Menggunakan karakter kartubebas

Gunakan perintah azcopy copy dengan opsi --include-pattern. Tentukan nama parsial yang menyertakan karakter kartubebas. Pisahkan nama menggunakan titik koma (;).

Sintaks

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

Contoh

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-pattern 'myFile*.txt;*.pdf*' --preserve-smb-permissions=true --preserve-smb-info=true

Anda juga dapat mengecualikan file menggunakan opsi --exclude-pattern. Untuk mempelajari selengkapnya, lihat dokumen referensi azcopy copy.

Opsi --include-pattern dan --exclude-pattern hanya berlaku untuk nama file dan bukan ke jalur. Jika Anda ingin menyalin semua file teks yang ada di pohon direktori, gunakan opsi --recursive untuk mendapatkan seluruh pohon direktori, lalu gunakan --include-pattern dan tentukan *.txt untuk mendapatkan semua file teks.

Mengunggah file yang diubah setelah tanggal dan waktu

Gunakan perintah azcopy copy dengan opsi --include-after. Tentukan tanggal dan waktu dalam format ISO 8601 (Misalnya: 2020-08-19T15:04:00Z).

Sintaks

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-after <Date-Time-in-ISO-8601-format>

Contoh

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-after '2020-08-19T15:04:00Z' --preserve-smb-permissions=true --preserve-smb-info=true

Untuk referensi terperinci, lihat dokumen referensi azcopy copy.

Mengunduh file

Anda dapat menggunakan perintah azcopy copy untuk mengunduh file, direktori, dan berbagi file ke komputer lokal Anda.

Tip

Contoh dalam bagian ini mengapit argumen jalur dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').

Bagian ini berisi contoh-contoh berikut:

  • Unduh file
  • Mengunduh direktori
  • Mengunduh konten direktori
  • Mengunduh file tertentu

Tip

Anda dapat mengubah operasi unduhan menggunakan bendera opsional. Berikut beberapa contohnya:

Skenario Bendera
Menyalin daftar kontrol akses (ACL) bersama dengan file. --preserve-smb-permissions=[true|false]
Menyalin informasi properti SMB beserta filenya. --preserve-smb-info=[true|false]
Mendekompresi file secara otomatis. --decompress

Untuk daftar lengkap, lihat opsi.

Catatan

Jika nilai properti Content-md5 file berisi hash, AzCopy menghitung hash MD5 untuk data yang diunduh dan memastikan bahwa hash MD5 yang disimpan di properti Content-md5 file cocok dengan hash terhitung. Jika nilai ini tidak cocok, unduhan gagal kecuali Anda mengambil alih perilaku ini dengan menambahkan --check-md5=NoCheck atau --check-md5=LogOnly ke perintah copy.

Unduh file

Sintaks

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>' '<local-file-path>'

Contoh

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory\myTextFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

Mengunduh direktori

Sintaks

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>' '<local-directory-path>' --recursive

Contoh

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory'  --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Contoh ini menghasilkan direktori bernama C:\myDirectory\myFileShareDirectory yang berisi semua file yang diunduh.

Mengunduh konten direktori

Anda dapat mengunduh isi direktori tanpa menyalin direktori yang memuatnya dengan menggunakan simbol wildcard (*).

Sintaks

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/*<SAS-token>' '<local-directory-path>/'

Contoh

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory/*?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory' --preserve-smb-permissions=true --preserve-smb-info=true

Catatan

Tambahkan bendera --recursive untuk mengunduh file di semua sub-direktori.

Mengunduh file tertentu

Anda dapat mengunduh file tertentu menggunakan nama file lengkap, nama parsial dengan karakter kartubebas (*), atau menggunakan tanggal dan waktu.

Menentukan beberapa nama blob lengkap

Gunakan perintah azcopy copy dengan opsi --include-path. Pisahkan nama file tersendiri dengan menggunakan titik koma (;).

Sintaks

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' '<local-directory-path>' --include-path <semicolon-separated-file-list>

Contoh

azcopy copy 'https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Dalam contoh ini, AzCopy mentransfer direktori https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos dan file https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/documents/myFile.txt. Sertakan opsi --recursive untuk mentransfer semua file di direktori https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos.

Anda juga dapat mengecualikan file menggunakan opsi --exclude-path. Untuk mempelajari selengkapnya, lihat dokumen referensi azcopy copy.

Menggunakan karakter kartubebas

Gunakan perintah azcopy copy dengan opsi --include-pattern. Tentukan nama parsial yang menyertakan karakter kartubebas. Pisahkan nama menggunakan titik koma (;).

Sintaks

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' '<local-directory-path>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

Contoh

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*' --preserve-smb-permissions=true --preserve-smb-info=true

Anda juga dapat mengecualikan file menggunakan opsi --exclude-pattern. Untuk mempelajari selengkapnya, lihat dokumen referensi azcopy copy.

Opsi --include-pattern dan --exclude-pattern hanya berlaku untuk nama file dan bukan ke jalur. Jika Anda ingin menyalin semua file teks yang ada di pohon direktori, gunakan opsi --recursive untuk mendapatkan seluruh pohon direktori, lalu gunakan --include-pattern dan tentukan *.txt untuk mendapatkan semua file teks.

Mengunggah file yang diubah setelah tanggal dan waktu

Gunakan perintah azcopy copy dengan opsi --include-after. Tentukan tanggal dan waktu dalam format ISO-8601 (Misalnya: 2020-08-19T15:04:00Z).

Sintaks

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name>/*<SAS-token>' '<local-directory-path>' --include-after <Date-Time-in-ISO-8601-format>

Contoh

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/*?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory' --include-after '2020-08-19T15:04:00Z' --preserve-smb-permissions=true --preserve-smb-info=true

Untuk referensi terperinci, lihat dokumen referensi azcopy copy.

Mengunduh dari rekam jepret bersama

Anda dapat mengunduh versi tertentu dari file atau direktori dengan merujuk pada nilai DateTime dari rekam jepret bersama. Untuk mempelajari selengkapnya tentang rekam jepret bersama, lihat Ringkasan rekam jepret bersama untuk Azure Files.

Sintaksis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-path-or-directory-name><SAS-token>&sharesnapshot=<DateTime-of-snapshot>' '<local-file-or-directory-path>'

Contoh (Mengunduh file)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

Contoh (Mengunduh direktori)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory'  --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Menyalin file antar-akun penyimpanan

Anda dapat menggunakan AzCopy untuk menyalin file ke akun penyimpanan lainnya. Operasi salin sinkron sehingga semua file disalin saat perintah kembali.

AzCopy menggunakan API server-ke-server, sehingga data disalin langsung antar server penyimpanan. Anda dapat meningkatkan throughput operasi tersebut dengan mengatur nilai variabel lingkungan AZCOPY_CONCURRENCY_VALUE. Untuk mempelajari selengkapnya, lihat Meningkatkan Konkurensi.

Anda juga dapat menyalin versi file tertentu dengan merujuk nilai DateTime rekam jepret berbagi. Untuk mempelajari selengkapnya tentang rekam jepret bersama, lihat Ringkasan rekam jepret bersama untuk Azure Files.

Tip

Contoh dalam bagian ini mengapit argumen jalur dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').

Bagian ini berisi contoh-contoh berikut:

  • Menyalin file ke akun penyimpanan lain
  • Menyalin direktori ke akun penyimpanan lain
  • Menyalin berbagi file ke akun penyimpanan lain
  • Menyalin semua file bersama, direktori, dan file ke akun penyimpanan lain

Tip

Anda dapat mengubah operasi salin menggunakan bendera opsional. Berikut adalah beberapa contohnya.

Skenario Bendera
Menyalin daftar kontrol akses (ACL) bersama dengan file. --preserve-smb-permissions=[true|false]
Menyalin informasi properti SMB beserta filenya. --preserve-smb-info=[true|false]

Untuk daftar lengkap, lihat opsi.

Menyalin file ke akun penyimpanan lain

Sintaks

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>'

Contoh

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --preserve-smb-permissions=true --preserve-smb-info=true

Contoh (rekam jepret bersama)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --preserve-smb-permissions=true --preserve-smb-info=true

Menyalin direktori ke akun penyimpanan lain

Sintaks

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Contoh

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Contoh (rekam jepret bersama)

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Menyalin berbagi file ke akun penyimpanan lain

Sintaks

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Contoh

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D --preserve-smb-permissions=true --preserve-smb-info=true

Contoh (rekam jepret bersama)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Menyalin semua file bersama, direktori, dan file ke akun penyimpanan lain

Sintaks

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<SAS-token>' --recursive'

Contoh

azcopy copy 'https://mysourceaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Contoh (rekam jepret bersama)

azcopy copy 'https://mysourceaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Menyinkronkan file

Anda dapat menyinkronkan isi sistem file lokal dengan berbagi file atau menyinkronkan isi file share dengan file share lain. Anda juga dapat menyinkronkan konten direktori dalam berbagi file dengan konten direktori yang terletak di berbagi file lain. Sinkronisasi adalah salah satu caranya. Dengan kata lain, Anda memilih mana dari kedua titik akhir ini yang merupakan sumber dan mana yang menjadi tujuannya. Sinkronisasi juga menggunakan API server ke server.

Catatan

Saat ini, skenario ini diaktifkan untuk akun yang telah mengaktifkan namespace layanan hierarkis melalui titik akhir blob.

Peringatan

Sinkronisasi AzCopy didukung tetapi tidak sepenuhnya direkomendasikan untuk Azure Files. Sinkronisasi AzCopy tidak mendukung salinan diferensial dalam skala besar, dan sebagian keakuratan file mungkin hilang. Untuk mempelajari selengkapnya, lihat Migrasikan ke berbagi file Azure.

Panduan

Secara default, perintah sinkronisasi membandingkan nama file dan tanda waktu terakhir yang dimodifikasi. Anda dapat mengambil alih perilaku tersebut untuk menggunakan hash MD5 alih-alih tanda waktu terakhir yang dimodifikasi dengan menggunakan --compare-hash bendera . Atur bendera opsional --delete-destination ke nilai true atau prompt untuk menghapus file di direktori tujuan jika file tersebut tidak ada lagi di direktori sumber.

  • Jika Anda mengatur bendera --delete-destination menjadi true, AzCopy akan menghapus file tanpa memberikan perintah. Jika Anda ingin perintah muncul sebelum AzCopy menghapus file, atur bendera --delete-destination menjadi prompt.

  • Jika Anda berencana untuk mengatur bendera --delete-destination menjadi prompt atau false, pertimbangkan untuk menggunakan perintah salin bukan perintah sinkronisasi lalu atur parameter --overwrite ke ifSourceNewer. Perintah salin menggunakan lebih sedikit memori dan menimbulkan lebih sedikit biaya tagihan karena operasi salin tidak harus mengindeks sumber atau tujuan sebelum memindahkan file.

  • Jika Anda tidak berencana untuk menggunakan --compare-hash bendera, maka komputer tempat Anda menjalankan perintah sinkronisasi harus memiliki jam sistem yang akurat karena waktu terakhir yang dimodifikasi sangat penting dalam menentukan apakah file harus ditransfer. Jika sistem Anda memiliki penyimpangan jam yang signifikan, hindari mengubah file di tujuan terlalu dekat dengan waktu yang Anda rencanakan untuk menjalankan perintah sinkronisasi.

  • AzCopy menggunakan API server-ke-server untuk menyinkronkan data antar akun penyimpanan. Itu berarti bahwa data disalin langsung di antara server penyimpanan. Namun, AzCopy memang menyiapkan dan memantau setiap transfer, dan untuk akun penyimpanan yang lebih besar (Misalnya, akun yang berisi jutaan blob), AzCopy mungkin memerlukan sejumlah besar sumber daya komputasi untuk menyelesaikan tugas-tugas ini. Oleh karena itu, jika Anda menjalankan AzCopy dari Komputer Virtual (VM), pastikan bahwa VM memiliki cukup core/memori untuk menangani beban.

Tip

Anda dapat mengubah operasi sinkronisasi menggunakan bendera opsional. Berikut adalah beberapa contohnya.

Skenario Bendera
Menyalin daftar kontrol akses (ACL) bersama dengan file. --preserve-smb-permissions=[true|false]
Menyalin informasi properti SMB beserta filenya. --preserve-smb-info=[true|false]
Mengecualikan file berdasarkan pola. --exclude-path
Menentukan seberapa detail Anda ingin entri log terkait sinkronisasi dibuat. --log-level=[WARNING|ERROR|INFO|NONE]

Untuk daftar lengkap, lihat opsi.

Contoh dalam bagian ini mengapit argumen jalur dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').

Memperbarui file bersama dengan perubahan pada sistem file lokal

Dalam hal ini, file bersama adalah tujuan, dan sistem file lokal adalah sumbernya.

Tip

Contoh ini menyertakan argumen jalur dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').

Sintaks

azcopy sync '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Contoh

azcopy sync 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive

Memperbarui sistem file lokal dengan perubahan pada file bersama

Dalam hal ini, sistem file lokal adalah tujuan, dan file berbagi adalah sumbernya.

Tip

Contoh ini menyertakan argumen jalur dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').

Sintaks

azcopy sync 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'C:\myDirectory' --recursive

Contoh

azcopy sync 'https://mystorageaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory' --recursive

Memperbarui berbagi file dengan perubahan pada berbagi file lain

Berbagi file pertama yang muncul dalam perintah ini adalah sumbernya. Yang kedua adalah tujuannya.

Sintaks

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Contoh

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Memperbarui direktori dengan perubahan pada direktori di berbagi file lain

Direktori pertama yang muncul dalam perintah ini adalah sumbernya. Yang kedua adalah tujuannya.

Sintaks

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-name><SAS-token>' --recursive

Contoh

azcopy sync 'https://mysourceaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Memperbarui berbagi file agar sesuai dengan konten rekam jepret bersama

Berbagi file pertama yang muncul dalam perintah ini adalah sumbernya. Di akhir URI, tambahkan untai (karakter) &sharesnapshot= diikuti dengan nilai DateTime dari rekam jepret.

Sintaks

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>&sharesnapsot<snapshot-ID>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Contoh

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-03-03T20%3A24%3A13.0000000Z' 'https://mydestinationaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Untuk mempelajari selengkapnya tentang rekam jepret bersama, lihat Ringkasan rekam jepret bersama untuk Azure Files.

Langkah berikutnya

Temukan contoh lainnya dalam salah satu artikel ini:

Lihat artikel ini untuk mengonfigurasi pengaturan, mengoptimalkan performa, dan memecahkan masalah: