Aracılığıyla paylaş

Azure portalını kullanarak Azure DocumentDB'ye 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. Azure portalı, Azure Cloud Shell dahil olmak üzere MongoDB verilerini sorgulamak için birden çok araç içerir. Azure Cloud Shell, Azure kaynaklarını yönetmek için etkileşimli, kimliği doğrulanmış, tarayıcı tarafından erişilebilen bir terminaldir. Bu makalede, Azure Cloud Shell içinde MongoDB Kabuğu kullanarak bir Azure DocumentDB kümesine nasıl bağlanabileceğiniz açıklanmaktadır.

Önkoşullar

  • Mevcut bir Azure DocumentDB kümesi

  • Ağlarınızdaki istemcilerin kümeye bağlanmasına izin veren güvenlik duvarı kuralları. Daha fazla bilgi için bkz. Güvenlik duvarını yapılandırma.

  • (İsteğe bağlı) Bu önkoşullar yalnızca Azure Cloud Shell'i Azure DocumentDB ile aynı veya eşlenmiş bir sanal ağ içinde kullanıyorsanız gereklidir.

    • Azure Cloud Shell ve Azure DocumentDB dağıtımı için alt ağlara sahip bir veya daha fazla mevcut Azure Sanal Ağı.

    • Azure DocumentDB kümesi için özel uç nokta. Daha fazla bilgi için bkz. Özel bağlantıyı yapılandırma.

    • Azure Cloud Shell, Azure DocumentDB özel uç noktasına bağlantısı olan aynı veya eşlenmiş bir sanal ağa dağıtıldı. Daha fazla bilgi için bkz. Cloud Shell'i sanal ağa dağıtma.

Azure Cloud Shell'den kümenize erişimi etkinleştirme

İlk olarak Azure Cloud Shell'in güvenlik duvarında IP adreslerine izin vererek Azure DocumentDB kümenize erişebildiğinden emin olun.

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

  2. Azure DocumentDB kümesine gidin.

  3. Gezinti menüsünden Ağ'ı seçin.

  4. Geçerli IP adresinizi izin verilenler listesine otomatik olarak eklemek için Genel erişim bölümündeki Ağ sayfasında + Azure Cloud Shell IP'leri ekle seçeneğini belirleyin.

  5. Değişiklikleri uygulamak için Kaydet'i seçin.

Uyarı

Bağlantı sağlamak için bölgenize özgü IP adreslerine izin verildiğinden emin olun. Daha fazla bilgi için bkz. Azure DocumentDB için IP adresleri.

Hızlı Başlangıç'tan Azure Cloud Shell kullanarak bağlanma

MongoDB Kabuğu'nı kullanarak doğrudan Azure DocumentDB'ye bağlanmak için, Kaynağın Azure portalındaki sayfasında sağlanan Hızlı Başlangıç deneyimini kullanın.

  1. Küme kaynağı sayfasında, gezinti menüsünden Hızlı başlangıç (önizleme) öğesini seçin.

  2. Ardından MongoDB kabuğunu aç seçin.

  3. MongoDB Kabuğu ortamının başlamasını bekleyin.

  4. Ortam hazır olduğunda bildirimi kabul etmek için Y girin.

    Uyarı

    Bildirimi kabul ettikten sonra MongoDB Kabuğu'na bağlanırken sorun yaşıyorsanız Azure Cloud Shell'in kümenize erişimi olduğundan emin olun.

  5. Şimdi, kümenizi Cloud Shell'e bağlamak için parolanızı girin.

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.

Azure Cloud Shell'de MongoDB Kabuğunu el ile yapılandırma

Node Package Manager'ı (npm) kullanarak MongoDB Shell (mongosh) istemcisini Azure Cloud Shell ortamınıza yükleyin.

  1. Bash betik ortamıyla yapılandırılmış Azure Cloud Shell'i açın.

  2. Kullanıcı dizininize, MongoDB Shell'in 1 sürümünü yükleyin.

    npm install mongosh@1

  3. Yüklemenin tamamlanmasını bekleyin.

  4. mongosh aracının sürümünü kontrol ederek yüklemenin başarılı olduğunu doğrulayın.

    npx mongosh --version

Kümeye 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. MongoDB Kabuk istemine parolayı girerek bağlanın. Bu adım için, parolasız bir bağlantı dizesi kullanın.

    npx mongosh "mongodb+srv://<username>@<cluster-name>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"

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

    İpucu

    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>

    İpucu

    Ö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)

    İpucu

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

İlgili içerik

  • Last updated on