Quote del servizio Azure Cosmos DBAzure Cosmos DB service quotas

Questo articolo fornisce una panoramica delle quote predefinite offerte a risorse diverse nella Azure Cosmos DB.This article provides an overview of the default quotas offered to different resources in the Azure Cosmos DB.

Archiviazione e velocità effettivaStorage and throughput

Dopo aver creato un account Azure Cosmos nella sottoscrizione, è possibile gestire i dati nell'account creando database, contenitori ed elementi.After you create an Azure Cosmos account under your subscription, you can manage data in your account by creating databases, containers, and items. È possibile effettuare il provisioning della velocità effettiva a livello di contenitore o di database in termini di unità richiesta (UR/s o UR).You can provision throughput at a container-level or a database-level in terms of request units (RU/s or RUs). La tabella seguente elenca i limiti per l'archiviazione e la velocità effettiva per contenitore/database.The following table lists the limits for storage and throughput per container/database.

GruppiResource Limite predefinitoDefault limit
Numero massimo di ur per contenitore (modalità di provisioning della velocità effettiva dedicata)Maximum RUs per container (dedicated throughput provisioned mode) 1 milione per impostazione predefinita.1,000,000 by default. È possibile aumentarlo inserendo un ticket di supporto di AzureYou can increase it by filing an Azure support ticket
Numero massimo di ur per database (modalità con provisioning della velocità effettiva condivisa)Maximum RUs per database (shared throughput provisioned mode) 1 milione per impostazione predefinita.1,000,000 by default. È possibile aumentarlo inserendo un ticket di supporto di AzureYou can increase it by filing an Azure support ticket
Numero massimo di ur per chiave di partizione (logica)Maximum RUs per (logical) partition key 10,00010,000
Archiviazione massima tra tutti gli elementi per ogni chiave di partizione (logica)Maximum storage across all items per (logical) partition key 10 GB10 GB
Numero massimo di chiavi di partizione (logiche) distinteMaximum number of distinct (logical) partition keys IllimitatoUnlimited
Spazio di archiviazione massimo per contenitoreMaximum storage per container IllimitatoUnlimited
Spazio di archiviazione massimo per databaseMaximum storage per database IllimitatoUnlimited
Dimensioni massime degli allegati per ogni account (la funzionalità degli allegati verrà ammortizzata)Maximum attachment size per Account (Attachment feature is being depreciated) 2 GB2 GB

Nota

Per informazioni sulle procedure consigliate per la gestione dei carichi di lavoro con chiavi di partizione che richiedono limiti più elevati per l'archiviazione o la velocità effettiva, vedere creare una chiave di partizione sintetica.To learn about best practices for managing workloads that have partition keys requiring higher limits for storage or throughput, see Create a synthetic partition key.

Un contenitore Cosmos (o un database con velocità effettiva condivisa) deve avere una velocità effettiva minima di 400 ur.A Cosmos container (or shared throughput database) must have a minimum throughput of 400 RUs. Man mano che aumenta il contenitore, la velocità effettiva minima supportata dipende anche dai fattori seguenti:As the container grows, the minimum supported throughput also depends on the following factors:

  • La velocità effettiva minima che è possibile impostare in un contenitore dipende dalla velocità effettiva massima di cui è stato effettuato il provisioning nel contenitore.The minimum throughput that you can set on a container depends on the maximum throughput ever provisioned on the container. Se ad esempio la velocità effettiva è aumentata a 10000 ur, la velocità effettiva con provisioning più bassa possibile sarà 1000 urFor example, if your throughput was increased to 10000 RUs, then the lowest possible provisioned throughput would be 1000 RUs
  • La velocità effettiva minima in un database di velocità effettiva condivisa dipende anche dal numero totale di contenitori creati in un database di velocità effettiva condivisa, misurato a 100 ur per ogni contenitore.The minimum throughput on a shared throughput database also depends on the total number of containers that you have ever created in a shared throughput database, measured at 100 RUs per container. Se, ad esempio, sono stati creati cinque contenitori all'interno di un database di velocità effettiva condivisa, la velocità effettiva deve essere almeno di 500 URFor example, if you have created five containers within a shared throughput database, then the throughput must be at least 500 RUs

La velocità effettiva corrente e minima di un contenitore o di un database può essere recuperata dal portale di Azure o dagli SDK.The current and minimum throughput of a container or a database can be retrieved from the Azure portal or the SDKs. Per altre informazioni, vedere provisioning della velocità effettiva nei contenitori e nei database.For more information, see Provision throughput on containers and databases.

Nota

In alcuni casi, potrebbe essere possibile ridurre la velocità effettiva a un valore inferiore al 10%.In some cases, you may be able to lower throughput to lesser than 10%. Usare l'API per ottenere le UR minime esatte per ogni contenitore.Use the API to get the exact minimum RUs per container.

In breve, di seguito sono riportati i limiti minimi di provisioning delle UR.In summary, here are the minimum provisioned RU limits.

GruppiResource Limite predefinitoDefault limit
Numero minimo di ur per contenitore (modalità di provisioning della velocità effettiva dedicata)Minimum RUs per container (dedicated throughput provisioned mode) 400400
Numero minimo di ur per database (modalità con provisioning della velocità effettiva condivisa)Minimum RUs per database (shared throughput provisioned mode) 400400
Unità richiesta minime per contenitore all'interno di un database di velocità effettiva condivisaMinimum RUs per container within a shared throughput database 100100

Cosmos DB supporta il ridimensionamento elastico della velocità effettiva (UR) per ogni contenitore o database tramite gli SDK o il portale.Cosmos DB supports elastic scaling of throughput (RUs) per container or database via the SDKs or portal. Ogni contenitore può essere ridimensionato in modo sincrono e immediatamente entro un intervallo di scala compreso tra 10 e 100 volte, tra i valori minimo e massimo.Each container can scale synchronously and immediately within a scale range of 10 to 100 times, between minimum and maximum values. Se il valore della velocità effettiva richiesta non rientra nell'intervallo, il ridimensionamento viene eseguito in modo asincrono.If the requested throughput value is outside the range, scaling is performed asynchronously. Il completamento del ridimensionamento asincrono può richiedere minuti o ore, a seconda della velocità effettiva richiesta e delle dimensioni di archiviazione dei dati nel contenitore.Asynchronous scaling may take minutes to hours to complete depending on the requested throughput and data storage size in the container.

Operazioni del piano di controlloControl plane operations

È possibile eseguire il provisioning e gestire l'account Azure Cosmos usando i modelli di portale di Azure, Azure PowerShell, interfaccia della riga di comando di azure e Azure Resource Manager.You can provision and manage your Azure Cosmos account using the Azure portal, Azure PowerShell, Azure CLI, and Azure Resource Manager templates. La tabella seguente elenca i limiti per sottoscrizione, account e numero di operazioni.The following table lists the limits per subscription, account, and number of operations.

GruppiResource Limite predefinitoDefault limit
Numero massimo di account di database per sottoscrizioneMaximum database accounts per subscription 50 per impostazione predefinita.50 by default. È possibile aumentarlo inserendo un ticket di supporto di AzureYou can increase it by filing an Azure support ticket
Numero massimo di failover a livello di areaMaximum number of regional failovers 1/ora per impostazione predefinita.1/hour by default. È possibile aumentarlo inserendo un ticket di supporto di AzureYou can increase it by filing an Azure support ticket

Nota

I failover a livello di area sono validi solo per le Scritture a area singola.Regional failovers only apply to single region writes accounts. Gli account di scrittura in più aree non richiedono o non hanno limiti per la modifica dell'area di scrittura.Multi-region write accounts do not require or have any limits on changing the write region.

Cosmos DB esegue automaticamente il backup dei dati a intervalli regolari.Cosmos DB automatically takes backups of your data at regular intervals. Per informazioni dettagliate sugli intervalli di conservazione del backup e su Windows, vedere backup online e ripristino dei dati su richiesta in Azure Cosmos DB.For details on backup retention intervals and windows, see Online backup and on-demand data restore in Azure Cosmos DB.

Limiti per accountPer-account limits

GruppiResource Limite predefinitoDefault limit
Numero massimo di databaseMaximum number of databases IllimitatoUnlimited
Numero massimo di contenitori per database (o account)Maximum number of containers per database (or account) IllimitatoUnlimited
Numero massimo di areeMaximum number of regions Nessun limite (tutte le aree di Azure)No limit (All Azure regions)

Limiti per contenitorePer-container limits

A seconda dell'API usata, un contenitore di Azure Cosmos può rappresentare una raccolta, una tabella o un grafo.Depending on which API you use, an Azure Cosmos container can represent either a collection, a table, or graph. I contenitori supportano le configurazioni per vincoli di chiave univoca, stored procedure, trigger e funzioni definite dall'utentee criteri di indicizzazione.Containers support configurations for unique key constraints, stored procedures, triggers, and UDFs, and indexing policy. La tabella seguente elenca i limiti specifici delle configurazioni all'interno di un contenitore.The following table lists the limits specific to configurations within a container.

GruppiResource Limite predefinitoDefault limit
Lunghezza massima del nome del database o del contenitoreMaximum length of database or container name 255255
Numero massimo di stored procedure per contenitoreMaximum stored procedures per container 100 *100 *
Numero massimo di UDF per contenitoreMaximum UDFs per container 25 *25 *
Numero massimo di percorsi nei criteri di indicizzazioneMaximum number of paths in indexing policy 100 *100 *
Numero massimo di chiavi univoche per ogni contenitoreMaximum number of unique keys per container 10 *10 *
Numero massimo di percorsi per vincolo di chiave univocaMaximum number of paths per unique key constraint 16 *16 *

