할당량 유형
Earth Engine 플랫폼에는 리소스가 사용자 간에 공정하게 분배되도록 여러 할당량 한도가 적용되어 있습니다. Earth Engine에는 다양한 유형의 리소스 (컴퓨팅, 스토리지 등)가 있으므로 다양한 유형의 할당량 한도가 있습니다.
할당량 유형 간의 주요 차이점은 조정 가능한지 여부입니다. 일부 할당량 유형의 경우 사용자별 또는 프로젝트별로 한도를 변경할 수 있지만 다른 유형은 변경할 수 없는 시스템 전체 한도입니다.
조정 가능한 할당량 한도
다음 한도는 프로젝트별로 적용됩니다.
| 할당량 유형 | 기본값 (프로젝트당) |
|---|---|
| 최대 동시 요청 수(표준 엔드포인트) | 동시 요청 40개 |
| 최대 동시 요청 수(대용량 엔드포인트) | 동시 요청 40개 |
| 최대 요청 속도 (프로젝트당) | 요청 100개/초 (요청 6,000개/분) |
| 최대 요청 속도 (계정당) | 요청 100개/초 (요청 6,000개/분) |
| 평균 동시 일괄 작업 | 작업 2개 (평균) |
| 최대 애셋 스토리지 공간 | 250 GB |
| 최대 애셋 수 | 10,000 |
| 일일 Earth Engine 컴퓨팅 시간(EECU-time)(초) | 무제한 |
동시 대화형 요청
각 프로젝트는 할당량 한도까지 대화형 요청을 동시에 할 수 있습니다. 한도를 초과하면 Earth Engine에서 "HTTP 429: 요청이 너무 많음" 오류를 반환합니다. 일반적으로 이러한 오류는 지수 백오프에서 요청을 래핑하고 성공할 때까지 쿼리를 재시도하는 Earth Engine 클라이언트 라이브러리에서 처리합니다. Earth Engine 클라이언트 라이브러리는 최대 5번 요청을 재시도합니다.
이러한 429 오류를 수신하지 않도록 하려면 가능한 경우 중복 쿼리를 방지하기 위해 memcache를 사용하는 등 애플리케이션에 캐싱을 사용 설정하는 것이 좋습니다. 쿼리를 자동으로 재시도하지 않는 이전 버전의 Earth Engine 클라이언트 라이브러리를 사용하거나 5번 재시도한 후에도 쿼리가 완료되지 않는 경우 요청 주위에 지수 백오프를 구현해야 할 수 있습니다.
요청 속도 (QPS)
동시 실행 한도 외에도 EarthEngine은 프로젝트 및 사용자 수준에서 대화형 요청 속도를 제한합니다. 이러한 설정은 Cloud Console에서 조정할 수 있습니다.
동시 일괄 작업
일괄 작업 은 대화형 요청보다 더 많은 리소스를 사용하므로 병렬 처리량이 적은 것으로 제한됩니다 대화형 요청.
Earth Engine을 비상업적으로 사용하는 경우 동시에 실행할 수 있는 최대 일괄 작업 수는 비상업용 등급에 따라 결정됩니다.
Earth Engine을 상업적으로 사용하는 경우 동시에 실행할 수 있는 최대 일괄 작업 수는 요금제에 따라 결정되지만 프로젝트별 일괄 작업 동시 실행 한도를 설정하여 더 낮출 수 있습니다. 기본적으로 프로젝트의 일괄 작업 동시 실행 한도는 프로젝트의 결제 계정에 구성된 요금제에서 허용하는 최댓값으로 설정됩니다. 프로젝트에서 이 한도를 보거나 업데이트하려면 명령줄 도구 문서를 참고하세요.
애셋 스토리지 한도
각 Earth Engine 애셋에는 바이트 단위로 측정되는 해당 데이터 스토리지 크기가 있습니다. 애셋은 Cloud 프로젝트 또는 개인 (기존 애셋)이 소유할 수 있으며 각 애셋은 소유자의 전체 스토리지 및 애셋 수에 대한 Earth Engine 한도에 포함됩니다.
비상업적 또는 연구용으로 추가 애셋 스토리지 한도를 신청하려면, 다음 항목을 참고하세요. 비상업적 또는 연구용
일일 EECU-time
비용을 제어하려면 프로젝트에서 Earth Engine에서 하루에 사용할 수 있는 EECU-time의 양을 제한할 수 있습니다. 기본적으로 이 할당량은 무제한입니다. 할당량 관리자는 Cloud Console에서 earthengine.googleapis.com/daily_eecu_usage_time 할당량 측정항목을 필터링하여 이 한도를
설정할 수 있습니다. 설정되면 이 할당량은 프로젝트의 모든 사용자의 성공적인 Earth Engine 요청에서 사용된 EECU-time을 누적합니다. 할당량을 초과하면 다음 날 할당량이 재설정되거나 한도가 증가할 때까지 요청이 실패합니다. 이 할당량 설정에 관한 자세한 내용은 비용 관리
가이드를 참고하세요.
고정 할당량 한도
이러한 유형의 할당량 한도는 플랫폼 수준에서 설정되므로 사용자별 또는 프로젝트별로 조정할 수 없습니다. 시간이 지나도 크게 변경되지 않을 가능성이 높습니다.
컴퓨팅 시간
요청 유형에 따라 최대 기간이 다르며 이는 처리 환경 문서에 자세히 설명되어 있습니다.
시간 제한 오류를 해결하려면 디버깅 가이드를 참고하세요.
요청당 메모리 사용량
'사용자 메모리 한도 초과'로 요청이 실패하면 Earth Engine에서 허용된 메모리 사용량 내에서 답변을 계산할 수 없다는 의미입니다. EE 컴퓨팅 플랫폼에는 사용 가능한 RAM의 양이 제한되어 있으며 시스템이 안정적으로 유지되도록 각 요청은 특정 양만 사용할 수 있습니다. 사용 가능한 최대 메모리 양은 요청 유형 (예: 지도 타일보다 일괄 작업에 더 많은 메모리)에 따라 다르지만 이는 시스템 전체 한도입니다.
메모리 오류를 해결하려면 디버깅 가이드를 참고하세요.
집계
Earth Engine 요청을 처리할 때 컴퓨팅 집약적인 것으로 알려진 특정 유형의 하위 컴퓨팅을 분리합니다. 이러한 하위 컴퓨팅을 '집계'라고 하며 EE 시스템에서 특별히 처리됩니다. 집계 결과는 재계산을 방지하기 위해 캐시됩니다.
동시 집계
제어되지 않는 컴퓨팅 팬아웃을 방지하기 위해 개별 사용자가 동시에 실행할 수 있는 집계 수를 제한하며 이는 변경할 수 없습니다. '동시 집계가 너무 많음'으로 요청이 실패하면 요청자가 동시에 실행 중인 집계가 너무 많다는 의미입니다.
동시 집계 오류를 해결하려면 디버깅 가이드를 참고하세요.
큰 집계 결과
'계산된 값이 너무 큼'으로 요청이 실패하면 집계에서 캐시에 맞지 않을 정도로 큰 결과를 반환했다는 의미입니다. 계산된 결과의 크기 한도는 100MiB이며 이는 시스템 전체 한도입니다.
테이블 가져오기 한도
테이블 업로드 한도는 테이블 데이터 가져오기 가이드에 설명되어 있습니다.
요청 페이로드 크기
Earth Engine에 대한 단일 쿼리는 크기가 10MB로 제한됩니다. 이 한도는 일반적으로 쿼리에 인라인된 셰이프 파일 또는 GeoJSON 구조와 같이 큰 추가 데이터가 쿼리에 직접 포함될 때만 초과됩니다. 이러한 객체는 대신 업로드되어 FeatureCollection 애셋으로 전환되고 애셋 ID로 참조되어야 합니다.
태스크 큐 길이
예약 대기 중인 태스크 (READY 상태)는 '태스크 큐'를 형성합니다. 각 프로젝트의 큐는 최대 3,000개의 태스크를 지원합니다. 즉, READY 상태의 태스크가 3,000개를 초과할 수 없습니다.
BigQuery 래스터 함수 할당량 한도
다음 할당량은 BigQuery에서 Earth Engine을 호출할 때 적용됩니다. 예를 들어
ST_REGIONSTATS
SQL 함수를 사용하는 경우입니다.
| 할당량 유형 | 기본값 (프로젝트당) |
|---|---|
| 일일 BigQuery 슬롯 시간 | 슬롯 초 1,260,000개 (슬롯 시간 350개) |
일일 BigQuery 슬롯 시간
일일 BigQuery 슬롯 시간 할당량은 BigQuery 래스터 함수가 특정 프로젝트의 특정 날짜에 Earth Engine에서 사용할 수 있는 슬롯 시간의 양을 제한할 수 있는 커스텀 할당량입니다. 일일 할당량은 실패한 쿼리를 포함한 모든 쿼리의 총 시간을 누적합니다. 할당량은
Cloud Console
의 earthengine.googleapis.com/bigquery_slot_usage_time 측정항목에서 볼 수 있으며
할당량 관리자가 값을 위 또는 아래로 조정할 수 있습니다. 값을 기본값보다 높이려면 자동으로 승인되는 할당량 상향
요청을
만드세요. 변경사항은 10분 이내에 적용됩니다.
이 할당량을 초과하면 BigQuery에서 다음 오류 메시지를 반환합니다.
From Earth Engine: Custom quota exceeded: Your usage exceeded the custom quota for'earthengine.googleapis.com/bigquery_slot_usage_time', which is adjustable by your administrator in the Google Cloud console: https://console.cloud.google.com/quotas/?project=_.
할당량을 초과하면 다음 날 할당량이 재설정되거나 관리자가 한도를 늘릴 때까지 ST_REGIONSTATS 호출이 실패합니다.