Condividi tramite


Informazioni di riferimento sui limiti e sulle quote del servizio Azure DocumentDB

Questo documento descrive i limiti rigidi e flessibili correnti per i cluster e le operazioni di Azure DocumentDB. Informazioni sui limiti di esecuzione delle query, sui vincoli di indicizzazione, sulle configurazioni del cluster e sui limiti di autenticazione che consentono di pianificare e ottimizzare efficacemente le distribuzioni di Azure DocumentDB.

Limitazioni di esecuzione e query

I limiti seguenti si applicano alle operazioni di query e all'esecuzione dei comandi nei cluster Azure DocumentDB.

Limitazioni di esecuzione di MongoDB

  • Durata massima delle transazioni: 30 secondi.

  • Durata del cursore: 10 minuti. Nota: potrebbe verificarsi un errore cursorNotFound se il cursore supera la durata assegnata.

  • Limite di esecuzione query predefinito: 120 secondi. Questo limite può essere superato per ogni query usando maxTimeMS nel rispettivo driver MongoDB.

Example

db.collection.find({ field: "value" }).maxTimeMS(5000)

Dimensioni massime delle query MongoDB

  • La dimensione massima della memoria per le query MongoDB dipende dal livello. Ad esempio, per M80, il limite di dimensioni della memoria delle query è di circa 150 MiB.

  • Nei cluster partizionati, se una query esegue il pull dei dati tra i nodi, il limite per tali dimensioni è di 1 GB.

Limitazioni di indicizzazione

Azure DocumentDB applica vari limiti di indicizzazione per garantire prestazioni ottimali e utilizzo delle risorse in diversi tipi di indice e operazioni.

Limitazioni generali per l'indicizzazione

  • Numero massimo di campi di indice composti: 32.

  • Dimensione massima per valore del campo _id: 2 KB.

  • Dimensioni massime per il percorso dell'indice: 256B.

  • Massimo predefinito: 64.

    • Configurabile fino a: 300 indici per raccolta.
  • L'ordinamento viene eseguito in memoria e non esegue il push verso il basso nell'indice.

  • Livello massimo di annidamento per oggetti/matrici incorporati nelle definizioni di indice: 6.

  • Una singola compilazione dell'indice può essere in corso nella stessa raccolta.

  • Il numero di compilazioni simultanee di indici su raccolte diverse è configurabile (impostazione predefinita: 2).

  • Usare il comando currentOp per visualizzare lo stato di avanzamento delle compilazioni di indici con esecuzione prolungata.

  • Le compilazioni di indici univoci vengono eseguite in primo piano e le scritture in blocchi nella raccolta.

Limitazioni dell'indicizzazione con caratteri jolly

  • Per gli indici con caratteri jolly, se il campo indicizzato è una matrice di matrici, l'intera matrice incorporata viene considerata come valore anziché attraversarne il contenuto.

Limitazioni dell'indicizzazione geospaziale

  • Nessun supporto per BigPolygons.

  • Gli indici composti non supportano gli indici geospaziali.

  • La query $geoWithin non supporta i poligoni con fori.

  • Il campo key è obbligatorio nella fase di aggregazione $geoNear.

  • Gli indici sono consigliati ma non necessari per $near, gli operatori di query $nearSphere e la fase di aggregazione $geoNear.

Limitazioni dell'indice di testo

  • È possibile definire un solo indice di testo in una raccolta.

  • Supporta solo ricerche di testo semplici; le funzionalità di ricerca avanzate, ad esempio le ricerche di espressioni regolari, non sono supportate.

  • hint() non è supportato in combinazione con una query che usa l’espressione $text.

  • Le operazioni di riordinamento non possono usare l'ordine dell'indice di testo.

  • La tokenizzazione per cinese, giapponese, coreano non è supportata.

  • La tokenizzazione senza distinzione tra maiuscole e minuscole non è supportata.

Limitazioni della ricerca vettoriale

  • Indicizzazione di vettori con dimensioni fino a 2.000.

  • L'indicizzazione si applica a un solo vettore per percorso.

  • È possibile creare un solo indice per percorso vettoriale.

  • HNSW e DiskANN sono disponibili nei livelli di cluster M30 e superiori.

Limitazioni di cluster e partizioni

Azure DocumentDB impone limiti specifici per la configurazione del cluster, il partizionamento orizzontale fisico e la gestione delle raccolte per garantire prestazioni ottimali e allocazione delle risorse.

Livello cluster

  • Massimo: M200 / 64 vCore / 256-GiB RAM per partizione fisica.

Partizioni fisiche

  • Massimo: 10.

Limitazioni della raccolta

  • Raccolte per cluster: 1.000

  • Dimensioni della raccolta non partizionate: 32 TiB

Aree secondarie

  • Massimo: un'area di Azure secondaria.

Limitazioni del livello gratuito

È possibile ignorare le limitazioni seguenti passando a un livello a pagamento.

  • Spazio di archiviazione massimo: 32 GiB.

  • Backup/Ripristino non supportato (disponibile in M25+)

  • Disponibilità elevata non supportata (disponibile in M30+)

  • Indici vettoriali HNSW (Navigable Small World) gerarchici non supportati (disponibili in M40+)

  • Registrazione diagnostica non supportata (disponibile solo nei livelli a pagamento)

  • ID Microsoft Entra non supportato

  • Nessun contratto di servizio fornito (richiede l'abilitazione della disponibilità elevata)

  • I cluster di livello gratuito vengono messi in pausa dopo 60 giorni di inattività in cui non ci sono connessioni al cluster.

  • La transizione da un account di livello a pagamento a un account di livello gratuito non è supportata.

Limiti di livello

I livelli di servizio M10, M20 e M25 presentano le limitazioni seguenti:

  • Supporta solo una partizione fisica (nodo).

  • Progettato per casi d'uso di sviluppo/test; la disponibilità elevata nell'area non è supportata.

  • Le dimensioni di archiviazione supportate includono 32 GiB, 64 GiB e 128 GiB.

  • Una volta che il cluster è stato portato al livello M30 o superiore, non è possibile ridimensionarlo al livello di calcolo M10, M20 o M25.

Limitazioni della crittografia dei dati con chiave gestita dal cliente

Le seguenti sono le limitazioni correnti per la configurazione della Chiave Gestita dal Cliente (CGC) in un'istanza di Azure DocumentDB:

Limiti di replica e di elevata disponibilità nella regione

Azure DocumentDB offre funzionalità di replica e disponibilità elevata predefinite con limitazioni specifiche per garantire la coerenza e le prestazioni dei dati in diversi scenari di distribuzione.

Replica tra aree e replica nella stessa area

  • Le configurazioni seguenti sono uguali sia nei cluster primario che in quello di replica e non possono essere modificate nel cluster di replica:

    • Spazio di archiviazione e numero di partizioni fisiche

    • Account degli utenti

  • Le funzionalità seguenti non sono disponibili nei cluster di replica:

    • Ripristino temporizzato

    • Disponibilità elevata nell'area

  • La replica non è disponibile nei cluster con calcolo espandibile o livello gratuito.

Autenticazione e controllo di accesso (controllo degli accessi in base al ruolo)

Azure DocumentDB applica limiti di autenticazione e controllo di accesso per mantenere la sicurezza e gestire l'allocazione delle risorse tra account utente e ruoli.

  • È possibile creare fino a 100 utenti/ruoli totali per ogni cluster.

Autenticazione dell'ID Microsoft Entra

La funzionalità di autenticazione microsoft Entra ID presenta queste limitazioni correnti:

Utenti secondari di DocumentDB nativi

La funzionalità relativa agli utenti secondari nativi presenta le limitazioni seguenti:

  • Il Updateuser comando supporta ora solo gli aggiornamenti delle password e non può modificare altri campi oggetto.

  • Il Roleinfo comando non è supportato. In alternativa, è possibile usare usersInfo.

  • L'assegnazione di ruoli a database o raccolte specifici non è supportata, è supportato solo il livello del cluster.

Limitazioni varie

Azure DocumentDB presenta limiti più operativi e specifici delle funzionalità che si applicano a vari aspetti della gestione e delle funzionalità del cluster.

Utilizzo della shell Mongo del portale

  • La shell Mongo del portale può essere usata per 120 minuti entro una finestra di 24 ore.

Dimensioni e profondità del documento

  • Dimensioni massime del documento BSON (Binary JavaScript Object Notation): 16 MB per documento.

  • Non viene applicato alcun limite massimo di profondità di annidamento fisso.

    • Le strutture dei documenti annidate in modo approfondito possono influire sulle prestazioni di query e di lettura, aumentare il sovraccarico di elaborazione e ridurre la gestibilità.

Limiti batch

  • Sono supportati entrambi i tipi di operazione batch (bulk e scrittura).

    • Un batch fa riferimento a una singola richiesta al server.
  • Numero massimo di scritture per operazione batch: 25.000 scritture.

  • Le operazioni batch che superano 25.000 scritture avranno esito negativo.

  • Nessun limite al numero totale di operazioni batch.