Quotas et limites par défaut du service Azure Cosmos DB

Cet article explique les quotas et les limites par défaut des ressources Azure Cosmos DB. Il vous aide à gérer efficacement les opérations, le stockage et le débit.

Opérations de stockage et de base de données

Une fois que vous avez créé un compte Azure Cosmos DB dans votre abonnement, vous pouvez y gérer des données en créant des bases de données, des conteneurs et des éléments.

Débit approvisionné

Vous allouez le débit au niveau du conteneur ou au niveau de la base de données en termes d'unités de requête (RU) ou d'unités de requête par seconde (RU/s). Le tableau suivant liste les limites de stockage et de débit par conteneur/base de données. Stockage fait référence à la quantité combinée du stockage des données et des index.

¹ Augmentez le nombre maximal d’unités de récupération par conteneur ou base de données en soumettant un ticket de support Azure.

² Pour découvrir les meilleures pratiques en matière de gestion des charges de travail utilisant des clés de partition qui nécessitent des limites plus élevées de stockage ou de débit, consultez Créer une clé de partition synthétique. Si votre charge de travail atteint la limite de partition logique de 20 Go en production, il est recommandé, à long terme, de repenser l'architecture de votre application avec une clé de partition différente. Pour vous donner le temps de repenser l'architecture de votre application, demandez une augmentation temporaire de la limite de clés de partition logique pour votre application existante. Envoyez un ticket de support Azure et sélectionnez le type de quota Augmentation temporaire de la taille de clé de partition logique du conteneur. Demander une augmentation temporaire est une atténuation temporaire et n’est pas recommandée en tant que solution à long terme, car les garanties du contrat de niveau de service ne sont pas respectées lorsque la limite est augmentée. Pour supprimer la configuration, envoyez un ticket de support et sélectionnez le type de quota Restaurer la valeur par défaut (20 Go) de la taille de la clé de partition logique du conteneur. Vous pouvez soumettre ce ticket d'assistance après avoir supprimé des données pour respecter la limite de 20 Go de la partition logique ou après avoir restructuré votre application avec une clé de partition différente.

Limites de débit minimal

Un conteneur Azure Cosmos DB (ou une base de données à débit partagé) avec un débit manuel doit avoir un débit minimum de 400 RU/s. Au fur et à mesure que le conteneur augmente, Azure Cosmos DB requiert un débit minimal pour s’assurer que la ressource (base de données ou conteneur) dispose de suffisamment de ressources pour ses opérations.

Récupérez le débit actuel et minimal d'un conteneur ou d'une base de données à partir du Portail Microsoft Azure ou des kits de développement logiciel (SDK). Pour plus d’informations, consultez Allouer un débit à des conteneurs et bases de données.

La valeur de requête minimales réelles peut varier en fonction de la configuration de votre compte. Vous pouvez utiliser les métriques Azure Monitor pour voir l’historique du débit provisionné (RU/s) et du stockage sur une ressource.

Débit minimal sur un conteneur

Estimez le débit minimal d'un conteneur à l'aide de cette section.

Débit manuel

Pour estimer les RU/s minimales requises d’un conteneur avec un débit manuel, recherchez le maximum de :

• 400 RU/s
• Stockage actuel en Go * 1 RU/s
• RU/s les plus élevées jamais provisionnées sur le conteneur / 100

Par exemple, un conteneur est configuré avec 400 RU/s et 0 Go de stockage. Vous augmentez le débit à 50 000 RU/s et importez 20 Go de données. La valeur RU/s minimale est maintenant MAX(400, 20 * 1 RU/s per GB, 50,000 RU/s / 100) = 500 RU/s. Au fil du temps, la capacité de stockage atteint 2 000 Go. La valeur RU/s minimale est maintenant MAX(400, 2000 * 1 RU/s per GB, 50,000 / 100) = 2 000 RU/s.

Mise à l’échelle automatique du débit

Pour estimer les RU/s maximales de mise à l’échelle automatique minimale requises d’un conteneur avec un débit de mise à l’échelle automatique, recherchez le maximum de :

• 1 000 RU/s
• Stockage actuel en Go * 10 RU/s
• RU/s les plus élevées jamais provisionnées sur le conteneur / 10

