Object Storage Service:sync (Sinkronisasi file OSS ke komputer lokal)

Batas jumlah file

Saat menjalankan perintah sync tanpa opsi --delete, tidak ada batasan jumlah file yang dapat disinkronkan. Jika Anda menyertakan --delete, Anda dapat menyinkronkan hingga 1 juta file sekaligus. Melebihi batas ini akan mengembalikan error: over max sync numbers 1000000.

Perbedaan antara sync dan cp

Selain perbedaan tersebut, perintah sync dan cp bekerja dengan cara yang serupa. Untuk informasi selengkapnya tentang cp, lihat Unduh objek.

Parameter

Perilaku sinkronisasi

Penyaringan file

Kinerja dan konkurensi

Unduhan yang dapat dilanjutkan

Penanganan tautan simbolik

Integritas data dan penanganan error

Output dan encoding

Penagihan

Contoh 1: Sinkronisasi dasar

Sinkronkan direktori localdir dari examplebucket ke direktori lokal destdir:

ossutil sync oss://examplebucket/localdir/ destdir/

Setelah sinkronisasi, objek a.txt, b.txt, dan subdirektori C ditambahkan ke destdir. File yang sudah ada d.txt dipertahankan karena opsi --delete tidak digunakan.

examplebucket           Local root directory
└── localdir/             └── destdir/
       ├── a.txt                ├── a.txt
       ├── b.txt                ├── b.txt
       └── C/                   ├── d.txt
                                └── C/

Contoh 2: Sinkronisasi dengan penghapusan dan backup

Sinkronkan localdir ke destdir dan hapus file dari destdir yang tidak ada di localdir. Pindahkan file yang dihapus ke direktori backup alih-alih menghapusnya secara permanen:

ossutil sync oss://examplebucket/localdir/ destdir/ --delete --backup-dir backup/

Setelah sinkronisasi, destdir hanya berisi objek dari localdir. File d.txt, yang hanya ada di destdir, dipindahkan ke direktori backup:

examplebucket              Local root directory
└── localdir/               ├── destdir/
       ├── a.txt            │     ├── a.txt
       ├── b.txt            │     ├── b.txt
       └── C/               │     └── C/
                            └── backup/
                                   └──d.txt

Contoh 3: Sinkronisasi hanya jenis file tertentu

Sinkronkan hanya file .txt dari localdir, mengecualikan semua jenis file lainnya:

ossutil sync oss://examplebucket/localdir/ destdir/ --include "*.txt"

Contoh 4: Mengecualikan jenis file tertentu

Sinkronkan semua objek dari localdir kecuali file .log:

ossutil sync oss://examplebucket/localdir/ destdir/ --exclude "*.log"

Contoh 5: Sinkronisasi inkremental

Sinkronkan hanya objek yang baru atau telah dimodifikasi sejak sinkronisasi terakhir:

ossutil sync oss://examplebucket/localdir/ destdir/ -u

Dengan opsi --update (-u), ossutil melewati objek yang waktu modifikasi terakhirnya di OSS sama dengan atau lebih lama daripada file lokal yang sesuai.

Contoh 6: Sinkronisasi hanya direktori tingkat atas

Sinkronkan hanya objek yang berada langsung di localdir, tanpa merekursif ke subdirektori:

ossutil sync oss://examplebucket/localdir/ destdir/ --only-current-dir

Contoh 7: Percepat sinkronisasi berulang dengan snapshot

Gunakan --snapshot-path untuk menyimpan status sinkronisasi. Pada eksekusi berikutnya, ossutil membaca snapshot untuk mengidentifikasi objek yang berubah dan hanya menyinkronkan objek tersebut, sehingga mengurangi waktu yang diperlukan untuk sinkronisasi berulang pada direktori yang sama:

ossutil sync oss://examplebucket/localdir/ destdir/ --snapshot-path /tmp/oss-sync-snapshot/

Contoh 8: Sesuaikan konkurensi untuk sinkronisasi skala besar

Saat menyinkronkan direktori yang berisi file kecil dan besar, sesuaikan --job dan --parallel untuk mengoptimalkan throughput:

• --job mengontrol jumlah objek yang diproses secara bersamaan. Tingkatkan nilai ini saat menyinkronkan banyak file kecil.

• --parallel mengontrol jumlah bagian dari satu objek besar yang diunduh secara bersamaan. Tingkatkan nilai ini saat mengunduh beberapa file besar.

ossutil sync oss://examplebucket/data/ /local/data/ --job 10 --parallel 5

Untuk membatasi kecepatan unduh hingga 10.240 KB/s (10 MB/s) dan menghindari saturasi lebar pita jaringan Anda:

ossutil sync oss://examplebucket/data/ /local/data/ --maxdownspeed 10240

Output sukses

Saat sinkronisasi berhasil diselesaikan, ossutil mengembalikan output yang mirip dengan berikut. Perhatikan bahwa output menggunakan "upload" terlepas dari arah sinkronisasi; ini adalah format output standar ossutil.

Succeed: Total num: 2, size: 750,081. OK num: 2(upload 2 files).

average speed 1641000(byte/s)