Merelokasi akun NoSQL Azure Cosmos DB ke wilayah lain
Ada berbagai alasan mengapa Anda mungkin ingin memindahkan sumber daya Azure yang ada dari satu wilayah ke wilayah lain. Anda mungkin ingin:
- Manfaatkan wilayah Azure baru.
- Sebarkan fitur atau layanan yang hanya tersedia di wilayah tertentu.
- Memenuhi persyaratan kebijakan dan tata kelola internal.
- Selaras dengan merger dan akuisisi perusahaan
- Memenuhi persyaratan perencanaan kapasitas.
Artikel ini menjelaskan cara:
- Merelokasi wilayah tempat data direplikasi di Azure Cosmos DB.
- Melakukan migrasi metadata dan data akun (Azure Resource Manager) dari satu wilayah ke wilayah lainnya.
Prasyarat
Pendaftaran aplikasi harus dibuat dengan izin yang didelegasikan ke instans grup sumber daya sumber dan target dan "izin API" untuk "User.ReadBasic.All".
API Cosmos DB yang dipilih harus tetap sama dari sumber ke target. Dokumen ini menggunakan SQL DB API.
Nama akun harus dibatasi hingga 44 karakter, semua huruf kecil.
Saat menambahkan atau menghapus lokasi ke akun Azure Cosmos, Anda tidak dapat mengubah properti lain secara bersamaan.
Identifikasi semua sumber daya dependen Cosmos DB.
Waktu henti
Pertimbangan untuk Titik Akhir Layanan
Titik akhir layanan jaringan virtual untuk Azure Cosmos DB membatasi akses ke jaringan virtual tertentu. Titik akhir juga dapat membatasi akses ke daftar rentang alamat IPv4 (protokol internet versi 4). Setiap pengguna yang terhubung ke Azure Event Hubs dari luar sumber tersebut ditolak aksesnya. Jika Titik akhir layanan dikonfigurasi di wilayah sumber untuk sumber daya Azure Event Hubs, hal yang sama perlu dilakukan di target satu.
Agar rekreasi Azure Cosmos DB berhasil ke wilayah target, VNet dan Subnet harus dibuat sebelumnya. Jika pemindahan kedua sumber daya ini dilakukan dengan alat Azure Resource Mover, titik akhir layanan tidak akan dikonfigurasi secara otomatis. Oleh karena itu, mereka perlu dikonfigurasi secara manual, yang dapat dilakukan melalui portal Azure, Azure CLI, atau Azure PowerShell.
Menyebarkan ulang tanpa data
Untuk kasus di mana instans Cosmos DB perlu direlokasi sendiri tanpa konfigurasi dan data pelanggan, instans itu sendiri dapat dibuat menggunakan databaseAccounts Microsoft.DocumentDB
Menyebarkan ulang dengan data
Azure Cosmos DB mendukung replikasi data secara alami, agar pemindahan data dari satu wilayah ke wilayah lain menjadi sederhana. Anda dapat mencapainya menggunakan portal Microsoft Azure, Azure PowerShell, atau Azure CLI. Tindakan ini memerlukan langkah-langkah berikut:
Menambahkan wilayah baru ke akun.
Untuk menambahkan wilayah baru ke akun Azure Cosmos DB, lihat Menambahkan/menghapus wilayah ke akun Azure Cosmos DB.
Melakukan failover manual ke wilayah baru.
Jika wilayah yang sedang dihapus saat ini merupakan wilayah penulisan untuk akun tersebut, Anda harus memulai failover ke wilayah baru yang ditambahkan di langkah sebelumnya. Ini adalah operasi tanpa waktu henti. Jika Anda memindahkan wilayah baca di akun beberapa wilayah, Anda dapat melewati langkah ini.
Untuk memulai failover, lihat Melakukan failover manual pada akun Azure Cosmos DB.
Menghapus wilayah asli.
Untuk menghapus wilayah dari akun Azure Cosmos DB, lihat Menambahkan/menghapus wilayah dari akun Azure Cosmos DB Anda.
Catatan
Jika Anda menjalankan operasi failover atau menambahkan/menghapus wilayah baru saat operasi penskalaan throughput asinkron sedang berlangsung, operasi peningkatan skala throughput akan dijeda. Operasi ini akan dilanjutkan secara otomatis ketika operasi failover atau tambahkan/hapus wilayah selesai.
Menyebarkan ulang metadata akun Azure Cosmos DB
Azure Cosmos DB tidak mendukung secara alami migrasi metadata akun dari satu wilayah ke wilayah lain. Untuk memigrasikan metadata akun dan data pelanggan dari satu wilayah ke wilayah lain, Anda harus membuat akun baru di wilayah yang diinginkan lalu menyalin data secara manual.
Penting
Tidak perlu memigrasikan metadata akun jika data tersebut disimpan atau dipindahkan ke wilayah lain. Wilayah tempat metadata akun berada tidak berdampak pada performa, keamanan, atau aspek operasional lainnya pada akun Azure Cosmos DB Anda.
Migrasi waktu henti mendekati nol untuk API untuk NoSQL memerlukan penggunaan umpan perubahan atau alat yang menggunakannya.
Langkah-langkah berikut menunjukkan cara memigrasikan akun Azure Cosmos DB untuk API untuk NoSQL dan datanya dari satu wilayah ke wilayah lain:
Membuat akun Azure Cosmos DB baru di wilayah yang diinginkan.
Untuk membuat akun baru melalui portal Microsoft Azure, PowerShell, atau Azure CLI, lihat Membuat akun Azure Cosmos DB.
Membuat database dan kontainer baru.
Untuk membuat database dan kontainer baru, lihat Membuat kontainer Azure Cosmos DB.
Migrasikan data dengan menggunakan sampel migrasi langsung Azure Cosmos DB Spark Connector.
Untuk memigrasikan data dengan waktu henti mendekati nol, lihat Data Live Migrate Azure Cosmos DB SQL API Containers dengan Spark Connector.
Memperbarui string koneksi aplikasi.
Dengan sampel Migrasi Data Langsung masih berjalan, perbarui informasi koneksi dalam penyebaran baru aplikasi Anda. Anda dapat mengambil titik akhir dan kunci untuk aplikasi Anda dari portal Microsoft Azure.
Mengalihkan permintaan ke aplikasi baru.
Setelah aplikasi baru terhubung ke Azure Cosmos DB, Anda dapat mengalihkan permintaan klien ke penyebaran baru Anda.
Menghapus sumber daya yang tidak lagi diperlukan.
Dengan permintaan yang sekarang sepenuhnya dialihkan ke instans baru, Anda dapat menghapus akun Azure Cosmos DB lama dan menghentikan sampel Live Data Migrator.
Langkah berikutnya
Untuk informasi dan contoh selengkapnya tentang cara mengelola akun Azure Cosmos DB serta database dan kontainer, baca artikel berikut: