Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu makale, MongoDB'den Azure DocumentDB'ye geçişi planlamanıza ve yürütmenize yardımcı olur. Kullanılabilir geçiş araçlarını, geçişin temel aşamalarını ve riski azaltmaya ve kapalı kalma süresini en aza indirmeye yönelik en iyi yöntemleri kapsar.
İster şirket içi MongoDB sunucusundan, ister bulutta barındırılan bir VM'den ister yönetilen MongoDB hizmetinden geçiş yapın, bu makaledeki geçiş seçenekleri, yönergeler ve en iyi yöntemler geçerlidir.
Önemli geçiş aşamaları
Başarılı bir geçiş, bu ayrı aşamaları izler. Her aşamanın belirli hedefleri ve başarı ölçütleri vardır.
1. Değerlendirme
Desteklenmeyen özellikleri, komutları, sorgu söz dizimini ve dizin türlerini belirlemek için Azure DocumentDB Geçiş uzantısı kullanarak kaynak MongoDB'nizde otomatik tarama çalıştırın. Değerlendirme ayrıca MongoDB sürümüne, lisansına, örnek türüne ve veritabanı ve koleksiyon ölçümlerine genel bir bakış sağlar. Şema değişikliklerini planlamak ve geçiş öncesinde gerekli yeniden düzenlemeyi belirlemek için bu bulguları kullanın.
Tip
Desteklenen MongoDB Sorgu Dili (MQL) özelliklerini ve söz dizimini ayrıntılı olarak gözden geçirin ve gerçek geçişten önce bir kavram kanıtı gerçekleştirin.
2. Hazırlama
Değerlendirme raporunu analiz edin ve kaynak TPS'yi (saniyedeki işlemler) ölçün. Hedef İşlem Katmanı, Depolama Katmanı ve parça sayısı oluşturmak için temsili verilerde deneme geçişleri çalıştırın. Hedef yapılandırmanın gereksinimlerinizi karşıladığından emin olmak için performans testleri gerçekleştirin.
Geçişe başlamadan önce yaşam süresi (TTL) dizinlerinin tanımlarını kaydedin ve bu dizinleri kaynak koleksiyonlardan kaldırın. Geçiş veya son veri doğrulaması sırasında hedef koleksiyonların TTL dizinlerine sahip olmadığından emin olun. Geçiş ve doğrulama tamamlandıktan sonra, kaydedilen tanımları kullanarak hedefte TTL dizinlerini oluşturun.
3. İyileştirme
Üretim sorgu desenlerinizle eşleşen uygun parça anahtarları ve dizinlerle hedef koleksiyonları hazırlayın. Birden çok parça kullanıyorsanız, yükü dengelemek ve parçalar arası işlemleri en aza indirmek için koleksiyonları parçalar arasında dağıtmaya karar verin.
4. Geçiş
Verileri çevrimdışı veya çevrimiçi modda taşımak için geçiş işini çalıştırın:
- Çevrimdışı geçiş: Başlangıçta kaynağın anlık görüntüsünü alır ve anlık görüntüyü hedefe toplu olarak kopyalar. İşlem, anlık görüntüden sonra kaynakta eklenen, güncelleştirilen veya silinen verileri kopyalamaz. Gerekli kapalı kalma süresi, toplu kopyalamanın ne kadar sürdüğüne bağlıdır.
- Çevrimiçi geçiş: Çevrimdışı olarak aynı toplu kopyalamayı gerçekleştirir, ancak işlem boyunca değişiklik akışını da izler. Geçiş sırasında yapılan değişiklikler hedefe çoğaltılır, bu nedenle gerekli uygulama kesintisi süresi en düşük düzeydedir. Bu yöntem, kaynakta bir değişiklik akışı ve yeterince büyük bir oplog gerektirir.
Tip
Çevrimiçi geçişler için, geçiş penceresi sırasında tüm değişiklikleri yakalamak için değişiklik akışının etkinleştirildiğinden ve oplog'un kaynak MongoDB'nizde uygun şekilde boyutlandırılmış olduğundan emin olun.
Kullanılabilir araçlar için bkz Geçiş araçları.
5. Doğrulama
Geçiş işleminin en son güncelleştirmeler de dahil olmak üzere tüm verilerin kopyalandığını doğrulayın. Belge sayılarını karşılaştırın, örnek tabanlı doğrulamayı çalıştırın ve dizinlerin ve veri yapılarının hedef üzerindeki beklentilerle eşleştiğinden emin olun. Doğrulamayı yinelenebilir ve tutarlı hale getirmek için otomatik betikleri kullanın.
6. Kesintisiz Geçiş
Okuma trafiğini hedefe taşıyın ve işlevsel veya performans sorunları olmadığını doğrulayın. Okuma doğrulaması başarılı olduktan sonra yazma trafiğini hedefe taşıyın. Kesilme penceresi sırasında olası anomalileri yakından izleyin.
Geçiş araçları
Bu makalede açıklanan araçlar, MongoDB iş yüklerinizi aşağıdaki kaynaklardan geçirmenize yardımcı olabilir:
- MongoDB Sanal Makinesi
- MongoDB Atlası
- AWS DocumentDB
Azure DocumentDB Geçiş Uzantısı
Visual Studio Code içinde Azure DocumentDB Migration Extension kullanarak geçiş işlerinizi oluşturun ve yönetin. Bu çözüm basitlik, güvenlik ve sıfır kesinti için tasarlanmıştır.
Bu araç, hizmet kesintisi olmadan iş yüklerini geçirmenize yardımcı olmak için açık, adım adım yönergeler sağlar. Şunları yapabilirsiniz:
- Geçiş için belirli veritabanlarını ve koleksiyonları seçme
- Tanıdık VS Code arabirimindeki tüm adımları gerçekleştirme
- İşlem boyunca güvenli bağlantı olduğundan emin olun
- Uzantıyı kullanmak için sıfır maliyetin keyfini çıkarın
Azure DocumentDB Geçiş Uzantısı'nı kullanarak, denetim ve güvenliği korurken geçiş yolculuğunuzu kolaylaştırabilir ve bunların tümünü ek altyapı veya karmaşıklık olmadan yapabilirsiniz.
Azure Veritabanı Geçiş Hizmeti
Azure portalındaAzure Veritabanı Geçiş Hizmeti kullanarak geçiş işleri oluşturun ve yönetin. Visual Studio Code uzantısı yüklemek istemediğinizde portal deneyimini kullanın.
Azure Veritabanı Geçiş Hizmeti destekler:
- Çevrimiçi ve çevrimdışı geçişler.
- Public ve private bağlantı.
- Tek tek veritabanlarının ve koleksiyonların seçimi ve yapılandırması.
- portalı kapattıktan sonra devam eden Azure’da barındırılan geçiş yürütmesi.
Web App Utility (Kullanımdan kaldırıldı)
Important
Web Uygulaması Yardımcı Programı kullanım dışıdır ve yeni geçişler için önerilmez. Desteklenen çevrimiçi ve çevrimdışı geçişler için Azure portalında Azure Veritabanı Geçiş Hizmeti veya Azure DocumentDB Geçiş Uzantısı kullanın.
Web Uygulaması Yardımcı Programı'nı kullanan mevcut bir geçişiniz varsa, dağıtım ve kullanım yönergeleri için MongoMigrationwebBasedUtility deposuna bakın. Yardımcı program çevrimiçi ve çevrimdışı geçişleri destekler ve sanal ağınızda özel olarak dağıtılabilir.
Önemli özellikler şunlardır:
- Bağlantı kaybı veya geçici hatalar sonrasında otomatik sürdürme
- Geçişleri yapılandırmaya yönelik grafiksel arayüz
- C# kaynak koduna erişim
- Geçiş performansını ölçeklendirmek için özelleştirilebilir Azure App Service planları
Yerel MongoDB araçları (çevrimdışı)
Veri kümelerini çevrimdışı (canlı değişiklikleri çoğaltmadan) Azure DocumentDB teklifine geçirmek için mongodump/mongorestore, mongoexport/mongoimport gibi yerel MongoDB araçlarını da kullanabilirsiniz.
| Scenario | MongoDB yerel aracı |
|---|---|
| Veritabanı verilerinin alt kümesini taşıma (JSON veya CSV tabanlı) | mongoexport/mongoimport |
| Veritabanının tamamını taşıma (BSON tabanlı) | mongodump/mongorestore |
-
mongoexport/mongoimport, MongoDB veritabanınızın bir alt kümesini geçirmek için en iyi geçiş araçları çiftidir.
- mongoexport mevcut verilerinizi insan tarafından okunabilir bir JSON veya CSV dosyasına aktarır. mongoexport , dışarı aktarılacak mevcut verilerinizin alt kümesini belirten bir bağımsız değişken alır.
- mongoimport bir JSON veya CSV dosyası açar ve içeriği hedef veritabanı örneğine ekler (bu örnekte Azure DocumentDB).
- JSON ve CSV kompakt biçimler değildir. mongoimport Azure DocumentDB'ye veri gönderdiğinden ek ağ ücretlerine maruz kalabilirsiniz.
-
mongodump/mongorestore , MongoDB veritabanınızın tamamını geçirmek için en iyi geçiş araçları çiftidir. Kompakt BSON biçimi, veriler Azure DocumentDB'ye eklendiğinden ağ kaynaklarının daha verimli kullanılmasını sağlar.
- mongodump , mevcut verilerinizi BSON dosyası olarak dışarı aktarır.
- mongorestore, BSON dosya dökümünüzü Azure DocumentDB'ye aktarır.
Note
MongoDB yerel araçları, verileri yalnızca konak donanımının izin verdiği kadar hızlı taşıyabilir.
Geçiş için en iyi yöntemler
Aşağıdaki işlem akışında, uygulama ve geçiş ekiplerinin MongoDB'den Azure DocumentDB'ye başarılı bir geçişi tamamlamak için tam geçiş öncesinde, sırasında ve sonrasında nasıl koordine olduğu gösterilmektedir.
Tam geçiş işlemi akışı
Çevrimiçi geçiş tam geçişi sırasında geçiş aracı, bekleyen değişiklikleri çoğaltmayı tamamlayabilmesi ve geçişi tamamlayabilmesi için kaynak koleksiyonlarda değişiklik yapılmayan bir pencere arar. Geçiş başlamadan önce kaynak TTL dizinlerini kaldırın ve bu değişikliksiz pencereyi oluşturmak için geçiş devralma aşamasında uygulama yazma işlemlerini durdurun. Yazma işlemleri veya TTL temelli silme işlemleri devam ederse, araç değişiklik yapılmayan bir pencere bulamayabilir ve bu değişiklikler durdurulana kadar tam geçiş devam edebilir.
Aşağıdaki işlemi sırayla tamamlamak için uygulama ve geçiş ekiplerini koordine edin:
- Uygulama ekibi, trafiğin düşük olduğu bir tam geçiş penceresi belirler ve bunu her iki takıma da iletir.
- Geçiş ekibi MongoDB ve Azure DocumentDB koleksiyonlarını karşılaştırır, eşitlendiğini onaylar ve uygulama ekibine bildirir.
- Tam geçiş penceresinin başında, uygulama ekibi uygulamanın MongoDB'ye yazma işlemlerini durdurur. Bu eylem ilk denetim noktasıdır.
- Geçiş ekibi, son eşitleme ve doğrulama sırasında arka plan silmelerini önlemek için TTL dizinlerinin hem kaynak hem de hedef koleksiyonlarda bulunmadığını onaylar.
- Uygulama ekibi, geçiş ekibine tüm kaynak yazmaların durdurulduğunu onaylar.
- Geçiş ekibi, geçiş aracında cutover işlemini başlatır.
- İsteğe bağlı olarak, geçiş ekibi MongoDB ve Azure DocumentDB koleksiyonlarını yeniden karşılaştırır. Koleksiyonların tam olarak eşitlendiğini onayladıktan sonra, geçiş ekibi uygulama ekibine bildirir.
- Geçiş ve son veri doğrulama tamamlandıktan sonra geçiş ekibi, geçiş öncesinde kaydedilen tanımları kullanarak hedefte TTL dizinlerini oluşturur.
- Uygulama ekibi, uygulama yazma işlemlerini Azure DocumentDB'ye yönlendirir. Bu eylem ikinci denetim noktasıdır.
- Uygulama ekibi trafiği, uygulama durumunu ve veritabanı yazmalarını izler.
- Her iki ekip de sonuçları gözden geçirir ve tamamlanan geçişi onaylar.
Riski azaltmak, kapasiteyi daha doğru tahmin etmek, geçiş hızını artırmak ve tam geçişi güvenli bir şekilde yürütmek için bu en iyi yöntemleri kullanın.
Hataları azaltma
Bağlantı dizelerinde URL ile kodlanmış parolalar kullanın.
#,:ve@gibi özel karakterler, bunları kodlamadığınızda ayrıştırmayı bozabilir. URL kodlaması, değerlendirme ve geçiş çalıştırmaları sırasında bağlantı hatalarını önlemenize yardımcı olur.Geçişten önce bir ön değerlendirme yapın. Değerlendirme, desteklenmeyen özellikleri, uyumluluk boşluklarını ve olası engelleyicileri erken belirlemenize yardımcı olur. Kesinti anında yeniden çalışmayı azaltmak için geçiş öncesi bulguları çözün.
Üretim öncesinde taşıma ve tam geçiş alıştırması yapın. Üretim dışı bir ortamda bir veya daha fazla prova geçişi uygulayın. Alıştırma, üretim tam geçişi sırasında zamanlama doğruluğunu, ekip hazırlığını ve güvenilirliği artırır.
Altyapıyı doğru boyutlandırma
Küçük ama temsili bir veri kümesinde deneme geçişi çalıştırın. Gerçekçi aktarım hızı, gecikme süresi ve kaynak tüketimini yakalamak için deneme sürümünü kullanın. Temsili örnek yapay test verilerinden daha iyi tahminler sunar.
İşlem Katmanı, Depolama Katmanı ve parça sayısını tahmin etmek için deneme sonuçlarını tahmin edin. Tam veri kümesi hacminize göre son boyutlandırma gereksinimlerini yansıtmak için gözlemlenen deneme ölçümlerini kullanın. Tahmininizi, üretim verileri dağılımınız örnekten farklıysa gözden geçirin.
Üretim benzeri ayarlarla temsili belge sayısını, boyutunu ve yapısını kullanın. Deneme sırasında maliyetin veya geçiş süresinin hafife alınmaması için üretimde kullanılan dizin oluşturma ve dilimleme ayarlarını eşleştirin. Üretim dışı ayarlar yanıltıcı sonuçlara neden olabilir.
Kaynak ve hedef boyutların eşit olduğunu varsayma yerine deneme sonuçlarından hedef depolama tahmini yapın. Kaynak ve hedef depolama ayak izleri, dizin tanımlarındaki ve veri düzenindeki farklılıklar nedeniyle farklılık gösterebilir. Güvenli bir arabelleğe sahip depolamayı planlamak için deneme sonuçlarını kullanın.
Geçiş hızını iyileştirme
Note
Çoğaltma ek yükünü azaltmak ve geçiş hızını artırmak için yüksek kullanılabilirliği (HA) etkinleştirmeyi ve hedef Azure DocumentDB kümesine çoğaltma kümeleri eklemeyi toplu kopyalama bitene kadar erteleyin. Çevrimiçi geçişler için HA'yı etkinleştirin ve toplu kopyalama tamamlandıktan ve geçiş devam eden kaynak değişiklikleri çoğaltan aşamaya girdikten sonra çoğaltma kümeleri ekleyin. Çevrimdışı geçişler için HA'yı etkinleştirin ve toplu kopyalama tamamlandıktan sonra çoğaltma kümeleri ekleyin. Üretim trafiğini hedefe yönlendirmeden önce HA ve gerekli çoğaltma kümelerinin hazır olduğundan emin olun.
Mümkün olduğunda aynı bölge içinde geçiş yapın. Kaynak ve hedefin aynı bölgede tutulması, ağ gecikme süresini azaltır ve veri aktarımı performansını artırır. Ayrıca bölgeler arası veri aktarımı maliyetlerini de azaltabilir.
Geçiş sırasında ölçeği artırın ve kesim sonrasında ölçeği küçültün. Örneğin, geçiş aktarım hızını artırmak için hedef kümeyi geçici olarak M200'e ölçeklendirin. Geçiş sonrasında, durağan iş yükleri için ölçeği desteklenen aralıkta uygun bir katmana düşürebilirsiniz.
Daha hızlı yazma işlemleri için Premium SSD v2 diskleri'ni seçin. Premium SSD v2 diskleri, yoğun yazma özellikli geçiş performansını önemli ölçüde iyileştirebilir.
Geri alma olmadığı için geçişi dikkatle planlayın.
Düşük trafikli bir pencere sırasında kapalı kalma süresini planlayın. Gerekli kapalı kalma süresi, geçiş tamamlandıktan sonra doğrulama adımlarının ne kadar süreceğine bağlıdır. Trafiğin düşük olduğu bir pencere, iş etkisini azaltır.
Tam geçişten hemen önce kaynağa yapılan tüm yazmaları durdurun. Bu adım, kaynak ve hedef arasında son dakika ayrışmasını önler. Tam geçişi tamamlamadan önce yazma işleminin tam anlamıyla durdurulduğunu onaylayın.
Geçiş öncesinde TTL dizinlerini kaldırın ve daha sonra hedefte oluşturun. Kaynak TTL dizin tanımlarını kaydedin ve geçişe başlamadan önce bu dizinleri, hedefe kopyalanmamaları için kaldırın. Hem kaynak hem de hedef koleksiyonları geçiş ve son veri doğrulama boyunca TTL dizinlerinden arındırın. Kaynak TTL silmeleri tam geçiş için gerekli değişiklik yok penceresini önleyebilirken, hedef TTL silmeleri çoğaltma tamamlandıktan sonra bile belge sayılarının farklı olmasına neden olabilir. Geçiş ve doğrulama tamamlandıktan sonra, kaydedilen tanımları kullanarak hedefte TTL dizinlerini oluşturun. Süresi dolma, geçiş sırasında süresi dolan belgeler de dahil olmak üzere hedefte devam eder.
Yazma işlemlerine geçmeden önce taşınan verileri doğrulayın. Belge sayılarını karşılaştırın, sonra rastgele örnek belge karşılaştırması (örneğin, karma tabanlı kontroller) yapın. Doğrulama sürecini tekrarlanabilir hale getirmek için mümkün olduğunda bir komut dosyası kullanın.
Uygulama bağlantı dizelerini güncelleştirin ve hedefte test edin. Üretim yazmalarını etkinleştirmeden önce hedef okumalara karşı işlevsel ve performans doğrulamasını çalıştırın ve trafiği test edin. Kritik yolların beklendiği gibi davrandığını onaylayın.
Yazma trafiğini yalnızca doğrulama başarılı olduktan sonra taşıyın. Yalnızca test sonuçları başarılı ve tutarlı olduktan sonra üretim yazmalarını hedefe kaydırma. Uygulama mimariniz destekliyorsa aşamalı bir dağıtım kullanın.
Sorunsuz geçiş için ekipler arasında koordinasyon
Tüm paydaşların onayını alın: uygulama, veri, altyapı, güvenlik, ağ ve yönetim ekipleri. Beklentileri ve sorumlulukları erken uyumlu hale getirin. Paylaşılan sahiplik, yürütme sırasındaki yanlış anlamaları ve gecikmeleri azaltır.
Ekip güveni oluşturmak ve yordamları iyileştirmek için planlama ve deneme çalıştırmalarını kullanın. Sorunsuz geçiş için kısayol yoktur. Deneme çalışmaları, sorunları daha düşük riskli bir ortamda ortaya çıkarır ve ekiplere pratik yapma olanağı sunar.
Geçiş sürecini kritik ve zamana duyarlı bir şekilde değerlendirin. Kesintisiz geçiş için hassas koordinasyon ve net duyuru gerekir. Karar verenleri belirleyin ve başlamadan önce yükseltme yolları oluşturun.
Her adımı kimin gerçekleştireceğini, ne zaman gerçekleşmesi gerektiğini ve kapalı kalma süresini nasıl en aza indirebileceğinizi öğrenin. Sorumlulukları atayın, zaman çizelgeleri oluşturun ve başarı ölçütlerine uygun hale getirin. Tam runbook'u belgeleyip tüm katılımcılarla paylaşın.
Kesinti birden çok iş yükünün eşzamanlı olarak güncellenmesini gerektirdiğinde, tüm paydaşlarla eşgüdüm sağlayın. Tam geçişi tüm ekipler için çalışan bir bakım penceresi sırasında zamanlayın. Cuma gecelerinden veya büyük iş etkinliklerine yakın dönemlerden kaçının.
Durum tespiti adımlarını aceleye getirmeyin veya atlamayın; geri alma işlemi yoktur. Kapsamlı doğrulama ve dikkatli yürütme, yüksek maliyetli hataları önler. Tam geçişin zaman aldığını kabul edin; hız odaklı kısayollar risk oluşturur.