MongoDB için Azure Cosmos DB API'sini kullanarak genel dağıtılmış veritabanı ayarlama

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: MongoDB

Bu makalede, Azure portal kullanarak genel bir dağıtılmış veritabanı ayarlamayı ve MongoDB için Azure Cosmos DB API'sini kullanarak bu veritabanına bağlanmayı göstereceğiz.

Bu makale aşağıdaki görevleri kapsar:

Azure portalını kullanarak genel veritabanı bölgeleri ekleme

Azure Cosmos DB, dünya genelindeki tüm Azure bölgelerinde kullanılabilir. Veritabanı hesabınız için varsayılan tutarlılık düzeyini seçtikten sonra bir veya daha fazla bölgeyi (tercih ettiğiniz varsayılan tutarlılık düzeyine ve genel dağıtım gereksinimlerine bağlı olarak) ilişkilendirebilirsiniz.

  1. Azure portalında, soldaki çubuktan Azure Cosmos DB seçeneğine tıklayın.

  2. Azure Cosmos DB sayfasında, değiştirilecek veritabanı hesabını seçin.

  3. Hesap sayfasındaki menüden Verileri genel olarak çoğaltma seçeneğine tıklayın.

  4. Verileri genel olarak çoğaltma sayfasında, haritadaki bölgelere tıklayarak eklenecek veya kaldırılacak bölgeleri seçin ve sonra Kaydet’e tıklayın. Bölgeleri eklemenin bir maliyeti yoktur. Daha fazla bilgi için fiyatlandırma sayfasına veya Azure Cosmos DB ile verileri genel olarak dağıtma makalesine bakın.

    Haritadaki bölgelere tıklayarak bölgeler ekleyin veya kaldırın

İkinci bir bölge eklediğinizde, portaldaki Verileri genel olarak çoğaltma sayfasında El İle Yük Devretme seçeneği etkinleştirilir. Yük devretme işlemini test etmek veya birincil yazma bölgesini değiştirmek için bu seçeneği kullanabilirsiniz. Üçüncü bir bölge eklemenizin ardından, okuma için yük devretme sırasını değiştirebilmeniz için aynı sayfada Yük Devretme Öncelikleri seçeneği etkinleştirilir.

Genel veritabanı bölgelerini seçme

İki veya daha fazla bölge yapılandırma için iki yaygın senaryo vardır:

  1. Dünya nerede bulunurlarsa bulunsunlar, son kullanıcılara düşük gecikmeli veri erişimi sunma
  2. İş sürekliliği ve olağanüstü durum kurtarma (BCDR) için bölgesel dayanıklılık ekleme

Son kullanıcılara düşük gecikme sunmak için, uygulama kullanıcılarının bulunduğu yere karşılık gelen bölgelerde hem uygulamayı hem de Azure Cosmos DB’yi dağıtmanız önerilir.

BCDR için, Azure'da bölgeler arası çoğaltma: İş sürekliliği ve olağanüstü durum kurtarma makalesinde açıklanan bölge çiftlerine göre bölgelerin eklenmesi önerilir.

Bölgesel kurulumunuzu doğrulama

MongoDB için Azure Cosmos DB API'siyle genel yapılandırmanızı denetlemenin basit bir yolu Mongo Kabuğu'ndan isMaster() komutunu çalıştırmaktır.

Mongo Kabuğunuzdan:

   db.isMaster()

Örnek sonuçlar:

   {
      "_t": "IsMasterResponse",
      "ok": 1,
      "ismaster": true,
      "maxMessageSizeBytes": 4194304,
      "maxWriteBatchSize": 1000,
      "minWireVersion": 0,
      "maxWireVersion": 2,
      "tags": {
         "region": "South India"
      },
      "hosts": [
         "vishi-api-for-mongodb-southcentralus.documents.azure.com:10255",
         "vishi-api-for-mongodb-westeurope.documents.azure.com:10255",
         "vishi-api-for-mongodb-southindia.documents.azure.com:10255"
      ],
      "setName": "globaldb",
      "setVersion": 1,
      "primary": "vishi-api-for-mongodb-southindia.documents.azure.com:10255",
      "me": "vishi-api-for-mongodb-southindia.documents.azure.com:10255"
   }

Tercih edilen bölgeye bağlanma

MongoDB için Azure Cosmos DB API'si, genel olarak dağıtılmış bir veritabanı için koleksiyonunuzun okuma tercihini belirtmenize olanak tanır. Hem düşük gecikmeli okumalar hem de genel yüksek kullanılabilirlik için, koleksiyonunuzun okuma tercihini en yakın olarak ayarlamanızı öneririz. En yakın bölgeden okumak için en yakın okuma tercihi yapılandırılır.

var collection = database.GetCollection<BsonDocument>(collectionName);
collection = collection.WithReadPreference(new ReadPreference(ReadPreferenceMode.Nearest));

Birincil okuma/yazma bölgesi ve olağanüstü durum kurtarma (DR) senaryoları için ikincil bölgeye sahip uygulamalar için koleksiyonunuzun okuma tercihini birincil tercih edilene ayarlamanızı öneririz. Birincil tercih edilen okuma tercihi, birincil bölge kullanılamadığında ikincil bölgeden okuyacak şekilde yapılandırılır.

var collection = database.GetCollection<BsonDocument>(collectionName);
collection = collection.WithReadPreference(new ReadPreference(ReadPreferenceMode.SecondaryPreferred));

Son olarak, okuma bölgelerinizi kendiniz belirtmek istiyorsanız. Okuma tercihiniz içinde bölge Etiketini ayarlayabilirsiniz.

var collection = database.GetCollection<BsonDocument>(collectionName);
var tag = new Tag("region", "Southeast Asia");
collection = collection.WithReadPreference(new ReadPreference(ReadPreferenceMode.Secondary, new[] { new TagSet(new[] { tag }) }));

Hepsi bu kadar. Böylece bu öğretici tamamlanmış olur. Azure Cosmos DB’deki tutarlılık düzeyleri bölümünü okuyarak genel olarak çoğaltılan hesabınızın tutarlılığının nasıl yönetileceğini öğrenebilirsiniz. Ayrıca genel veritabanı çoğaltmasının Azure Cosmos DB’de nasıl çalıştığı hakkında daha fazla bilgi için bkz. Azure Cosmos DB ile verileri genel olarak dağıtma.

Sonraki adımlar

Bu öğreticide aşağıdakileri yaptınız:

  • Azure portalını kullanarak genel dağıtımı yapılandırma
  • MongoDB için Azure Cosmos DB API'sini kullanarak genel dağıtımı yapılandırma

Artık Azure Cosmos DB yerel öykünücüsünü kullanarak yerel olarak geliştirme konusunda bilgi almak için sonraki öğreticiye geçebilirsiniz.

Azure Cosmos DB öykünücüsü ile yerel olarak geliştirme

Azure Cosmos DB'ye geçiş için kapasite planlaması yapmaya mı çalışıyorsunuz? Kapasite planlaması için mevcut veritabanı kümeniz hakkındaki bilgileri kullanabilirsiniz.