Aracılığıyla paylaş

MongoDB için Azure Cosmos DB hesap özelliklerinizi yapılandırma

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: MongoDB

Özellikler, MongoDB hesabı için API'nize eklenebilecek veya kaldırabileceğiniz özelliklerdir. Bu özelliklerin çoğu hesap davranışını etkilediğinden, etkinleştirmeden veya devre dışı bırakmadan önce bir özelliğin etkisini tam olarak bilmeniz önemlidir. MongoDB hesapları için API'de varsayılan olarak çeşitli özellikler ayarlanır ve değiştirilemez veya kaldırılamaz. Bir örnek, yetenektir EnableMongo . Bu makalede, bir özelliği etkinleştirme ve devre dışı bırakma işlemleri gösterilmektedir.

Önkoşullar

  • Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
  • MongoDB için Azure Cosmos DB hesabı. MongoDB hesabı için bir API oluşturun.
  • Azure CLI veya Azure portal erişimi. Azure Resource Manager aracılığıyla özelliklerin değiştirilmesi desteklenmez.

Kullanılabilir özellikler

Yetenek Açıklama Çıkarılabilir
DisableRateLimitingResponses Mongo API'sinin için ayarlanan max-request-timeoutdeğere kadar sunucu tarafında hız sınırlama isteklerini yeniden denemesine izin verir. Yes
EnableMongoRoleBasedAccessControl Yerel MongoDB rol tabanlı erişim denetimi için kullanıcı ve rol oluşturma desteğini etkinleştirin. Hayır
EnableMongoRetryableWrites Hesapta yeniden denenebilir yazmalar için destek sağlar. Yes
EnableMongo16MBDocumentSupport Boyutu 16 MB'a kadar olan belgeleri ekleme desteği sağlar. Hayır
EnableUniqueCompoundNestedDocs İç içe yerleştirilmiş alan bir dizi değilse, iç içe yerleştirilmiş alanlarda bileşik ve benzersiz dizinler için destek sağlar. Hayır
EnableTtlOnCustomPath Koleksiyondaki herhangi bir alanda özel bir Yaşam Süresi (TTL) ayarlama olanağı sağlar. Kısmi benzersiz dizin özelliğinde TTL ayarlanması desteklenmez. 1 Hayır
EnablePartialUniqueIndex Benzersiz bir kısmi dizin desteğini etkinleştirir, böylece belgelerde tam olarak hangi alanları dizine almak istediğinizi belirtme esnekliğiniz daha fazla olur. Hayır
EnableUniqueIndexReIndex MongoDB RU için Cosmos DB için benzersiz dizin yeniden dizin oluşturma desteğini etkinleştirir. 1 Hayır

Not

1 Bu özellik, sürekli yedeklemeye sahip MongoDB hesapları için Azure Cosmos DB'de etkinleştirilemez.

Bir özelliği etkinleştirme

  1. az cosmosdb show komutunu kullanarak mevcut hesap yeteneklerinizi alın:

    az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>

    Bu örnek çıktıya benzer bir yetenek bölümü görmeniz gerekir:

    "capabilities": [
  {
    "name": "EnableMongo"
  }
]

    Varsayılan özelliği gözden geçirin. Bu örnekte, ayarlanan tek özelliktir EnableMongo.

  2. Veritabanı hesabınızda yeni özelliği ayarlayın. Özellikler listesi, saklamak istediğiniz önceden etkinleştirilen özelliklerin listesini içermelidir.

    Hesabınızda yalnızca açıkça adlandırılmış özellikler ayarlanır. Örneğin, özelliği önceki örne eklemek DisableRateLimitingResponses istiyorsanız az cosmosdb update komutunu parametresiyle --capabilities birlikte kullanın ve hesabınızda olmasını istediğiniz tüm özellikleri listeleyin:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo DisableRateLimitingResponses

    Önemli

    Özellikler listesi her zaman etkinleştirmek istediğiniz tüm özellikleri (dahil) belirtmelidir. Bu, saklamak istediğiniz hesap için zaten etkinleştirilmiş olan özellikleri içerir. Bu örnekte, EnableMongo özellik zaten etkinleştirilmiştir, bu nedenle hem özelliği hem DisableRateLimitingResponses de EnableMongo özelliği belirtmeniz gerekir.

    İpucu

    PowerShell kullanıyorsanız ve önceki komutu kullandığınızda bir hata iletisi görüntüleniyorsa, bunun yerine özellikleri listelemek için bir PowerShell dizisi kullanmayı deneyin:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo","DisableRateLimitingResponses")

Bir özelliği devre dışı bırakma

  1. kullanarak az cosmosdb showmevcut hesap yeteneklerinizi alın:

    az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>

    Bu örnek çıktıya benzer bir yetenek bölümü görmeniz gerekir:

    "capabilities": [
  {
    "name": "EnableMongo"
  },
  {
    "name": "DisableRateLimitingResponses"
  }
]

    Şu anda ayarlanmış olan tüm özellikleri denetleyin. Bu örnekte iki özellik ayarlanır: EnableMongo ve DisableRateLimitingResponses.

  2. Veritabanı hesabınızdaki özelliklerden birini kaldırın. Özellikler listesi, saklamak istediğiniz önceden etkinleştirilen özelliklerin listesini içermelidir.

    Hesabınızda yalnızca açıkça adlandırılmış özellikler ayarlanır. Örneğin, bu özelliği kaldırmak DisableRateLimitingResponses istiyorsanız komutunu kullanabilir az cosmosdb update ve saklamak istediğiniz özelliği listeleyebilirsiniz:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo

    İpucu

    PowerShell kullanıyorsanız ve bu komutu kullandığınızda bir hata iletisi görüntüleniyorsa, bunun yerine özellikleri listelemek için bir PowerShell dizisi kullanmayı deneyin:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo")

Sonraki adımlar