Limiti del servizio Gemelli digitali di Azure

  • Articolo

Le sezioni seguenti descrivono i limiti del servizio di Gemelli digitali di Azure.

Nota

Alcune aree di questo servizio hanno limiti regolabili. Questa operazione è rappresentata nelle tabelle seguenti con la colonna Regolabile? Quando è possibile regolare il limite, il valore Regolabile? è Sì.

Se l'azienda richiede un aumento di un limite o una quota regolabile al di sopra del limite predefinito, è possibile richiedere risorse aggiuntive aprendo un ticket di supporto.

Limiti per tipo

Limiti funzionali

La tabella seguente elenca i limiti funzionali di Gemelli digitali di Azure.

Area Funzionalità Limite predefinito Rettificabile?
Risorsa di Azure Numero di istanze di Gemelli digitali di Azure in un'area, per sottoscrizione 10 Sì
Gemelli digitali Numero di gemelli in un'istanza di Gemelli digitali di Azure 2,000,000 Sì
Gemelli digitali Numero di gemelli digitali che possono essere importati in un singolo processo dell'API Dei processi di importazione 2,000,000 No
Gemelli digitali Numero di relazioni in ingresso a un singolo gemello 50,000 No
Gemelli digitali Numero di relazioni in uscita da un singolo gemello 50,000 No
Gemelli digitali Numero totale di relazioni in un'istanza di Gemelli digitali di Azure 20,000,000 Sì
Gemelli digitali Numero di relazioni che possono essere importate in un singolo processo dell'API Processi di importazione 10,000,000 No
Gemelli digitali Dimensione massima (del corpo JSON in una richiesta PUT o PATCH) di un singolo gemello 32 KB No
Gemelli digitali Dimensioni massime del payload della richiesta 32 KB No
Gemelli digitali Dimensioni massime di un valore della proprietà stringa (UTF-8) 4 KB No
Gemelli digitali Dimensioni massime di un nome di proprietà 1 KB No
Definizione dei percorsi di trasferimento Numero di endpoint per una singola istanza di Gemelli digitali di Azure 6 No
Definizione dei percorsi di trasferimento Numero di route per una singola istanza di Gemelli digitali di Azure 6 Sì
Modelli Numero di modelli all'interno di una singola istanza di Gemelli digitali di Azure 10,000 Sì
Modelli Numero di modelli che possono essere importati in una singola chiamata API (non usando l'API Importa processi) 250 No
Modelli Numero di modelli che possono essere importati in un singolo processo dell'API Import Jobs 10,000 No
Modelli Dimensione massima (del corpo JSON in una richiesta PUT o PATCH) di un singolo modello 1 MB No
Modelli Numero di elementi restituiti in una singola pagina 100 No
Query Numero di elementi restituiti in una singola pagina 1000 Sì
Query Numero di AND / OR espressioni in una query 50 Sì
Query Numero di elementi di matrice in una IN / NOT IN clausola 50 Sì
Query Numero di caratteri in una query 8.000 Sì
Query Numero di JOINS in una query 5 Sì

Limiti di richieste inviate al bot

La tabella seguente riflette i limiti di frequenza di API diverse.

API Funzionalità Limite predefinito Rettificabile?
API per processi Numero di richieste al secondo 1 Sì
API per processi Numero di processi in blocco in esecuzione simultanea (inclusi l'importazione e l'eliminazione) 1 Sì
Models API Numero di richieste al secondo 100 Sì
API di Gemelli digitali Numero di richieste di lettura al secondo 1000 Sì
API di Gemelli digitali Numero di richieste di patch al secondo 1000 Sì
API di Gemelli digitali Numero di operazioni di creazione/eliminazione al secondo tra tutti i gemelli e le relazioni 500 Sì
API di Gemelli digitali Numero di operazioni di creazione/aggiornamento/eliminazione al secondo in un singolo gemello o nelle relazioni in ingresso/in uscita 10 No
API di Gemelli digitali Numero di operazioni in sospeso su un singolo gemello o sulle relazioni in ingresso/in uscita 500 No
API di query Numero di richieste al secondo 500 Sì
API di query Unità di query al secondo 4.000 Sì
API Route eventi Numero di richieste al secondo 100 Sì

Altri limiti

I limiti per i tipi di dati e i campi all'interno dei documenti DTDL per i modelli di Gemelli digitali di Azure sono disponibili nella documentazione specifica in GitHub: Digital Twins Definition Language (DTDL) - versione 2.

I dettagli della latenza delle query sono descritti nel linguaggio di query. Le limitazioni di particolari funzionalità del linguaggio di query sono disponibili nella documentazione di riferimento sulle query.

Utilizzo dei limiti

Quando viene raggiunto un limite, tutte le richieste successive vengono limitate dal servizio, che genererà una risposta di errore 429 da queste richieste.

Per gestire la limitazione, ecco alcuni consigli per l'uso dei limiti.

  • Usare la logica di ripetizione dei tentativi. Gli SDK di Gemelli digitali di Azure implementano la logica di ripetizione dei tentativi per le richieste non riuscite, quindi se si usa un SDK fornito, questa funzionalità è già incorporata. In caso contrario, prendere in considerazione l'implementazione della logica di ripetizione dei tentativi nella propria applicazione. Il servizio restituisce un'intestazione Retry-After nella risposta di errore, che è possibile usare per determinare il tempo di attesa prima di riprovare.
  • Usare soglie e notifiche per avvisare sull'avvicinamento dei limiti. Alcuni dei limiti del servizio per Gemelli digitali di Azure hanno metriche corrispondenti che possono essere usate per tenere traccia dell'utilizzo in queste aree. Per configurare le soglie e configurare un avviso per qualsiasi metrica quando si avvicina una soglia, vedere le istruzioni in Creare una nuova regola di avviso. Per configurare le notifiche per altri limiti in cui le metriche non vengono fornite, valutare la possibilità di implementare questa logica nel codice dell'applicazione.
  • Distribuire su larga scala tra più istanze. Evitare di avere un singolo punto di errore. Invece di un grafico di grandi dimensioni per l'intera distribuzione, è consigliabile suddividere in più istanze sottoinsiemi di gemelli in modo logico, ad esempio in base all'area o al tenant.
  • Per indicazioni sulla modellazione che consentono di operare entro i limiti funzionali, vedere Strumenti di modellazione e procedure consigliate.

Nota

Gemelli digitali di Azure ridimensiona automaticamente le risorse per soddisfare i limiti di velocità descritti in questo articolo. È possibile che si verifichi una limitazione prima che questi limiti vengano raggiunti a causa del ridimensionamento interno per adattarsi al carico in ingresso. Il ridimensionamento interno può richiedere da 5 a 30 minuti, durante il quale l'applicazione può riscontrare errori 429.

Passaggi successivi

Altre informazioni sulla versione corrente di Gemelli digitali di Azure sono disponibili nella panoramica del servizio: