Azure DocumentDB geçiş uzantısını kullanarak MongoDB'yi çevrimiçi olarak Azure DocumentDB'ye geçirme (genel önizleme)

Bu öğreticide, Şirket içi veya bulut mongoDB örneğinden Azure DocumentDB'ye geçiş işleri oluşturmak ve yönetmek için Visual Studio Code'daki Azure DocumentDB Geçiş Uzantısı'nı kullanacaksınız. Bu uzantı, hizmet kesintisi olmadan geçişleri gerçekleştirmek için geliştirici dostu bir arabirim sağlar. Uzantı, ek altyapı gereksinimini ortadan kaldırır ve hangi veritabanlarının ve koleksiyonların geçirildiği üzerinde güvenli bağlantı, sıfır maliyetli kullanım ve ayrıntılı denetim sunar.

Bu makalenin odak noktası, doğrudan Visual Studio Code'da geçiş adımlarını basitleştirmek için uzantının tümleşik iş akışını kullanmaktır. Bu yaklaşım, minimum karmaşıklık ve maksimum güvenilirlik ile kolaylaştırılmış, yönetilen bir deneyim istediğiniz senaryolar için idealdir.

Önkoşullar

• Azure aboneliği

  • Azure aboneliğiniz yoksa ücretsiz bir hesap oluşturun

• Mevcut bir Azure DocumentDB kümesi

  • Kümeniz yoksa yeni bir küme oluşturun

• Makinenize Azure DocumentDB Geçiş Uzantısı'nı yükleyin. Bu işlem önkoşulu olan Visual Studio Code için DocumentDB uzantısını otomatik olarak yükler.

Geçişe başlamadan önce Azure DocumentDB hesabınızı ve mevcut MongoDB örneğinizi geçiş için hazırlayın.

MongoDB örneği (kaynak)

• Kaynak örneğinizle hedef hesabınız arasında uyumsuzluklar ve uyarılar olup olmadığını belirlemek için geçiş öncesi değerlendirmesini tamamlayın.
• readAnyDatabase ve clusterMonitor izinlerine sahip bir kullanıcı ekleyin, ancak önceden mevcut değilse. Uzantıda geçiş işleri oluştururken bu kimlik bilgilerini kullanırsınız.

Azure DocumentDB (hedef)

• Azure DocumentDB hesabının kimlik bilgilerini toplayın.
• Kullanıcının , , createCollectiondropCollection, , createIndexve insert izinlerine sahip listCollectionsolduğundan emin olun.

Önemli

Microsoft Entra Id kimlik doğrulaması şu anda geçiş işlerinde desteklenmiyor. Lütfen yerel DocumentDB kimlik doğrulamayı kullanın.

Geçişi gerçekleştirme

Kaynağa bağlan

1. VS Code için DocumentDB uzantısını açın.
2. Geçirmek istediğiniz MongoDB sunucusunu Belge VERITABANı Bağlantıları listesine ekleyin.
3. Yeni Bağlantı Ekle'yi seçin.
4. Gezinti çubuğunda Bağlantı Dizesi'ni seçin.
5. Bağlantı dizenizi yapıştırın: mongodb://<YOUR_USERNAME>:<YOUR_PASSWORD>@localhost:10260/?tls=true&tlsAllowInvalidCertificates=true&authMechanism=SCRAM-SHA-256
6. DocumentDB Bağlantıları'ndan bağlantıyı seçin ve bağlanmak için genişletin.

Geçiş Uzantısını Çağırma

DocumentDB Bağlantıları'ndan Geçiş Uzantısı'nı çağırabilirsiniz.

1. Genişletilmiş (bağlı) bağlantıya sağ tıklayın.

2. Bağlam menüsünden Veri Geçişi'ni seçin.

   

3. Komut paletinden Azure DocumentDB'ye Geçir'i seçin.

   

4. Geçiş sihirbazı, işlemde size yol gösterir.

Geçiş işi oluştur

Geçiş işi, bir koleksiyon grubunu kaynaktan hedef Azure DocumentDB'ye geçirmek için kullanılır. Geçiş işi oluşturma sihirbazının altı adımı vardır.

1. Adım: İş oluşturma

Bu adımda, işin temel ayrıntılarını sağlarsınız.

• İş Adı: Geçiş işini tanımlamak için kullanıcı dostu bir ad sağlayın.

• Geçiş Modu: Kullanım örneğiniz için en uygun geçiş modunu seçin.

  • Çevrimiçi geçiş, işlem sırasında güncellemelerin de aktarılmasını sağlayarak 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.

  Önemli

  MongoDB'den çevrimiçi geçişlerin başarılı olmasını sağlamak için Kaynak MongoDB sunucusunda ChangeStream'in etkinleştirilmesi gerekir. ChangeStream olmadan, ilk geçişten sonra verilerde yapılan değişiklikler yakalanmaz. Bu nedenle, çevrimiçi geçiş modunu yalnızca kaynak MongoDB sunucunuzda ChangeStream özelliği etkinleştirilmişse kullanın.

• Bağlantı: Kuruluşunuzun güvenlik yetkisine ve ağ kurulumuna bağlı olarak Genel ve Özel'i seçin.

  • Kaynak ve hedef sunuculara genel IP'ler aracılığıyla İnternet üzerinden erişildiğinde Genel'i kullanın. Dış erişilebilirlik gerektiren hizmetler için destek sağlar.
  • Kaynak veya hedef sunuculara yalnızca sanal ağ içindeki özel IP'ler aracılığıyla erişilebiliyorsa Özel'i kullanın. Genel İnternet'e maruz kalma durumunu ortadan kaldırarak güvenliği artırır.

Devam etmek için İleri'yi seçin.

2. Adım: Hedefi seçme

Bu adımda, mevcut bir Azure DocumentDB hesabını seçer ve bağlantı dizesini sağlarsınız.

1. Açılan listeden aboneliği, kaynak grubunu ve Azure DocumentDB hesabını seçin.

2. Azure DocumentDB hesabına bağlantı dizesini sağlayın.

3. Ekranda listelenen IP'ye Azure DocumentDB güvenlik duvarında izin verildiğinden emin olun.

4. Devam etmek için İleri'yi seçin.

3. Adım: Veritabanı Geçiş Hizmeti(DMS) seçeneğini belirleyin

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. Açılan listeden mevcut bir Azure Veritabanı Geçiş Hizmeti örneğini seçin veya yeni bir geçiş hizmeti oluşturmak için DMS Oluştur'u seçin.

Önemli

Microsoft.DataMigration kaynak sağlayıcısının aboneliğinize kayıtlı olduğundan emin olun. Bunu abonelik başına yalnızca bir kez yapmanız gerekir.

Devam etmek için İleri'yi seçin.

4. Adım: Bağlantıyı yapılandırma

Bu ekran, 1. Adımda seçtiğiniz bağlantı moduna bağlıdır.

Genel bağlantı

Genel bağlantıda, geçiş işi genel İnternet'i kullanarak kaynağınıza ve hedefinize bağlanır. İletişimi etkinleştirmek için kaynak ve hedef güvenlik duvarlarını güncelleştirmeniz gerekir. DMS sunucularından iletişimi etkinleştirmek için, ekranda listelenen IP adreslerini kaynak ve hedef güvenlik duvarlarına ekleyin. Daha fazla bilgi için bkz. Azure DocumentDB kümesi güvenlik duvarını yapılandırma .

Özel bağlantı

Özel bağlantıda, geçiş işi kendi sanal ağı içinde çalışır. Sanal ağınızla güvenli bir şekilde iletişim kurmak için sanal ağ eşlemesini kullanırız.

1. Açılan listeden aboneliği, kaynak grubunu ve sanal ağı seçin.

2. Sanal ağ tümleştirmesini etkinleştirmek için ekranda sağlanan PowerShell betiğini çalıştırın.

3. Devam etmek için İleri'yi seçin.

5. Adım: Koleksiyonları seçme

Bu adımda, geçiş işine dahil edilecek koleksiyonları seçersiniz. Sağlanan arama seçeneklerini kullanarak koleksiyon listesinden seçim yapın. Hedefte zaten var olan koleksiyonlar, Hedefte Var sütununda otomatik olarak Evet olarak işaretlenir.

Tip

Geçiş işi oluşturulduktan sonra koleksiyon listesi eklenemez, bu yüzden eklemek istediğiniz tüm koleksiyonları seçtiğinizden emin olun.

Devam etmek için İleri'yi seçin.

6. Adım: Onaylayın ve başlatın

Geçişi Başlat'ı seçmeden önce geçiş işi ayrıntılarını gözden geçirin. Ayrıntıların güncelleştirilmiş olması gerekiyorsa Ayrıntıları Düzenle düğmesini kullanın.

Geçiş işi başarıyla oluşturulduktan sonra otomatik olarak Varolan İşleri Görüntüle sayfasına yönlendirilirsiniz

Tip

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

Mevcut geçiş işlerini izleme

Başlatılan işlerin geçiş durumunu izlemek için Varolan İşleri Görüntüle sekmesini kullanın. İşler seçilen DMS'ye göre listelenir. Seçiminizi değiştirmek için DMS'yi Değiştir düğmesini kullanın.

Durum, sık aralıklarla otomatik olarak güncelleştirilir. Seçili koleksiyon anlık görüntüleri hedefe kopyalandıktan sonra çevrimdışı işler otomatik olarak tamamlanır. Ancak çevrimiçi geçişlerin manuel olarak tamamlanması gerekir.

Koleksiyona göre durumu görüntülemek için tablodan bir satır seçin.

Çevrimiçi geçişleri izleme

Çevrimdışı geçişlerin aksine çevrimiçi geçişler otomatik olarak tamamlanmaz. Bunun yerine, Cutover seçilerek elle sonlandırılana kadar sürekli çalışırlar.

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

1. Tüm koleksiyonlar için ilk veri yükü tamamlandıktan sonra Tam Geçiş düğmesi etkinleştirilir. Bu aşamada, iş çoğaltma sürecindedir ve kaynak örnekten hedef örneğe sürekli olarak kopyalanarak, en son değişikliklerle güncel kalmasını sağlar.

2. Kesimi gerçekleştirmeye hazır olduğunuzda, geçiş yapılan kaynak koleksiyonlara gelen tüm işlemleri durdurun.

3. Çoğaltma Boşluğu, son güncelleştirme ile geçerli saat arasındaki zaman aralığını gösterir.

4. Tablodaki çoğaltma değişikliklerini izleyin ve Çalınan Çoğaltma Değişiklikleri ölçümü sabit olana kadar bekleyin. Kararlı Replikasyon Değişiklikleri Uygulandı ölçümü, kaynaktan gelen tüm güncelleştirmelerin hedefe başarıyla kopyalandığını gösterir.

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

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

Uyarı

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

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üğmesini seçin.

Azure Komut Satırı Arayüzü (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"
   

FAQ

Azure DocumentDB görünümleri desteklerken koleksiyon seçme ekranı adımında görünümler neden eksik?

Azure DocumentDB, yeni görünümlerin oluşturulmasını destekler. Ancak geçiş uzantısı mevcut görünümlerin geçirilmesi için destek sağlamaz.

Geçiş tamamlandıktan sonra görünümleri istediğiniz zaman yeniden oluşturabilirsiniz.

MongoDB'den Azure DocumentDB'ye geçiş sırasında hangi koleksiyonlar ve veritabanları atlanır?

Aşağıdaki veritabanları ve koleksiyonlar MongoDB için iç olarak kabul edilir:

Kategori	Description
Veritabanları	admin, yerel, sistem yapılandırması
Koleksiyonlar	Ön eki olan herhangi bir koleksiyon system.

Geçiş görevleri makinemde yerel olarak çalışır mı?

Veritabanları ve koleksiyonlar, yerel VS Code istemcisinden yürütülen komutlar kullanılarak doğrudan sihirbaz kullanıcı arabiriminde listelenir. Bu işlevsellik, VS Code çalıştıran makine ile hem kaynak hem de hedef ortamlar arasında ağ bağlantısı gerektirir.

Veri geçiş görevleri Azure Veritabanı Geçiş Hizmeti (DMS) tarafından yürütülür. DMS, veri taşıma etkinliklerini düzenleyen ve yöneten azure tarafından barındırılan bir hizmettir. Geçiş görevleri oluşturulduktan sonra artık kaynak ve hedef ortamlara bağlantıyı sürdürmeniz gerekmez.

Geçiş sırasında veritabanlarını ve koleksiyonları yeniden adlandırabilir miyim?

Uzantı, geçiş sırasında veritabanı ve koleksiyonun yeniden adlandırılmasını desteklemez.

Bağlantı sorunlarını önlemek için kaynak sunucu güvenlik duvarlarımı nasıl yapılandırmalıyım?

Gerekli ağ yapılandırması seçili bağlantı moduna bağlıdır:

• Genel mod: İletişimi etkinleştirmek için sihirbazda hem kaynak hem de hedef güvenlik duvarlarında görüntülenen IP adreslerine izin vermelisiniz.
• Özel mod: DMS sunucularının sanal ağ içindeki kaynak ve hedef uç noktalarla güvenli bir şekilde iletişim kurabilmesi için sanal ağ tümleştirmesini etkinleştirmeniz gerekir.

Ayrıca VS Code bağlantısına da bakın

Tek bir geçişte kaç veritabanı ve koleksiyon geçirebilirim?

Tek bir geçişe en fazla 25 koleksiyon ekleyebilirsiniz. Ancak, diğer koleksiyonları geçirmek için birden çok geçiş işi oluşturabilir ve çalıştırabilirsiniz.

Aynı anda kaç geçiş işi çalıştırabilirim?

Genel erişimi kullanırken birden çok geçiş işi çalıştırabilirsiniz. Ancak , özel erişim kullanılırken tek bir sanal ağ aynı anda yalnızca bir etkin işi destekleyebilir. Özel erişimle birden çok iş çalıştırmak için her iş için farklı sanal ağ kullanmanız gerekir.

Uzantı ne tür günlükler oluşturur?

Uzantı hataları, uyarıları ve diğer tanılama günlüklerini varsayılan günlük dizinine kaydeder:

• Windows - C:\Users\<username>\.dmamongo\logs\
• Linux - ~/.dmamongo/logs
• macOS - /Users/<username>/.dmamongo/logs

Sonraki Adımlar

Node.js web uygulaması oluşturma