Azure Data Studio için MongoDB için Azure Cosmos DB geçiş uzantısı (önizleme)

MongoDB için Azure Cosmos DB geçiş uzantısı, MongoDB iş yüklerinizi Azure Cosmos DB'ye geçirmenize yardımcı olur. Bu uzantıyı şu amaçla kullanabilirsiniz:

  • İş yükünüzde uçtan uca bir değerlendirme çalıştırın ve iş yüklerinizi MongoDB için sanal çekirdek tabanlı Azure Cosmos DB'ye geçirmek için yapmanız gereken eylemleri öğrenin.
  • Seçili veritabanları ve koleksiyonlarla MongoDB için sanal çekirdek tabanlı Azure Cosmos DB'ye geçiş işlemini gerçekleştirin.

Önemli

Şu anda bu uzantı aşağıdaki senaryoları desteklememektedir:

  • Kaynak veya hedef hesabın Özel Uç Nokta'nın etkinleştirildiği geçiş.
  • MongoDB için RU tabanlı Azure Cosmos DB için Çevrimiçi/Çevrimdışı Geçişler.

MongoDB sanal çekirdeği api'sinin alternatif çözümleri hakkında daha fazla bilgi için bkz . geçiş seçenekleri.

Önkoşullar

  • MongoDB için mevcut sanal çekirdek tabanlı Azure Cosmos DB hesabı.
  • Azure Data Studio'nun en son sürümü.
  • MongoDB sürüm 3.2 veya üzerini çalıştırıyor.
  • Genel Azure veri merkezlerinden gelen bağlantıları kabul etmek için mongoDB için kaynak MongoDB ve sanal çekirdek tabanlı Azure Cosmos DB hedef hesabına güvenlik duvarı özel durumları ekleyin.
  • Veritabanı Geçiş Hizmeti ilk kez kullanıyorsanız Microsoft.DataMigration kaynak sağlayıcısının aboneliğinize kayıtlı olduğundan emin olun.

Hazırlama

Geçişe başlamadan önce, gerçekten veri taşımadan önce geçişiniz hakkında önceden planlama ve karar alma işlemleri gerçekleştirin.

Microsoft.DataMigration kaynak sağlayıcısını aboneliğinize kaydetme

Microsoft.DataMigration kaynak sağlayıcısının aboneliğinizde kayıtlı olduğundan emin olmak için şu adımları izleyebilirsiniz:

Azure portalı:

  1. Azure portalına gidin ve aboneliğinize gidin.
  2. Sol taraftaki menüde Ayarlar'ın altında Kaynak sağlayıcıları'nı seçin.
  3. Üstteki arama kutusunda Microsoft.DataMigration araması yapın.
  4. Kayıtlı değilse seçin ve Kaydet düğmesine tıklayın.

Azure CLI:

  1. Azure Cloud Shell'i veya yerel terminalinizi açın.
  2. Aşağıdaki komutu çalıştırarak kaynak sağlayıcısını kaydedin:
az provider register --namespace Microsoft.DataMigration

PowerShell:

  1. Azure Cloud Shell'i veya yerel PowerShell'inizi açın.
  2. Aşağıdaki komutu çalıştırarak kaynak sağlayıcısını kaydedin:
Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

Uzantıyı yükleme

Geçişinize başlamadan önce MongoDB için Azure Cosmos DB geçiş uzantısını Azure Data Studio'ya yükleyin.

  1. Uzantı yöneticisini Azure Data Studio'da açın. Uzantılar simgesini seçin veya Görünüm menüsünde Uzantılar'ı seçin.

  2. Arama çubuğuna Cosmos girin.

  3. MongoDB için Azure Cosmos DB Geçişi uzantısını seçin ve ayrıntılarını görüntüleyin.

    MongoDB için Azure Cosmos DB geçiş uzantısı yükleme düğmesinin ekran görüntüsü.

  4. Yükle'yi seçin.

Uzantı ayarlarını yapılandırma

Uzantıyı yükledikten sonra bazı uzantı ayarlarını yapılandırabilirsiniz. Bu adım isteğe bağlıdır. Hiçbir ayar açıkça yapılandırılmamışsa, uzantı varsayılan ayarları kullanır.

  1. Uzantılara gidin ve MongoDB için Azure Cosmos DB Geçişi'ni seçin, ayarları yönet simgesini ve ardından uzantı ayarları'nı seçin.

    Uzantı ayarları seçiminin ekran görüntüsü.

  2. Bu uzantının uzantı ayarları altında, değerlendirme meta verilerinin depolandığı konumu değiştirmek için öğesini sağlayın Assessment path . Boş bırakılırsa, varsayılan konum kullanılır.

MongoDB kaynağına bağlanma

Mevcut MongoDB kaynak örneğine bağlanmak için uzantıyı ilk kez kullanın. Bu bölüme başlamadan önce kaynak için bağlantı kimlik bilgilerinin hazır olduğundan emin olun.

  1. Menü çubuğunda bağlantılar simgesini bulun ve Yeni Bağlantı'yı seçin.

    Uzantıdaki bağlantılar menü çubuğunun ekran görüntüsü.

  2. Bağlantı bölmesinde aşağıdaki alanları doldurun:

    Değer
    Bağlantı türü Azure Cosmos DB for MongoDB
    Bağlantı dizesi/Parametreler Mevcut kaynak MongoDB örneğinin bağlantı dizesi veya parametrelerini kullanın.
    Sunucu grubu Default
    Ad (isteğe bağlı) Bu bağlantı için benzersiz bir ad sağlayın.
  3. Bağlan'ı seçin.

  4. Bağlantılar bölmesinde yeni bağlantının bağlam menüsünü açın. Ardından Yönet'i seçin.

    Veritabanını yönet ekranının ekran görüntüsü.

  5. Azure Cosmos DB Geçişi'ne tıklayın.

    Geçiş Değerlendirmesi veritabanı ekranının ekran görüntüsü.

Değerlendirmeyi çalıştırma

Değerlendirme, geçerli MongoDB veri varlığınızı ve kullanımınızı inceler. Değerlendirme özelliği daha sonra iş yüklerinizi MongoDB için Azure Cosmos DB'ye geçirmeden önce gerçekleştirmeniz gereken eylemleri belirlemenize yardımcı olan kapsamlı bir rapor oluşturur.

  1. Pano sekmesini bulun ve bu sekmeye gidin. Ardından Veritabanlarını Değerlendir ve Geçir'i seçin.

    Uzantının geçiş özelliği içindeki Pano sekmesinin ekran görüntüsü.

  2. Değerlendirme yapabilmesi için uzantının ayrıntılarını sağlamak için sihirbazı tamamlayın.

    Kimlik bilgileri doğrulanmadan önce değerlendirme ayrıntılarının ekran görüntüsü.

    1. Değerlendirme adı alanına bir başlık girin.

    2. Teklif açılan listesinden MongoDB için hedef Azure Cosmos DB hesabını seçin.

    3. MongoDB Günlüklerinin yolunu belirtin.

      İpucu

      Bu isteğe bağlı bir alandır, ancak günlük yolunun belirtilmesi koleksiyon düzeyinde daha ayrıntılı bulgularla sonuçlanır. Günlük klasörü belirtilmediğinde, araç değerlendirmeyi gerçekleştirmek için komuttan serverStatus ayrıntıları kullanır.

      Komut serverStatus yalnızca son yeniden başlatmadan bu yana özellik kullanımını döndürür, bu nedenle gerçek iş yükünüzü doğru yansıtan bir değerlendirme almak için son sunucu yeniden başlatmadan bu yana yeterli sürenin geçtiğinden emin olmanız gerekir.

    4. Veri değerlendirme günlüklerinin yolunu belirtin.

      İpucu

      Bu alan isteğe bağlı olsa da, veri değerlendirme günlüklerinin sağlanması iş yükü hakkında daha ayrıntılı içgörüler sağlayabilir. Bu günlükler, veriler taranarak ve ayrıntılı günlükler okunarak elde edilir. Veri değerlendirmesi, geçiş değerlendirmesini başlatmadan önce bağımsız olarak CLI olarak çalışır ve sonuçta elde edilen JSON burada sağlanır. Veri değerlendirme CLI'sini buradan indirin.

    5. Değerlendirme girişlerini doğrulamak için Doğrulamayı çalıştır'ı seçin.

  3. Doğrulama başarılı olduktan sonra değerlendirmeyi çalıştırmak için Değerlendirmeyi başlat'ı seçin.

    Kimlik bilgileri doğrulandıktan sonra değerlendirme ayrıntılarının ekran görüntüsü.

  4. Kaynak sunucunuzun boyutuna bağlı olarak değerlendirme birkaç dakika sürer. Devam etmeden önce değerlendirmenin tamamlanmasını bekleyin.

    Devam eden yeni değerlendirmenin ekran görüntüsü.

  5. Değerlendirme tamamlandıktan sonra bir değerlendirme raporunuz olmalıdır.

    Kaynak MongoDB örneği için yeni değerlendirme raporunun ekran görüntüsü.

  6. Değerlendirme raporunda örnek adını seçerek sunucu genelindeki sorunların listesini gözden geçirin. Yalnızca seçili veritabanı için geçerli olan sorunları görüntülemek için belirli bir veritabanını seçin.

    Kaynak MongoDB örneğindeki seçili veritabanı için yeni değerlendirme raporunun ekran görüntüsü.

  7. Birleştirilmiş indirilebilir rapor almak için Raporu İndir'i seçin.

  8. MongoDB için Azure Cosmos DB'de iş yüklerinizin sorunsuz bir şekilde geçirilmesi için gerçekleştirmeniz gereken eylemleri belirlemek için değerlendirme raporunu inceleyin. Bir sonraki adıma geçmeden önce değerlendirmede bildirilen tüm engelleme sorunlarının ele alındığından emin olun. Çözülmemiş sorunlar varsa, işlemden çıkıp bunları daha sonra işleyebilirsiniz. Sorunlar çözüldükten sonra geri gelip değerlendirme ve geçiş işlemini yeniden başlatabilirsiniz.

Geçiş gerçekleştirme

Şimdi, kaynak MongoDB örneğinizden mongoDB için hedef sanal çekirdek tabanlı Azure Cosmos DB hesabınıza verilerinizin geçişini gerçekleştirmek için değerlendirme raporunu kullanın.

  1. Değerlendirme raporu ekranında, geçirmeyi planladığınız veritabanlarını seçin. Ardından İleri'yi seçin.

    Geçiş için seçilen veritabanının ekran görüntüsü.

  2. Abonelik ve kaynak grubuna göre filtreleyerek listeleri daraltarak MongoDB için hedef Azure Cosmos DB hesabını seçin. Ardından hesaba bağlanmak için gereken bağlantı kimlik bilgilerini sağlayın.

    MongoDB hesabı için hedef Azure Cosmos DB seçiminin ekran görüntüsü.

  3. MongoDB için Azure Cosmos DB hesabının kimlik bilgilerini doğrulamak için Bağlantıyı test et'i seçin. Kaynaktan hedefe koleksiyon eşlemesine gitmek için İleri'yi seçin.

  4. Eşleme listesindeki her koleksiyon için Atla veya Geçir'i seçin. Hedefte zaten var olan koleksiyonlar otomatik olarak bir simgeyle işaretlenir ve varsayılan olarak Atla olarak ayarlanır. Azure Veritabanı Geçiş Hizmeti (DMS) yapılandırmak için İleri'yi seçin.

    Kaynaktan hedefe koleksiyon eşlemesinin ekran görüntüsü.

    Uyarı

    Mevcut bir koleksiyonu geçirmeyi kabul etmek koleksiyonun tamamının üzerine yazılır ve bu da geri alınamaz veri kaybına neden olur. Bu seçeneği seçerken lütfen dikkatli olun.

  5. Açılan listeden mevcut bir Azure Veritabanı Geçiş Hizmeti örneği seçin veya yeni bir geçiş hizmeti oluşturmak için Yeni Oluştur'u seçin. Azure Veritabanı Geçiş Hizmeti, yerel kaynaklara güvenmek yerine veri aktarımı için bulut altyapısını kullanarak Verileri Azure veri platformlarına ve Azure veri platformlarından geçiren bir hizmettir.

    Geçiş hizmeti seçme seçeneğinin ekran görüntüsü.

  6. Kullanım örneğiniz için en uygun geçiş modunu seçin.

    • Çevrimiçi geçiş , işlem sırasında güncelleştirmelerin de çoğaltıldığından emin olarak toplama verilerini kopyalar. Bu yöntem, iş sürekliliği için sürekli işlemlere olanak sağlayan en düşük kapalı kalma süresiyle avantajlıdır. Devam eden işlemler kritik öneme sahip olduğunda ve kapalı kalma süresini azaltmak öncelikliyse bu seçeneği kullanın.
    • Çevrimdışı geçiş , başlangıçta veritabanının anlık görüntüsünü yakalar ve daha basit ve öngörülebilir bir yaklaşım sunar. Veritabanının statik bir kopyasının kullanılması kabul edilebilir olduğunda ve gerçek zamanlı güncelleştirmeler gerekli olmadığında iyi çalışır.
  7. Geçiş özetini görüntülemek için İleri'yi seçin. Ayrıntıları gözden geçirip onayladıktan sonra, hedef hesapta kaynak oluşturmak için Şema Oluştur'u seçin.

    Geçiş özetini görüntüleme seçeneğinin ekran görüntüsü.

  8. Seçili geçiş hizmetini kullanarak veri aktarımını başlatmak için Geçişi Başlat'ı seçin.

    Geçiş hizmetini kullanarak geçiş başlatma seçeneğinin ekran görüntüsü.

  9. Ayarları Onayla açılır penceresinde güvenlik duvarı ayarlarınızın gereksinimleri karşıladığını doğrulayın. Onaylamak için Tamam'ı seçin.

    Güvenlik duvarı ayarlarınızı doğrulamak için Ayarları Onayla açılır penceresinin ekran görüntüsü.

