MongoDB yerel araçlarını kullanarak MongoDB'yi Çevrimdışı Azure DocumentDB'ye geçirme

Bu öğreticide, MongoDB'nin şirket içi veya bulut örneğinden Azure DocumentDB'ye çevrimdışı (tek seferlik) bir veritabanı geçişi gerçekleştirmek için MongoDB yerel araçlarını kullanacaksınız. MongoDB yerel araçları, mevcut bir MongoDB örneğinde veri işlemeyi kolaylaştıran ikili dosyalar kümesidir. Bu belgenin odak noktası mongoexport/mongoimport veya mongodump/mongorestore kullanarak mongoDB örneğinden verileri geçirmektir. Yerel araçlar bağlantı dizelerini kullanarak MongoDB'ye bağlandığından, araçları her yerde çalıştırabilirsiniz. Yerel araçlar, toplam geçiş süresinin önemli olmadığı küçük veri kümeleri için en basit çözüm olabilir.

Ö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

• Makinenizde yüklü MongoDB yerel araçları.

Hazırlamak

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

• MongoDB örneği (kaynak)
  • Kaynak örneğinizle hedef hesabınız arasında uyumsuzlukların ve uyarıların listesi olup olmadığını belirlemek için geçiş öncesi değerlendirmesini tamamlayın.
  • MongoDB yerel araçlarınızın mevcut (kaynak) MongoDB örneğiyle aynı sürümle eşleştiğinden emin olun.
    • MongoDB örneğinizin Azure DocumentDB'den farklı bir sürümü varsa, hem MongoDB yerel araç sürümlerini yükleyin hem de sırasıyla MongoDB ve Azure DocumentDB için uygun araç sürümünü kullanın.
  • Zaten bir kullanıcı yoksa, izinleri olan readWrite bir kullanıcı ekleyin. Sonunda mongoexport ve mongodump araçlarıyla bu kimlik bilgilerini kullanırsınız.
• Azure DocumentDB (amaç)
  • Azure DocumentDB hesabının kimlik bilgilerini toplayın.
  • Azure DocumentDB'de Güvenlik Duvarı Ayarlarını yapılandırın.

Tip

Diğer güvenlik duvarı sorunlarını önlemek için bu araçları MongoDB örneğiyle aynı ağ içinde çalıştırmanızı öneririz.

Uygun MongoDB yerel aracını seçin

Çevrimdışı geçişiniz için doğru MongoDB yerel aracını seçerken dikkat edilmesi gereken bazı üst düzey noktalar vardır.

Geçişi gerçekleştirme

Tercih ettiğiniz yerel aracı kullanarak kaynak MongoDB örneğinden bir koleksiyonu hedef Azure DocumentDB hesabına geçirin. Araç seçme hakkında daha fazla bilgi için bkz. geçiş seçenekleri.

Tip

Azure DocumentDB'ye aktarmak istediğiniz küçük bir JSON dosyanız varsa mongoimport aracı, verileri almak için hızlı bir çözümdür.

mongoexport/mongoimport

1. Kaynak MongoDB örneğinden verileri dışarı aktarmak için bir terminal açın ve burada listelenen üç yöntemden birini kullanın.

   • JSON kayıtlarına bağlanmak ve dışarı aktarmak için, --host, --username ve --password bağımsız değişkenlerini belirtin.

     mongoexport \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --db <database-name> \
         --collection <collection-name> \
         --out <filename>.json
     

   • MongoDB verilerinin bir --query alt kümesini, bağımsız değişken ekleyerek dışarı aktarın. Bu bağımsız değişken, aracın yalnızca filtreyle eşleşen belgeleri dışarı aktarmasını sağlar.

     mongoexport \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --db <database-name> \
         --collection <collection-name> \
         --query '{ "quantity": { "$gte": 15 } }' \
         --out <filename>.json
     

   • Azure DocumentDB'den verileri dışarı aktarma.

     mongoexport \
         --uri <target-connection-string>
         --db <database-name> \
         --collection <collection-name> \
         --query '{ "quantity": { "$gte": 15 } }' \
         --out <filename>.json
     

2. Daha önce dışarı aktarılan dosyayı hedef Azure DocumentDB hesabına aktarın.

   mongoimport \
       --file <filename>.json \
       --type json \
       --db <database-name> \
       --collection <collection-name> \
       --ssl \
       --uri <target-connection-string>
   

3. Mongoimport'tan terminal çıkışını izleyin. Çıktı, içeri aktarma işleminin durumuyla ilgili güncelleştirmelerle birlikte metin satırlarını terminale yazdırır.

mongodump/mongorestore

1. MongoDB örneğinizdeki tüm verilerin veri dökümünü oluşturmak için bir terminal açın ve burada listelenen üç yöntemden birini kullanın.

   • Verileri yerel BSON olarak dökümlemek için --host, --username, ve --password bağımsız değişkenlerini belirtin.

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --out <dump-directory>
     

   • --db ve --collection bağımsız değişkenlerini belirterek dökümünü almak istediğiniz verilerin kapsamını daraltın.

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \    
         --db <database-name> \
         --out <dump-directory>
     

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \    
         --db <database-name> \
         --collection <collection-name> \
         --out <dump-directory>
     

   • Azure DocumentDB'nizdeki tüm verilerin veri dökümünü oluşturun.

     mongodump \
         --uri <target-connection-string> \
         --out <dump-directory>
     

2. Aracın yerel BSON verilerinin atıldığı bir dizin oluşturduğunu gözlemleyin. Dosyalar ve klasörler, veritabanı ve koleksiyon adlarına göre bir kaynak hiyerarşisi halinde düzenlenir. Her veritabanı bir klasör ve her koleksiyon bir .bson dosyadır.

3. Koleksiyonun belirli BSON dosyasını belirterek belirli bir koleksiyonun içeriğini bir Azure DocumentDB hesabına geri yükleyin. Dosya adı şu söz dizimi kullanılarak oluşturulur: <dump-directory>/<database-name>/<collection-name>.bson.

   mongorestore \ 
       --ssl \
       --uri <target-connection-string> \
       <dump-directory>/<database-name>/<collection-name>.bson
   

   Uyarı

   Belirli bir koleksiyonu veya koleksiyonları dump-directory /directory dizininden de geri yükleyebilirsiniz. Örneğin, aşağıdaki işlem dump-directory /directory içindeki ilgili veri dosyalarından tek bir koleksiyonu geri yükler. mongorestore --nsInclude=test.purchaseorders <dump-directory>/

4. Mongoimport'tan terminal çıkışını izleyin. Çıkış, geri yükleme işleminin durumuyla ilgili güncelleştirmelerle terminale metin satırları yazdırır.

Sonraki adım

Node.js web uygulaması oluşturma