Supposons par exemple que vous disposiez d’un conteneur approvisionné avec 1000 RU/s et un stockage de 0 Go. Vous augmentez le débit à 50 000 RU/s et importez 20 Go de données. Le nombre minimal de RU/s est maintenant MAX(1000, 20 * 10 RU/s per GB, 50,000 RU/s / 10) = 5 000 RU/s. Au fil du temps, la capacité de stockage atteint 2 000 Go. Le nombre minimal de RU/s est maintenant MAX(1000, 2000 * 10 RU/s per GB, 50,000 / 10) = 20 000 RU/s.

Débit minimal sur une base de données à débit partagé

Utilisez cette section pour estimer le débit minimal d'une base de données partageant le débit entre plusieurs conteneurs.

Débit manuel

Pour estimer les RU/s minimales requises d’une base de données de débit partagé avec un débit manuel, recherchez le maximum de :

• 400 RU/s
• Stockage actuel en Go * 1 RU/s
• RU/s les plus élevées jamais provisionnées sur la base de données / 100
• 400 + MAX (nombre de conteneurs - 25, 0) * 100 RU/s

Supposons par exemple que vous disposiez d’une base de données configurée avec 400 RU/s, 15 Go de stockage et 10 conteneurs. La valeur RU/s minimale est MAX(400, 15 * 1 RU/s per GB, 400 / 100, 400 + 0 ) = 400 RU/s. En présence de 30 conteneurs dans la base de données, la valeur RU/s minimale serait 400 + MAX(30 - 25, 0) * 100 RU/s = 900 RU/s.

Mise à l’échelle automatique du débit

Pour estimer les RU/s maximales de mise à l’échelle automatique minimale requises d’une base de données de débit partagé avec débit de mise à l’échelle automatique, recherchez le maximum de :

• 1 000 RU/s
• Stockage actuel en Go * 10 RU/s
• RU/s les plus élevées jamais provisionnées sur la base de données / 10
• 1000 + MAX(Nombre de conteneurs - 25, 0) * 1 000 RU/s

Par exemple, vous disposez d’une base de données approvisionnée avec 1 000 RU/s, 15 Go de stockage et 10 conteneurs. Le nombre minimal de RU/s pour la base de données de mise à l’échelle automatique est MAX(1000, 15 * 10 RU/s per GB, 1000 / 10, 1000 + 0 ) = 1 000 RU/s. S’il y avait 30 conteneurs dans la base de données, le nombre minimal de RU/s serait 1000 + MAX(30 - 25, 0) * 1000 RU/s = 5 000 RU/s.

En résumé, voici les limites minimales de RU provisionnée lors de l’utilisation du débit provisionné.

Azure Cosmos DB prend en charge la mise à l'échelle programmatique du débit (RU/s) par conteneur ou base de données via les SDK ou le portail.

Chaque ressource s'adapte de manière synchrone et immédiate entre le minimum de RU/s et jusqu'à 100 fois le minimum de RU/s, en fonction des RU/s actuellement provisionnés et des paramètres de la ressource. Si la valeur de débit demandée est en dehors de la plage, la mise à l’échelle est exécutée de façon asynchrone. La mise à l'échelle asynchrone peut prendre de quelques minutes à plusieurs heures en fonction du débit demandé et de la taille du stockage des données dans le conteneur. En savoir plus.

Sans serveur

Serverless vous permet d’utiliser vos ressources Azure Cosmos DB en fonction de la consommation.

¹ Si votre charge de travail atteint la limite de partition logique de 20 Go en production, la réarchitecture de votre application avec une clé de partition différente est recommandée comme solution à long terme. Pour vous donner le temps de repenser l'architecture de votre application, demandez une augmentation temporaire de la limite de clés de partition logique pour votre application existante. Envoyez un ticket de support Azure et sélectionnez le type de quota Augmentation temporaire de la taille de clé de partition logique du conteneur. La demande d’une augmentation temporaire est destinée à une atténuation temporaire et n’est pas recommandée comme solution à long terme. Pour supprimer la configuration, envoyez un ticket de support et sélectionnez le type de quota Restaurer la valeur par défaut (20 Go) de la taille de la clé de partition logique du conteneur. Vous pouvez soumettre ce ticket d'assistance après avoir supprimé des données pour respecter la limite de 20 Go de la partition logique ou après avoir restructuré votre application avec une clé de partition différente.

Plan de contrôle

Azure Cosmos DB dispose d'un fournisseur de ressources qui vous permet de créer, de mettre à jour et de supprimer des ressources dans votre compte Azure Cosmos DB. Le fournisseur de ressources s’interface avec la couche globale de gestion des ressources Azure, qui est le service de déploiement et de gestion d’Azure.

Créez et gérez des ressources Azure Cosmos DB à l'aide de :

• Portail Azure
• Azure PowerShell
• Azure CLI
• Modèles JSON/Bicep pour Azure Resource Manager
• API REST Azure
• Kits de développement logiciel (SDK) de gestion Azure
• Terraform
• Pulumi

Cette couche de gestion est également accessible à partir des kits de développement logiciel (SDK) de plan de données Azure Cosmos DB utilisés dans vos applications pour créer et gérer des ressources dans un compte. Les SDK du plan de données effectuent également des requêtes au plan de contrôle lors de la connexion initiale au service pour réaliser des opérations telles que l'énumération des bases de données et des conteneurs, et la requête de clés de compte pour l'authentification.

Chaque compte Azure Cosmos DB possède une partition principale qui contient toutes les métadonnées du compte. Il a également un faible débit pour prendre en charge des opérations de plan de contrôle. Les requêtes du plan de contrôle qui créent, lisent, mettent à jour ou suppriment ces métadonnées consomment ce débit. Lorsque la quantité de débit consommée par les opérations de plan de contrôle dépasse ce montant, les opérations sont limitées en débit, de même que les opérations de plan de données dans Azure Cosmos DB. Cependant, contrairement au débit des opérations de données, le débit de la partition principale ne peut pas être augmenté.

Certaines opérations du plan de contrôle ne consomment pas le débit de la partition principale, comme Get ou List Keys. Cependant, contrairement aux requêtes sur les données de votre compte Azure Cosmos DB, les fournisseurs de ressources d'Azure ne sont pas conçus pour des volumes de requêtes élevés. Opérations de plan de contrôle qui dépassent les limites documentées à des niveaux soutenus sur des périodes consécutives de 5 minutes peuvent rencontrer une limitation des demandes ainsi que des opérations ayant échoué ou incomplètes sur les ressources Azure Cosmos DB.

Les opérations de plan de contrôle peuvent être analysées en accédant à l’onglet Insights d’un compte Azure Cosmos DB. Pour plus d'informations, consultez la section Surveillance des requêtes du plan de contrôle. Vous pouvez personnaliser ces informations, utiliser Azure Monitor et créer un classeur pour surveiller les requêtes de métadonnées et définir des alertes.

Limites des ressources

Le tableau suivant répertorie les limites de ressources par abonnement ou compte.

¹ Les limites par défaut diffèrent pour les clients internes de Microsoft. Augmentez ces limites en créant une requête de support Azure jusqu'à un maximum de 1 000. Cosmos DB se réserve le droit de supprimer tout compte de base de données vide, c'est-à-dire sans base de données ni collection. ² Cette limite ne peut pas être augmentée. Le nombre total comprend à la fois les bases de données et les conteneurs au sein d'un compte (par exemple, 1 base de données et 499 conteneurs, ou 250 bases de données et 250 conteneurs).

Limites de requête

Le tableau suivant répertorie les limites de requêtes par intervalle de 5 minutes et par compte, sauf indication contraire.

¹ Utilisez un client singleton pour les instances SDK et mettez en cache les clés, la base de données et les références de conteneur entre les requêtes pour toute la durée de vie de cette instance. ² Les basculements régionaux s’appliquent uniquement aux comptes d’écriture spécifiques à une région. Les comptes d’écriture multirégions ne requièrent et n’autorisent pas de changement de région d’écriture.

Azure Cosmos DB sauvegarde automatiquement vos données à intervalles réguliers. Pour plus d’informations sur les fenêtres et intervalles de conservation des sauvegardes, consultez Sauvegarde en ligne et restauration de données à la demande dans Azure Cosmos DB.

Limites par compte

Voici les limites par compte.

Débit approvisionné

Sans serveur

Limites par conteneur

Selon l'API utilisée, un conteneur Azure Cosmos DB peut représenter une collection, une table ou un graphe. Les conteneurs prennent en charge les configurations pour les contraintes de clés uniques, les procédures stockées, les déclencheurs et les fonctions définies par l'utilisateur (UDF), ainsi que les stratégies d'indexation. Le tableau suivant liste les limites propres aux configurations dans un conteneur.

