이 가이드를 참조하여 Cloud Firestore 한도를 이해하고 주의사항을 포함한 Cloud Firestore 비용에 대한 자세한 내용은 Cloud Firestore 가격 책정을 참조하세요.
사용량 모니터링
Cloud Firestore 사용량을 모니터링하려면 Firebase Console에서 Cloud Firestore 사용량 탭을 여세요. 대시보드를 사용하여 여러 기간에 걸친 사용량을 측정할 수 있습니다.
Google Cloud 콘솔의 사용량 세부정보
Firebase 프로젝트를 만들면 Google Cloud 프로젝트도 생성됩니다. Google Cloud 콘솔의 Cloud Firestore API 할당량 및 App Engine 할당량 페이지에서는 Cloud Firestore 사용량 및 할당량 정보를 추적합니다.
무료 할당량
Cloud Firestore는 무료 할당량을 제공하므로 비용을 들이지 않고도 시작할 수 있습니다. 무료 할당량은 아래에 나와 있습니다. 할당량이 더 필요하다면 Cloud Platform 프로젝트에 결제를 사용 설정해야 합니다.
할당량은 일 단위로 적용되며 태평양 표준시 자정에 재설정됩니다.
| 무료 등급 | 할당량 |
|---|---|
| 저장된 데이터 | 1GiB |
| 문서 읽기 | 50,000/일 |
| 문서 쓰기 | 20,000/일 |
| 문서 삭제 | 20,000/일 |
| 네트워크 이그레스 | 10GiB/월 |
표준 한도
다음 표에서는 Cloud 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 |
| 트랜잭션 제한 시간 | 270초(유휴 만료 시간 60초) |
가벼운 한도
Cloud Firestore에서 아래 기준을 초과하는 것을 막을 수 없지만 초과할 경우 성능에 영향을 줍니다.
| 가벼운 한도 | 세부정보 |
|---|---|
| 색인이 지정된 필드에 순차 값이 포함된 문서의 컬렉션 최대 쓰기 속도 | 초당 500개 |
색인
다음의 한도는 단일 필드 색인 및 복합 색인에 적용됩니다.
| 한도 | 세부정보 |
|---|---|
| 데이터베이스의 최대 복합 색인 수 |
200개 지원팀에 문의하여 이 한도 상향을 요청할 수 있습니다. |
| 데이터베이스의 최대 단일 필드 구성 수 |
200개 필드 수준 구성은 총 200개까지 허용됩니다. 한 필드 구성에 동일한 필드에 대한 여러 구성이 포함될 수 있습니다. 예를 들어 동일한 필드의 단일 필드 색인 생성 예외와 TTL 정책은 한도에서 1개의 필드 구성으로 집계됩니다. |
|
각 문서의 최대 색인 항목 수 |
40,000개 색인 항목 수는 문서 내 다음 항목의 총합입니다.
Cloud Firestore에서 문서와 색인 집합을 색인 항목으로 전환하는 방식을 확인하려면 색인 항목 개수의 예시를 참조하세요. |
| 복합 색인의 최대 필드 수 | 100개 |
| 색인 항목의 최대 크기 |
7.5KiB Cloud 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 비용을 추적하려면 Google Cloud 콘솔에서 월 예산을 만드세요. 예산에 따라 사용량이 제한되지는 않지만, 계획된 월 비용에 근접하거나 이를 초과할 때 알림을 받도록 설정할 수 있습니다.
예산을 설정하려면 Google Cloud 콘솔에서 결제 섹션으로 이동하고 Cloud Billing 계정의 예산을 만듭니다. 기본 알림 설정을 사용할 수도 있고 다양한 월 예산 비율에 대한 알림을 받도록 수정할 수도 있습니다.
예산 및 예산 알림 설정에 대해 자세히 알아보세요.
일일 지출 한도 설정
Cloud Firestore 사용량을 제한하려면 App Engine을 통해 일일 지출 한도를 설정합니다. App Engine을 사용하면 Cloud Firestore를 비롯한 App Engine 관련 리소스를 통해 일일 지출 한도를 설정할 수 있습니다. App Engine 한도는 기타 다른 Firebase 제품에는 적용되지 않습니다.