Forum aux questions sur le débit provisionné en mode de mise à l’échelle automatique dans Azure Cosmos DB

Mise à l’échelle automatique ou débit approvisionné avec mise à l’échelle automatique est le nouveau nom de la fonctionnalité d’Azure Cosmos DB qui s’appelait auparavant autopilot. Dans la version actuelle de la mise à l’échelle automatique, nous avons ajouté de nouvelles fonctionnalités, notamment le support programmatique et la possibilité de définir une unité de requête/s maximale personnalisée.

Les ressources qui ont été créées dans le modèle de niveau antérieur sont prises en charge automatiquement dans le nouveau modèle de RU/s personnalisée de mise à l’échelle automatique. La limite supérieure du niveau devient la nouvelle RU/s maximale, ce qui se traduit par la même plage d’échelle.

Par exemple, si vous avez précédemment sélectionné le niveau qui a été mis à l’échelle entre 400 RU/s et 4 000 RU/s, la base de données ou le conteneur affiche désormais un nombre maximal de 4 000 RU/s, ce qui varie entre 400 RU/s et 4 000 RU/s. Ensuite, vous pouvez modifier la RU/s maximale en valeur personnalisée en fonction de votre charge de travail.

À compter d’avril 2022, vous pouvez définir la mise à l’échelle automatique avec un nombre maximal de RU/s pouvant descendre jusqu’à 1 000 RU/s (mise à l’échelle entre 100 RU/s et 1 000 RU/s). Vous pouvez également définir une plage de mise à l’échelle de 200 RU/s à 2 000 RU/s ou de 300 RU/s à 3 000 RU/s. Auparavant, le point d’entrée était de 400 RU/s à 4 000 RU/s.

Nous recommandons cette configuration pour les charges de travail qui ont des exigences de débit faibles, mais qui peuvent toujours être mises à l’échelle jusqu’au nombre maximal de RU/s.

Avec la mise à l’échelle automatique, le système met à l’échelle le débit (RU/s) T vers le haut ou T vers le bas dans la plage de 0,1 x Tmax vers Tmax en fonction du trafic entrant. Étant donné que la mise à l’échelle est automatique et instantanée, à tout moment, vous pouvez consommer jusqu’à Tmax approvisionné sans retard.

Utilisez Mesures Azure Monitor pour analyser la RU/s maximale de mise à l’échelle automatique approvisionnée et le débit actuel (RU/s) sur lequel le système est mis à l’échelle.

Vous êtes facturé toutes les heures pour le débit le plus élevé T sur lequel le système est mis à l’échelle dans l’heure en question. Si votre ressource ne comporte aucune demande pendant l’heure ou n’a pas été mise à l’échelle au-delà de 0,1 x Tmax, vous êtes facturé au minimum 0,1 x Tmax. Pour plus d’informations, consultez la page Tarification d’Azure Cosmos DB.

Dans les comptes de région d’écriture unique, le taux de mise à l’échelle automatique par 100 RU/s est de 1,5 fois le taux de débit standard (manuel) approvisionné. Votre facture affiche le compteur de débit approvisionné standard existant. La quantité de ce compteur est multipliée par 1,5. Par exemple, si la RU/s la plus élevée sur laquelle le système est mis à l’échelle en une heure est de 6 000 RU/s, vous êtes facturé 60 x 1,5 = 90 unités du compteur pour cette heure.

Dans les comptes couvrant plusieurs régions d’écritures, le taux de mise à l’échelle automatique par 100 RU/s est le même que le taux de débit standard (manuel) approvisionné couvrant plusieurs régions d’écriture. Votre facture affiche le compteur couvrant plusieurs régions d’écriture existant. Comme les taux sont les mêmes, si vous utilisez la mise à l’échelle automatique, vous verrez la même quantité que pour le débit standard.

Oui. Avec une capacité de réserve pour des comptes couvrant des régions d’écriture unique, la remise de réservation pour ressources de mise à l’échelle automatique est appliquée à l’utilisation du compteur à un ratio de 1,5 fois le ratio de la région spécifique. Par exemple, si vous souhaitez utiliser une capacité réservée pour couvrir 10 000 RU/s de mise à l’échelle automatique, vous devez planifier l’achat de 15 000 RU/s de capacité réservée globale.

La capacité de réserve de régions d’écriture fonctionne de la même façon pour la mise à l’échelle automatique et le débit approvisionné standard (manuel). Pour plus d’informations, consultez Capacité de réserve Azure Cosmos DB.

Oui. Au niveau Gratuit, vous pouvez utiliser le débit de mise à l’échelle automatique sur une base de données ou sur un conteneur. En savoir plus sur la façon dont fonctionne la facturation du niveau gratuit avec la mise à l’échelle automatique.

Oui. La mise à l’échelle automatique est prise en charge pour toutes les API : NoSQL, Gremlin, Table, Cassandra et MongoDB.

Oui. La RU/s maximale est disponible dans chaque région ajoutée au compte Azure Cosmos DB.

Apprenez comment activer la mise à l’échelle automatique.

Oui. Vous pouvez aussi basculer entre la mise à l’échelle automatique et le débit approvisionné standard (manuel). Actuellement, pour toutes les API, vous pouvez utiliser le portail Microsoft Azure, l’interface de ligne de commande Azure ou PowerShell pour effectuer ces opérations. Par défaut, vous ne pouvez pas utiliser les SDK clients Azure Cosmos DB ou le modèle Azure Resource Manager (ARM) pour effectuer une migration entre le débit approvisionné manuel et la mise à l’échelle automatique. Toutefois, vous pouvez utiliser les SDK clients ou un modèle Azure Resource Manager (ARM) pour créer des ressources de mise à l’échelle automatique et modifier le nombre maximal de RU/s sur une ressource de mise à l’échelle automatique existante.

Conceptuellement, la modification du type de débit est un processus en deux étapes. Tout d’abord, vous envoyez une requête de modification des paramètres de débit pour utiliser la mise à l’échelle automatique ou le débit approvisionné manuellement. Dans les deux cas, le système détermine et définit automatiquement une valeur RU/s initiale, en fonction des paramètres de débit et du stockage actuels. Au cours de cette étape, aucune valeur RU/s fournie par l’utilisateur n’est acceptée. Ensuite, une fois la mise à jour terminée, vous pouvez modifier la RU/s pour l’adapter à votre charge de travail.

Effectuer une migration du débit approvisionné standard (manuel) vers la mise à l’échelle automatique

Pour un conteneur, utilisez la formule suivante qui vise à estimer la RU/s maximale de mise à l’échelle automatique :

MAX(1,000, current manual provisioned RU/s, maximum RU/s ever provisioned / 10, storage in GB × 10), arrondie aux 1 000 RU/s les plus proches.

La RU/s maximale de mise à l’échelle automatique initiale réelle peut varier en fonction de la configuration de votre compte.

Exemple 1 : vous disposez d’un conteneur avec un débit approvisionné manuel de 10 000 RU/s et un stockage de 25 Go. Une fois la mise à l’échelle automatique activée, la valeur RU/s maximale de mise à l’échelle automatique initiale est de 10 000 RU/s, correspondant à des valeurs comprises entre 1 000 et 10 000 RU/s.

Exemple 2 : vous disposez d’un conteneur avec un débit approvisionné manuel de 50 000 RU/s et un stockage de 25 000 Go. Une fois la mise à l’échelle automatique activée, la valeur RU/s maximale de mise à l’échelle automatique initiale est de 250 000 RU/s, correspondant à des valeurs comprises entre 25 000 et 250 000 RU/s.

Effectuer une migration de la mise à l’échelle automatique vers le débit approvisionné standard (manuel)

Le débit manuel approvisionné initial est égal à la valeur RU/s maximale de mise à l’échelle automatique actuelle.

Exemple : vous disposez d’une base de données ou d’un conteneur de mise à l’échelle automatique dont le nombre maximal de RU/s est de 20 000 RU/s (mise à l’échelle entre 2 000 RU/s et 20 000 RU/s). Lors de la mise à jour pour utiliser le débit provisionné manuel, le débit initial est de 20 000 RU/s.

Oui. Pour activer programmatiquement la mise à l’échelle automatique sur une base de données ou un conteneur existant, vous pouvez utiliser Azure CLI ou PowerShell.

Pour créer une base de données ou un conteneur qui utilise la mise à l’échelle automatique, vous pouvez utiliser l’interface de ligne de commande Azure, PowerShell ou un modèle Azure Resource Manager.

Oui. Afin d’activer la mise à l’échelle automatique pour une base de données à débit partagé, lorsque vous créez cette dernière, sélectionnez mise à l’échelle automatique et l’option Approvisionner le débit.

Azure Cosmos DB applique un maximum de 25 conteneurs dans une base de données à débit partagé. La valeur maximale s’applique aux bases de données qui ont un débit avec mise à l’échelle automatique ou un débit standard (manuel).

La mise à l’échelle automatique n’a aucun effet sur le niveau de cohérence d’une base de données.

