Pekerjaan penyalinan kontainer di Azure Cosmos DB (pratinjau)
BERLAKU UNTUK: Nosql MongoDB Cassandra
Anda dapat melakukan salinan kontainer offline dalam akun Azure Cosmos DB menggunakan pekerjaan penyalinan kontainer.
Anda mungkin perlu menyalin data dalam akun Azure Cosmos DB jika Anda ingin mencapai salah satu skenario ini:
- Salin semua item dari satu kontainer ke kontainer lainnya.
- Ubah granularitas di mana throughput disediakan, dari database ke kontainer dan sebaliknya.
- Ubah kunci partisi kontainer.
- Perbarui kunci unik untuk kontainer.
- Mengganti nama kontainer atau database.
- Ubah mode kapasitas akun dari tanpa server ke yang disediakan atau sebaliknya.
- Mengadopsi fitur baru yang hanya didukung untuk kontainer baru, misalnya kunci partisi hierarkis.
Pekerjaan salinan kontainer dapat dibuat dan dikelola dengan menggunakan perintah Azure CLI.
Mulai
Untuk memulai, daftarkan fitur pratinjau yang relevan di portal Azure.
Salinan kontainer di seluruh akun Azure Cosmos DB
NoSQL API
Untuk mulai menggunakan salinan kontainer offline lintas akun untuk Akun Azure Cosmos DB for NoSQL API, daftar untuk bendera fitur pratinjau Salinan kontainer offline lintas akun (NoSQL) di Fitur Pratinjau di portal Azure. Setelah pendaftaran selesai, pratinjau tersebut akan berlaku untuk semua akun API NoSQL dalam langganan.
Salinan kontainer dalam akun Azure Cosmos DB
API NoSQL dan Cassandra
Untuk mulai menggunakan salinan kontainer offline intra-akun untuk akun NoSQL dan Cassandra API, daftar untuk bendera fitur pratinjau Salinan kontainer offline Intra-account (Cassandra & NoSQL) di Fitur Pratinjau di portal Azure. Ketika pendaftaran selesai, pratinjau efektif untuk semua Cassandra dan API untuk akun NoSQL dalam langganan.
API untuk MongoDB
Untuk mulai menggunakan salinan kontainer offline intra-akun untuk Azure Cosmos DB untuk akun MongoDB, daftar untuk bendera fitur pratinjau salinan offline intra-account (MongoDB) di Fitur Pratinjau di portal Azure. Setelah pendaftaran selesai, pratinjau tersebut akan berlaku untuk semua API untuk akun MongoDB dalam langganan.
Menyalin data kontainer
- Buat kontainer Azure Cosmos DB target dengan menggunakan pengaturan yang ingin Anda gunakan (kunci partisi, granularitas throughput, unit permintaan, kunci unik, dan sebagainya).
- Hentikan operasi pada kontainer sumber dengan menjeda instans aplikasi atau klien apa pun yang terhubung ke kontainer tersebut.
- Buat pekerjaan penyalinan kontainer.
- Pantau kemajuan pekerjaan penyalinan kontainer dan tunggu hingga selesai.
- Lanjutkan operasi dengan mengarahkan aplikasi atau klien dengan tepat ke salinan kontainer sumber atau target seperti yang dimaksudkan.
Bagaimana cara kerja salinan kontainer?
Pekerjaan penyalinan kontainer melakukan salinan data offline dengan menggunakan log umpan perubahan bertambah bertahap kontainer sumber.
- Platform ini mengalokasikan instans komputasi sisi server untuk akun Azure Cosmos DB tujuan.
- Instans dialokasikan ketika satu atau beberapa pekerjaan salinan kontainer dibuat dalam akun tersebut.
- Pekerjaan salinan kontainer berjalan pada instans ini.
- Satu pekerjaan dijalankan di semua instans kapan saja.
- Instans dibagikan oleh semua pekerjaan salinan kontainer yang berjalan dalam akun yang sama.
- Platform mungkin membatalkan alokasi instans jika tidak aktif selama lebih dari 15 menit.
Catatan
Saat ini kami hanya mendukung pekerjaan penyalinan kontainer offline. Kami sangat menyarankan Agar Anda berhenti melakukan operasi apa pun pada kontainer sumber sebelum Anda memulai salinan kontainer. Penghapusan item dan pembaruan yang dilakukan pada kontainer sumber setelah Anda memulai pekerjaan penyalinan mungkin tidak ditangkap. Jika Anda terus melakukan operasi pada kontainer sumber saat pekerjaan kontainer sedang berlangsung, Anda mungkin memiliki data duplikat atau hilang pada kontainer target.
Faktor-faktor yang memengaruhi tingkat pekerjaan salinan kontainer
Tingkat kemajuan pekerjaan penyalinan kontainer ditentukan oleh faktor-faktor berikut:
Pengaturan kontainer sumber atau throughput database.
Pengaturan kontainer target atau throughput database.
Tip
Atur throughput kontainer target ke setidaknya dua kali throughput kontainer sumber.
Instans komputasi sisi server yang dialokasikan ke akun Azure Cosmos DB untuk melakukan transfer data.
Penting
SKU default menawarkan dua instans sisi server 4-vCPU 16 GB per akun.
Pembatasan
Kriteria kelayakan pratinjau
Pekerjaan penyalinan kontainer tidak berfungsi dengan akun yang mengaktifkan kemampuan berikut. Nonaktifkan fitur-fitur ini sebelum Anda menjalankan pekerjaan penyalinan kontainer:
Konfigurasi akun
Pengaturan Time to Live (TTL) tidak disesuaikan dalam kontainer tujuan. Akibatnya, jika dokumen belum kedaluwarsa dalam kontainer sumber, dokumen memulai hitungan mundurnya di kontainer tujuan.
Tanya Jawab Umum
Apakah ada perjanjian tingkat layanan untuk pekerjaan salinan kontainer?
Pekerjaan salinan kontainer saat ini didukung berdasarkan upaya terbaik. Kami tidak memberikan jaminan perjanjian tingkat layanan (SLA) untuk waktu yang diperlukan agar pekerjaan selesai.
Bisakah saya membuat beberapa pekerjaan salinan kontainer dalam akun?
Ya, Anda dapat membuat beberapa pekerjaan dalam akun yang sama. Pekerjaan berjalan berturut-turut. Anda dapat mencantumkan semua pekerjaan yang dibuat dalam akun, dan memantau kemajuannya.
Bisakah saya menyalin seluruh database dalam akun Azure Cosmos DB?
Anda harus membuat pekerjaan untuk setiap kontainer dalam database.
Saya memiliki akun Azure Cosmos DB dengan beberapa wilayah. Di wilayah mana pekerjaan penyalinan kontainer akan berjalan?
Pekerjaan penyalinan kontainer berjalan di wilayah tulis. Dalam akun yang dikonfigurasi dengan penulisan multi-wilayah, pekerjaan berjalan di salah satu wilayah dalam daftar wilayah tulis.
Apa yang terjadi pada pekerjaan penyalinan kontainer saat wilayah tulis akun berubah?
Wilayah tulis akun mungkin berubah dalam skenario langka pemadaman wilayah atau karena failover manual. Dalam skenario ini, pekerjaan penyalinan kontainer yang tidak lengkap yang dibuat dalam akun gagal. Anda harus membuat ulang pekerjaan yang gagal ini. Pekerjaan yang dibuat ulang kemudian berjalan di wilayah tulis baru (saat ini).
Wilayah yang didukung
Saat ini, salinan kontainer hanya didukung di wilayah berikut:
Amerika | Eropa dan Afrika | Asia Pasifik |
---|---|---|
Brasil Selatan | Prancis Tengah | Australia Tengah |
Kanada Tengah | Prancis Selatan | Australia Tengah 2 |
Kanada Timur | Jerman Utara | Australia Timur |
US Tengah | Jerman Barat Tengah | India Tengah |
US Tengah EUAP | Eropa Utara | Jepang Timur |
AS Timur | Norwegia Timur | Korea Tengah |
AS Timur 2 | Norwegia Barat | Asia Tenggara |
US Timur 2 EUAP | Swiss Utara | UAE Tengah |
US Tengah Utara | Swiss Barat | India Barat |
US Tengah Selatan | UK Selatan | Asia Timur |
AS Tengah Bagian Barat | UK Barat | Malaysia Selatan |
US Barat | Eropa Barat | Jepang Barat |
US Barat 2 | Israel Tengah | Australia Tenggara |
Tidak didukung | Afrika Selatan Utara | Tidak didukung |
Masalah umum dan umum
Kesalahan - Sumber daya pemilik tidak ada.
Jika pembuatan pekerjaan gagal dan menampilkan kesalahan Sumber daya Pemilik tidak ada (kode kesalahan 404), kontainer target belum dibuat atau nama kontainer yang digunakan untuk membuat pekerjaan tidak cocok dengan nama kontainer yang sebenarnya.
Pastikan bahwa kontainer target dibuat sebelum Anda menjalankan pekerjaan seperti yang ditentukan dalam gambaran umum, dan pastikan bahwa nama kontainer dalam pekerjaan cocok dengan nama kontainer yang sebenarnya.
"code": "404", "message": "Response status code does not indicate success: NotFound (404); Substatus: 1003; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: (Message: {\"Errors\":[\"Owner resource does not exist\"]
Kesalahan - Permintaan tidak sah.
Jika permintaan gagal dan menampilkan kesalahan Tidak Sah (kode kesalahan 401), otorisasi lokal mungkin dinonaktifkan. Pelajari cara mengaktifkan otorisasi lokal.
Pekerjaan penyalinan kontainer menggunakan kunci primer untuk mengautentikasi. Jika otorisasi lokal dinonaktifkan, pembuatan pekerjaan gagal. Otorisasi lokal harus diaktifkan agar pekerjaan penyalinan kontainer berfungsi.
"code": "401", "message": " Response status code does not indicate success: Unauthorized (401); Substatus: 5202; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: Local Authorization is disabled. Use an AAD token to authorize all requests."
Kesalahan - Kesalahan saat mendapatkan sumber daya untuk pekerjaan.
Kesalahan ini mungkin terjadi karena masalah server internal. Untuk mengatasi masalah ini, hubungi Dukungan Microsoft dengan membuka Permintaan Dukungan Baru di portal Azure. Untuk Jenis Masalah, pilih Migrasi Data. Untuk Subjenis masalah, pilih Salinan kontainer intra-account.
"code": "500" "message": "Error while getting resources for job, StatusCode: 500, SubStatusCode: 0, OperationId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Langkah berikutnya
- Pelajari cara membuat, memantau, dan mengelola pekerjaan salinan kontainer di akun Azure Cosmos DB dengan menggunakan perintah CLI.