Delen via

De mogelijkheden van uw Azure Cosmos DB voor MongoDB-account configureren

  • Artikel

VAN TOEPASSING OP: MongoDB

Mogelijkheden zijn functies die kunnen worden toegevoegd aan of verwijderd uit uw API voor MongoDB-account. Veel van deze functies hebben invloed op het gedrag van accounts, dus het is belangrijk dat u zich volledig bewust bent van het effect dat een mogelijkheid heeft voordat u deze inschakelt of uitschakelt. Er zijn standaard verschillende mogelijkheden ingesteld voor API voor MongoDB-accounts en kunnen niet worden gewijzigd of verwijderd. Een voorbeeld hiervan is de EnableMongo mogelijkheid. In dit artikel wordt beschreven hoe u een mogelijkheid inschakelt en uitschakelt.

Vereisten

Beschikbare mogelijkheden

Mogelijkheid Beschrijving Verwisselbare
DisableRateLimitingResponses Hiermee kan mongo-API aanvragen voor frequentiebeperking aan de serverzijde opnieuw proberen totdat de waarde die is ingesteld voor max-request-timeout. Ja
EnableMongoRoleBasedAccessControl Schakel ondersteuning in voor het maken van gebruikers en rollen voor systeemeigen op rollen gebaseerd toegangsbeheer van MongoDB. Nee
EnableMongoRetryableWrites Biedt ondersteuning voor schrijfbewerkingen die opnieuw kunnen worden geprobeerd voor het account. Ja
EnableMongo16MBDocumentSupport Biedt ondersteuning voor het invoegen van documenten tot 16 MB in grootte. 1 Nee
EnableUniqueCompoundNestedDocs Biedt ondersteuning voor samengestelde en unieke indexen voor geneste velden als het geneste veld geen matrix is. Nee
EnableTtlOnCustomPath Biedt de mogelijkheid om een aangepaste TTL (Time to Live) in te stellen voor elk veld in een verzameling. Het instellen van TTL voor een gedeeltelijke unieke indexeigenschap wordt niet ondersteund. 2 Nee
EnablePartialUniqueIndex Biedt ondersteuning voor een unieke gedeeltelijke index, dus u hebt meer flexibiliteit om precies op te geven welke velden in documenten u wilt indexeren. Nr.

Notitie

1 Deze mogelijkheid kan niet worden ingeschakeld op een Azure Cosmos DB voor MongoDB-accounts met door de klant beheerde sleutels (CMK).

Notitie

2 Deze mogelijkheid kan niet worden ingeschakeld op een Azure Cosmos DB voor MongoDB-accounts met continue back-up.

Belangrijk

Veranderende mogelijkheden met Behulp van Azure Resource Manager zijn niet beschikbaar voor Azure Cosmos DB voor MongoDB-accounts.

Een mogelijkheid inschakelen

  1. Haal uw bestaande accountmogelijkheden op met behulp van az cosmosdb show:

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

    Als het goed is, ziet u een sectie met mogelijkheden die vergelijkbaar is met deze voorbeelduitvoer:

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

    Controleer de standaardmogelijkheid. In dit voorbeeld is EnableMongode enige mogelijkheid die is ingesteld.

  2. Stel de nieuwe mogelijkheid in voor uw databaseaccount. De lijst met mogelijkheden moet de lijst met eerder ingeschakelde mogelijkheden bevatten die u wilt behouden.

    Alleen expliciet benoemde mogelijkheden zijn ingesteld voor uw account. Als u bijvoorbeeld de DisableRateLimitingResponses mogelijkheid wilt toevoegen aan het vorige voorbeeld, gebruikt u de opdracht az cosmosdb update met de --capabilities parameter en geeft u alle mogelijkheden weer die u in uw account wilt hebben:

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

    Belangrijk

    De lijst met mogelijkheden moet altijd alle mogelijkheden opgeven die u wilt inschakelen, inclusief. Dit omvat mogelijkheden die al zijn ingeschakeld voor het account dat u wilt behouden. In dit voorbeeld is de EnableMongo mogelijkheid al ingeschakeld, dus u moet zowel de EnableMongo mogelijkheid als de DisableRateLimitingResponses mogelijkheid opgeven.

    Tip

    Als u PowerShell gebruikt en er een foutbericht wordt weergegeven wanneer u de voorgaande opdracht gebruikt, gebruikt u in plaats daarvan een PowerShell-matrix om de mogelijkheden weer te geven:

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

Een mogelijkheid uitschakelen

  1. Haal uw bestaande accountmogelijkheden op met behulp van az cosmosdb show:

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

    Als het goed is, ziet u een sectie met mogelijkheden die vergelijkbaar is met deze voorbeelduitvoer:

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

    Controleer op alle mogelijkheden die momenteel zijn ingesteld. In dit voorbeeld zijn er twee mogelijkheden ingesteld: EnableMongo en DisableRateLimitingResponses.

  2. Verwijder een van de mogelijkheden uit uw databaseaccount. De lijst met mogelijkheden moet de lijst met eerder ingeschakelde mogelijkheden bevatten die u wilt behouden.

    Alleen expliciet benoemde mogelijkheden zijn ingesteld voor uw account. Als u bijvoorbeeld de mogelijkheid wilt verwijderen, gebruikt u de DisableRateLimitingResponses az cosmosdb update opdracht en geeft u de mogelijkheid weer die u wilt behouden:

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

    Tip

    Als u PowerShell gebruikt en er een foutbericht wordt weergegeven wanneer u deze opdracht gebruikt, kunt u in plaats daarvan een PowerShell-matrix gebruiken om de mogelijkheden weer te geven:

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

Volgende stappen