Límites del servicio Azure Digital Twins
En las secciones siguientes se describen los límites de servicio de Azure Digital Twins.
Nota:
Los límites de algunas áreas de este servicio son ajustables. Esto se representa en las tablas siguientes con la columna ¿Ajustable? . Cuando se puede ajustar el límite, el valor de ¿Ajustable? es Sí.
Si su empresa requiere el aumentar una cuota o límite ajustable por encima del límite predeterminado, puede abrir una incidencia de soporte técnico para solicitar más recursos.
Límites por tipo
Límites funcionales
En la tabla siguiente se enumeran los límites funcionales de Azure Digital Twins.
| Área | Capacidad | Límite predeterminado | ¿Ajustable? |
|---|---|---|---|
| Recurso de Azure | Número de instancias de Azure Digital Twins en una región por suscripción | 10 | Sí |
| Gemelos digitales | Número de gemelos de una instancia de Azure Digital Twins | 2 000 000 | Sí |
| Gemelos digitales | Número de gemelos digitales que se pueden importar en un único trabajo de Import Jobs API | 2 000 000 | No |
| Gemelos digitales | Número de relaciones entrantes en un solo gemelo | 50.000 | No |
| Gemelos digitales | Número de relaciones de salida de un solo gemelo | 50.000 | No |
| Gemelos digitales | Número total de relaciones en una instancia de Azure Digital Twins | 20 000 000 | Sí |
| Gemelos digitales | Número de relaciones que se pueden importar en un único trabajo de Import Jobs API | 10,000,000 | No |
| Gemelos digitales | Tamaño máximo (del cuerpo JSON en una solicitud PUT o PATCH) de un solo gemelo | 32 KB | No |
| Gemelos digitales | Tamaño máximo de carga de solicitud | 32 KB | No |
| Gemelos digitales | Tamaño máximo de un valor de propiedad de cadena (UTF-8) | 4 KB | No |
| Gemelos digitales | Tamaño máximo de un nombre de propiedad | 1 KB | No |
| Enrutamiento | Número de puntos de conexión de una instancia de Azure Digital Twins | 6 | No |
| Enrutamiento | Número de rutas de una instancia de Azure Digital Twins | 6 | Sí |
| Modelos | Número de modelos de una instancia de Azure Digital Twins | 10 000 | Sí |
| Models | Número de modelos que se pueden importar en una sola llamada API (no mediante la Import Jobs API) | 250 | No |
| Modelos | Número de modelos que se pueden importar en un único trabajo de Import Jobs API | 10 000 | No |
| Modelos | Tamaño máximo (del cuerpo JSON en una solicitud PUT o PATCH) de un solo modelo | 1 MB | No |
| Modelos | Número de elementos devueltos en una única página | 100 | No |
| Consultar | Número de elementos devueltos en una única página | 1000 | Sí |
| Consultar | Número de expresiones AND / OR de una consulta |
50 | Sí |
| Consultar | Número de elementos de matriz de una cláusula IN / NOT IN |
50 | Sí |
| Consultar | Número de caracteres de una consulta | 8,000 | Sí |
| Consultar | Número de JOINS de una consulta |
5 | Sí |
Límites de frecuencia
En la tabla siguiente se reflejan los límites de frecuencia de distintas API.
| API | Capacidad | Límite predeterminado | ¿Ajustable? |
|---|---|---|---|
| Jobs API | Número de solicitudes por segundo | 1 | Sí |
| API de trabajo | Número de trabajos masivos que se ejecutan simultáneamente (incluida la importación y la eliminación) | 1 | Sí |
| API de modelos | Número de solicitudes por segundo | 100 | Sí |
| API de Digital Twins | Número de solicitudes de lectura por segundo | 1,000 | Sí |
| API de Digital Twins | Número de solicitudes de revisión por segundo | 1,000 | Sí |
| API de Digital Twins | Número de operaciones de creación y eliminación por segundo en todos los gemelos y las relaciones | 500 | Sí |
| API de Digital Twins | Número de operaciones de creación, actualización y eliminación por segundo en un único gemelo o sus relaciones entrantes o salientes | 10 | No |
| API de Digital Twins | Número de operaciones pendientes en un único gemelo o sus relaciones entrantes o salientes | 500 | No |
| API de consulta | Número de solicitudes por segundo | 500 | Sí |
| API de consulta | Unidades de consulta por segundo | 4\.000 | Sí |
| API de rutas de eventos | Número de solicitudes por segundo | 100 | Sí |
Otros límites
Los límites de los tipos de datos y los campos de los documentos de DTDL para los modelos de Azure Digital Twins se pueden encontrar en la documentación de la especificación en GitHub: Lenguaje de definición de Digital Twins (DTDL): versión 2.
Los detalles de la latencia de consulta se describen en Lenguaje de consulta. Las limitaciones de características concretas del lenguaje de consulta se pueden encontrar en la documentación de referencia de consulta.
Trabajo con límites
Cuando se alcanza un límite, el servicio limita las solicitudes más allá de él, lo que generará una respuesta de error 429 de estas solicitudes.
Para administrar el límite, estas son algunas recomendaciones para trabajar con límites.
- Use la lógica de reintento. Los SDK de Azure Digital Twins implementan la lógica de reintento para las solicitudes con error, por lo que si está trabajando con un SDK proporcionado, esta funcionalidad ya está integrada. De lo contrario, considere la posibilidad de implementar la lógica de reintento en su propia aplicación. El servicio devuelve un encabezado
Retry-Afteren la respuesta del error, que puede usar para determinar cuánto tiempo se debe esperar antes de volver a intentarlo. - Use umbrales y notificaciones para advertir sobre la proximidad de los límites. Algunos de los límites de servicio de Azure Digital Twins tienen métricas correspondientes que se pueden usar para hacer un seguimiento del uso en estas áreas. Para configurar umbrales y definir una alerta sobre cualquier métrica cuando se aproxime a un umbral, consulte las instrucciones de Creación de una nueva regla de alertas. Para configurar notificaciones para otros límites en los que no se proporcionan métricas, considere la posibilidad de implementar esta lógica en su propio código de aplicación.
- Implementación a escala en varias instancias. Evite tener un único punto de error. En lugar de un grafo grande para toda la implementación, considere la posibilidad de separar los subconjuntos de gemelos de manera lógica (por ejemplo, por región o inquilino) en varias instancias.
- Para conocer las recomendaciones de modelado que le ayudarán a operar dentro de estos límites funcionales, consulte Procedimientos recomendados y herramientas para la creación de modelos.
Nota:
Azure Digital Twins escalará automáticamente los recursos para cumplir los límites de velocidad descritos en este artículo. Es posible que experimente una limitación antes de que se alcancen estos límites debido al escalado interno para adaptarse a la carga entrante. El escalado interno puede tardar entre 5 y 30 minutos, tiempo durante el cual la aplicación puede encontrar errores 429.
Pasos siguientes
Encuentre más información sobre la versión actual de Azure Digital Twins en la información general del servicio: