Limites de serviço dos Gêmeos Digitais do Azure
As seções a seguir descrevem os limites de serviço dos Gêmeos Digitais do Azure.
Observação
Algumas áreas desse serviço têm limites ajustáveis. Isso está representado nas tabelas abaixo com a coluna Ajustável? . Quando o limite puder ser ajustado, o valor Ajustável? será Sim.
Se seu negócio exigir a geração de um limite ajustável ou uma cota acima do limite padrão, é possível solicitar recursos adicionais abrindo um tíquete de suporte.
Limites por tipo
Limites funcionais
A tabela a seguir descreve os limites funcionais dos Gêmeos Digitais do Azure.
| Área | Funcionalidade | Limite padrão | Ajustável? |
|---|---|---|---|
| Recursos do Azure | Número de instâncias de Gêmeos Digitais do Azure em uma região, por assinatura | 10 | Sim |
| Gêmeos Digitais | Número de gêmeos na instância de Gêmeos Digitais do Azure | 2.000.000 | Sim |
| Gêmeos Digitais | Número de gêmeos digitais que podem ser importados em um único trabalho da API de Importação de Trabalhos | 2.000.000 | Não |
| Gêmeos Digitais | Número de relações de entrada para um único gêmeo | 50.000 | Não |
| Gêmeos Digitais | Número de relações de saída de um único gêmeo | 50.000 | Não |
| Gêmeos Digitais | Número total de relações em uma instância dos Gêmeos Digitais do Azure | 20.000.000 | Sim |
| Gêmeos Digitais | Número de relacionamentos que podem ser importados em um único trabalho da API de Importação de Trabalhos | 10.000.000 | Não |
| Gêmeos Digitais | Tamanho máximo (do corpo JSON em uma solicitação PUT ou PATCH) de um único gêmeo | 32 KB | Não |
| Gêmeos Digitais | Tamanho máximo da solicitação de payload | 32 KB | Não |
| Gêmeos Digitais | Tamanho máximo de um valor de propriedade de cadeia de caracteres (UTF-8) | 4 KB | Não |
| Gêmeos Digitais | Tamanho máximo do nome de uma propriedade | 1 KB | Não |
| Roteamento | Número de pontos de extremidade para uma única instância de Gêmeos Digitais do Azure | 6 | Não |
| Roteamento | Número de rotas para uma única instância de Gêmeos Digitais do Azure | 6 | Sim |
| Modelos | Número de modelos em uma única instância de Gêmeos Digitais do Azure | 10.000 | Yes |
| Modelos | Número de modelos que podem ser importados em uma única chamada à API (sem usar a API de Importação de Trabalhos) | 250 | Não |
| Modelos | Número de modelos que podem ser importados em um único trabalho da API de Importação de Trabalhos | 10.000 | Não |
| Modelos | Tamanho máximo (do corpo JSON em uma solicitação PUT ou PATCH) de um único modelo | 1 MB | Não |
| Modelos | Número de itens retornados em uma única página | 100 | Não |
| Consulta | Número de itens retornados em uma única página | 1000 | Sim |
| Consulta | Número de AND / OR expressões em uma consulta |
50 | Sim |
| Consulta | Número de itens de matriz em uma IN / NOT IN cláusula |
50 | Sim |
| Consulta | Número de caracteres em uma consulta | 8,000 | Sim |
| Consulta | Número de JOINS em uma consulta |
5 | Sim |
Limites de taxa
A tabela a seguir reflete os limites de taxa de APIs diferentes.
| API | Funcionalidade | Limite padrão | Ajustável? |
|---|---|---|---|
| API de trabalhos | Número de solicitações por segundo | 1 | Sim |
| API de trabalhos | Número de trabalhos em massa em execução simultaneamente (incluindo importação e exclusão) | 1 | Sim |
| API de modelos | Número de solicitações por segundo | 100 | Sim |
| API dos Gêmeos Digitais | Número de solicitações de leitura por segundo | 1,000 | Sim |
| API dos Gêmeos Digitais | Número de solicitações de patch por segundo | 1,000 | Sim |
| API dos Gêmeos Digitais | Número de operações de criação/exclusão por segundo em todos os gêmeos e relações | 500 | Yes |
| API dos Gêmeos Digitais | Número de operações de criação/atualização/exclusão por segundo em um único gêmeo ou nas relações de entrada/saída | 10 | Não |
| API dos Gêmeos Digitais | Número de operações pendentes em um único gêmeo ou nas relações de entrada/saída | 500 | Não |
| API de Consulta | Número de solicitações por segundo | 500 | Yes |
| API de Consulta | Unidades de Consulta por segundo | 4.000 | Yes |
| API de rotas de eventos | Número de solicitações por segundo | 100 | Sim |
Outros limites
Os limites dos campos e tipos de dados nos documentos de DTDL para modelos de Gêmeos Digitais do Azure podem ser encontrados na documentação de especificações no GitHub: DTDL (Digital Twins Definition Language [Linguagem de Definição dos Gêmeos Digitais]) – versão 2.
Os detalhes da latência de consulta são descritos em Linguagem de consulta. As limitações de recursos específicos do idioma de consulta podem ser encontradas na documentação de referência da consulta.
Trabalhar com limites
Quando um limite é atingido, qualquer solicitação adicional é limitada pelo sistema, o que resultará em uma resposta de erro 429 para essas solicitações.
Para gerenciar isso, aqui estão algumas recomendações para trabalhar com limites.
- Usar lógica de repetição. Os SDKs dos Gêmeos Digitais do Azure implementam a lógica de repetição para solicitações com falha, portanto, se estiver trabalhando com um SDK fornecido, esta funcionalidade já estará inserida. Caso contrário, considere implementar a lógica de repetição em seu próprio aplicativo. O serviço envia de volta um cabeçalho
Retry-Afterna resposta de falha, que pode ser usado para determinar por quanto tempo aguardar antes de tentar novamente. - Use limites e notificações para avisar sobre os limites de abordagem. Alguns dos limites de serviço dos Gêmeos Digitais do Azure têm métricas correspondentes que podem ser usadas para controlar o uso nessas áreas. Para definir limites e configurar um alerta de aproximação do limite em qualquer métrica, confira as instruções em Criar uma nova regra de alerta. Para configurar notificações para outros limites em que as métricas não são fornecidas, considere implementar essa lógica em seu próprio código de aplicativo.
- Implantar em escala em várias instâncias. Evite ter um ponto único de falha. Em vez de um grafo grande para toda a implantação, considere separar subconjuntos de gêmeos de forma lógica (como por região ou locatário) em várias instâncias.
- Para obter recomendações de modelagem para ajudá-lo a operar dentro dos limites funcionais, consulte Ferramentas de modelagem e práticas recomendadas.
Observação
Os Gêmeos Digitais do Azure escalarão automaticamente os recursos para atender aos limites de taxa descritos neste artigo. Você pode enfrentar limitação antes que esses limites sejam atingidos, devido à escala interna para se adaptar à carga de entrada. A escala interna pode levar de 5 a 30 minutos e, nesse tempo, seu aplicativo pode encontrar 429 erros.
Próximas etapas
Saiba mais sobre a versão atual dos Gêmeos Digitais na visão geral do serviço: