View a markdown version of this page

Amazon Textract의 기본 할당량 수정 - Amazon Textract
할당량 유형할당량 증가 계산서비스 할당량 증가 요청 모범 사례기본 할당량 변경할당량 수정 효과

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Textract의 기본 할당량 수정

콘솔 계정에는 Amazon Textract 작업에 대한 기본 할당량이 있습니다. 다음은 수정할 수 있는 리전별 할당량 세트입니다. 기본 할당량은 Service Quotas 콘솔을 통해 보거나 변경할 수 있습니다. Amazon Textract 엔드포인트 및 서비스 할당량에서 현재 Amazon Textract 기본 할당량을 볼 수도 있습니다.

할당량 유형

Amazon Textract에는 두 가지 유형의 할당량이 있습니다.

  • 초당 트랜잭션 수(TPS)(동기식 및 비동기식)

  • 동시 작업(비동기식만 해당)

  • 어댑터

TPS

TPS 할당량에 따라 Textract가 새 문서를 처리하도록 요청할 수 있는 빈도가 결정됩니다. TPS 할당량은 API, 동기 또는 비동기 작업 및 리전에 고유합니다.

동기 TPS

동기 작업은 단일 페이지 문서를 처리하고 AnalyzeDocument, DetectDocumentText, AnalyzeExpense, AnalyzeID 등 Textract에 대한 실시간에 가까운 응답을 수신하는 데 사용됩니다. 자세한 내용은 문서를 동기식으로 처리 단원을 참조하십시오.

다음 동기 APIs의 경우 초당 최대 트랜잭션 수(TPS)는 지정된 리전에서 계정으로 수행할 수 있는 최대 트랜잭션 수(API 호출)를 설명합니다.

  • AnalyzeDocument

  • DetectDocumentText

  • AnalyzeExpense

  • AnalyzeID

비동기 TPS

Amazon Textract는 더 큰 다중 페이지 문서를 처리하기 위한 비실시간 비동기 작업을 제공합니다. 비동기 처리 작업에는 시작 작업과 가져오기 작업의 두 가지 유형이 있습니다. 시작 작업은 Textract가 문서를 처리하도록 요청하는 데 사용되고 가져오기 작업은 문서 처리의 상태 및 결과를 가져오는 데 사용됩니다. 시작 및 가져오기 작업의 할당량은 TPS로 측정됩니다. 비동기 처리에 대한 자세한 내용은 섹션을 참조하세요비동기식으로 문서 처리.

API 시작 및 가져오기 APIs, 초당 최대 트랜잭션 수(TPS)는 지정된 리전에서 계정으로 수행할 수 있는 최대 트랜잭션 수(API 호출)를 설명합니다.

시작

  • StartDocumentAnalysis

  • StartDocumentTextDetection

  • StartExpenseAnalysis

Get

  • GetDocumentAnalysis

  • GetDocumentTextDetection

  • GetExpenseAnalysis

동시 작업

동시 작업 제한은 지정된 시간에 병렬로 실행할 수 있는 작업 수를 정의합니다. 동시 작업 제한은 비동기 작업에만 적용되며 개별 작업에 고유합니다.

다음 APIs에는 계정에서 지정된 리전에 생성할 수 있는 최대 동시 작업 수를 정의하는 할당량이 있습니다.

  • AnalyzeDocument

  • DetectDocumentText

  • DetectDocumentExpense

어댑터

어댑터 할당량은 어댑터 훈련에 대한 다음 제한을 정의합니다. 할당량 증가를 요청하려면 Service Quotas 콘솔을 사용하세요.

  • 최대 어댑터 수 - 허용되는 총 어댑터 수입니다. 단일 어댑터에서 여러 어댑터 버전을 사용할 수 있습니다.

  • 매월 생성된 최대 AdapterVersions - 매월 AWS 계정당 생성할 수 있는 성공한 어댑터 버전 수입니다. 매월 초에 재설정됩니다.

  • 계정당 진행 중인 최대 AdapterVersions(어댑터 훈련과 유사).