Veri geçiş görevleri Azure Veritabanı Geçiş Hizmeti üzerinde çalıştırıldığından, veri geçişi sırasında kaynak ve hedef ortamlara bağlanmanız gerekmez. Durum panoda sık aralıklarla güncelleştirilir

Not

Geçiş için 50'den fazla koleksiyon seçtiyseniz, geçiş işi her biri en fazla 50 koleksiyon içeren geçiş hizmetindeki birden çok işe toplu olarak alınır.

  1. İşler başlatıldıktan sonra pano sayfasında geçiş durumunu izleyin.

    Geçiş durumu olan panonun ekran görüntüsü.

  2. Diğer ayrıntıları görüntülemek için geçişler listesinden belirli bir geçişi seçin.

Çevrimdışı geçişleri izleme

Tüm veri geçiş görevleri tamamlandıktan sonra durum otomatik olarak güncelleştirilir.

Geçiş durumu olan koleksiyonların ekran görüntüsü.

Veriler kaynaktan hedefe başarıyla kopyalandıktan sonra çevrimdışı geçişlerin durumu başarılı olduğunu gösterir.

Geçiş durumundaki başarının ekran görüntüsü.

  • Uygulamalarınızdaki bağlantı dizesi hedef hesaba işaret eden şekilde değiştirin.

Çevrimiçi geçişleri izleme

Çevrimdışı geçişlerin aksine çevrimiçi geçişler otomatik olarak tamamlanmaz. Bunun yerine, Tam Geçiş'i seçerek el ile sonlandırılana kadar sürekli olarak çalışırlar.

Çevrimiçi geçiş durumunun ekran görüntüsü.

Çevrimiçi geçişi tamamlamak için aşağıdaki adımları verilen sırada izleyin:

  1. Tüm koleksiyonlar için İlk Veri Yükü tamamlandıktan sonra Tam Geçiş düğmesi etkinleştirilir. Geçiş şu anda çoğaltma aşamasındadır ve en son değişikliklerle güncel kalmasını sağlamak için güncelleştirmeleri kaynak örnekten hedef örneğe sürekli olarak kopyalar.

  2. Geçiş tam geçişini gerçekleştirmeye hazır olduğunuzda, geçirilmekte olan kaynak koleksiyonlara gelen tüm işlemleri durdurun.

  3. Tablodaki çoğaltma değişikliklerini izleyin ve 'Çoğaltma Değişiklikleri Çalındı' ölçümü kararlı hale gelene kadar bekleyin. Kararlı bir 'Çoğaltma Değişiklikleri Oynatıldı' ölçümü, kaynaktan gelen tüm güncelleştirmelerin hedefe başarıyla kopyalandığını gösterir.

  4. Çoğaltma aralığı tüm koleksiyonlar için en düşük düzeyde olduğunda ve 'Çoğaltma Değişiklikleri Oynatılıyor' ölçümü kararlı olduğunda Tam Geçiş'i seçin.

  5. Kaynak ve hedef koleksiyonlar arasında satır sayısının aynı olduğunu el ile doğrulayın.

  6. Açılan iletişim kutusunda. Tam Geçişi Tamamla'yı seçin.
    Çevrimiçi geçiş tam geçiş açılır penceresinin ekran görüntüsü.

    Not

    Kaynak ve hedefin eşitlendiğini doğrulamadan tam geçiş işleminin gerçekleştirilmesi veri kaybına neden olabilir.

  7. Durumun Başarılı olarak değişmesini bekleyin.

  8. Uygulamalarınızdaki bağlantı dizesi hedef hesaba işaret eden şekilde güncelleştirin.

Geçmiş geçişleri ve değerlendirmeleri görüntüleme

Geçmiş değerlendirmeleri ve geçişleri gözden geçirmek genellikle yararlıdır. Uzantı, geçmiş değerlendirme ve geçişlerin özetlerini gözden geçirmek için bir arabirim sağlar. Uzantı ayrıca ayrıntılı geçmiş değerlendirme raporlarını gözden geçirme olanağı sağlar.

  1. Geçmiş geçişleri görüntülemek için araç çubuğunda Geçişler sekmesini seçin. Geçişler listesi, geçerli makinede başlatılan tüm geçişleri içerir. Daha fazla ayrıntı almak için listeden belirli bir geçişi seçebilirsiniz.

    Uzantı kullanılarak oluşturulan tüm geçişlerin listesinin ekran görüntüsü.

  2. Geçmiş değerlendirmeleri görüntülemek için araç çubuğunda Değerlendirmeler sekmesini seçin. Değerlendirmeler listesi, geçerli makinede başlatılan tüm değerlendirmeleri içerir.

    Uzantı kullanılarak gerçekleştirilen tüm değerlendirmelerin listesinin ekran görüntüsü.

Sonraki adım