Aracılığıyla paylaş


Azure DocumentDB'ye MongoDB Kabuk kullanarak bağlanma

MongoDB Shell (mongosh), MongoDB dağıtımlarıyla etkileşime yönelik bir JavaScript ve Node.js çalışma ortamıdır. Sorguları test etmek ve Azure DocumentDB kümenizdeki verilerle etkileşime geçmek için popüler bir topluluk aracıdır. Bu makalede MongoDB Kabuğu kullanarak azure documentDB kümesine nasıl bağlandığınız açıklanmaktadır.

Önkoşullar

  • Mevcut bir Azure DocumentDB kümesi

Küme kimlik bilgilerini alma

Bu kümeye bağlanmak için ihtiyacınız olan bağlantı dizesini alın.

  1. Azure portalında (https://portal.azure.com ) oturum açın.

  2. Mevcut Azure DocumentDB kümesine gidin.

Kümeye bağlanmak için kullandığınız kimlik bilgilerini alın.

  1. Küme sayfasında, kaynak menüsünde Bağlantı dizeleri seçeneğini belirleyin.

  2. Bağlantı dizeleri bölümünde, Değeri Bağlantı dizesi alanından kopyalayın veya kaydedin.

Bağlantı dizeleri seçeneğini gösteren ekran görüntüsü.

Önemli

Portaldaki bağlantı dizesi parola değerini içermez. Yer tutucuyu, kümeyi <password> oluştururken girdiğiniz kimlik bilgileriyle değiştirmeniz veya parolayı etkileşimli olarak girmeniz gerekir.

Etkileşimli parola kimlik doğrulaması ile bağlanma

MongoDB Kabuğunu parola içermeyen bir bağlantı dizesiyle kullanarak kümenize bağlanın. Bağlantı adımlarının bir parçası olarak parolanızı girmek için etkileşimli parola istemini kullanın.

  1. Bir terminal açın.

  2. MongoDB Kabuk istemine parolayı girerek bağlanın. Bu adım için, parolasız bir bağlantı dizesi kullanın.

    mongosh "mongodb+srv://<username>@<cluster-name>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"
    
  3. Parolayı sağladıktan ve kimlik doğrulaması başarıyla tamamlandıktan sonra görüntülenen uyarıyı gözlemleyin

    This server or service appears to be an emulation of MongoDB.
    

    Tavsiye

    Bu uyarıyı güvenle yoksayabilirsiniz. Bağlantı dizesi cosmos.azure içerdiğinden bu uyarı üretilir. Azure DocumentDB, yerel bir hizmet olarak Azure platformu (PaaS) teklifidir.

  4. Kabuk bağlamından çıkın.

Bağlantı dizesi ve parola ile bağlanma

Şimdi, MongoDB Shell'den kümenize, parola içeren bir bağlantı dizesi ve parametrelerle bağlanın.

  1. Bağlantı dizesini ve --username ve --password bağımsız değişkenlerini kullanarak bağlanın.

    mongosh "mongodb+srv://<cluster-name>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "<username>" -password "<password>"
    
  2. Parolayı sağladıktan ve kimliği başarıyla doğrulandıktan sonra görüntülenen uyarıyı gözlemleyin.

    ------
       Warning: Non-Genuine MongoDB Detected
       This server or service appears to be an emulation of MongoDB rather than an official MongoDB product.
    ------
    

    Tavsiye

    Bu uyarıyı güvenle yoksayabilirsiniz. Bağlantı dizesi cosmos.azure içerdiğinden bu uyarı üretilir. Azure DocumentDB, yerel bir hizmet olarak Azure platformu (PaaS) teklifidir.

Test sorguları gerçekleştirme

Bir dizi test komutu ve sorgu gerçekleştirerek kümenize başarıyla bağlandığınızı doğrulayın.

  1. komutunu çalıştırarak connectionStatus bağlantı durumunuzu denetleyin.

    db.runCommand({connectionStatus: 1})
    
    {
      ...
      ok: 1
    }
    
  2. Kümenizdeki veritabanlarını listeleyin.

    show dbs
    
  3. Belirli bir veritabanına geçin. Yer tutucuyu <database-name> kümenizdeki herhangi bir veritabanının adıyla değiştirin.

    use <database-name>
    

    Tavsiye

    Örneğin, veritabanı adı ise inventorykomutu olacaktır use inventory.

  4. Veritabanındaki koleksiyonları listeleyin.

    show collections
    
  5. Belirli bir koleksiyondaki ilk beş öğeyi bulun. Yer tutucuyu <collection-name> kümenizdeki herhangi bir koleksiyonun adıyla değiştirin.

    db.<collection-name>.find().limit(5)
    

    Tavsiye

    Örneğin, eğer koleksiyon adı equipment ise, komut db.equipment.find().limit(5) olacaktır.