할당량 증가 계산

Amazon Textract에는 할당량 요구 사항을 추정할 수 있는 제품별 Service Quotas Calculator가 있습니다. Textract Service Quotas Calculator를 사용하여 사용 사례를 충족하는 할당량 값을 추정할 수 있습니다. Amazon Textract 콘솔에서 액세스할 수 있습니다. 이 섹션에서는 할당량 계산기를 사용하여 필요에 맞게 할당량을 계산하는 프로세스를 간략하게 설명합니다.

Textract Service Quotas 계산기를 사용하려면

  1. 리전 선택

    AWS 리전 '미국 동부(버지니아 북부)'가 선택된 드롭다운 메뉴와 할당량 요구 사항이 지정된 리전에 대한 예측임을 설명하는 정보입니다.

    계정의 리전 선택

    서비스 계산기는 모든 리전의 할당량을 추정할 수 있으며, 리전마다 기본 할당량이 다릅니다. 따라서 계정의 리전을 계산하려는 리전과 일치해야 합니다. 다른 리전에 대한 할당량을 계산하려면 먼저 콘솔에서 계정의 리전을 변경합니다.

  2. 처리 유형

    동기식 API 작업을 사용하여 문서를 처리하는 옵션으로, 단일 페이지 문서에 거의 실시간으로 적합하거나 대규모 다중 페이지 문서의 비동기식 작업에 적합합니다.

    동기 또는 비동기를 선택합니다.

    동기식 작업과 비동기식 작업의 제한은 Amazon Textract에서 서로 다릅니다. 가장 많이 사용하려는 작업 유형을 결정하고 계산을 위해 해당 작업 유형을 선택합니다. 일반적으로 동기식 작업은 비동기식 처리가 여러 페이지 문서를 포함하는 단일 페이지 문서 처리에 사용됩니다.

    예를 들어 사용 사례가 단일 페이지 고객 영수증을 처리하는 경우 동기식

  3. 사용 사례 유형

    다양한 사용 사례와 관련된 요구 사항 할당량을 예측하는 옵션이 있는 "사용 사례 유형 선택"에 대한 드롭다운 선택입니다.

    사용 사례에 가장 적합한 작업을 선택합니다.

    작업마다 다양한 종류의 데이터를 추출하므로 사용 사례에 가장 적합한 작업을 선택합니다. 다양한 작업에서 추출한 데이터에 대한 자세한 내용은 섹션을 참조하세요Amazon Textract 사용 사례 식별.

    예를 들어 사용 사례가 주로 영수증 처리와 관련된 경우 작업 목록에서 비용 분석을 선택합니다.

  4. 사용량 값

    일일 또는 시간당 처리할 최대 문서 수와 문서당 최대 페이지 수를 입력하는 필드를 보여주는 인터페이스로, 동기 API 작업은 단일 페이지 문서 전용이라는 점에 유의하세요.

    사용 값을 지정합니다.

    요구 사항을 결정할 때는 작업 유형이 맞는지 여부를 염두에 두세요. 동기식 작업의 경우 지정된 기간 동안 처리할 최대 페이지 수를 시간 또는 일수로 지정합니다.

    참고

    비동기 작업의 경우 처리에 필요한 예상 시간과 처리된 문서의 평균 페이지 수를 입력할 수도 있습니다.

    예를 들어 하루에 평균 백만 개의 영수증을 처리하는 경우 처리할 문서 탭에 1,000,000을 입력하여 필요한 할당량 값을 추정합니다.

  5. 결과 검토

    AnalyzeExpense 할당량을 보여주는 서비스 할당량 값 표시에는 12가 필요하지만 현재 값은 5로, 할당량 증가가 필요함을 나타냅니다.

    계산기 페이지의 3단계를 확인하고 계산기의 출력을 검토합니다. 계산기는 현재 할당량 정보를 가져와 사용 사례에 필요한 할당량과 비교합니다. 이렇게 하면 현재 할당량이 처리 요구 사항에 비해 너무 낮은지 알 수 있습니다. 이 경우 계산기에서 제공하는 링크를 클릭하면 서비스 할당량에서 선택한 리전에서 예상한 작업에 대한 할당량 증가 요청에 직접 연결됩니다.

    참고

    비동기식으로 계산하는 경우 예상 할당량이 여러 개 표시됩니다. 증가가 필요한 경우 각 할당량에 대한 링크를 클릭하여 각 할당량에 대한 증가를 요청해야 합니다.

    이 단계의 예제에 따라 하루에 백만 개의 영수증을 모두 처리하려면 TPS가 12여야 합니다. 따라서 기본 TPS인 5에서 증가를 요청해야 합니다.

