Limites de serviço do Azure Digital Twins
As seções a seguir descrevem os limites de serviço dos Gêmeos Digitais do Azure.
Nota
Algumas áreas deste serviço têm limites ajustáveis. Isso é representado nas tabelas abaixo com a coluna Ajustável? . Quando o limite pode ser ajustado, o valor Ajustável? é Sim.
Se sua empresa precisar aumentar um limite ajustável ou cota acima do limite padrão, você poderá solicitar recursos adicionais abrindo um tíquete de suporte.
Limites por tipo
Limites funcionais
A tabela a seguir lista os limites funcionais dos Gêmeos Digitais do Azure.
| Área | Funcionalidade | Limite predefinido | Ajustável? |
|---|---|---|---|
| Recurso do Azure | Número de instâncias do Azure Digital Twins em uma região, por assinatura | 10 | Sim |
| Digital Twins | Número de gêmeos em uma instância do Azure Digital Twins | 2,000,000 | Sim |
| Digital Twins | Número de gêmeos digitais que podem ser importados em um único trabalho da API de Trabalhos de Importação | 2,000,000 | Não |
| Digital Twins | Número de relações recebidas para um único gêmeo | 50 000 | Não |
| Digital Twins | Número de relações de saída de um único gémeo | 50 000 | Não |
| Digital Twins | Número total de relações em uma instância do Azure Digital Twins | 20,000,000 | Sim |
| Digital Twins | Número de relações que podem ser importadas em um único trabalho da API de Trabalhos de Importação | 10,000,000 | Não |
| Digital Twins | Tamanho máximo (do corpo JSON em uma solicitação PUT ou PATCH) de um único gêmeo | 32 KB | Não |
| Digital Twins | Tamanho máximo da carga útil solicitada | 32 KB | Não |
| Digital Twins | Tamanho máximo de um valor de propriedade string (UTF-8) | 4 KB | Não |
| Digital Twins | Tamanho máximo do nome de uma propriedade | 1 KB | Não |
| Encaminhamento | Número de pontos de extremidade para uma única instância do Azure Digital Twins | 6 | Não |
| Encaminhamento | Número de rotas para uma única instância do Azure Digital Twins | 6 | Sim |
| Modelos | Número de modelos em uma única instância do Azure Digital Twins | 10.000 | Sim |
| Modelos | Número de modelos que podem ser importados em uma única chamada de API (não usando a API de Trabalhos de Importação) | 250 | Não |
| Modelos | Número de modelos que podem ser importados em um único trabalho da API de Trabalhos de Importação | 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 devolvidos numa única página | 100 | Não |
| Query | Número de itens devolvidos numa única página | 1000 | Sim |
| Query | Número de AND / OR expressões em uma consulta |
50 | Sim |
| Query | Número de itens de matriz em uma IN / NOT IN cláusula |
50 | Sim |
| Query | Número de caracteres em uma consulta | 8,000 | Sim |
| Query | Número de JOINS em uma consulta |
5 | Sim |
Limites de taxa
A tabela a seguir reflete os limites de taxa de diferentes APIs.
| API | Funcionalidade | Limite predefinido | Ajustável? |
|---|---|---|---|
| API de Trabalhos | Número de pedidos por segundo | 1 | Sim |
| API de Trabalhos | Número de trabalhos em massa executados simultaneamente (incluindo importação e exclusão) | 1 | Sim |
| API de modelos | Número de pedidos por segundo | 100 | Sim |
| API de gêmeos digitais | Número de pedidos de leitura por segundo | 1,000 | Sim |
| API de gêmeos digitais | Número de solicitações de patch por segundo | 1,000 | Sim |
| API de gêmeos digitais | Número de operações de criação/exclusão por segundo em todos os gêmeos e relacionamentos | 500 | Sim |
| API de gêmeos digitais | Número de operações de criação/atualização/exclusão por segundo em um único gêmeo ou suas relações de entrada/saída | 10 | Não |
| API de gêmeos digitais | Número de operações pendentes em um único gêmeo ou suas relações de entrada/saída | 500 | Não |
| API de Consulta | Número de pedidos por segundo | 500 | Sim |
| API de Consulta | Unidades de consulta por segundo | 4,000 | Sim |
| API de rotas de eventos | Número de pedidos por segundo | 100 | Sim |
Outros limites
Os limites de tipos de dados e campos em documentos DTDL para modelos de Gêmeos Digitais do Azure podem ser encontrados em sua documentação de especificações no GitHub: Digital Twins Definition Language (DTDL) - versão 2.
Os detalhes da latência da consulta são descritos em Linguagem de consulta. As limitações de recursos específicos da linguagem de consulta podem ser encontradas na documentação de referência da consulta.
Trabalhar com limites
Quando um limite é atingido, todas as solicitações além dele são limitadas pelo serviço, o que resultará em uma resposta de erro 429 dessas solicitações.
Para gerenciar a limitação, aqui estão algumas recomendações para trabalhar com limites.
- Use a lógica de repetição. Os SDKs do Azure Digital Twins implementam a lógica de repetição para solicitações com falha, portanto, se você estiver trabalhando com um SDK fornecido, essa funcionalidade já está interna. Caso contrário, considere implementar a lógica de repetição em seu próprio aplicativo. O serviço envia de volta um
Retry-Aftercabeçalho na resposta de falha, que você pode usar para determinar quanto tempo esperar antes de tentar novamente. - Use limites e notificações para avisar sobre a aproximação dos limites. Alguns dos limites de serviço para Gêmeos Digitais do Azure têm métricas correspondentes que podem ser usadas para rastrear o uso nessas áreas. Para configurar limites e configurar um alerta em qualquer métrica quando um limite é aproximado, consulte 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.
- Implante em escala em várias instâncias. Evite ter um único ponto de falha. Em vez de um gráfico grande para toda a implantação, considere separar subconjuntos de gêmeos logicamente (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.
Nota
Os Gêmeos Digitais do Azure dimensionarã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 ao dimensionamento interno para se adaptar à carga de entrada. O dimensionamento interno pode levar de 5 a 30 minutos, período durante o qual seu aplicativo pode encontrar 429 erros.
Próximos passos
Saiba mais sobre a versão atual dos Gêmeos Digitais do Azure na visão geral do serviço:
- What is Azure Digital Twins? (O que é o Azure Digital Twins?)