Mulai menggunakan AzCopy

Catatan

Jika Anda berencana memigrasi data ke Azure Storage, gunakan Azure Storage Mover. Azure Storage Mover adalah layanan terkelola yang dirancang untuk transfer skala besar (lebih dari 1 TB). Ini menyederhanakan perencanaan, pelaksanaan, dan pemantauan dalam skala besar. Untuk informasi lebih lanjut tentang alat migrasi untuk skenario Anda, lihat aka.ms/migratemydata.

AzCopy adalah utilitas baris perintah yang dapat Anda gunakan untuk menyalin data ke, dari, atau di antara akun penyimpanan. Artikel ini membantu Anda mengunduh AzCopy, menyambungkan ke akun penyimpanan Anda, dan mentransfer data.

AzCopy v10 adalah versi AzCopy yang saat ini didukung. Ini hanya didukung pada versi Windows, Linux, atau macOS yang secara resmi dipertahankan. Jika Anda perlu menggunakan AzCopy versi sebelumnya, lihat bagian Gunakan versi AzCopy sebelumnya di artikel ini.

Kasus penggunaan AzCopy

Gunakan AzCopy untuk menyalin data Anda ke, dari, atau di antara akun penyimpanan Azure. Kasus penggunaan umum meliputi:

  • Menyalin data dari sumber lokal ke akun penyimpanan Azure
  • Menyalin data dari akun penyimpanan Azure ke sumber lokal
  • Menyalin data dari satu akun penyimpanan ke akun penyimpanan lain

AzCopy mendukung setiap kasus penggunaan dengan perintah dan opsi tertentu. Misalnya, AzCopy memiliki perintah asli untuk menyalin dan menyinkronkan data, menjadikannya alat fleksibel untuk aktivitas penyalinan satu kali dan skenario sinkronisasi yang sedang berlangsung. Anda dapat menargetkan layanan penyimpanan tertentu seperti Azure Blob Storage atau Azure Files, dan Anda juga dapat menyalin di antara mereka. Misalnya, Anda dapat menyalin data dari kontainer Azure Blob Storage ke berbagi File Azure atau sebaliknya.

Untuk daftar lengkap panduan transfer data, lihat bagian Transfer data di artikel ini.

Dapatkan AzCopy

Jika Anda menggunakan AzCopy pada komputer Linux, Anda dapat menggunakan manajer paket. Untuk semua sistem operasi lainnya, unduh file biner portabel. Untuk informasi terperinci tentang rilis AzCopy, lihat halaman rilis AzCopy.

Menggunakan manajer paket (khusus Linux)

Menginstal AzCopy melalui manajer paket distribusi Linux Anda adalah pendekatan yang paling nyaman dan dapat dipertahankan. Penginstalan manajer paket menyediakan resolusi dependensi otomatis, pembaruan yang disederhanakan, dan integrasi dengan manajemen perangkat lunak sistem Anda. Untuk panduan langkah demi langkah, lihat Menginstal AzCopy di Linux dengan menggunakan manajer paket.

Mengunduh biner portabel

Paket penginstalan hanya tersedia untuk Linux. Untuk semua sistem operasi lainnya, unduh file yang dapat dieksekusi AzCopy v10 ke direktori apa pun di komputer Anda.

File-file ini dikompresi sebagai file zip (Windows dan macOS) atau file tar (Linux). Untuk mengunduh dan mendekompresi file tar di Linux, lihat dokumentasi untuk distribusi Linux Anda.

Menambahkan AzCopy ke jalur sistem Anda

Untuk kemudahan, pertimbangkan untuk menambahkan lokasi direktori file executable AzCopy ke path sistem Anda. Penambahan ini memungkinkan Anda mengetik azcopy dari direktori apa pun di sistem Anda. Jika Anda tidak menambahkan direktori AzCopy ke jalur Anda, Anda perlu mengubah direktori ke lokasi AzCopy yang dapat dieksekusi dan mengetik azcopy atau .\azcopy dalam shell perintah.

Otorisasi AzCopy

Sebagai pemilik akun Penyimpanan Azure, Anda tidak secara otomatis diberi izin untuk mengakses data. Sebelum Anda dapat melakukan sesuatu yang bermakna dengan AzCopy, Anda perlu memutuskan bagaimana Anda akan memberikan kredensial otorisasi ke layanan penyimpanan. Anda dapat memberikan kredensial dengan menggunakan MICROSOFT Entra ID atau dengan menggunakan token SAS.

Otorisasi dengan Microsoft Entra ID

Dengan menggunakan MICROSOFT Entra ID, Anda memberikan kredensial sekali alih-alih menambahkan token SAS ke setiap perintah. Mulailah dengan memilih jenis prinsip keamanan apa yang ingin Anda otorisasi. Gunakan tabel berikut sebagai panduan.

Prinsipal keamanan Bimbingan
Identitas pengguna Mengotorisasi akses untuk AzCopy dengan identitas pengguna
Identitas yang dikelola Mengotorisasi akses untuk AzCopy dengan identitas terkelola
Principal layanan Mengotorisasi akses untuk AzCopy dengan perwakilan layanan

