翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Textract でのデフォルトのクォータの変更
コンソールアカウントには、Amazon Textract オペレーションのデフォルトのクォータがあります。これらは、変更できるリージョン固有のクォータのセットです。デフォルトのクォータは、Service Quotas コンソールで表示または変更できます。Amazon Textract エンドポイントとサービスクォータで現在の Amazon Textract デフォルトクォータを表示することもできます。
クォータのタイプ
Amazon Textract には 2 種類のクォータがあります。
-
トランザクション/秒 (TPS) (同期および非同期)
-
同時ジョブ (非同期のみ)
-
アダプター
TPS
TPS クォータは、Textract が新しいドキュメントを処理するようにリクエストできる頻度を決定します。TPS クォータは、API、同期または非同期オペレーション、リージョンに固有です。
同期 TPS
同期オペレーションは、単一ページのドキュメントを処理し、AnalyzeDocument、DetectDocumentText、AnalyzeExpense、AnalyzeID などの Textract のほぼリアルタイムのレスポンスを受信するために使用されます。詳細については、「ドキュメントの同期処理」を参照してください。
次の同期 APIs の場合、1 秒あたりの最大トランザクション数 (TPS) は、特定のリージョンでアカウントで実行できるトランザクション (API コール) の最大数を表します。
-
AnalyzeDocument
-
DetectDocumentText
-
AnalyzeExpense
-
AnalyzeID
非同期 TPS
Amazon Textract は、複数ページの大規模なドキュメントを処理するための非リアルタイム非同期オペレーションを提供します。非同期処理オペレーションには、開始オペレーションと取得オペレーションの 2 種類があります。開始オペレーションは Textract がドキュメントを処理するようにリクエストするために使用されますが、取得オペレーションはドキュメント処理のステータスと結果を取得するために使用されます。開始オペレーションと取得オペレーションの両方のクォータは TPS で測定されます。非同期処理の詳細については、「」を参照してくださいドキュメントの非同期処理。
次の場合、APIs の開始と取得、1 秒あたりの最大トランザクション数 (TPS) は、特定のリージョンでアカウントで実行できるトランザクション (API コール) の最大数を表します。
Start
-
StartDocumentAnalysis
-
StartDocumentTextDetection
-
StartExpenseAnalysis
Get
-
GetDocumentAnalysis
-
GetDocumentTextDetection
-
GetExpenseAnalysis
同時ジョブ
同時ジョブ制限は、一度に並行して実行できるジョブの数を定義します。同時ジョブの制限は非同期オペレーションにのみ適用され、個々のオペレーションに固有です。
次の APIs には、アカウントが特定のリージョンで作成できる同時ジョブの最大数を定義するクォータがあります。
-
AnalyzeDocument
-
DetectDocumentText
-
DetectDocumentExpense
アダプター
Adapter Quotas は、アダプタートレーニングの以下の制限を定義します。サービスクォータの引き上げをリクエストするときは、Service Quotas のコンソールを使用します。
アダプターの最大数 - 許可されるアダプターの合計数。1 つのアダプターに複数のアダプターバージョンを含めることができます。
1 か月あたりに作成された AdapterVersions の最大数 - AWS アカウントごとに 1 か月あたりに作成できる成功したアダプターバージョンの数。これは毎月の初めにリセットされます。
アカウントあたりの最大進行中 AdapterVersions (アダプタートレーニングに類似)。
クォータの引き上げを計算する
Amazon Textract には、クォータのニーズを見積もるための製品固有の Service Quotas Calculator
Textract Service Quotas 計算ツールを使用するには
リージョンの選択
アカウントのリージョンを選択する
サービス計算ツールは任意のリージョンのクォータを見積もることができ、異なるリージョンのデフォルトクォータは異なります。そのため、アカウントのリージョンを計算対象のリージョンと必ず一致させてください。別のリージョンのクォータを計算する場合は、まずコンソールでアカウントのリージョンを変更します。
処理タイプ
同期または非同期を選択します。
同期オペレーションと非同期オペレーションには、Amazon Textract で異なる制限があります。最も使用するオペレーションのタイプを決定し、そのオペレーションタイプを計算対象として選択します。通常、同期オペレーションは単一ページのドキュメント処理に使用されます。非同期処理は複数ページのドキュメントを対象とします。
たとえば、ユースケースが単一ページの顧客受信を処理している場合は、同期を選択します。
ユースケースタイプ
ユースケースに最適なオペレーションを選択します。
オペレーションごとに異なる種類のデータが抽出されるため、ユースケースに最も適したオペレーションを選択します。さまざまなオペレーションによって抽出されるデータの詳細については、「」を参照してくださいAmazon Textract ユースケースの特定。
たとえば、ユースケースが主に領収書の処理に関連している場合は、オペレーションのリストから経費分析を選択します。
使用値
使用量の値を指定します。
要件を決定するときは、オペレーションのタイプに注意してください。同期オペレーションでは、特定の期間に処理するページの最大数を時間または日単位で指定します。
注記
非同期オペレーションでは、処理に必要な予想時間数と、処理されたドキュメントの平均ページ数を入力することもできます。
たとえば、1 日あたり平均 100 万件の受信を処理する場合、処理するドキュメントタブに 1,000,000 と入力して、必要なクォータ値を見積もります。
結果を確認する
計算ツールページのステップ 3 を確認し、計算ツールの出力を確認します。計算ツールは現在のクォータ情報を取得し、ユースケースに必要なクォータと比較します。これにより、現在のクォータが処理ニーズに対して低すぎるかどうかがわかります。このような場合は、計算ツールが提供するリンクをクリックできます。このリンクをクリックすると、Service Quotas で選択したリージョンで推定したオペレーションのクォータ引き上げリクエストに直接リンクされます。
注記
非同期に対して計算する場合、複数のクォータが推定されます。引き上げが必要な場合は、各クォータのリンクをクリックして、各クォータの引き上げをリクエストする必要があります。
これらのステップの例では、1 日あたり 100 万件の受信をすべて処理するには、TPS が 12 である必要があります。そのため、デフォルトの TPS である 5 からの引き上げをリクエストする必要があります。
Service Quota Increase リクエストのベストプラクティス
デフォルトのクォータの引き上げをリクエストする場合、いくつかのベストプラクティスに従うことをお勧めします。これには、スムーズなスパイクトラフィック、再試行の設定、エクスポネンシャルバックオフとジッターの設定が含まれます。
-
Textract Service Quota Calculator を使用して、最適なクォータ値を見積もります。
-
スパイクトラフィックのスムーズ化。スパイキートラフィックはスループットに影響します。割り当てられたトランザクション/秒 (TPS) の最大スループットを得るには、キューイングサーバーレスアーキテクチャまたは別のメカニズムを使用してトラフィックを「スムーズ」し、一貫性を保ちます。
-
再試行を設定します。「エラー処理」のガイドラインに従って、エラーを許可するエラーの再試行を設定します。
-
エクスポネンシャルバックオフとジッターの設定 再試行用にエクスポネンシャルバックオフとジッターを設定することで、スループットを向上させることができます。「AWS でのエラーの再試行とエクスポネンシャルバックオフ」を参照してください。
-
CDK コンストラクトを使用した IDP CDK サンプル
など、ベストプラクティスを適用するサンプルから始めます。 https://github.com/aws-samples/amazon-textract-idp-cdk-constructs
デフォルトのクォータを変更する
計算ツールから直接リクエストを発行する代わりに、Service Quotas コンソールを使用することもできます。これは Service Quotas コンソール
サービスクォータの引き上げリクエストを行うには
マネジメントコンソールにログインし、サービスクォータコンソール
に移動し、サービスで「抽出」を選択します。 目的のクォータを選択し、次のページで「クォータの引き上げをリクエスト」をクリックします。
目的のクォータ値を入力し、「Request」をクリックします。Service Quotas Calculator を使用した場合は、クォータ値を計算からリクエストにコピーできます。
クォータの引き上げをリクエストしたら、ページを更新してクォータステータスの更新を確認します。
注記
クォータ値の増加によっては、手動によるレビューが必要になる場合があります。
クォータ変更の効果
次の表に、さまざまなタイプのクォータと、クォータを変更する効果を示します。
| 引き上げるクォータ値 | 増加の影響 |
|---|---|
|
同期オペレーション TPS |
1 秒あたりのトランザクション数で測定される特定の同期オペレーションを使用して、Textract が新しいドキュメントを処理するようにリクエストできる頻度を増やします。 |
|
非同期開始オペレーション TPS |
Textract が入力ドキュメントの非同期処理を開始するようにリクエストできる頻度を増やします。これは 1 秒あたりのトランザクション数で測定されます。 |
|
非同期取得オペレーション TPS |
Textract が特定の非同期分析ジョブの結果を返すようにリクエストできる頻度を増やし、1 秒あたりのトランザクション数で測定します。 |
|
非同期同時ジョブ |
並列処理できるドキュメントの合計数を増やします。 |