할당량 및 한도
이 페이지에서는 Firestore의 요청 할당량과 한도에 대해 다룹니다.
무료 할당량
Firestore는 무료 할당량을 제공하므로 비용을 들이지 않고도 시작할 수 있습니다. 무료 할당량은 아래에 나와 있습니다. 할당량이 더 필요하다면 Cloud Platform 프로젝트에 결제를 사용 설정해야 합니다.
할당량은 일 단위로 적용되며 태평양 표준시 자정에 재설정됩니다.
무료 등급 | 할당량 |
---|---|
저장된 데이터 | 1GiB |
문서 읽기 | 50,000/일 |
문서 쓰기 | 20,000/일 |
문서 삭제 | 20,000/일 |
네트워크 이그레스 | 10GiB/월 |
표준 한도
다음 표에서는 Firestore에 적용되는 한도를 보여줍니다. 달리 명시하지 않는 한 엄격한 한도입니다.
컬렉션, 문서, 필드
한도 | 세부정보 |
---|---|
컬렉션 ID 제약조건 |
|
하위 컬렉션 최대 심도 | 100 |
문서 ID 제약조건 |
|
문서 이름 최대 크기 | 6KiB |
문서 최대 크기 | 1MiB(1,048,576바이트) |
필드 이름 제약조건 | 유효한 UTF-8 문자여야 합니다. |
필드 이름 최대 크기 | 1,500바이트 |
필드 경로 제약조건 |
|
필드 경로 최대 크기 | 1,500바이트 |
필드 값 최대 크기 | 1MiB - 89바이트(1,048,487바이트) |
지도 또는 배열의 필드 최대 심도 | 20 |
쓰기 및 트랜잭션
이러한 한도 외에도 확장을 위한 설계 권장사항을 참조하세요.
한도 | 세부정보 |
---|---|
최대 API 요청 크기 | 10MiB |
Commit 작업에 전달하거나 트랜잭션에서 수행할 수 있는 최대 쓰기 수 |
500 |
단일 문서에서 Commit 작업 또는 트랜잭션으로 수행할 수 있는 최대 필드 변환 수 |
500 |
트랜잭션 제한 시간 | 270초(유휴 만료 시간 60초) |
가벼운 한도
Firestore에서 아래 기준을 초과하는 것을 막을 수 없지만 초과할 경우 성능에 영향을 줍니다.
가벼운 한도 | 세부정보 |
---|---|
색인이 지정된 필드에 순차 값이 포함된 문서의 컬렉션 최대 쓰기 속도 | 초당 500개 |
색인
다음의 한도는 단일 필드 색인 및 복합 색인에 적용됩니다.
한도 | 세부정보 |
---|---|
데이터베이스의 최대 복합 색인 수 |
200 지원팀에 문의하여 이 한도 상향을 요청할 수 있습니다. |
데이터베이스의 최대 단일 필드 구성 수 |
200개 필드 수준 구성은 총 200개까지 허용됩니다. 한 필드 구성에 동일한 필드에 대한 여러 구성이 포함될 수 있습니다. 예를 들어 동일한 필드의 단일 필드 색인 생성 예외와 TTL 정책은 한도에서 1개의 필드 구성으로 집계됩니다. |
각 문서의 최대 색인 항목 수 |
40,000개 색인 항목 수는 문서 내 다음 항목의 총합입니다.
Firestore에서 문서 및 색인 집합을 색인 항목으로 전환하는 방식을 확인하려면 색인 항목 개수 예시를 참조하세요. |
복합 색인의 최대 필드 수 | 100개 |
색인 항목의 최대 크기 |
7.5KiB Firestore에서 색인 항목 크기를 계산하는 방식을 확인하려면 색인 항목 크기를 참조하세요. |
문서의 색인 항목 크기 최대 총합 |
8MiB 전체 크기는 문서 내 다음 항목의 총합입니다. |
색인이 지정된 필드 값의 최대 크기 |
1,500바이트 1,500바이트를 초과하는 필드 값은 잘립니다. 잘린 필드 값을 포함하는 쿼리는 일관성 없는 결과를 반환할 수 있습니다. |
TTL(수명)
한도 | 세부정보 |
---|---|
데이터베이스의 최대 단일 필드 구성 수 |
200개 필드 수준 구성은 총 200개까지 허용됩니다. 한 필드 구성에 동일한 필드에 대한 여러 구성이 포함될 수 있습니다. 예를 들어 동일한 필드의 단일 필드 색인 생성 예외와 TTL 정책은 한도에서 1개의 필드 구성으로 집계됩니다. |
내보내기/가져오기
다음 한도는 관리형 가져오기 및 내보내기 작업에 적용됩니다.
한도 | 세부정보 |
---|---|
프로젝트에 분당 허용되는 내보내기 및 가져오기 요청 최대 총합 | 20 |
최대 내보내기 및 가져오기 동시 실행 수 | 50 |
내보내기 및 가져오기 요청의 최대 컬렉션 ID 필터 수 | 100 |
보안 규칙
한도 | 세부정보 |
---|---|
요청당 최대 exists() , get() , getAfter() 호출 수 |
한도 중 하나라도 초과하면 권한 거부 오류가 발생합니다. 일부 문서 액세스 호출은 캐시될 수 있으며 캐시된 호출은 한도에 적용되지 않습니다. |
중첩된 match 문 최대 심도 |
10 |
중첩된 match 문 집합 내에서 허용되는 최대 경로 길이(경로 세그먼트) |
100 |
중첩된 match 문 집합 내에서 허용되는 최대 경로 캡처 변수 개수 |
20 |
함수 호출 최대 심도 | 20 |
최대 함수 인수 개수 | 7 |
함수당 최대 let 변수 결합 개수 |
10 |
재귀 또는 순환 함수 호출의 최대 개수 | 0(허용되지 않음) |
요청당 평가되는 최대 표현식 수 | 1,000 |
규칙 세트의 최대 크기 | 규칙 세트는 다음 두 가지 크기 제한을 준수해야 합니다.
|
사용량 모니터링
Cloud Firestore API 할당량 페이지와 App Engine 할당량 페이지에서 Firestore 사용량을 확인할 수 있습니다.