Mengotorisasi dengan token SAS

Tambahkan token SAS ke setiap URL sumber atau tujuan yang Anda gunakan dalam perintah AzCopy Anda. Contoh perintah ini secara rekursif menyalin data dari direktori lokal ke kontainer gumpalan. Token SAS fiktif ditambahkan ke akhir URL kontainer.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

Token SAS dalam contoh di atas berisi parameter kueri yang menentukan akses yang diberikan ke sumber daya penyimpanan. Misalnya, sv menentukan versi layanan penyimpanan, sp menentukan operasi yang diizinkan, st dan se menentukan periode validitas, spr menentukan protokol yang diizinkan, dan sig berisi tanda tangan kriptografi. Bendera --recursive=true menyalin semua file dan subdirektori dari direktori lokal yang ditentukan. Untuk mempelajari selengkapnya tentang token SAS dan cara mendapatkannya, lihat tanda tangan akses bersama (SAS).

Pindahkan data

Setelah mengotorisasi identitas Anda atau mendapatkan token SAS, Anda dapat mulai mentransfer data.

Untuk contoh perintah, lihat salah satu artikel ini.

Layanan Artikel
Azure Blob Storage Unggah file ke Penyimpanan Blob Azure
Azure Blob Storage Mengunduh blob dari Azure Blob Storage
Azure Blob Storage Menyalin blob antar akun penyimpanan Azure
Azure Blob Storage Menyinkronkan dengan Azure Blob Storage
Azure Files Transfer data dengan AzCopy dan penyimpanan berkas
Amazon S3 Menyalin data dari Amazon S3 ke Azure Storage
Google Cloud Storage Salin data dari Google Cloud Storage ke Azure Storage. (Pratinjau)
Azure Stack Storage Mentransfer data dengan penyimpanan AzCopy dan Azure Stack

Anda dapat menjalankan perintah AzCopy secara interaktif. Anda juga dapat menggabungkan AzCopy ke dalam skrip otomatis untuk operasi batch, transfer data terjadwal, atau alur integrasi berkelanjutan. Untuk informasi selengkapnya, lihat Menggunakan AzCopy dalam skrip dan transfer terjadwal.

Catatan

AzCopy tidak mendukung skenario di mana sumber atau tujuan sedang diubah secara aktif selama transfer.

Minta bantuan perintah

Untuk melihat daftar perintah, ketik azcopy -h dan kemudian tekan tombol ENTER.

Untuk mempelajari tentang perintah tertentu, sertakan nama perintah (misalnya: azcopy list -h).

Bantuan langsung

Daftar perintah

Tabel berikut ini mencantumkan semua perintah AzCopy v10. Setiap perintah menautkan ke artikel referensi.

Perintah Deskripsi
azcopy bench Menjalankan tolok ukur performa dengan mengunggah atau mengunduh data pengujian ke atau dari lokasi tertentu.
azcopy copy Menyalin data sumber ke lokasi tujuan.
azcopy doc Membuat dokumentasi untuk alat dalam format Markdown.
azcopy env Menampilkan variabel lingkungan yang dapat mengonfigurasi perilaku AzCopy.
Pekerjaan azcopy Subperintah terkait pengelolaan pekerjaan.
pekerjaan azcopy bersih Menghapus semua file log dan file rencana untuk semua tugas.
daftar pekerjaan azcopy Menampilkan informasi tentang semua pekerjaan.
azcopy pekerjaan hapus Menghapus semua file yang terkait dengan ID pekerjaan yang diberikan.
azcopy pekerjaan resume Melanjutkan pekerjaan yang ada dengan ID pekerjaan yang ditentukan.
azcopy jobs show (tampilkan pekerjaan azcopy) Menampilkan informasi terperinci untuk ID pekerjaan yang ditentukan.
azcopy list Mencantumkan entitas dalam sumber daya tertentu.
azcopy login Masuk ke ID Microsoft Entra untuk mengakses sumber daya Azure Storage.
status masuk azcopy Menampilkan status autentikasi Azure saat ini.
keluar dari azcopy Mengeluarkan pengguna dan mengakhiri akses ke sumber daya Azure Storage.
azcopy make Membuat kontainer atau berbagi file.
azcopy remove - menghapus file atau data menggunakan perintah azcopy. Menghapus blob atau file dari akun penyimpanan Azure.
azcopy sync Mereplikasi lokasi sumber ke lokasi tujuan.
azcopy set-properties Mengubah level akses satu atau beberapa blob dan mengganti metadata dan tag indeks dari satu atau beberapa blob.

Catatan

AzCopy tidak memiliki perintah untuk mengganti nama file.

Mengonfigurasi, mengoptimalkan, dan memecahkan masalah AzCopy

Lihat salah satu sumber daya berikut ini:

Langkah berikutnya

Jika Anda memiliki pertanyaan, masalah, atau umpan balik umum, kirimkan di GitHub.

  • Terakhir diperbarui pada