Limites de serviço do Azure Digital Twins

  • Artigo

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-After cabeç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: