Service Quotas - Amazon Athena

Service Quotas

참고

Service Quotas 콘솔은 Amazon Athena 할당량에 대한 정보를 제공합니다. Service Quotas 콘솔을 사용하여 조정 가능한 할당량에 대한 할당량 증가를 요청할 수도 있습니다. AWS Glue 관련 스키마 제한은 AWS Glue 엔드포인트 및 할당량 페이지를 참조하세요. AWS 서비스 할당량에 대한 일반적인 정보는 AWS 일반 참조AWS 서비스 할당량을 참조하세요.

쿼리

계정에는 Amazon Athena에 대해 다음과 같은 쿼리 관련 할당량이 있습니다. 자세한 내용은 AWS 일반 참조의 Amazon Athena 엔드포인트 및 할당량을 참조하세요.

  • 활성 DDL 쿼리(Active DDL queries) - 활성 DDL 쿼리 수입니다. DDL 쿼리에는 CREATE TABLEALTER TABLE ADD PARTITION 쿼리가 포함됩니다.

  • DDL 쿼리 제한 시간(DDL query timeout) - DDL 쿼리가 취소되기 전에 실행할 수 있는 최대 시간(분)입니다.

  • 활성 DML 쿼리(Active DML queries) - 활성 DML 쿼리 수입니다. DML 쿼리에는 SELECT, CREATE TABLE AS(CTAS) 및 INSERT INTO 쿼리가 포함됩니다. 구체적인 할당량은 AWS 리전에 따라 다릅니다.

  • DDL 쿼리 제한 시간(DML query timeout) - DML 쿼리가 취소되기 전에 실행할 수 있는 최대 시간(분)입니다. 이 제한 시간을 최대 240분까지 늘리도록 요청할 수 있습니다.

할당량 증가를 요청하려면 Athena Service Quotas 콘솔을 사용합니다.

Athena는 전체 서비스 부하와 수신 요청 수에 따라 리소스를 할당하여 쿼리를 처리합니다. 쿼리는 실행되기 전에 일시적으로 대기열에 머무를 수 있습니다. 비동기 프로세스는 대기열에서 쿼리를 선택하고 리소스가 가용 상태가 되는 즉시 물리적 리소스에서 쿼리를 실행합니다. 단, 계정 구성이 이를 허용해야 합니다.

DML 또는 DDL 쿼리 할당량은 실행 중인 쿼리와 대기 중인 쿼리를 모두 포함합니다. 예를 들어 DML 쿼리 할당량이 25이고 실행 중인 쿼리와 대기 중인 쿼리의 합계가 26인 경우 쿼리 26은 TooManyRequestsException 오류를 발생시킵니다.

참고

Athena에서 실행하는 쿼리의 동시성을 직접 제어하려는 경우 용량 예약을 사용할 수 있습니다. 자세한 내용은 쿼리 처리 용량 관리 단원을 참조하십시오.

쿼리 문자열 길이

허용되는 최대 쿼리 문자열 길이는 262144바이트이며, 문자열은 UTF-8로 인코딩됩니다. 이 할당량은 조정 가능한 할당량이 아닙니다. 그러나 긴 쿼리를 여러 개의 작은 쿼리로 분할하여 이러한 제한을 해결할 수 있습니다. 자세한 내용은 AWS 지식 센터에서 Athena의 최대 쿼리 문자열 길이를 늘리려면 어떻게 해야 합니까?를 참조하세요.

작업 그룹

Athena 작업 그룹으로 작업할 때는 다음 사항을 기억하세요.

  • Athena 서비스 할당량은 계정의 모든 작업 그룹 간에 공유됩니다.

  • 한 계정에서 리전별로 생성할 수 있는 최대 작업 그룹 수는 1,000개입니다.

  • 작업 그룹에서 준비된 문의 최대 개수는 1000입니다.

  • 작업 그룹당 최대 태그 수는 50개입니다. 자세한 내용은 태그 제한 단원을 참조하세요.

데이터베이스, 테이블, 파티션

Athena는 AWS Glue Data Catalog을(를) 사용합니다. 테이블, 데이터베이스, 파티션에 대한 서비스 할당량(예: 계정당 최대 데이터베이스 또는 테이블 수)은 AWS Glue 엔드포인트 및 할당량을 참조하세요. Athena는 1천만 개의 파티션이 있는 AWS Glue 테이블에 대한 쿼리를 지원하지만, 단일 스캔으로 1백만 개 이상의 파티션을 읽을 수 없습니다.

Amazon S3 버킷

Amazon S3 버킷으로 작업할 때는 다음 사항을 기억하세요.

  • Amazon S3에는 계정당 버킷 100개의 기본 서비스 할당량이 있습니다.

  • Athena에는 결과를 기록하기 위해 별도의 버킷이 필요합니다.

  • AWS 계정당 Amazon S3 버킷 최대 1,000개의 할당량 증가를 요청할 수 있습니다.

계정당 API 호출 할당량

Athena API에는 계정당(쿼리당이 아님) API에 호출할 수 있는 수에 다음과 같은 기본 할당량이 있습니다.

API 이름 초당 기본 호출 수 버스트 용량
BatchGetNamedQuery, ListNamedQueries, ListQueryExecutions 5 최대 10개
CreateNamedQuery, DeleteNamedQuery, GetNamedQuery 5 최대 20
BatchGetQueryExecution 20 최대 40
StartQueryExecution, StopQueryExecution 20 최대 80
GetQueryExecution, GetQueryResults 100 최대 200

예를 들어 StartQueryExecution의 경우 초당 최대 20회 호출할 수 있습니다. 또한 이 API가 4초 동안 호출되지 않는 경우 계정이 최대 80회 호출의 버스트 용량을 누적합니다. 이 경우 애플리케이션은 버스트 모드에서 이 API를 최대 80회 호출합니다.

이러한 API를 사용하고 초당 호출 수의 기본 할당량 또는 계정의 버스트 용량을 초과하는 경우, Athena API는 ""ClientError: An error occurred (ThrottlingException) when calling the <API_name> operation: Rate exceeded"와 유사한 오류를 생성합니다. 초당 호출 수 또는 이 계정의 API에 대한 버스트 용량을 줄입니다.

계정별 API 호출에 대한 Athena 할당량은 Athena Service Quotas 콘솔에서 변경할 수 없습니다. Athena API 호출에 대한 할당량 증가를 요청하려면 AWS Support 서비스 한도 증가 페이지로 이동하여 양식을 작성해 제출하세요.