Quota en standaardlimieten voor Azure Cosmos DB-services

In dit artikel worden de standaardquota en limieten voor Azure Cosmos DB-resources uitgelegd. Hiermee kunt u bewerkingen, opslag en doorvoer effectief beheren.

Opslag- en databasebewerkingen

Nadat u een Azure Cosmos DB-account hebt gemaakt onder uw abonnement, kunt u gegevens in uw account beheren door databases, containers en items te maken.

Ingerichte doorvoer

U wijst doorvoer toe op containerniveau of op databaseniveau in termen van aanvraageenheden (RU's) of aanvraageenheden per seconde (RU/s). De volgende tabel bevat de limieten voor opslag en doorvoer per container/database. Opslag verwijst naar de gecombineerde hoeveelheid gegevens en indexopslag.

¹ Verhoog het maximum aantal RU's per container of database door een Azure-ondersteuningsticket in te dienen.

² Zie Een synthetische partitiesleutel maken voor meer informatie over aanbevolen procedures voor het beheren van workloads met partitiesleutels waarvoor hogere limieten voor opslag of doorvoer zijn vereist. Als uw workload de logische partitielimiet van 20 GB in productie bereikt, wordt het opnieuw ontwerpen van uw toepassing met een andere partitiesleutel aanbevolen als een langetermijnoplossing. Als u tijd wilt geven om uw toepassing opnieuw te ontwerpen, vraagt u een tijdelijke verhoging aan van de limiet voor de logische partitiesleutel voor uw bestaande toepassing. Dien een ondersteuning voor Azure ticket in en selecteer tijdelijke verhoging van het quotumtype van de logische partitiesleutelgrootte van de container. Het aanvragen van een tijdelijke verhoging is bedoeld als een tijdelijke oplossing en wordt niet aanbevolen als een oplossing voor de lange termijn, omdat SLA-garanties niet worden uitgevoerd wanneer de limiet wordt verhoogd. Als u de configuratie wilt verwijderen, moet u een ondersteuningsticket indienen en een quotumtype selecteren De grootte van de logische partitiesleutel van de container herstellen naar de standaardgrootte (20 GB) . U kunt dit ondersteuningsticket indienen nadat u gegevens hebt verwijderd om aan de limiet voor logische partities van 20 GB te voldoen of uw toepassing opnieuw te ontwerpen met een andere partitiesleutel.

Minimale doorvoerlimieten

Een Azure Cosmos DB-container (of gedeelde doorvoerdatabase) met behulp van handmatige doorvoer moet een minimale doorvoer van 400 RU/s hebben. Naarmate de container groeit, vereist Azure Cosmos DB een minimale doorvoer om ervoor te zorgen dat de resource (database of container) voldoende resource heeft voor de bewerkingen.

Haal de huidige en minimale doorvoer van een container of database op uit de Azure-portal of de SDK's (Software Development Kits). Zie Doorvoer toewijzen voor containers en databases voor meer informatie.

De werkelijke minimale RU/s kunnen variëren, afhankelijk van uw accountconfiguratie. U kunt metrische gegevens van Azure Monitor gebruiken om de geschiedenis van ingerichte doorvoer (RU/s) en opslag op een resource weer te geven.

Minimale doorvoer voor container

Maak een schatting van de minimale doorvoer voor een container met behulp van deze sectie.

Handmatige doorvoer

Als u een schatting wilt maken van de minimale RU/s die vereist zijn voor een container met handmatige doorvoer, zoekt u het maximum van:

• 400 RU/s
• Huidige opslag in GB * 1 RU's
• Hoogste RU/s ooit ingericht voor de container / 100

Een container is bijvoorbeeld ingericht met 400 RU/s en 0 GB-opslag. U verhoogt de doorvoer naar 50.000 RU/s en importeert 20 GB aan gegevens. De minimale RU/s is nu MAX(400, 20 * 1 RU/s per GB, 50,000 RU/s / 100) = 500 RU/s. Na verloop van tijd groeit de opslag tot 2000 GB. De minimale RU/s is nu MAX(400, 2000 * 1 RU/s per GB, 50,000 / 100) = 2000 RU/s.

Doorvoer automatisch schalen

Als u een schatting wilt maken van de minimale maximale RU/s voor automatische schaalaanpassing van een container met doorvoer voor automatische schaalaanpassing, zoekt u het maximum van:

• 1000 RU/s
• Huidige opslag in GB * 10 RU's
• Hoogste RU/s ooit ingericht voor de container/10

U hebt bijvoorbeeld een container ingericht met 1000 RU/s en 0 GB-opslag. U verhoogt de doorvoer naar 50.000 RU/s en importeert 20 GB aan gegevens. Het minimum aantal RU/s is nu MAX(1000, 20 * 10 RU/s per GB, 50,000 RU/s / 10) = 5000 RU/s. Na verloop van tijd groeit de opslag tot 2000 GB. Het minimum aantal RU/s is nu MAX(1000, 2000 * 10 RU/s per GB, 50,000 / 10) = 20.000 RU/s.

Minimale doorvoer voor gedeelde doorvoerdatabase

Gebruik deze sectie om een schatting te maken van de minimale doorvoer voor een database die doorvoer deelt tussen containers.

Handmatige doorvoer

Als u de minimale RU/s wilt schatten die vereist zijn voor een gedeelde doorvoerdatabase met handmatige doorvoer, zoekt u het maximum van:

• 400 RU/s
• Huidige opslag in GB * 1 RU's
• Hoogste RU/s ooit ingericht voor de database / 100
• 400 + MAX(Aantal containers - 25, 0) * 100 RU/s

U hebt bijvoorbeeld een database ingericht met 400 RU/s, 15 GB opslagruimte en 10 containers. De minimale RU/s is MAX(400, 15 * 1 RU/s per GB, 400 / 100, 400 + 0 ) = 400 RU/s. Als de database 30 containers bevat, is 400 + MAX(30 - 25, 0) * 100 RU/s de minimale RU/s = 900 RU/s.

Doorvoer automatisch schalen

Als u een schatting wilt maken van de minimale maximale RU/s voor automatische schaalaanpassing van een gedeelde doorvoerdatabase met automatische schaalaanpassing, zoekt u het maximum van:

• 1000 RU/s
• Huidige opslag in GB * 10 RU's
• Hoogste RU/s ooit ingericht voor de database/10
• 1000 + MAX(Aantal containers - 25, 0) * 1000 RU/s

U hebt bijvoorbeeld een database ingericht met 1000 RU/s, 15 GB opslagruimte en 10 containers. Het minimale maximum aantal RU/s voor de database voor automatisch schalen is MAX(1000, 15 * 10 RU/s per GB, 1000 / 10, 1000 + 0 ) = 1000 RU/s. Als er 30 containers in de database zijn, is 1000 + MAX(30 - 25, 0) * 1000 RU/s het minimum aantal RU/s = 5000 RU/s.

Kortom, hier volgen de minimaal ingerichte RU-limieten bij het gebruik van ingerichte doorvoer.

Azure Cosmos DB biedt ondersteuning voor programmatisch schalen van doorvoer (RU/s) per container of database via de SDK's of portal.

Elke resource wordt synchroon en onmiddellijk geschaald tussen de minimale RU/s en maximaal 100x de minimale RU/s, afhankelijk van de huidige ingerichte RU/s en resource-instellingen. Als de aangevraagde doorvoerwaarde buiten het bereik valt, wordt schaalaanpassing asynchroon uitgevoerd. Asynchrone schaalaanpassing kan enkele minuten tot uren duren, afhankelijk van de aangevraagde doorvoer en de grootte van de gegevensopslag in de container. Meer informatie.

Serverloos

Met serverloos kunt u uw Azure Cosmos DB-resources op basis van verbruik gebruiken. De volgende tabel bevat de limieten voor opslag en doorvoer met burstmogelijkheden per container/database. Deze limieten kunnen niet worden verhoogd. Wijs extra serverloze accounts toe voor meer opslagbehoeften.

*Maximale beschikbaarheid van RU/sec is afhankelijk van gegevens die zijn opgeslagen in de container. Zie serverloze prestaties

Besturingsvlak

Azure Cosmos DB heeft een resourceprovider waarmee u resources in uw Azure Cosmos DB-account kunt maken, bijwerken en verwijderen. De resourceproviderinterfaces met de algehele Azure Resource Management-laag, de implementatie- en beheerservice voor Azure.

Azure Cosmos DB-resources maken en beheren met behulp van:

• Azure Portal
• Azure PowerShell
• Azure-opdrachtregelinterface (CLI)
• JSON-/Bicep-sjablonen voor Azure Resource Manager
• Azure REST-API
• Azure Management SDK's
• Terraform
• Pulumi

Deze beheerlaag kan ook worden geopend vanuit de Azure Cosmos DB-gegevensvlak-SDK's die in uw toepassingen worden gebruikt om resources binnen een account te maken en te beheren. Sdk's voor gegevensvlakken maken ook controlevlakaanvragen tijdens de eerste verbinding met de service om zaken te doen, zoals het inventariseren van databases en containers en het aanvragen van accountsleutels voor verificatie.

Elk Azure Cosmos DB-account heeft een primaire partitie die alle metagegevens voor het account bevat. Het heeft ook een kleine hoeveelheid doorvoer ter ondersteuning van besturingsvlakbewerkingen. Aanvragen van besturingsvlak die deze metagegevens maken, lezen, bijwerken of verwijderen, verbruiken deze doorvoer. Wanneer de hoeveelheid doorvoer die wordt verbruikt door besturingsvlakbewerkingen deze hoeveelheid overschrijdt, zijn bewerkingen beperkt, hetzelfde als bewerkingen in het gegevensvlak in Azure Cosmos DB. In tegenstelling tot doorvoer voor gegevensbewerkingen kan de doorvoer voor de primaire partitie echter niet worden verhoogd.

Sommige besturingsvlakbewerkingen verbruiken geen primaire partitiedoorvoer, zoals Ophalen of Lijstsleutels. In tegenstelling tot aanvragen voor gegevens binnen uw Azure Cosmos DB-account, zijn resourceproviders binnen Azure niet ontworpen voor grote aanvraagvolumes. Besturingsvlakbewerkingen die de gedocumenteerde limieten overschrijden op aanhoudende niveaus gedurende opeenvolgende perioden van vijf minuten, kunnen aanvragen beperken en mislukte of onvolledige bewerkingen op Azure Cosmos DB-resources ondervinden.

Besturingsvlakbewerkingen kunnen worden bewaakt door het tabblad Inzichten voor een Azure Cosmos DB-account te navigeren. Zie Controlevlakaanvragen controleren voor meer informatie. U kunt deze inzichten aanpassen, Azure Monitor gebruiken en een werkmap maken om metagegevensaanvragen te bewaken en waarschuwingen in te stellen.

Bronlimieten

De volgende tabel bevat resourcelimieten per abonnement of account.

¹ Standaardlimieten verschillen voor interne Klanten van Microsoft. Verhoog deze limieten door een Azure-ondersteuningsaanvraag te maken tot maximaal 1000. Cosmos DB behoudt zich het recht voor om lege databaseaccounts te verwijderen, dat wil gezegd, geen databases/verzamelingen. ² Deze limiet kan niet worden verhoogd. Het totale aantal omvat zowel databases als containers binnen een account (bijvoorbeeld 1 database en 499 containers, of 250 databases en 250 containers).

Aanvraaglimieten

De volgende tabel bevat aanvraaglimieten per interval van 5 minuten, per account, tenzij anders is opgegeven.

¹ Gebruik een singleton-client voor SDK-exemplaren en cachesleutels, database- en containerverwijzingen tussen aanvragen voor de levensduur van dat exemplaar. Regionale failovers van ² zijn alleen van toepassing op schrijfaccounts voor één regio. Schrijfaccounts voor meerdere regio's vereisen of staan het wijzigen van de schrijfregio niet toe.

Azure Cosmos DB maakt automatisch een back-up van uw gegevens met regelmatige tussenpozen. Zie Online back-up en on-demand gegevensherstel in Azure Cosmos DB voor meer informatie over back-upretentieintervallen en vensters.

limieten per account

Dit zijn de limieten per account.

Ingerichte doorvoer

Serverloos

Limieten per container

Afhankelijk van de API die u gebruikt, kan een Azure Cosmos DB-container een verzameling, een tabel of een grafiek vertegenwoordigen. Containers ondersteunen configuraties voor unieke sleutelbeperkingen, opgeslagen procedures, triggers en door de gebruiker gedefinieerde functies (UDF's) en indexeringsbeleid. De volgende tabel bevat de limieten die specifiek zijn voor configuraties binnen een container.

¹ Verhoog elk van deze limieten per container door een Azure-ondersteuningsaanvraag te maken.

Limieten per item

Een Azure Cosmos DB-item kan een document in een verzameling, een rij in een tabel of een knooppunt of rand in een grafiek vertegenwoordigen, afhankelijk van de API die u gebruikt. In de volgende tabel ziet u de limieten per item in Azure Cosmos DB.

¹ Grote documentgrootten tot 16 MB worden alleen ondersteund met Azure Cosmos DB voor MongoDB. Zie de documentatie voor MongoDB 4.2-functies voor meer informatie.

Er zijn geen beperkingen voor de nettoladingen van items (zoals het aantal eigenschappen en de diepte van nesten), met uitzondering van de lengtebeperkingen voor partitiesleutels en id-waarden, en de algehele groottebeperking van 2 MB. Mogelijk moet u het indexeringsbeleid configureren voor containers met grote of complexe itemstructuren om het RU-verbruik te verminderen. Zie Modelleringsitems in Azure Cosmos DB voor een praktijkvoorbeeld en patronen voor het beheren van grote items.

Limieten per aanvraag

Azure Cosmos DB biedt ondersteuning voor CRUD- en querybewerkingen voor resources zoals containers, items en databases. Het ondersteunt ook transactionele batchaanvragen voor items met dezelfde partitiesleutel in een container.

Azure Cosmos DB ondersteunt triggers tijdens schrijfbewerkingen. De service staat één pretrigger en één posttrigger per schrijfbewerking toe.

Wanneer een querybewerking de uitvoeringstime-out of antwoordgroottelimiet bereikt, retourneert deze een pagina met resultaten en een vervolgtoken aan de client om de uitvoering te hervatten. Er is geen praktische limiet voor de duur die één query kan uitvoeren op pagina's/vervolgen.

Azure Cosmos DB maakt gebruik van hashgebaseerde berichtverificatiecodes (HMAC) voor autorisatie. Gebruik een primaire sleutel voor gedetailleerd toegangsbeheer voor resources. Deze resources kunnen containers, partitiesleutels of items bevatten. De volgende tabel bevat limieten voor autorisatietokens in Azure Cosmos DB.

¹ Verhoog het door een Azure-ondersteuningsticket in te dienen.

Beperkingen van de automatische schaalaanpassing van ingerichte doorvoer

Zie het artikel over automatische schaalaanpassing en veelgestelde vragen voor een gedetailleerde uitleg van doorvoer- en opslaglimieten met automatische schaalaanpassing.

SQL-querylimieten

Azure Cosmos DB biedt ondersteuning voor het uitvoeren van query's op items met behulp van SQL. In de volgende tabel worden beperkingen in queryinstructies beschreven, zoals het aantal componenten of de lengte van de query.

¹ U kunt deze SQL-querylimieten verhogen door een Azure-ondersteuningsaanvraag te maken.

API voor MongoDB-specifieke limieten

Azure Cosmos DB ondersteunt het MongoDB-wire-protocol voor toepassingen die zijn geschreven met MongoDB. Zoek de ondersteunde opdrachten en protocolversies op ondersteunde MongoDB-functies en -syntaxis.

De volgende tabel bevat de limieten die specifiek zijn voor ondersteuning van MongoDB-functies. Andere servicelimieten die voor de API voor NoSQL worden vermeld, zijn ook van toepassing op de API voor MongoDB.

¹ Voor grote documentgrootten tot 16 MB is het inschakelen van functies in Azure Portal vereist. Meer informatie vindt u in de functiedocumentatie.

² Stel de time-out voor inactiviteit in de stuurprogramma-instellingen in op 2-3 minuten, omdat de standaardtime-out voor Azure LoadBalancer 4 minuten is. Deze time-out zorgt ervoor dat een tussenliggende load balancer-inactiviteit geen verbindingen tussen de clientcomputer en Azure Cosmos DB sluit.

Accountlimieten voor gratis laag van Azure Cosmos DB

De volgende tabel bevat de limieten voor gratis Azure Cosmos DB-accounts.

Naast de vorige tabel zijn de limieten per account ook van toepassing op accounts in de gratis laag. Zie voor meer informatie hoe u een gratis account maakt.

Gerelateerde inhoud

• Wereldwijde distributie
• Partitionering en ingerichte doorvoer