Pour plus d’informations, consultez Niveaux de cohérence.

La limite de stockage en Go pour chaque RU/s maximale est la quantité maximale de RU/s de la base de données ou du conteneur divisée par 10. Par exemple, si le nombre maximal de RU/s est de 20 000, la ressource peut prendre en charge 2 000 Go de stockage.

Pour connaître le nombre maximal de RU/s disponibles et les options de stockage, consultez Limites d’approvisionnement de mise à l’échelle automatique du débit.

Si la limite de stockage qui est associée au débit maximal de la base de données ou du conteneur est dépassée, Azure Cosmos DB augmente automatiquement le débit maximal à la valeur RU/s suivante la plus élevée pouvant prendre en charge ce niveau de stockage.

Voici un exemple de scénario : si vous démarrez avec des RU/s maximales de 50 000 (avec une mise à l’échelle de 5 000 à 50 000 RU/s), vous pouvez stocker jusqu’à 5 000 Go de données. Si votre taille de stockage monte à 5 001 Go, le stockage est désormais de 6 000 Go et le nouveau nombre maximal de RU/s est de 60 000 RU/s (mise à l’échelle entre 6 000 RU/s et 60 000 RU/s).

Oui. Pour plus d’informations, consultez Comment approvisionner un débit avec mise à l’échelle automatique.

Lorsque vous modifiez le nombre maximal de RU/s, en fonction de la valeur demandée, l’opération asynchrone peut prendre 4 à 6 heures. Plus d’informations

Lorsque vous envoyez une requête pour augmenter l’unité de RU/s maximale Tmax, en fonction de la RU/s sélectionnée, le service approvisionne plus de ressources pour prendre en charge l’unité de RU/s maximale la plus élevée. Pendant que cela se produit, vos charges de travail et opérations existantes ne sont pas affectées. Le système continue à mettre à l’échelle votre base de données ou votre conteneur entre les valeurs 0,1 x Tmax et Tmax précédentes, jusqu’à ce que la nouvelle plage de mise à l’échelle de 0,1 x Tmax_new à Tmax_new soit prête.

Lorsque vous réduisez l’unité de RU/s maximale, la valeur minimale que vous pouvez lui affecter est MAX(1,000, highest maximum RU/s ever provisioned / 10, current storage in GB × 10), arrondie aux 1 000 RU/s les plus proches.

Exemple 1 : vous disposez d’un conteneur avec mise à l’échelle automatique dont le nombre maximal de RU/s est de 20 000 RU/s (mise à l’échelle entre 2 000 RU/s et 20 000 RU/s) et de 1 500 Go de stockage. La valeur minimale la plus basse que vous pouvez définir pour la RU/s maximale est : MAX(1,000, 20,000 / 10, 1,500 × 10) = 15 000 RU/s (mise à l’échelle entre 1 500 et 15 000 RU/s).

Exemple 2 : vous disposez d’un conteneur avec mise à l’échelle automatique dont le nombre maximal de RU/s est de 100 000 RU/s et de 100 Go de stockage. Vous pouvez à présent mettre à l’échelle la RU/s maximale jusqu’à 150 000 RU/s (mise à l’échelle entre 15 000 RU/s et 150 000 RU/s). La valeur minimale la plus basse que vous pouvez désormais définir pour la RU/s maximale est : MAX(1,000, 150,000 / 10, 100 × 10) = 15 000 RU/s (mise à l’échelle entre 1 500 et 15 000 RU/s).

Pour une base de données à débit partagé, lorsque vous réduisez la RU/s maximale, la valeur minimale que vous pouvez lui affecter est MAX(1,000, highest maximum RU/s ever provisioned / 10, current storage in GB × 10, 1,000 + (MAX(Container count - 25, 0) × 1,000)), arrondie aux 1 000 RU/s les plus proches.

Ces formules et exemples s’appliquent au nombre maximal de RU/s de mise à l’échelle automatique minimale que vous pouvez définir. Elles sont distinctes de la plage de 0,1 × Tmax à Tmax à laquelle le système effectue automatiquement une mise à l’échelle. Quel que soit le nombre maximal de RU/s, le système est toujours mis à l’échelle entre 0,1 × Tmax et Tmax.

Les opérations de TTL n’affectent pas la mise à l’échelle de la RU/s dans le cadre de la mise à l’échelle automatique. Toutes les unités de requête qui sont consommées en raison de la durée de vie ne font pas partie de la RU/s facturée pour le conteneur avec mise à l’échelle automatique.

Par exemple, pour un conteneur avec mise à l’échelle automatique qui dispose de 400 RU/s à 4 000 RU/s :

• Heure 1 : T = 0 : Le conteneur n’a aucune utilisation (aucune durée de vie ni requête de charge de travail). L’unité de requête/s facturable est de 400 RU/s.
• Heure 1 : T = 1 : La durée de vie est activée.
• Heure 1 – T=2 : le conteneur commence à recevoir des requêtes. Les requêtes consomment 1 000 unités de requête en 1 seconde. 200 RU de TTL sont utilisées. La RU/s facturable est toujours de 1 000 RU/s. Quel que soit le moment où les suppressions de TTL se produisent, elles n’affectent pas la logique de mise à l’échelle de la mise à l’échelle automatique.

Lors de la première sélection du nombre maximal de RU/s, Azure Cosmos DB approvisionne en divisant le nombre maximal de RU/s par 10 000 RU/s pour obtenir le nombre de partitions physiques requises. Chaque partition physique peut prendre en charge jusqu’à 10 000 RU/s et 50 Go de stockage. À mesure que la taille de stockage augmente, Azure Cosmos DB fractionne automatiquement les partitions pour ajouter des partitions physiques afin de gérer l’augmentation du stockage. Si le stockage dépasse la limite associée, Azure Cosmos DB augmente le nombre maximal de RU/s.

La RU/s maximale de la base de données ou du conteneur est divisée uniformément entre toutes les partitions physiques. Le débit total auquel toute partition physique unique peut être mise à l’échelle est le nombre maximal de RU/s de la base de données ou du conteneur divisé par le nombre de partitions physiques.

Si le nombre total de RU/s consommées dépasse le nombre maximal de RU/s de la base de données ou du conteneur, les requêtes qui dépassent le nombre maximal de RU/s sont limitées et retournent un code d’état 429. Les requêtes qui entraînent une utilisation normalisée supérieure à 100 % sont limitées. L’utilisation normalisée est définie comme la quantité maximale d’utilisation de RU/s parmi toutes les partitions physiques.

Par exemple, votre débit maximal est de 20 000 RU/s et vous disposez de deux partitions physiques, P_1 et P_2. Chaque partition est capable de se mettre à l’échelle jusqu’à 10 000 RU/s. Dans une seconde donnée, si P_1 a utilisé 6 000 RU et P_2 a utilisé 8 000 RU, l’utilisation normalisée est MAX(6,000 RU / 10,000 RU, 8,000 RU / 10,000 RU) = 0,8.

Oui. Il est possible d’observer des erreurs de code 429 dans deux scénarios.

Tout d’abord, quand le nombre total de RU/s consommées dépasse le nombre maximal de RU/s de la base de données ou du conteneur, le service limite les requêtes en conséquence.

Ensuite, si une valeur de clé de partition logique présente un nombre de requêtes beaucoup plus élevé que d’autres valeurs de clé de partition (comme pour une partition à chaud), la partition physique sous-jacente peut dépasser son budget de RU/s. En guise de bonne pratique, pour éviter les partitions à chaud, choisissez une clé de partition appropriée qui entraîne une répartition égale du stockage et du débit.

Par exemple, si vous sélectionnez l’option de débit maximal de 20 000 RU/s et que vous avez 200 Go de stockage, si vous avez quatre partitions physiques, chaque partition physique peut être mise à l’échelle automatiquement jusqu’à 5 000 RU/s. Si une partition à chaud se trouve sur une clé de partition logique spécifique, vous verrez des erreurs de code 429 lorsque la partition physique sous-jacente dans laquelle elle réside dépasse 5 000 RU/s ou 100 % d’utilisation normalisée.

L’affichage d’erreurs de code 429 lorsque vous utilisez la mise à l’échelle automatique n’indique pas nécessairement un problème au niveau de votre base de données ou conteneur. En règle générale, pour une charge de travail de production, si entre 1 et 5 % des requêtes présentent des erreurs de code 429 et que votre latence de bout en bout est acceptable, les erreurs sont un signe sain que les RU/s sont entièrement utilisées. Aucune action n'est requise.

En savoir plus sur l’interprétation et le débogage des erreurs de code 429 de limitation de débit.

Oui. Pour plus d’informations, consultez Surveiller les RU/s normalisées.

Étapes suivantes

• Découvrez comment activer la mise à l’échelle automatique sur une base de données ou un conteneur Azure Cosmos DB.
• En savoir plus sur les avantages du débit approvisionné en utilisant la mise à l’échelle automatique.
• Apprenez-en davantage sur les partitions logiques et physiques.