¹ Augmentez l’une de ces limites par conteneur en créant une requête de support Azure.

Limites par élément

Un élément Azure Cosmos DB peut représenter un document dans une collection, une ligne dans une table, ou un nœud ou une arête dans un graphe, selon l'API utilisée. Le tableau suivant indique les limites par élément dans Azure Cosmos DB.

¹ Les documents volumineux, jusqu’à 16 Mo, sont pris en charge par Azure Cosmos DB for MongoDB uniquement. Pour plus d'informations, consultez la documentation relative aux fonctionnalités de MongoDB 4.2.

Aucune restriction ne pèse sur les charges utiles d’élément (comme le nombre de propriétés et la profondeur d’imbrication), sauf en ce qui concerne la longueur des valeurs d’ID et de clé de partition, et la taille globale est limitée à 2 Mo. Vous devrez peut-être configurer la stratégie d'indexation pour les conteneurs ayant des structures d'éléments volumineuses ou complexes afin de réduire la consommation d'unités de requête (RU). Consultez Modélisation des éléments dans Azure Cosmos DB pour découvrir un exemple concret et des modèles permettant de gérer de grands éléments.

Limites par demande

Azure Cosmos DB prend en charge les opérations CRUD et de requête pour les ressources telles que les conteneurs, les éléments et les bases de données. Il prend également en charge les requêtes par lots transactionnelles pour les éléments ayant la même clé de partition dans un conteneur.

Azure Cosmos DB prend en charge les déclencheurs lors des écritures. Le service autorise un pré-déclenchement et un post-déclenchement par opération d'écriture.

Lorsqu'une opération de requête atteint le délai d'exécution ou la limite de taille de réponse, elle renvoie une page de résultats et un jeton de continuation au client pour reprendre l'exécution. Il n’existe aucune limite pratique quant à la durée de l’exécution d’une requête unique entre les continuations et les pages.

Azure Cosmos DB utilise des codes d'authentification de message basés sur le hachage (HMAC) pour l'autorisation. Utilisez une clé primaire pour un contrôle d'accès précis aux ressources. Ces ressources peuvent inclure des conteneurs, des clés de partition ou des éléments. Le tableau suivant liste les limites pour les jetons d’autorisation dans Azure Cosmos DB.

¹ Augmentez-le en soumettant un ticket de support Azure.

Limites du débit approvisionné en mode de mise à l’échelle automatique

Consultez l'article et la FAQ sur la mise à l'échelle automatique pour une explication détaillée des limites de débit et de stockage avec la mise à l'échelle automatique.

Limites de requête SQL

Azure Cosmos DB prend en charge l’interrogation d’éléments à l’aide de SQL. Le tableau suivant décrit les restrictions applicables aux instructions de requête, telles que le nombre de clauses ou la longueur de la requête.

¹ Vous pouvez augmenter ces limites de requêtes SQL en créant une requête de support Azure.

Limites propres à l’API pour MongoDB

Azure Cosmos DB prend en charge le protocole de communication MongoDB pour les applications écrites avec MongoDB. Vous trouverez les commandes et versions de protocole prises en charge dans la section Fonctionnalités et syntaxe MongoDB prises en charge.

Le tableau suivant liste les limites propres à la prise en charge des fonctionnalités MongoDB. D’autres limites de service mentionnées pour l’API pour NoSQL s’appliquent également à l’API pour MongoDB.

¹ Les documents de grande taille, jusqu’à 16 Mo, requièrent l’activation de la fonctionnalité dans le Portail Azure. Pour en savoir plus, consultez la documentation de la fonctionnalité..

² Configurez le délai d'inactivité de la connexion dans les paramètres du pilote sur 2 à 3 minutes, car le délai d'inactivité par défaut pour Azure LoadBalancer est de 4 minutes.. Ce délai d’expiration garantit que l’inactivité d’un équilibreur de charge intermédiaire ne ferme pas les connexions entre la machine cliente et Azure Cosmos DB.

Limites des comptes du niveau Gratuit d’Azure Cosmos DB

Le tableau suivant répertorie les limites des comptes gratuits Azure Cosmos DB.

En plus des limites indiquées dans le tableau précédent, les limites par compte s'appliquent également aux comptes gratuits. Pour en savoir plus, consultez la procédure de création d'un compte gratuit.

Contenu connexe

• Diffusion mondiale
• Partitionnement et débit provisionné