Limites du service Azure Digital Twins

  • Article

Les sections suivantes décrivent les limites du service Azure Digital Twins.

Remarque

Certaines zones de ce service ont des limites ajustables. Cela est représenté dans les tableaux ci-dessous avec la colonne Ajustable ? . Quand la limite peut être ajustée, la valeur Réglable ? est Oui.

Si votre entreprise nécessite de déclencher une limite ou un quota ajustable au-delà de la limite par défaut, vous pouvez demander des ressources supplémentaires en ouvrant un ticket de support.

Limites par type

Limitations fonctionnelles

Le tableau suivant liste les limites opérationnelles d’Azure Digital Twins.

Domaine Fonctionnalité Limite par défaut Ajustable ?
Ressource Azure Nombre d’instances Azure Digital Twins dans une région, par abonnement 10 Oui
Jumeaux numériques Nombre de jumeaux dans une instance Azure Digital Twins 2 000 000 Oui
Jumeaux numériques Nombre de jumeaux numériques pouvant être importés dans un seul travail de l’API Importer des travaux 2 000 000 Non
Jumeaux numériques Nombre de relations entrantes à un seul jumeau 50 000 Non
Jumeaux numériques Nombre de relations sortantes à partir d’un seul jumeau 50 000 Non
Jumeaux numériques Nombre total de relations dans une instance Azure Digital Twins 20 000 000 Oui
Jumeaux numériques Nombre de relations pouvant être importées dans un seul travail de l’API Importer des travaux 10,000,000 Non
Jumeaux numériques Taille maximale (du corps JSON dans une requête PUT ou PATCH) d’un seul jumeau 32 Ko Non
Jumeaux numériques Taille maximale de la charge utile de requête 32 Ko Non
Jumeaux numériques Taille maximale d’une valeur de propriété de type chaîne (UTF-8) 4 Ko Non
Jumeaux numériques Taille maximale du nom d’une propriété 1 Ko Non
Routage Nombre de points de terminaison pour une même instance Azure Digital Twins 6 Non
Routage Nombre d’itinéraires pour une même instance Azure Digital Twins 6 Oui
Modèles Nombre de modèles dans une même instance Azure Digital Twins 10 000 Oui
Modèles Nombre de modèles pouvant être importés dans un seul appel d’API (sans utiliser l’API Importer des travaux) 250 Non
Modèles Nombre de modèles pouvant être importés dans un seul travail de l’API Importer des travaux 10 000 Non
Modèles Taille maximale (du corps JSON dans une requête PUT ou PATCH) d’un seul modèle 1 Mo Non
Modèles Nombre d’éléments retournés sur une même page 100 Non
Requête Nombre d’éléments retournés sur une même page 1 000 Oui
Requête Nombre d’expressions AND / OR dans une requête 50 Oui
Requête Nombre d’éléments de tableau dans une clause IN / NOT IN 50 Oui
Requête Nombre de caractères dans une requête 8,000 Oui
Requête Nombre de JOINS dans une requête 5 Oui

Limites du taux de transfert

Le tableau suivant reflète les limites de débit de différentes API.

API Fonctionnalité Limite par défaut Ajustable ?
API Travaux Nombre de demandes par seconde 1 Oui
API Jobs Nombre de travaux en bloc en cours d’exécution (y compris l’importation et la suppression) 1 Oui
API Modèles Nombre de demandes par seconde 100 Oui
API Digital Twins Nombre de requêtes de lecture par seconde 1 000 Oui
API Digital Twins Nombre de requêtes patch par seconde 1 000 Oui
API Digital Twins Nombre d’opérations de création/suppression par seconde pour l’ensemble des jumeaux et des relations 500 Oui
API Digital Twins Nombre d’opérations de création/mise à jour/suppression par seconde sur un jumeau unique ou ses relations entrantes/sortantes 10 Non
API Digital Twins Nombre d’opérations en attente sur un jumeau unique ou ses relations entrantes et sortantes 500 Non
API de requête Nombre de demandes par seconde 500 Oui
API de requête Unités de requête par seconde 4 000 Oui
API Routage d’événement Nombre de demandes par seconde 100 Oui

Autres limites

Les limites des types de données et des champs dans les documents DTDL pour les modèles Azure Digital Twins sont disponibles dans la documentation des spécifications sur GitHub : DTDL (Digital Twins Definition Language) – version 2.

Les détails de la latence des requêtes sont décrits dans Langage de requête. Les limitations des fonctionnalités spécifiques du langage de requête se trouvent dans la documentation de référence sur les requêtes.

Gestion des limites

Quand une limite est atteinte, toute requête au-delà de cette valeur est bloquée par le service, ce qui génère une réponse d’erreur 429 par cette requête.

Pour gérer l’étranglement, voici quelques recommandations relatives aux limites.

  • Utilisez la logique de nouvelle tentative. Les kits SDK Azure Digital Twins implémentent la logique de nouvelle tentative pour les requêtes ayant échoué. Par conséquent, si vous travaillez avec un SDK fourni, cette fonctionnalité est déjà intégrée. Sinon, envisagez d’implémenter une logique de nouvelle tentative dans votre propre application. Le service renvoie un en-tête Retry-After dans la réponse d’échec, que vous pouvez utiliser pour déterminer la durée d’attente avant une nouvelle tentative.
  • Utilisez des seuils et des notifications pour signaler les limites. Certaines des limites de service pour Azure Digital Twins ont des métriques correspondantes qui peuvent être utilisées pour suivre l’utilisation dans ces domaines. Pour configurer des seuils et une alerte sur n’importe quelle métrique lorsqu’un seuil est proche, consultez les instructions dans Créer une nouvelle règle d’alerte. Pour configurer des notifications pour d’autres limites où les métriques ne sont pas fournies, envisagez d’implémenter cette logique dans votre propre code d’application.
  • Déployez à grande échelle sur plusieurs instances. Évitez d’avoir un point de défaillance unique. Au lieu d’un seul grand graphique pour l’ensemble de votre déploiement, envisagez de répartir des sous-ensembles de jumeaux de manière logique (p. ex. : par région ou locataire) sur plusieurs instances.
  • Pour obtenir des recommandations de modélisation pour vous aider à travailler dans les limites fonctionnelles, consultez les outils de modélisation et les meilleures pratiques.

Remarque

Azure Digital Twins met automatiquement à l’échelle les ressources pour atteindre les limites de débit décrites dans cet article. Vous pouvez rencontrer des limitations avant que ces limites soient atteintes en raison de la mise à l’échelle interne pour s’adapter à la charge entrante. Quel que soit l’endroit, la mise à l’échelle interne peut prendre de 5 à 30 minutes, pendant lesquelles votre application peut rencontrer des erreurs 429.

Étapes suivantes

Apprenez-en davantage sur la version actuelle d’Azure Digital Twins dans la vue d’ensemble du service :