öğretici: mongodb 'yi mongodb için Azure Cosmos DB apı 'ye geçirme

Uygulama hedefı: MongoDB için Azure Cosmos DB API

Önemli

Geçiş adımlarınızı gerçekleştirmeden önce lütfen bu kılavuzun tamamını okuyun.

Bu MongoDB geçiş kılavuzu, MongoDB geçişinin serisinin bir parçasıdır. Kritik MongoDB geçiş adımları, aşağıda gösterildiği gibi, ön geçiş, geçiş ve geçiş sonrasıgeçişlerdir.

Geçiş adımlarının diyagramı.

mongodb 'den DMS kullanarak Azure Cosmos DB çevrimdışı veri geçişine genel bakış

Azure veritabanı geçiş hizmeti 'ni kullanarak mongodb 'nin şirket içi veya bulut örneğinden mongodb için Azure Cosmos DB apı 'sine yönelik çevrimdışı, tek seferlik bir geçiş işlemi gerçekleştirin.

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz:

  • Azure Veritabanı Geçiş Hizmeti örneği oluşturun.
  • Azure veritabanı geçiş hizmeti 'ni kullanarak bir geçiş projesi oluşturun.
  • Geçişi çalıştırma.
  • Geçişi izleme.

Bu öğreticide, bir Azure sanal makinesinde barındırılan MongoDB içindeki bir veri kümesini geçirolursunuz. Azure veritabanı geçiş hizmeti 'ni kullanarak, veri kümesini mongodb için Azure Cosmos DB apı 'sine geçirolursunuz. zaten bir mongodb kaynağınız yoksa, bkz. Azure 'da Windows VM 'de mongodb 'yi kurma ve yapılandırma.

Önkoşullar

Bu öğreticiyi tamamlamak için aşağıdakileri yapmanız gerekir:

  • Aktarım hızını tahmin etme ve bölüm anahtarı seçme gibi geçiş öncesi adımları doldurun .

  • mongodb için Azure Cosmos DB apı 'si için bir hesap oluşturun.

    Not

    I, sunucusuz mod ile sağlanan MongoDB hesabı için API 'ye geçiş yapıyorsanız, DMS Şu anda desteklenmemektedir.

  • Azure veritabanı geçiş hizmeti için Azure Resource Manager kullanarak Microsoft Azure sanal ağı oluşturun. Bu dağıtım modeli, Azure ExpressRoute veya VPNkullanarak şirket içi kaynak sunucularınız için siteden siteye bağlantı sağlar. Sanal ağ oluşturma hakkında daha fazla bilgi için Azure sanal ağ belgelerine, özellikle de adım adım ayrıntılara sahip "hızlı başlangıç" makalelerine bakın.

    Not

    Sanal ağ kurulumu sırasında, Microsoft 'a ağ eşlemesi ile ExpressRoute kullanırsanız, hizmetin sağlanacağı alt ağa aşağıdaki hizmet uç noktalarını ekleyin:

    • hedef veritabanı uç noktası (örneğin, SQL uç noktası veya Azure Cosmos DB uç noktası)
    • Depolama uç noktası
    • Service Bus uç noktası

    Azure veritabanı geçiş hizmeti internet bağlantısı olmadığından bu yapılandırma gereklidir.

  • Sanal ağınız için ağ güvenlik grubu (NSG) kurallarınızın şu iletişim bağlantı noktalarını engellemediğinden emin olun: 53, 443, 445, 9354 ve 10000-20000. Daha fazla bilgi için bkz. Ağ güvenlik grupları ile ağ trafiğini filtreleme.

  • Azure veritabanı geçiş hizmeti 'nin, varsayılan olarak TCP bağlantı noktası 27017 olan kaynak mongodb sunucusuna erişmesine izin vermek için Windows güvenlik duvarınızı açın.

  • Kaynak veritabanınızın önünde bir güvenlik duvarı gereci kullanırken, Azure veritabanı geçiş hizmeti 'nin geçiş için kaynak veritabanına erişmesine izin vermek üzere güvenlik duvarı kuralları eklemeniz gerekebilir.

Sunucu tarafı yeniden deneme özelliğini yapılandırma

mongodb 'den Azure Cosmos DB 'e geçiş yapıyorsanız kaynak idare özelliğinden yararlanabilirsiniz. Bu özelliklerde, sağlanan istek birimlerinizin (RU/s) aktarım hızını tam olarak kullanabilirsiniz. Azure Cosmos DB, bu istek kapsayıcı tarafından sağlanan RU/s 'yi aşarsa geçiş sırasında belirli bir veritabanı geçiş hizmeti isteğini kısıtlayabilir. Daha sonra bu isteğin yeniden denenilmesi gerekir.

Veritabanı geçiş hizmeti yeniden deneme gerçekleştirebilir. veritabanı geçiş hizmeti ve Azure Cosmos DB arasındaki gidiş dönüş süresinin, bu isteğin genel yanıt süresini etkilediği anlaşılması önemlidir. Kısıtlanmış istekler için yanıt süresini iyileştirmek, geçiş için gereken toplam süreyi kısaltabilir.

sunucu tarafı yeniden deneme özelliği Azure Cosmos DB, hizmetin kısıtlama hata kodlarını kesmesini ve daha sonra istek yanıt sürelerini önemli ölçüde iyileştirerek çok daha düşük bir gidiş dönüş süresi ile yeniden denemesini sağlar.

sunucu tarafı yeniden denemesini kullanmak için Azure Cosmos DB portalında özellikler > sunucu tarafı yeniden dene' yi seçin.

Sunucu tarafı yeniden deneme özelliğinin nerede bulunacağını gösteren ekran görüntüsü.

Özellik devre dışıysa Etkinleştir' i seçin.

Sunucu tarafı yeniden denemesini nasıl etkinleştireceğinizi gösteren ekran görüntüsü.

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

  1. Azure portalında oturum açın. Abonelikler'i arayın ve seçin.

    Portal aboneliklerini gösterme

  2. Örnek oluşturmak istediğiniz aboneliği seçin ve Azure Veritabanı Geçiş Hizmeti sağlayıcılar'ı seçin.

    Kaynak sağlayıcılarını gösterme

  3. Geçiş araması ve ardından Microsoft.DataMigration için kaydol'u seçin.

    Kaynak sağlayıcısını kaydetme

Örnek oluşturma

  1. Azure portal + kaynak oluştur' u seçin, Azure veritabanı geçiş hizmeti ' ni arayın ve ardından açılan listeden Azure veritabanı geçiş hizmeti ' ni seçin.

    Azure Market'i gösteren ekran görüntüsü.

  2. Azure Veritabanı Geçiş Hizmeti ekranında Oluştur'u seçin.

    Azure veritabanı geçiş hizmeti örneğinin nasıl oluşturulacağını gösteren ekran görüntüsü.

  3. Geçiş hizmeti oluştur' da hizmet, abonelik ve yeni veya mevcut bir kaynak grubu için bir ad belirtin.

  4. Azure veritabanı geçiş hizmeti örneğini oluşturmak istediğiniz konumu seçin.

  5. Var olan bir sanal ağı seçin veya yeni bir ağ oluşturun.

    sanal ağ, kaynak mongodb örneğine ve hedef Azure Cosmos DB hesabına erişimi olan Azure veritabanı geçiş hizmeti sağlar.

    Azure portal sanal ağ oluşturma hakkında daha fazla bilgi için, bkz. Azure Portal kullanarak sanal ağ oluşturma.

  6. Fiyatlandırma katmanını seçin.

    Maliyetler ve fiyatlandırma katmanları hakkında daha fazla bilgi için fiyatlandırma sayfasına bakın.

    Azure veritabanı geçiş hizmeti örneği için yapılandırma ayarlarını gösteren ekran görüntüsü.

  7. Hizmeti oluşturmak için Oluştur’u seçin.

Geçiş projesi oluşturma

Hizmeti oluşturduktan sonra, Azure portal içinde bulun ve açın. Ardından yeni bir geçiş projesi oluşturun.

  1. Azure portalda Tüm hizmetler'i seçin, Azure Veritabanı Geçiş Hizmeti araması yapın ve Azure Veritabanı Geçiş Hizmeti'ni seçin.

    Azure veritabanı geçiş hizmeti 'nin tüm örneklerinin nasıl bulunacağını gösteren ekran görüntüsü.

  2. Azure veritabanı geçiş Hizmetleri ekranında, oluşturduğunuz Azure veritabanı geçiş hizmeti örneğinin adını arayın ve ardından örneği seçin.

  3. + Yeni geçiş Project seçin.

  4. Yeni geçiş projesinde, proje için bir ad belirtin ve kaynak sunucu türü metin kutusunda MongoDB' yi seçin. Hedef sunucu türü metin kutusunda Cosmosdb (MONGODB API) öğesini seçin ve ardından etkinlik türü seç' i seçerek çevrimdışı veri geçişi' ni seçin.

    Proje seçeneklerini gösteren ekran görüntüsü.

  5. Projeyi oluşturmak ve geçiş etkinliğini çalıştırmak için Etkinlik oluştur ve çalıştır'ı seçin.

