Dela via

Konfigurera din Azure Cosmos DB för MongoDB-kontokapacitet

  • Artikel

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

Tillgängliga funktioner

Kapacitet beskrivning Avtagbar
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. 1 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. 2 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

Kommentar

1 Den här funktionen kan inte aktiveras på ett Azure Cosmos DB för MongoDB-konton med kundhanterade nycklar (CMK).

Kommentar

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

Viktigt!

Det går inte att ändra funktioner med Hjälp av Azure Resource Manager för Azure Cosmos DB för MongoDB-konton.

Aktivera en funktion

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

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

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

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