Limiti del servizio Gemelli digitali di Azure
Le sezioni seguenti descrivono i limiti del servizio 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 API di importazione processi | 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 è possibile importare in un singolo processo API di importazione processi | 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 di importazione processi) | 250 | No |
| Modelli | Numero di modelli che possono essere importati in un singolo processo API di importazione processi | 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 espressioni AND / OR in una query |
50 | Sì |
| Query | Numero di elementi di matrice in una clausola IN / NOT IN |
50 | Sì |
| Query | Numero di caratteri in un a 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ì |
| API di modelli | Numero di richieste al secondo | 100 | Sì |
| API di Gemelli digitali | Numero di richieste di lettura al secondo | 1.000 | Sì |
| API di Gemelli digitali | Numero di richieste di patch al secondo | 1.000 | 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 di 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 in linguaggio di query. Le limitazioni di particolari funzionalità del linguaggio di query sono disponibili nella documentazione di riferimento delle query.
Uso 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-Afternella 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 guasto. 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: