Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Modifica delle quote predefinite in Amazon Textract
L'account della tua console ha quote predefinite per le operazioni di Amazon Textract. Si tratta di un insieme di Region-specific quote che puoi modificare. Le quote predefinite possono essere visualizzate o modificate tramite la console Service Quotas. Puoi anche visualizzare le quote predefinite correnti di Amazon Textract sugli endpoint Amazon Textract e sulle quote di servizio.
Tipi di quote
Esistono due tipi di quote per Amazon Textract.
-
Transazioni al secondo (TPS) (sincrone e asincrono)
-
Lavori simultanei (solo asincroni)
-
Adattatori
TPS
Le quote TPS determinano la frequenza con cui puoi richiedere che Textract elabori un nuovo documento. Le quote TPS sono uniche per l'API, le operazioni sincrone o asincrone e la regione.
TPS sincrono
Le operazioni sincrone vengono utilizzate per elaborare documenti a pagina singola e ricevere risposte quasi in tempo reale per Textract includono AnalyzeDocument DetectDocumentText, AnalyzeExpense e AnalyzeID. Per ulteriori informazioni, consulta Elaborazione sincrona dei documenti.
Per le seguenti API sincrone, Maximum Transactions Per Second (TPS) descrive il numero massimo di transazioni (chiamate API) che puoi eseguire con il tuo account in una determinata regione:
-
AnalyzeDocument
-
DetectDocumentText
-
AnalyzeExpense
-
ID analizzato
TPS asincrono
Amazon Textract fornisce operazioni asincrone non in tempo reale per l'elaborazione di documenti multipagina di grandi dimensioni. Esistono due tipi di operazioni di elaborazione asincrona: operazioni Start e operazioni Get. Le operazioni di avvio vengono utilizzate per richiedere che Textract elabori un documento, mentre le operazioni Get vengono utilizzate per ottenere lo stato e i risultati dell'elaborazione del documento. Le quote per le operazioni Start e Get vengono misurate in TPS. Per ulteriori informazioni sull'elaborazione asincrona, vedere. Elaborazione asincrona dei documenti
Per quanto segue, Start and Get API, Maximum Transactions Per Second (TPS) descrive il numero massimo di transazioni (chiamate API) che è possibile eseguire con il proprio account in una determinata regione:
Start (Avvio)
-
StartDocumentAnalysis
-
StartDocumentTextDetection
-
StartExpenseAnalysis
Get
-
GetDocumentAnalysis
-
GetDocumentTextDetection
-
GetExpenseAnalysis
Lavori simultanei
Il limite dei lavori simultanei definisce quanti lavori possono essere eseguiti in parallelo in un dato momento. I limiti Concurrent Job si applicano solo alle operazioni asincrone e sono unici per le singole operazioni.
Le seguenti API hanno quote che definiscono il numero massimo di lavori simultanei che l'account può creare in una determinata regione:
-
AnalyzeDocument
-
DetectDocumentText
-
DetectDocumentExpense
Adattatori
Le quote degli adattatori definiscono i seguenti limiti per l'addestramento degli adattatori. Utilizza la console Service Quotas per inviare una richiesta di aumento della quota di servizio.
Numero massimo di adattatori: numero totale di adattatori consentito. È possibile avere diverse versioni di adattatori in un unico adattatore
Numero massimo di adattatori AdapterVersions creati al mese: numero di versioni di adattatori di successo che possono essere create per account AWS al mese. Questo valore verrà ripristinato all'inizio di ogni mese.
Numero massimo di corsi in corso AdapterVersions (analogo alla formazione per adattatori) per account.
Calcola l'aumento della quota
Amazon Textract dispone di un Service Quotas Calculator specifico per prodotto per stimare il fabbisogno di quote
Per utilizzare il Textract Service Quotas Calculator
Selezione delle regioni
Seleziona la regione del tuo account
Il calcolatore del servizio può stimare le quote in qualsiasi regione e aree diverse hanno quote predefinite diverse. Pertanto, assicurati di abbinare la regione del tuo account alla regione per cui stai effettuando il calcolo. Se desideri calcolare una quota per un'altra regione, modifica prima la regione dell'account nella console.
Tipo di elaborazione
Seleziona Sincrono o Asincrono.
Le operazioni sincrone e asincrone hanno limiti diversi in Amazon Textract. Determina il tipo di operazione che intendi utilizzare di più e seleziona quel tipo di operazione per i calcoli. In genere, le operazioni sincrone vengono utilizzate per l'elaborazione di documenti a pagina singola, mentre l'elaborazione asincrona riguarda documenti composti da più pagine.
Ad esempio, se il tuo caso d'uso è l'elaborazione delle ricevute dei clienti a pagina singola, selezionerai Synchronous
Tipo di caso d'uso
Seleziona l'operazione più adatta al tuo caso d'uso.
Operazioni diverse estraggono diversi tipi di dati, quindi seleziona l'operazione più adatta al tuo caso d'uso. Per ulteriori informazioni sui dati estratti da diverse operazioni, vedereIdentificazione del caso d'uso di Amazon Textract.
Ad esempio, se il tuo caso d'uso è principalmente correlato all'elaborazione delle ricevute, selezionerai Expense Analysis dall'elenco delle operazioni.
Valori di utilizzo
Specificate i valori di utilizzo.
Quando stabilisci i requisiti, tieni presente il tipo di operazione. Per le operazioni sincrone, specificate il numero massimo di pagine da elaborare in un determinato periodo di tempo, in ore o giorni.
Nota
Per le operazioni asincrone, puoi anche inserire il numero previsto di ore di elaborazione necessarie per l'elaborazione e il numero medio di pagine nei documenti elaborati.
Ad esempio, se elabori una media di un milione di ricevute al giorno, inserirai 1.000.000 nella scheda Documenti da elaborare per stimare il valore della quota necessaria.
Rivedi i risultati
Controlla il passaggio 3 della pagina della calcolatrice ed esamina l'output della calcolatrice. La calcolatrice estrae le informazioni sulle quote correnti e le confronta con le quote richieste per il tuo caso d'uso. Questo ti dirà se le tue quote attuali sono troppo basse per le tue esigenze di elaborazione. In tal caso, puoi fare clic sul collegamento fornito dal calcolatore che ti collegherà direttamente a una richiesta di aumento della quota per l'operazione stimata nella regione selezionata in Quote di servizio.
Nota
Se esegui il calcolo in modo asincrono, vedrai una stima di più quote. Dovrai fare clic sul link relativo a ciascuna quota per richiedere un aumento per ognuna, se necessario.
Seguendo il nostro esempio in tutti questi passaggi, avresti bisogno di un TPS di 12 per elaborare tutto il milione di ricevute in un giorno. Pertanto, dovrai richiedere un aumento rispetto al TPS predefinito di 5.
Le migliori pratiche per le richieste di aumento delle quote di servizio
Quando si richiede un aumento a una quota predefinita, ci sono diverse best practice consigliate da seguire. Queste includono la fluidità del traffico con picchi di traffico, la configurazione di nuovi tentativi e la configurazione di backoff e jitter esponenziali.
-
Stima i valori di quota ottimali utilizzando il Textract Service Quota Calculator.
-
Attenuazione del traffico con picchi di traffico. Il traffico intenso influisce sulla velocità di throughput. Per ottenere il massimo throughput per le transazioni assegnate al secondo (TPS), utilizza un'architettura serverless di accodamento o un altro meccanismo per «fluidificare» il traffico in modo che sia più coerente.
-
Configura nuovi tentativi. Segui le linee guida riportate in Gestione degli errori per configurare i nuovi tentativi in base agli errori che li consentono
-
Configurazione backoff esponenziale e jitter. Configurando il backoff e il jitter esponenziali per i nuovi tentativi, puoi migliorare la velocità effettiva. Vedi Tentativi di errore e backoff esponenziale in AWS.
-
Inizia con esempi che applicano le migliori pratiche, come gli IDP CDK Samples che utilizzano CDK
Constructs.
Modifica la quota predefinita
In alternativa alla richiesta direttamente dalla calcolatrice, puoi anche utilizzare la console Service Quotas. Questa operazione può essere eseguita dalla console Service Quotas
Per aumentare una richiesta di aumento della quota di servizio
Accedi a Management Console e vai alla console Service Quotas
e seleziona «Textract» nella sezione servizi Seleziona la quota desiderata e fai clic su «Richiedi aumento della quota» nella pagina successiva
Inserisci il valore di quota desiderato e fai clic su «Richiedi». Se hai utilizzato il Service Quotas Calculator, puoi copiare il valore della quota dai tuoi calcoli nella richiesta.
Dopo aver richiesto un aumento della quota, aggiorna la pagina per visualizzare l'aggiornamento dello stato della quota.
Nota
Alcuni aumenti dei valori delle quote potrebbero richiedere una revisione manuale.
Effetti di modifica delle quote
La tabella seguente elenca i diversi tipi di quote e gli effetti che avrà la loro modifica.
| Valore della quota da aumentare | Effetto dell'aumento |
|---|---|
|
Funzionamento sincrono TPS |
Aumenta la frequenza con cui puoi richiedere che Textract elabori un nuovo documento utilizzando una determinata operazione sincrona, misurata in transazioni al secondo |
|
Operazione di avvio asincrona (TPS) |
Aumenta la frequenza con cui puoi richiedere che Textract inizi l'elaborazione asincrona di un documento di input, misurata in transazioni al secondo |
|
Operazione Get asincrona (TPS) |
Aumenta la frequenza con cui puoi richiedere che Textract restituisca i risultati di un determinato processo di analisi asincrono, misurato in transazioni al secondo |
|
Lavori simultanei asincroni |
Aumenta il numero totale di documenti che è possibile elaborare in parallelo. |
