Bagikan melalui

Menyalin blob antar akun penyimpanan Azure dengan AzCopy

Anda dapat menggunakan utilitas baris perintah AzCopy v10 untuk menyalin blob, direktori, dan kontainer di antara akun penyimpanan.

Untuk contoh jenis tugas lain, seperti mengunggah file, mengunduh blob, dan menyinkronkan dengan penyimpanan Blob, lihat tautan di bagian Langkah Berikutnya di artikel ini.

AzCopy menggunakan APIserver-ke-server, sehingga data disalin langsung antar server penyimpanan.

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 mengasumsikan bahwa Anda memberikan kredensial otorisasi dengan menggunakan ID Microsoft Entra dan bahwa identitas Microsoft Entra Anda memiliki penetapan peran yang tepat untuk akun sumber dan tujuan.

Atau, Anda dapat menambahkan token SAS ke URL sumber atau tujuan di setiap perintah AzCopy. Misalnya: azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>'.

Panduan

Terapkan panduan berikut ini ke perintah AzCopy Anda.

  • Jika Anda menggunakan otorisasi Microsoft Entra untuk sumber dan tujuan, kedua akun harus milik penyewa Microsoft Entra yang sama.

  • Klien Anda harus memiliki akses jaringan ke akun penyimpanan sumber dan tujuan.

    Untuk mempelajari cara mengonfigurasikan pengaturan jaringan setiap akun penyimpanan, lihat Mengonfigurasikan firewall dan jaringan virtual Azure Storage.

    Untuk mempelajari tentang topologi jaringan yang didukung saat menyalin antar akun, lihat Menyalin blob antar akun penyimpanan dengan pembatasan akses.

  • Jika Anda menyalin ke akun penyimpanan blob blok premium, hilangkan tingkat penyimpanan blob dari operasi salin dengan mengatur s2s-preserve-access-tier ke false (Misalnya: --s2s-preserve-access-tier=false). Akun penyimpanan blob blok premium tidak mendukung tingkat penyimpanan.

  • Anda dapat meningkatkan throughput operasi salin dengan mengatur nilai variabel lingkungan AZCOPY_CONCURRENCY_VALUE. Untuk mempelajari selengkapnya, lihat Meningkatkan Konkurensi.

  • Jika blob sumber memiliki tag indeks, dan Anda ingin mempertahankan tag tersebut, Anda perlu menerapkannya kembali ke blob tujuan. Untuk informasi tentang cara mengatur tag indeks, lihat bagian Menyalin blob ke akun penyimpanan lain dengan tag indeks dari artikel ini.

Menyalin blob

Menyalin blob ke akun penyimpanan lain menggunakan perintah azcopy copy.

Petunjuk / Saran

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 copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>'

Contoh

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

Contoh (titik akhir Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'

Operasi penyalinan sinkron. Ketika perintah kembali, perintah menunjukkan bahwa semua file disalin.

Menyalin direktori

Menyalin direktori ke akun penyimpanan lain dengan menggunakan perintah azcopy copy.

Petunjuk / Saran

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 copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive

Contoh

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive

Contoh (titik akhir Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive

Operasi penyalinan sinkron. Setelah perintah selesai dijalankan, semua file disalin.

Menyalin kontainer

Menyalin kontainer ke akun penyimpanan lain dengan menggunakan perintah azcopy copy.

Petunjuk / Saran

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 copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive

Contoh

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive

Contoh (titik akhir Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive

Operasi penyalinan sinkron. Ketika perintah kembali, semua file disalin.

Menyalin kontainer, direktori, dan blob

Menyalin semua kontainer, direktori, dan blob ke akun penyimpanan lain dengan menggunakan perintah azcopy copy.

Petunjuk / Saran

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 copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/' --recursive

Contoh

azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive

Contoh (titik akhir Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/' 'https://mydestinationaccount.dfs.core.windows.net' --recursive

Operasi penyalinan sinkron. Ketika perintah kembali, perintah menunjukkan bahwa semua file disalin.

Menyalin blob dan menambahkan tag indeks

Salin blob ke akun penyimpanan lain dan tambahkan tag indeks blob ke blob target.

Jika Anda menggunakan otorisasi Microsoft Entra, tetapkan peran Pemilik Data Blob Penyimpanan ke prinsip keamanan Anda, atau beri izin ke Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeoperasi penyedia sumber daya Azure melalui peran Azure kustom. Jika Anda menggunakan token Tanda Tangan Akses Bersama (SAS), token harus menyediakan akses ke tag blob melalui t izin SAS.

Untuk menambahkan tag, gunakan opsi --blob-tags dengan pasangan nilai kunci yang dikodekan dalam format URL.

Misalnya, untuk menambahkan kunci my tag dan nilai my tag value, tambahkan --blob-tags='my%20tag=my%20tag%20value' ke parameter tujuan.

Pisahkan beberapa tag indeks dengan ampersand (&). Misalnya, jika Anda ingin menambahkan kunci my second tag dan nilai my second tag value, string opsi lengkapnya adalah --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'.

Contoh berikut menunjukkan cara menggunakan opsi --blob-tags.

Petunjuk / Saran

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 ('').

Contoh blob


azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Contoh direktori

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Contoh kontainer

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Contoh akun

azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Operasi penyalinan sinkron. Ketika perintah kembali, semua file disalin.

Catatan

Jika Anda menentukan direktori, kontainer, atau akun untuk sumbernya, semua blob yang Anda salin ke tujuan memiliki tag yang sama dengan yang Anda tentukan dalam perintah.

Menyalin dengan bendera opsional

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

Skenario Bendera
Menyalin blob sebagai Blob Blok, Halaman, atau Tambahan. --blob-type=[BlockBlob|PageBlob|TambahkanBlob]
Menyalin ke tingkat penyimpanan tertentu (seperti tingkat arsip). --block-blob-tier=[None|Panas|Dingin|Arsip]
Mendekompresi file secara otomatis. --decompress=[gzip|deflate]

Untuk daftar lengkap, lihat opsi.

Tentukan jenis sumber dan tujuan

AzCopy menggunakan --from-to parameter untuk secara eksplisit menentukan jenis sumber daya sumber dan tujuan saat deteksi otomatis mungkin gagal, seperti dalam skenario perpipaan atau emulator. Parameter ini membantu AzCopy memahami konteks transfer dan mengoptimalkannya.

Nilai Dari Ke Description
BlobBlob Menyalin antara dua lokasi Azure Blob Storage
BlobBlobFS Salin dari Azure Blob Storage ke Azure Data Lake Gen2 (BlobFS)
BlobFSBlob Salin dari Azure Data Lake Gen2 (BlobFS) ke Azure Blob Storage
BlobFSBlobFS Salin antara dua lokasi Azure Data Lake Gen2 (BlobFS)
BlobFSFile Salin dari Azure Data Lake Gen2 (BlobFS) ke Azure File Storage
BlobFile Salin dari Azure Blob Storage ke Azure File Storage
FileBlob Salin dari Azure File Storage ke Azure Blob Storage
FileBlobFS Salin dari Azure File Storage ke Azure Data Lake Gen2 (BlobFS)

Langkah berikutnya

Temukan contoh lainnya dalam artikel ini:

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

  • Last updated on