Limites du service Azure Digital Twins
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-Afterdans 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 pouvant vous aider dans le cadre des limites fonctionnelles, consultez Outils de modélisation et 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 :