Azure Cosmos DB NoSQL hesabını başka bir bölgeye taşıma

Makale
07/04/2024

Bu makalede aşağıdakilerden herhangi biri açıklanır:

Azure Cosmos DB'de verilerin çoğaltıldığı bir bölgeyi yeniden yerleştirin.
Hesap (Azure Resource Manager) meta verilerini ve verilerini bir bölgeden diğerine geçirin.

Önkoşullar

Kaynak ve hedef kaynak grubu örneği için temsilci izni ve "User.ReadBasic.All" için "API izni" ile bir uygulama kaydı oluşturulmalıdır.
Seçilen Cosmos DB API'sinin kaynaktan hedefe aynı kalması gerekir. Bu belgede SQL DB API'si kullanılır.
Hesap adları, tümü küçük harfle olmak üzere 44 karakterle sınırlandırılmalıdır.
Azure Cosmos hesabına konum eklediğinizde veya kaldırdığınızda, diğer özellikleri aynı anda değiştiremezsiniz.
Tüm Cosmos DB bağımlı kaynaklarını tanımlayın.

Kesinti süresi

Hizmet Uç Noktaları için Dikkat Edilmesi Gerekenler

Azure Cosmos DB için sanal ağ hizmet uç noktaları, belirtilen sanal ağa erişimi kısıtlar. Uç noktalar ayrıca IPv4 (internet protokolü sürüm 4) adres aralıkları listesine erişimi kısıtlayabilir. Event Hubs'a bu kaynakların dışından bağlanan tüm kullanıcıların erişimi reddedilir. Hizmet uç noktaları Event Hubs kaynağının kaynak bölgesinde yapılandırıldıysa, hedef bölgede de aynı işlem yapılması gerekir.

Azure Cosmos DB'nin hedef bölgeye başarılı bir şekilde yeniden oluşturulması için VNet ve Alt Ağ önceden oluşturulmalıdır. Bu iki kaynağın taşınması Azure Kaynak Taşıyıcı aracıyla gerçekleştiriliyorsa, hizmet uç noktaları otomatik olarak yapılandırılmaz. Bu nedenle bunların el ile yapılandırılması gerekir. Bu yapılandırma Azure portalı, Azure CLI veya Azure PowerShell üzerinden yapılabilir.

Veri olmadan yeniden dağıtma

Cosmos DB örneğinin yapılandırma ve müşteri verileri olmadan tek başına yeniden konumlandırılması gereken durumlarda, örneğin kendisi Microsoft.DocumentDB databaseAccounts kullanılarak oluşturulabilir

Verilerle yeniden dağıtma

Azure Cosmos DB yerel olarak veri çoğaltmayı desteklediğinden verileri bir bölgeden diğerine taşımak kolaydır. Bunu Azure portalını, Azure PowerShell'i veya Azure CLI'yı kullanarak gerçekleştirebilirsiniz. Aşağıdaki adımları içerir:

Hesaba yeni bir bölge ekleyin.

Azure Cosmos DB hesabına yeni bölge eklemek için bkz . Azure Cosmos DB hesabına bölge ekleme/kaldırma.
Yeni bölgeye el ile yük devretme gerçekleştirin.

Kaldırılan bölge şu anda hesabın yazma bölgesi olduğunda, önceki adımda eklenen yeni bölgeye yük devretme başlatmanız gerekir. Bu, sıfır kapalı kalma süresine sahip bir işlemdir. Birden çok bölgeli bir hesapta okuma bölgesini taşıyorsanız bu adımı atlayabilirsiniz.

Yük devretme başlatmak için bkz . Azure Cosmos DB hesabında el ile yük devretme gerçekleştirme.
Özgün bölgeyi kaldırın.

Azure Cosmos DB hesabından bölge kaldırmak için bkz . Azure Cosmos DB hesabınızdan bölge ekleme/kaldırma.

Not

Zaman uyumsuz aktarım hızı ölçeklendirme işlemi devam ederken bir yük devretme işlemi gerçekleştirirseniz veya yeni bir bölge eklerseniz/kaldırırsanız, aktarım hızı ölçeği artırma işlemi duraklatılır. Yük devretme veya bölge ekleme/kaldırma işlemi tamamlandığında otomatik olarak sürdürülür.

Azure Cosmos DB hesabı meta verilerini yeniden dağıtma

Azure Cosmos DB, hesap meta verilerinin bir bölgeden diğerine geçirilmesini yerel olarak desteklemez. Hem hesap meta verilerini hem de müşteri verilerini bir bölgeden diğerine geçirmek için, istenen bölgede yeni bir hesap oluşturmanız ve ardından verileri el ile kopyalamanız gerekir.

Önemli

Veriler depolandığında veya farklı bir bölgeye taşındığında hesap meta verilerinin geçirilmesi gerekmez. Hesap meta verilerinin bulunduğu bölge, Azure Cosmos DB hesabınızın performansı, güvenliği veya diğer operasyonel yönlerini etkilemez.

NoSQL için API için neredeyse sıfır kapalı kalma süresi geçişi, değişiklik akışının veya onu kullanan bir aracın kullanılmasını gerektirir.

Aşağıdaki adımlar, NoSQL api'sinin Azure Cosmos DB hesabını ve verilerini bir bölgeden diğerine geçirmeyi gösterir:

İstenen bölgede yeni bir Azure Cosmos DB hesabı oluşturun.

Azure portalı, PowerShell veya Azure CLI aracılığıyla yeni bir hesap oluşturmak için bkz . Azure Cosmos DB hesabı oluşturma.
Yeni bir veritabanı ve kapsayıcı oluşturun.

Yeni bir veritabanı ve kapsayıcı oluşturmak için bkz . Azure Cosmos DB kapsayıcısı oluşturma.
Azure Cosmos DB Spark Bağlayıcısı canlı geçiş örneğini kullanarak verileri geçirme.

Neredeyse sıfır kapalı kalma süresiyle verileri geçirmek için bkz . Spark Bağlayıcısı ile Azure Cosmos DB SQL API Kapsayıcıları verilerini dinamik geçirme.
Uygulama bağlantı dizesi güncelleştirin.

Live Data Migration örneği çalışmaya devam ettiyse, uygulamanızın yeni dağıtımında bağlantı bilgilerini güncelleştirin. Azure portalından uygulamanızın uç noktalarını ve anahtarlarını alabilirsiniz.
İstekleri yeni uygulamaya yeniden yönlendirin.

Yeni uygulama Azure Cosmos DB'ye bağlandıktan sonra istemci isteklerini yeni dağıtımınıza yönlendirebilirsiniz.
Artık ihtiyacınız olmayan kaynakları silin.

İstekler artık yeni örneğe tamamen yeniden yönlendirildiğinde, eski Azure Cosmos DB hesabını silebilir ve Canlı Veri Geçişcisi örneğini durdurabilirsiniz.

Sonraki adımlar

Azure Cosmos DB hesabının yanı sıra veritabanlarını ve kapsayıcıları yönetme hakkında daha fazla bilgi ve örnek için aşağıdaki makaleleri okuyun:

Aracılığıyla paylaş