Konfigurera azure Cosmos DB för MongoDB-kontofunktioner

Artikel
04/25/2024

GÄLLER FÖR: Mongodb

Funktioner är funktioner som kan läggas till eller tas bort i ditt API för MongoDB-konto. Många av dessa funktioner påverkar kontobeteendet, så det är viktigt att vara fullt medveten om vilken effekt en funktion har innan du aktiverar eller inaktiverar den. Flera funktioner har angetts för API för MongoDB-konton som standard och kan inte ändras eller tas bort. Ett exempel är funktionen EnableMongo . Den här artikeln visar hur du aktiverar och inaktiverar en funktion.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
Ett Azure Cosmos DB för MongoDB-konto. Skapa ett API för MongoDB-konto.
Åtkomst till Azure CLI eller Azure-portalen. Det går inte att ändra funktioner via Azure Resource Manager.

Tillgängliga funktioner

Kapacitet	beskrivning	Flyttbara
`DisableRateLimitingResponses`	Gör att Mongo-API:et kan försöka begränsa antalet begäranden på serversidan tills värdet som har angetts för `max-request-timeout`.	Ja
`EnableMongoRoleBasedAccessControl`	Aktivera stöd för att skapa användare och roller för intern rollbaserad åtkomstkontroll i MongoDB.	Nej
`EnableMongoRetryableWrites`	Aktiverar stöd för återförsöksbara skrivningar på kontot.	Ja
`EnableMongo16MBDocumentSupport`	Aktiverar stöd för att infoga dokument med en storlek på upp till 16 MB.	Nej
`EnableUniqueCompoundNestedDocs`	Aktiverar stöd för sammansatta och unika index i kapslade fält om det kapslade fältet inte är en matris.	Nej
`EnableTtlOnCustomPath`	Ger möjlighet att ange en anpassad TTL (Time to Live) för ett fält i en samling. Det går inte att ange TTL för partiell unik indexegenskap. ¹	Nej
`EnablePartialUniqueIndex`	Aktiverar stöd för ett unikt partiellt index, så att du har större flexibilitet att ange exakt vilka fält i dokument som du vill indexera.	Nej
`EnableUniqueIndexReIndex`	Aktiverar stöd för unik indexomindexering för Cosmos DB för MongoDB RU. ¹	Nej

Kommentar

¹ Den här funktionen kan inte aktiveras på en Azure Cosmos DB för MongoDB-konton med kontinuerlig säkerhetskopiering.

Aktivera en funktion

Hämta dina befintliga kontofunktioner med az cosmosdb show:
```
az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>
```
Du bör se ett funktionsavsnitt som liknar det här exemplets utdata:
```
"capabilities": [
  {
    "name": "EnableMongo"
  }
]
```
Granska standardfunktionen. I det här exemplet är EnableMongoden enda funktionen som har angetts .
Ange den nya funktionen för ditt databaskonto. Listan över funktioner bör innehålla listan över tidigare aktiverade funktioner som du vill behålla.

Endast explicit namngivna funktioner anges för ditt konto. Om du till exempel vill lägga DisableRateLimitingResponses till funktionen i föregående exempel använder du kommandot az cosmosdb update med parametern --capabilities och listar alla funktioner som du vill ha i ditt konto:
```
az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo DisableRateLimitingResponses
```
Viktigt!

Listan över funktioner måste alltid ange alla funktioner som du vill aktivera, inklusive. Detta inkluderar funktioner som redan är aktiverade för det konto som du vill behålla. I det här exemplet EnableMongo var funktionen redan aktiverad, så du måste ange både EnableMongo funktionen och DisableRateLimitingResponses funktionen.
Dricks

Om du använder PowerShell och ett felmeddelande visas när du använder föregående kommando kan du i stället prova att använda en PowerShell-matris för att visa en lista över funktionerna:
```
az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo","DisableRateLimitingResponses")
```

Inaktivera en funktion

Hämta dina befintliga kontofunktioner med hjälp az cosmosdb showav :
```
az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>
```
Du bör se ett funktionsavsnitt som liknar det här exemplets utdata:
```
"capabilities": [
  {
    "name": "EnableMongo"
  },
  {
    "name": "DisableRateLimitingResponses"
  }
]
```
Sök efter alla funktioner som har angetts för närvarande. I det här exemplet anges två funktioner: EnableMongo och DisableRateLimitingResponses.
Ta bort en av funktionerna från ditt databaskonto. Listan över funktioner bör innehålla listan över tidigare aktiverade funktioner som du vill behålla.

Endast explicit namngivna funktioner anges för ditt konto. Om du till exempel vill ta bort DisableRateLimitingResponses funktionen använder az cosmosdb update du kommandot och listar den funktion som du vill behålla:
```
az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo
```
Dricks

Om du använder PowerShell och ett felmeddelande visas när du använder det här kommandot kan du i stället försöka använda en PowerShell-matris för att visa en lista över funktionerna:
```
az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo")
```

Nästa steg

Lär dig hur du använder Studio 3T med Azure Cosmos DB för MongoDB.
Lär dig hur du använder Robo 3T med Azure Cosmos DB för MongoDB.
Utforska MongoDB-exempel med Azure Cosmos DB för MongoDB.
Försöker du planera kapacitet för en migrering till Azure Cosmos DB? Du kan använda information om ditt befintliga databaskluster för kapacitetsplanering.
- Om allt du vet är antalet virtuella kärnor och servrar i ditt befintliga databaskluster kan du lära dig hur du beräknar enheter för begäranden med hjälp av virtuella kärnor eller virtuella kärnor.
- Om du känner till vanliga begäranden för din aktuella databasarbetsbelastning kan du lära dig hur du beräknar enheter för begäranden med hjälp av Kapacitetshanteraren för Azure Cosmos DB.

Share via