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

Makale
04/19/2024

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 Azure Cosmos DB sanal çekirdeğine geçirmek için yapmanız gereken eylemleri öğrenin.
Seçili veritabanları ve koleksiyonlarla MongoDB sanal çekirdeği için Azure Cosmos DB'ye geçiş işlemini gerçekleştirin.

Önemli

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

MongoDB için Azure Cosmos DB sanal çekirdeği için çevrimiçi geçiş.
MongoDB RU için 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 bir Azure Cosmos DB sanal çekirdek hesabı.
- Azure aboneliğiniz yoksa ücretsiz bir hesap oluşturun.
Azure Data Studio'nun en son sürümü.
MongoDB sürüm 3.2 veya üzerini çalıştırıyor.

Hazırlama

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

MongoDB sanal çekirdeği için API'nin ön geçiş planlaması hakkında daha fazla bilgi için bkz . MongoDB için Azure Cosmos DB sanal çekirdeği için ön geçiş adımları,
MongoDB RU API'sine yönelik ön geçiş planlaması hakkında daha fazla bilgi için bkz . MongoDB RU için Azure Cosmos DB için ön geçiş adımları

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.

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.
Arama çubuğuna Cosmos girin.
MongoDB için Azure Cosmos DB Geçişi uzantısını seçin ve ayrıntılarını görüntüleyin.
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.

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.
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ğlan

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.

Menü çubuğunda bağlantılar simgesini bulun ve Yeni Bağlan ion'u seçin.

Bağlan bölmesinde aşağıdaki alanları doldurun:

	Değer
Bağlantı türü	`Azure Cosmos DB for MongoDB`
Bağlan ion 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.

Bağlan'ı seçin.
yeni bağlantının bağlam menüsünü Bağlan ions bölmesinde açın. Ardından Yönet'i seçin.
Azure Cosmos DB Geçişi'ne tıklayın.

Değerlendirme ç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.

Pano sekmesini bulun ve bu sekmeye gidin. Ardından Veritabanlarını Değerlendir ve Geçir'i seçin.
Değerlendirme yapabilmesi için uzantının ayrıntılarını sağlamak için sihirbazı tamamlayın.
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 ve günlükler yolunun koleksiyon düzeyinde daha ayrıntılı içgörüler sağlaması sağlanır. Günlük klasörü belirtilmediğinde, araç değerlendirme için komuttan serverStatus alınan bilgilere dayanır. 'serverStatus' komutunun yalnızca son sunucu yeniden başlatmadan sonra özellik kullanımını bildirdiğini unutmayın. Gerçek iş yükünüzü doğru yansıtan bir değerlendirme elde etmek için, sunucunun en son yeniden başlatılmasından bu yana yeterli sürenin geçtiğinden emin olun.
4. Veri değerlendirme günlüklerinin yolunu belirtin.
  
  İpucu
  
  Bu alan isteğe bağlı olarak kalır ancak veri değerlendirme günlükleri de dahil olmak üzere iş yüküyle ilgili daha kapsamlı içgörüler sunabilir. Bu günlükler, veriler taranarak ve ayrıntılı günlükler gözden geçirilerek alınır. Veri değerlendirmesi, geçiş değerlendirmesini başlatmadan önce bağımsız olarak bir komut satırı arabirimi (CLI) olarak yürütülü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.
Doğrulama başarılı olduktan sonra değerlendirmeyi çalıştırmak için Değerlendirmeyi başlat'ı seçin.
Kaynak sunucunuzun boyutuna bağlı olarak değerlendirme birkaç dakika sürer. Devam etmeden önce değerlendirmenin tamamlanmasını bekleyin.
Değerlendirme tamamlandıktan sonra bir değerlendirme raporunuz olmalıdır.
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.
Birleştirilmiş indirilebilir rapor almak için Raporu İndir'i seçin.
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.

Çevrimdışı geçiş gerçekleştirme

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

Değerlendirme raporu ekranında, geçirmeyi planladığınız veritabanlarını seçin. Ardından İleri'yi seçin.
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 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.
Önemli

Uzantı şu anda Özel Uç Nokta özellikli kaynağı veya hedef MongoDB örneklerini desteklememektedir.
- Kaynak MongoDB örneğini, genel Azure veri merkezlerinden gelen bağlantılara izin verecek şekilde yapılandırın.
- MongoDB için Azure Cosmos DB sanal çekirdek hedef hesabına güvenlik duvarı özel durumları ekleyerek genel Azure veri merkezlerinden bağlantılara izin verin.
- İlgili IP aralığı bilgilerini bulmak için JSON'u genel Azure IP adresi aralıklarından indirin ve "AzureCloud" ifadesini arayın. JSON dosyasının içinde Hedef Cosmos DB Hesap Bölgesi}".
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.

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.
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.

Önemli

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.
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.
Seçili geçiş hizmetini kullanarak veri aktarımını başlatmak için Geçişi Başlat'ı seçin.
İşler başlatıldıktan sonra pano sayfasında geçiş durumunu görüntüleyin.
Daha fazla ayrıntı görüntülemek için geçiş listesinden belirli bir geçişi seçin. Devam etmeden önce geçişin tamamlanmasını bekleyin.

Not

Geçiş işleri uzaktan ve zaman uyumsuz olarak yürütülürken geçiş hizmetine veya Azure Data Studio'ya bağlı kalmanız gerekmez. Geçiş işleri geçiş hizmetinde yürütülür ve durum panoda sık aralıklarla güncelleştirilir.

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.
İş tamamlandıktan sonra geçiş durumu başarılı olduğunu gösterir.

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.

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.
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.