* È possibile aumentare i limiti per ogni contenitore contattando il supporto tecnico di Azure.* You can increase any of these per-container limits by contacting Azure Support.

Limiti per singolo elementoPer-item limits

A seconda dell'API usata, un elemento di Azure Cosmos può rappresentare un documento in una raccolta, una riga in una tabella o un nodo o un bordo in un grafico.Depending on which API you use, an Azure Cosmos item can represent either a document in a collection, a row in a table, or a node or edge in a graph. La tabella seguente mostra i limiti per ogni elemento in Cosmos DB.The following table shows the limits per item in Cosmos DB.

GruppiResource Limite predefinitoDefault limit
Dimensioni massime di un elementoMaximum size of an item 2 MB (lunghezza UTF-8 della rappresentazione JSON)2 MB (UTF-8 length of JSON representation)
Lunghezza massima del valore della chiave di partizioneMaximum length of partition key value 2048 byte2048 bytes
Lunghezza massima del valore IDMaximum length of id value 1024 byte1024 bytes
Numero massimo di proprietà per elementoMaximum number of properties per item Nessun limite praticoNo practical limit
Profondità massima di annidamentoMaximum nesting depth Nessun limite praticoNo practical limit
Lunghezza massima del nome della proprietàMaximum length of property name Nessun limite praticoNo practical limit
Lunghezza massima del valore della proprietàMaximum length of property value Nessun limite praticoNo practical limit
Lunghezza massima del valore della proprietà stringaMaximum length of string property value Nessun limite praticoNo practical limit
Lunghezza massima del valore della proprietà numericaMaximum length of numeric property value IEEE754 a precisione doppia 64 bitIEEE754 double-precision 64-bit

Non sono previste restrizioni per i payload dell'elemento come il numero di proprietà e la profondità di nidificazione, ad eccezione delle limitazioni di lunghezza per la chiave di partizione e i valori ID e la restrizione di dimensione complessiva di 2 MB.There are no restrictions on the item payloads like number of properties and nesting depth, except for the length restrictions on partition key and id values, and the overall size restriction of 2 MB. Potrebbe essere necessario configurare i criteri di indicizzazione per i contenitori con strutture di elementi grandi o complesse per ridurre il consumo di ur.You may have to configure indexing policy for containers with large or complex item structures to reduce RU consumption. Vedere modellazione di elementi in Cosmos DB per un esempio reale e modelli per gestire elementi di grandi dimensioni.See Modeling items in Cosmos DB for a real-world example, and patterns to manage large items.

Limiti per richiestaPer-request limits

Cosmos DB supporta operazioni CRUD e di query su risorse quali contenitori, elementi e database.Cosmos DB supports CRUD and query operations against resources like containers, items, and databases.

GruppiResource Limite predefinitoDefault limit
Tempo massimo di esecuzione per una singola operazione (ad esempio, un'esecuzione stored procedure o un singolo recupero della pagina di query)Maximum execution time for a single operation (like a stored procedure execution or a single query page retrieval) 5 secondi5 sec
Dimensioni massime richiesta (stored procedure, CRUD)Maximum request size (stored procedure, CRUD) 2 MB2 MB
Dimensione massima della risposta (ad esempio, query impaginata)Maximum response size (for example, paginated query) 4 MB4 MB

Una volta che un'operazione come query raggiunge il limite di timeout di esecuzione o la dimensione della risposta, restituisce una pagina di risultati e un token di continuazione al client per riprendere l'esecuzione.Once an operation like query reaches the execution timeout or response size limit, it returns a page of results and a continuation token to the client to resume execution. Non esiste un limite pratico per la durata di esecuzione di una singola query tra pagine/continuazioni.There is no practical limit on the duration a single query can run across pages/continuations.

Cosmos DB USA HMAC per l'autorizzazione.Cosmos DB uses HMAC for authorization. È possibile usare una chiave master o un token di risorsa per il controllo di accesso con granularità fine a risorse quali contenitori, chiavi di partizione o elementi.You can use either a master key, or a resource tokens for fine-grained access control to resources like containers, partition keys, or items. Nella tabella seguente sono elencati i limiti per i token di autorizzazione in Cosmos DB.The following table lists limits for authorization tokens in Cosmos DB.

GruppiResource Limite predefinitoDefault limit
Ora di scadenza massima del token masterMaximum master token expiry time 15 min15 min
Tempo di scadenza del token di risorsa minimoMinimum resource token expiry time 10 minuti10 min
Tempo di scadenza massimo del token di risorsaMaximum resource token expiry time 24 ore per impostazione predefinita.24 h by default. È possibile aumentarlo inserendo un ticket di supporto di AzureYou can increase it by filing an Azure support ticket
Sfasamento di clock massimo per l'autorizzazione del tokenMaximum clock skew for token authorization 15 min15 min

Cosmos DB supporta l'esecuzione di trigger durante le Scritture.Cosmos DB supports execution of triggers during writes. Il servizio supporta un massimo di un pre-trigger e un post-trigger per operazione di scrittura.The service supports a maximum of one pre-trigger and one post-trigger per write operation.

Limiti per le query SQLSQL query limits

Cosmos DB supporta l'esecuzione di query su elementi con SQL.Cosmos DB supports querying items using SQL. Nella tabella seguente vengono descritte le restrizioni nelle istruzioni di query, ad esempio in termini di numero di clausole o di lunghezza della query.The following table describes restrictions in query statements, for example in terms of number of clauses or query length.

GruppiResource Limite predefinitoDefault limit
Lunghezza massima della query SQLMaximum length of SQL query 256 KB *256 KB *
Numero massimo di JOIN per queryMaximum JOINs per query 5 *5 *
Numero massimo di i/o per queryMaximum ANDs per query 2000 *2000 *
Numero massimo di ORs per queryMaximum ORs per query 2000 *2000 *
Numero massimo di UDF per queryMaximum UDFs per query 10 *10 *
Numero massimo di argomenti per espressioneMaximum arguments per IN expression 6000 *6000 *
Punti massimi per poligonoMaximum points per polygon 4096 *4096 *

* È possibile aumentare i limiti di query SQL contattando il supporto tecnico di Azure.* You can increase any of these SQL query limits by contacting Azure Support.

Limiti specifici dell'API MongoDBMongoDB API-specific limits

Cosmos DB supporta il protocollo wire di MongoDB per le applicazioni scritte in MongoDB.Cosmos DB supports the MongoDB wire protocol for applications written against MongoDB. È possibile trovare i comandi e le versioni del protocollo supportati in funzionalità e sintassi di MongoDB supportate.You can find the supported commands and protocol versions at Supported MongoDB features and syntax.

La tabella seguente elenca i limiti specifici del supporto della funzionalità MongoDB.The following table lists the limits specific to MongoDB feature support. Altri limiti di servizio indicati per l'API SQL (Core) si applicano anche all'API MongoDB.Other service limits mentioned for the SQL (core) API also apply to the MongoDB API.

GruppiResource Limite predefinitoDefault limit
Dimensioni massime memoria query MongoDBMaximum MongoDB query memory size 40 MB40 MB
Tempo massimo di esecuzione per le operazioni MongoDBMaximum execution time for MongoDB operations 30 secondi30s

Prova Cosmos DB limiti gratuitiTry Cosmos DB Free limits

La tabella seguente elenca i limiti per la versione di valutazione gratuita di Try Azure Cosmos DB .The following table lists the limits for the Try Azure Cosmos DB for Free trial.

GruppiResource Limite predefinitoDefault limit
Durata della versione di valutazioneDuration of the trial 30 giorni (è possibile rinnovare un numero qualsiasi di volte)30 days (can be renewed any number of times)
Numero massimo di contenitori per sottoscrizione (SQL, Gremlin, API Tabella)Maximum containers per subscription (SQL, Gremlin, Table API) 11
Numero massimo di contenitori per sottoscrizione (API MongoDB)Maximum containers per subscription (MongoDB API) 33
Velocità effettiva massima per contenitoreMaximum throughput per container 50005000
Velocità effettiva massima per database con velocità effettiva condivisaMaximum throughput per shared-throughput database 2000020000
Spazio di archiviazione totale massimo per accountMaximum total storage per account 10 GB10 GB

Prova Cosmos DB supporta la distribuzione globale solo nelle aree Stati Uniti centrali, Europa settentrionale e Asia sudorientale.Try Cosmos DB supports global distribution in only the Central US, North Europe, and Southeast Asia regions. Non è possibile creare ticket di supporto di Azure per gli account di prova Azure Cosmos DB.Azure support tickets can't be created for Try Azure Cosmos DB accounts. Tuttavia, viene fornito il supporto per i sottoscrittori con piani di supporto esistenti.However, support is provided for subscribers with existing support plans.

Passaggi successiviNext steps

Scopri di più sui concetti di base di Cosmos DB la distribuzione globale e il partizionamento e la velocità effettiva con provisioning.Read more about Cosmos DB's core concepts global distribution and partitioning and provisioned throughput.

Per un'introduzione ad Azure Cosmos DB, fare riferimento alle guide introduttive seguenti:Get started with Azure Cosmos DB with one of our quickstarts: