Mulai menggunakan AzCopy
AzCopy adalah utilitas baris perintah yang dapat Anda gunakan untuk menyalin gumpalan atau file ke atau dari akun penyimpanan. Artikel ini membantu Anda mengunduh AzCopy, terhubung ke akun penyimpanan Anda, lalu mentransfer file.
Catatan
AzCopy V10 adalah versi AzCopy yang saat ini didukung.
Jika Anda perlu menggunakan AzCopy versi sebelumnya, lihat bagian Gunakan versi AzCopy sebelumnya di artikel ini.
Unduh AzCopy
Pertama, unduh file yang dapat dieksekusi AzCopy V10 ke direktori apa pun di komputer Anda. AzCopy V10 hanyalah file yang dapat dieksekusi, jadi tidak ada yang perlu diinstal.
- Windows 64-bit (zip)
- Windows 32-bit (zip)
- Linux x86-64 (tar)
- Pratinjau Linux ARM64 (tar)
- macOS (zip)
File-file ini dikompresi sebagai file zip (Windows dan Mac) atau file tar (Linux). Untuk mengunduh dan mendekompresi file tar di Linux, lihat dokumentasi untuk distribusi Linux Anda.
Untuk informasi mendetail tentang rilis AzCopy, lihat halaman rilis AzCopy.
Catatan
Jika Anda ingin menyalin data ke dan dari layanan penyimpanan Azure Table Anda, instal AzCopy versi 7.3.
Jalankan AzCopy
Demi kenyamanan, pertimbangkan untuk menambahkan lokasi direktori AzCopy yang dapat dieksekusi ke jalur sistem Anda untuk kemudahan penggunaan. Dengan begitu Anda dapat mengetik azcopy azcopy dari direktori apa pun di sistem Anda.
Jika Anda memilih untuk tidak menambahkan direktori AzCopy ke jalur Anda, Anda harus mengubah direktori ke lokasi AzCopy yang dapat dieksekusi dan ketik azcopy atau .\azcopy di perintah Windows PowerShell.
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.
Otorisasi AzCopy
Anda bisa memberikan kredensial otorisasi dengan menggunakan Azure Active Directory (AD), atau dengan menggunakan token Tanda Tangan Akses Bersama (SAS).
Gunakan tabel ini sebagai panduan:
| Jenis penyimpanan | Metode Otorisasi Terbaru yang didukung |
|---|---|
| Penyimpanan Blob | Azure AD & SAS |
| Penyimpanan blob (namespace hierarkis) | Azure AD & SAS |
| Penyimpanan File | Khusus SAS |
Opsi 1: Gunakan Azure Active Directory
Opsi ini hanya tersedia untuk Penyimpanan gumpalan. Dengan menggunakan Azure Active Directory, Anda dapat memberikan kredensial sekali alih-alih harus menambahkan token SAS ke setiap perintah.
Opsi 2: Gunakan token SAS
Anda dapat menambahkan token SAS ke setiap URL sumber atau tujuan yang digunakan 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
Untuk mempelajari selengkapnya tentang token SAS dan cara mendapatkannya, lihat Menggunakan tanda tangan akses bersama (SAS).
Catatan
Pengaturan secure transfer yang diperlukan dari akun penyimpanan menentukan apakah koneksi ke akun penyimpanan diamankan dengan Transport Layer Security (TLS). Setelan ini diaktifkan secara asali.
Transfer data
Setelah Anda mengizinkan identitas Anda atau mendapatkan token SAS, Anda dapat mulai mentransfer data.
Untuk menemukan contoh perintah, lihat salah satu artikel ini.
| Layanan | Artikel |
|---|---|
| Azure Blob Storage | Unggah file ke Penyimpanan Blob Azure |
| Azure Blob Storage | Mengunduh blob dari penyimpanan Blob Azure menggunakan |
| Azure Blob Storage | Menyalin blob antar akun penyimpanan Azure |
| Azure Blob Storage | Sinkronkan dengan Penyimpanan Blob Azure |
| File Azure | Transfer data dengan AzCopy dan penyimpanan file |
| Amazon S3 | Menyalin data dari Amazon S3 ke Azure Storage |
| Google Cloud Storage | Salin data dari Google Cloud Storage ke Azure Storage. (Pratinjau) |
| Penyimpanan Azure Stack | Mentransfer data dengan penyimpanan AzCopy dan Azure Stack |
Dapatkan bantuan perintah
Untuk melihat daftar perintah, ketik azcopy -h dan kemudian tekan tombol ENTER.
Untuk mempelajari tentang perintah tertentu, cukup masukkan nama perintahnya (Misalnya: azcopy list -h).
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. |
| azcopy jobs | Subperintah terkait pengelolaan pekerjaan. |
| azcopy jobs clean | Hapus semua file log dan rencana untuk semua pekerjaan |
| azcopy jobs list | Menampilkan informasi tentang semua pekerjaan. |
| azcopy jobs remove | Hapus semua berkas yang terkait dengan ID tugas yang diberikan. |
| azcopy jobs resume | Melanjutkan pekerjaan yang ada dengan ID pekerjaan yang ditentukan. |
| azcopy jobs show | Menampilkan informasi terperinci untuk ID pekerjaan yang ditentukan. |
| azcopy jobs | Subperintah terkait pengelolaan pekerjaan. |
| azcopy list | Mencantumkan entitas dalam sumber daya tertentu. |
| azcopy login | Masuk ke Azure Active Directory untuk mengakses sumber daya Azure Storage. |
| status masuk azcopy | Mencantumkan entitas dalam sumber daya tertentu. |
| azcopy logout | Melakukan logout pengguna dan menghentikan akses ke sumber daya Azure Storage. |
| azcopy make | Membuat kontainer atau file berbagi. |
| azcopy remove | Hapus blob atau file dari akun penyimpanan Azure. |
| azcopy sync | Mereplikasi lokasi sumber ke lokasi tujuan. |
Catatan
AzCopy tidak memiliki perintah untuk mengganti nama file.
Gunakan dalam skrip
Dapatkan tautan unduhan statis
Seiring waktu, tautan unduhan AzCopy akan menunjuk ke versi baru AzCopy. Jika skrip Anda mengunduh AzCopy, skrip mungkin berhenti berfungsi jika versi AzCopy yang lebih baru memodifikasi fitur yang bergantung pada skrip Anda.
Untuk menghindari masalah ini, dapatkan tautan statis (tidak berubah) ke versi AzCopy saat ini. Dengan begitu, skrip Anda mengunduh versi AzCopy yang sama persis setiap kali dijalankan.
Untuk mendapatkan tautan, jalankan perintah ini:
| Sistem operasi | Perintah |
|---|---|
| Linux | curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location |
| Windows (PowerShell Core 7) | (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue -SkipHttpErrorCheck).headers.location[0] |
| Windows (PowerShell 5.1) | (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue ).headers.location |
Catatan
Untuk --strip-components=1 Linux, pada tar perintah akan menghapus folder tingkat atas yang berisi nama versi, dan sebaliknya mengekstrak biner langsung ke folder saat ini. Ini memungkinkan skrip diperbarui dengan versi baru azcopy dengan hanya memperbarui wget URL.
URL muncul dalam keluaran perintah ini. Skrip Anda kemudian dapat mengunduh AzCopy dengan menggunakan URL tersebut.
| Sistem operasi | Perintah |
|---|---|
| Linux | wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1 |
| Windows | Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>> |
Lolos dari karakter khusus dalam token SAS
Dalam file batch yang memiliki .cmd ekstensi, Anda harus melarikan diri dari % karakter yang muncul di token SAS. Anda dapat melakukannya dengan menambahkan %karakter tambahan di samping karakter yang ada% di string token SAS.
Jalankan skrip dengan menggunakan Jenkins
Jika Anda berencana menggunakan Jenkins untuk menjalankan skrip, pastikan untuk menempatkan perintah berikut di awal skrip.
/usr/bin/keyctl new_session
Gunakan Azure Storage Explorer.
Storage Explorer menggunakan AzCopy untuk melakukan semua operasi transfer datanya. Anda dapat menggunakan Storage Explorer jika Anda ingin memanfaatkan keunggulan kinerja AzCopy, tetapi Anda lebih suka menggunakan antarmuka pengguna grafis daripada baris perintah untuk berinteraksi dengan file Anda.
Storage Explorer menggunakan kunci akun Anda untuk melakukan operasi, jadi setelah Masuk ke Storage Explorer, Anda tidak perlu memberikan kredensial otorisasi tambahan.
Mengonfigurasi, mengoptimalkan, dan memperbaiki
Lihat salah satu sumber daya berikut ini:
Gunakan versi sebelumnya
Jika Anda perlu menggunakan AzCopy versi sebelumnya, lihat salah satu tautan berikut:
Langkah berikutnya
Jika Anda memiliki pertanyaan, masalah, atau umpan balik umum, kirimkan di halaman GitHub.