De totale doorvoer beperken die is ingericht voor uw Azure Cosmos DB-account

VAN TOEPASSING OP: Nosql MongoDB Cassandra Gremlin Tabel

Wanneer u een Azure Cosmos DB-account gebruikt in de ingerichte doorvoermodus , worden de meeste kosten meestal veroorzaakt door de hoeveelheid doorvoer die u in uw account hebt ingericht. Deze kosten worden met name rechtstreeks beïnvloed door:

  • Het aantal databases met gedeelde doorvoer.
  • Het aantal containers met toegewezen doorvoer.
  • De hoeveelheid doorvoer die voor elk van deze resources is ingericht.
  • Het aantal regio's waar uw account beschikbaar is.

Het kan lastig zijn om de totale hoeveelheid doorvoer bij te houden die u in uw account hebt ingericht, met name wanneer u aan de slag gaat met Azure Cosmos DB. Dit kan leiden tot onverwachte kosten wanneer dit bedrag een bepaald budget overschrijdt dat u niet verwachtte te overschrijden. Om u te helpen uw kosten beter te beheersen, kunt u met Azure Cosmos DB de totale doorvoer beperken die voor uw account is ingericht.

Notitie

Deze functie is niet beschikbaar voor serverloze accounts.

Nadat u een limiet hebt ingesteld voor de totale doorvoer van uw account, wordt een van de volgende bewerkingen die ertoe leiden dat deze limiet wordt overschreden, geblokkeerd en mislukt deze expliciet:

  • Een nieuwe database met gedeelde doorvoer maken.
  • Een nieuwe container met toegewezen doorvoer maken.
  • De ingerichte doorvoer verhogen voor een resource die is geconfigureerd in de standaardmodus (handmatig).
  • De maximale ingerichte doorvoer verhogen voor een resource die is geconfigureerd in de modus voor automatische schaalaanpassing.
  • Een nieuwe regio toevoegen aan uw account.

Notitie

Voor resources die zijn geconfigureerd in de modus voor automatische schaalaanpassing, is dit de maximale doorvoer die is geconfigureerd voor de resource die telt voor de totale doorvoer van uw account.

Belangrijk

Zodra een totale doorvoerlimiet is ingeschakeld voor uw account, moet u een expliciete doorvoerwaarde doorgeven bij het maken van nieuwe containers. Er wordt momenteel een fout weergegeven als u probeert een container te maken zonder expliciete doorvoer.

Stel de limiet voor de totale doorvoer in vanaf de Azure Portal

Nieuw account

Wanneer u een nieuw Azure Cosmos DB-account maakt vanuit de portal, kunt u de totale doorvoer van het account beperken:

Schermopname van de Azure Portal die laat zien hoe u de totale accountdoorvoer kunt beperken bij het maken van een nieuw account

Als u deze optie inschakelt, wordt de totale doorvoer van uw account beperkt tot 1000 RU/s voor een gratis laagaccount en 4000 RU/s voor een normaal, niet-gratis laagaccount. U kunt deze waarde wijzigen nadat uw account is gemaakt.

Bestaand account

Ga in de Azure Portal naar uw Azure Cosmos DB-account en selecteer Kostenbeheer in het menu aan de linkerkant.

Schermopname van de Azure Portal die laat zien hoe u de totale accountdoorvoer voor een bestaand account kunt bijwerken

In deze sectie ziet u een overzicht van de totale doorvoer die voor uw account is ingericht en kunt u de totale doorvoerlimiet configureren. De volgende drie opties zijn beschikbaar:

  • Beperk de totale ingerichte doorvoer van het account tot het bedrag dat is opgenomen in de korting voor de gratis laag. Deze optie is alleen beschikbaar voor accounts in de gratis laag en beperkt de totale doorvoer van uw account tot 1000 RU/s. Wanneer u deze optie inschakelt, zorgt u ervoor dat er geen kosten in rekening worden gebracht voor ingerichte doorvoer.
  • Toestaan dat de totale doorvoer van het account wordt ingericht tot een aangepast bedrag. Met deze optie kunt u de totale ingerichte doorvoer invoeren die u niet wilt overschrijden. Een maandelijkse kostenraming die overeenkomt met uw invoer wordt weergegeven als referentie.

    Notitie

    Deze aangepaste limiet mag niet lager zijn dan de totale doorvoer die momenteel in het account is ingericht.

  • Geen limiet, de totale doorvoer van het account kan worden ingericht voor een willekeurige hoeveelheid. Met deze optie wordt de limiet uitgeschakeld.

Programmatisch de totale doorvoerlimiet instellen

Azure Resource Manager-sjablonen gebruiken

Wanneer u uw Azure Cosmos DB-account maakt of bijwerkt met Azure Resource Manager, kunt u de totale doorvoerlimiet configureren door de eigenschap in te properties.capacity.totalThroughputLimit stellen:

{
  "location": "West US",
  "kind": "DocumentDB",
  "properties": {
    "locations": [
      {
        "locationName": "West US",
        "failoverPriority": 0,
        "isZoneRedundant": false
      }
    ],
    "databaseAccountOfferType": "Standard",
    "capacity": {
        "totalThroughputLimit": 2000
    }
  }
}

Stel deze eigenschap in op om -1 de limiet uit te schakelen.

Veelgestelde vragen

Zijn er situaties waarin de totale ingerichte doorvoer de limiet kan overschrijden?

Azure Cosmos DB dwingt een minimale doorvoer af van 1 RU/s per GB aan opgeslagen gegevens. Als u gegevens opneemt terwijl u al op dat minimum bent, wordt de doorvoer die voor uw resources is ingericht, automatisch verhoogd tot 1 RU/s per GB. In dit geval, en alleen in dit geval, kan de totale ingerichte doorvoer de limiet overschrijden die u hebt ingesteld.

Volgende stappen