서비스 할당량 증가 요청 모범 사례

기본 할당량 증가를 요청할 때 따라야 할 몇 가지 권장 모범 사례가 있습니다. 여기에는 부드러운 급증하는 트래픽, 재시도 구성, 지수 백오프 및 지터 구성이 포함됩니다.

  • Textract Service Quota 계산기를 사용하여 최적의 할당량 값을 추정합니다.

  • 급증하는 트래픽을 완화합니다. 급증하는 트래픽은 처리량에 영향을 줍니다. 할당된 초당 트랜잭션(TPS)에서 처리량을 극대화하려면 큐잉 서버리스 아키텍처 또는 다른 메커니즘을 사용하여 트래픽이 더 고르도록 ‘평탄화’하세요.

  • 재시도를 구성합니다. 오류 처리의 지침에 따라 재시도를 허용하는 오류에 대한 재시도를 구성합니다.

  • 지수 백오프 및 지터를 구성하세요. 재시도에 대한 지수 백오프 및 지터를 구성하면 처리량을 개선할 수 있습니다. AWS에서 오류 재시도 및 지수 백오프를 참조하세요.

  • 먼저 CDK Constructs를 사용하는 IDP CDK 샘플과 같은 모범 사례를 적용하는 샘플로 시작합니다.

기본 할당량 변경

계산기에서 직접 요청을 제기하는 대신 서비스 할당량 콘솔을 사용할 수도 있습니다. 이는 서비스 할당량 콘솔에서 수행할 수 있으며 자동으로 처리될 수 있습니다. 특히 대규모 증가와 같은 일부 상황에서는 요청이 수동으로 처리되며 추가 정보가 필요할 수 있습니다.

서비스 할당량 증가 요청을 제기하려면

  1. Management Console에 로그인하고 서비스 할당량 콘솔로 이동하여 서비스에서 “추출”을 선택합니다.

  2. 원하는 할당량을 선택하고 다음 페이지에서 “할당량 증가 요청”을 클릭합니다.

  3. 원하는 할당량 값을 입력하고 “요청”을 클릭합니다. Service Quotas Calculator를 사용한 경우 계산에서 할당량 값을 요청에 복사할 수 있습니다.

  4. 할당량 증가를 요청한 후 페이지를 새로 고쳐 할당량 상태 업데이트를 확인합니다.

참고

할당량 값을 일부 늘리려면 수동 검토가 필요할 수 있습니다.

할당량 수정 효과

다음 표에는 다양한 유형의 할당량과 할당량을 수정하는 효과가 나와 있습니다.

늘릴 할당량 값 증가의 영향

동기식 작업 TPS

Textract가 초당 트랜잭션으로 측정되는 지정된 동기 작업을 사용하여 새 문서를 처리하도록 요청할 수 있는 빈도를 높입니다.

비동기식 시작 작업 TPS

Textract가 초당 트랜잭션으로 측정되는 입력 문서의 비동기 처리를 시작하도록 요청할 수 있는 빈도를 늘립니다.

비동기 가져오기 작업 TPS

Textract가 초당 트랜잭션으로 측정되는 지정된 비동기 분석 작업의 결과를 반환하도록 요청할 수 있는 빈도를 늘립니다.

비동기 동시 작업

병렬로 처리할 수 있는 총 문서 수를 늘립니다.