Kaynak ayrıntılarını belirtme

  1. Kaynak ayrıntıları ekranında, kaynak MongoDB sunucusu için bağlantı ayrıntılarını belirtin.

    Önemli

    Azure veritabanı geçiş hizmeti kaynak olarak Azure Cosmos DB desteklemiyor.

    Bir kaynağa bağlanmak için üç mod vardır:

    • Tam etki alanı adı veya IP adresi, bağlantı noktası numarası ve bağlantı kimlik bilgilerini kabul eden Standart mod.

    • Bağlantı dizesi URI biçimindeaçıklandığı şekilde bir MongoDB bağlantı dizesi kabul eden bağlantı dizesi modu.

    • Blob kapsayıcı SAS URL 'sini kabul eden Azure Storage verileri. Blob kapsayıcısının MongoDB bsondump aracıtarafından oluşturulan bSon dökümlerini içermesi durumunda blob bSon dökümleri içerir ' i seçin. Kapsayıcı JSON dosyaları içeriyorsa bu seçeneği seçmeyin.

      Bu seçeneği belirlerseniz, depolama hesabı bağlantı dizesinin aşağıdaki biçimde göründüğünden emin olun:

      https://blobnameurl/container?SASKEY
      

      bu blob kapsayıcısı SAS bağlantı dizesini Azure Depolama explorer 'da bulabilirsiniz. İlgili kapsayıcı için SAS oluşturulması istenen biçimde URL 'YI sağlar.

      ayrıca, Azure Depolama 'daki tür dökümü bilgilerine göre şunları göz önünde bulundurun:

      • BSON dökümler için, blob kapsayıcısı içindeki verilerin bsondump biçiminde olması gerekir. Veri dosyalarını, koleksiyon. bSon biçiminde kapsayan veritabanlarının ardından adlandırılan klasörlere yerleştirin. Koleksiyon. Metadata. JSON biçimini kullanarak tüm meta veri dosyalarını adlandırın.

      • JSON dökümlerinde, blob kapsayıcısındaki dosyaların, kapsayan veritabanlarının ardından adlandırılan klasörlere yerleştirilmesi gerekir. Her veritabanı klasörü içinde, veri dosyalarının veri adlı bir alt klasöre yerleştirilmesi ve Collection. JSON biçimi kullanılarak adlandırılması gerekir. Tüm meta veri dosyalarını meta veriler adlı bir alt klasöre yerleştirin ve aynı biçimi, Collection. JSON' ı kullanarak adı. Meta veri dosyaları MongoDB bsondump aracı tarafından oluşturulan biçimde olmalıdır.

    Önemli

    MongoDB sunucusunda otomatik olarak imzalanan bir sertifika kullanmanızı önermiyoruz. Bir tane kullanmanız gerekiyorsa bağlantı dizesi modunu kullanarak sunucuya bağlanın ve bağlantı dizeniz tırnak işaretleri ("") olduğundan emin olun.

    &sslVerifyCertificate=false
    

    IP adresini, DNS ad çözümlemesi mümkün olmayan durumlar için de kullanabilirsiniz.

    Kaynak ayrıntılarını belirtmeyi gösteren ekran görüntüsü.

  2. Kaydet’i seçin.

Hedef ayrıntılarını belirtme

  1. geçiş hedefi ayrıntıları ekranında, hedef Azure Cosmos DB hesabının bağlantı ayrıntılarını belirtin. bu hesap, mongodb verilerinizi geçirdiğiniz mongodb hesabı için önceden sağlanmış Azure Cosmos DB apı 'sidir.

    Hedef ayrıntılarını belirtmeyi gösteren ekran görüntüsü.

  2. Kaydet’i seçin.

Hedef veritabanlarıyla eşleyin

  1. Hedef veritabanlarına eşle ekranında, geçiş için kaynağı ve hedef veritabanını eşleyin.

    Hedef veritabanı, kaynak veritabanıyla aynı veritabanı adını içeriyorsa, Azure veritabanı geçiş hizmeti varsayılan olarak hedef veritabanını seçer.

    Veritabanı adının yanında Oluştur görünürse, Azure veritabanı geçiş hizmeti 'nin hedef veritabanını bulmadığını ve hizmetin sizin için veritabanını oluşturacağını belirtir.

    Geçişin bu noktasında üretilen iş sağlamasağlayabilirsiniz. Azure Cosmos DB, veritabanı düzeyinde ya da her bir koleksiyon için ayrı ayrı üretilen iş sağlama sağlayabilirsiniz. Aktarım hızı, İstek birimlericinsinden ölçülür. Azure Cosmos DB fiyatlandırmasıhakkında daha fazla bilgi edinin.

    Hedef veritabanlarına eşlemeyi gösteren ekran görüntüsü.

  2. Kaydet’i seçin.

  3. Koleksiyon ayarı ekranında koleksiyonlar listesini genişletin ve geçirilecek koleksiyonların listesini gözden geçirin.

    Azure veritabanı geçiş hizmeti, hedef Azure Cosmos DB hesabında mevcut olmayan kaynak mongodb örneğinde mevcut olan tüm koleksiyonları otomatik olarak seçer. Zaten veri içeren koleksiyonları yeniden geçirmek istiyorsanız, bu bölmedeki koleksiyonları açıkça seçmeniz gerekir.

    Koleksiyonların kullanmasını istediğiniz RUs sayısını belirtebilirsiniz. Azure veritabanı geçiş hizmeti, koleksiyon boyutuna bağlı olarak akıllı varsayılanlar önerir.

    Not

    Veritabanı geçişini ve toplamayı paralel olarak gerçekleştirin. Gerekirse, çalıştırmayı hızlandırmak için Azure veritabanı geçiş hizmeti 'nin birden çok örneğini kullanabilirsiniz.

    ayrıca, en iyi ölçeklenebilirlik için Azure Cosmos DB bölümlemeden yararlanmak üzere bir parça anahtarı belirtebilirsiniz. Parça /bölüm anahtarı seçmek için en iyi uygulamalarıgözden geçirin.

    Koleksiyon tablolarını seçmeyi gösteren ekran görüntüsü.

  4. Kaydet’i seçin.

  5. Geçiş özeti ekranının Etkinlik adı metin kutusunda geçiş etkinliği için bir ad belirtin.

    Nibir özetini gösteren ekran görüntüsü.

Geçişi çalıştırma

Geçişi çalıştır'ı seçin. Geçiş etkinliği penceresi görüntülenir ve etkinliğin durumu başlatılmaz.

Etkinlik durumunu gösteren ekran görüntüsü.

Geçişi izleme

Geçiş etkinliği ekranında, geçişin durumu tamamlandı olarak gösterilene kadar görünümü güncelleştirmek için Yenile ' yi seçin.

Not

Veritabanı ve koleksiyon düzeyinde geçiş ölçümlerinin ayrıntılarını almak için etkinliğini seçebilirsiniz.

Etkinlik durumunun tamamlandığını gösteren screnshot.

Azure Cosmos DB verileri doğrulama

geçiş bittikten sonra, tüm koleksiyonların başarıyla geçirildiğini doğrulamak için Azure Cosmos DB hesabınızı kontrol edebilirsiniz.

tüm koleksiyonların başarıyla geçirildiğini doğrulamak üzere Azure Cosmos DB hesabınızın nerede kontrol ettiğini gösteren ekran görüntüsü.

Geçiş sonrası iyileştirmesi

mongodb veritabanında depolanan verileri mongodb için Azure Cosmos DB apı 'sine geçirdikten sonra, Azure Cosmos DB bağlanabilir ve verileri yönetebilirsiniz. Ayrıca, diğer geçiş sonrası iyileştirme adımlarını da gerçekleştirebilirsiniz. bunlar, dizin oluşturma ilkesini iyileştirmek, varsayılan tutarlılık düzeyini güncelleştirmek veya Azure Cosmos DB hesabınız için genel dağıtımı yapılandırmak içerebilir. Daha fazla bilgi için bkz. geçiş sonrası iyileştirmesi.

Ek kaynaklar

Sonraki adımlar

Azure veritabanı geçiş kılavuzu'ndaki ek senaryolar için geçiş kılavuzunu gözden geçirin.