이 가이드를 사용하여 Cloud Firestore 한도를 이해하고 주의 사항을 포함하여 Cloud Firestore 비용에 대한 전체적이고 자세한 설명은 Cloud Firestore 가격 책정 을 참조하세요.
사용량 모니터링
Cloud Firestore 사용량을 모니터링하려면 Firebase 콘솔에서 Cloud Firestore 사용량 탭 을 엽니다. 대시보드를 사용하여 다양한 기간 동안 사용량을 측정하십시오.
Google Cloud Console의 자세한 사용량
Firebase 프로젝트를 생성하면 Google Cloud 프로젝트도 생성됩니다. Google Cloud Console의 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 |
Commit 작업 또는 트랜잭션에서 단일 문서에 대해 수행할 수 있는 최대 필드 변환 수 | 500 |
| 거래 시간 제한 | 270초(유휴 만료 시간 60초 포함) |
소프트 한계
Cloud Firestore는 아래 임계값을 초과하지 못하도록 막지는 않지만 그렇게 하면 성능에 영향을 미칩니다.
| 소프트 리미트 | 세부 |
|---|---|
| 문서가 인덱싱된 필드에 순차적 값을 포함하는 컬렉션에 대한 최대 쓰기 속도 | 초당 500 |
인덱스
단일 필드 색인 및 복합 색인 에는 다음 제한이 적용됩니다.
| 한계 | 세부 |
|---|---|
| 데이터베이스에 대한 최대 복합 인덱스 수 | 200 지원팀에 문의 하여 이 한도 증가를 요청할 수 있습니다. |
| 데이터베이스에 대한 최대 단일 필드 구성 수 | 200 총 200개의 필드 수준 구성이 허용됩니다. 하나의 필드 구성은 동일한 필드에 대한 여러 구성을 포함할 수 있습니다. 예를 들어 동일한 필드에 대한 단일 필드 인덱싱 면제 및 TTL 정책은 제한에 대한 하나의 필드 구성으로 계산됩니다. |
각 문서의 최대 색인 항목 수 | 40,000 색인 항목 수는 문서에 대한 다음 항목의 합계입니다.
Cloud Firestore가 문서와 인덱스 집합을 인덱스 항목으로 변환하는 방법을 보려면 이 인덱스 항목 수 예 를 참조하세요. |
| 복합 인덱스의 최대 필드 수 | 100 |
| 색인 항목의 최대 크기 | 7.5KiB Cloud Firestore에서 색인 항목 크기를 계산하는 방법을 보려면 색인 항목 크기를 참조하세요. |
| 문서 색인 항목 크기의 최대 합계 | 8MiB 총 크기는 문서에 대한 다음 항목의 합계입니다. |
| 인덱싱된 필드 값의 최대 크기 | 1500바이트 1500바이트를 초과하는 필드 값은 잘립니다. 잘린 필드 값과 관련된 쿼리는 일관되지 않은 결과를 반환할 수 있습니다. |
TTL(수명)
| 한계 | 세부 |
|---|---|
| 데이터베이스에 대한 최대 단일 필드 구성 수 | 200 총 200개의 필드 수준 구성이 허용됩니다. 하나의 필드 구성은 동일한 필드에 대한 여러 구성을 포함할 수 있습니다. 예를 들어 동일한 필드에 대한 단일 필드 인덱싱 면제 및 TTL 정책은 제한에 대한 하나의 필드 구성으로 계산됩니다. |
수출 수입
관리형 가져오기 및 내보내기 작업 에는 다음 제한이 적용됩니다.
| 한계 | 세부 |
|---|---|
| 분당 허용되는 프로젝트에 대한 내보내기 및 가져오기 요청의 최대 총 수 | 20 |
| 최대 동시 내보내기 및 가져오기 수 | 50 |
| 내보내기 및 가져오기 요청에 대한 최대 컬렉션 ID 필터 수 | 100 |
보안 규칙
| 한계 | 세부 |
|---|---|
요청당 최대 exists() , get() 및 getAfter() 호출 수 |
한도를 초과하면 권한 거부 오류가 발생합니다. 일부 문서 액세스 호출은 캐시될 수 있으며 캐시된 호출은 제한에 포함되지 않습니다. |
최대 중첩 match 문 깊이 | 10 |
중첩된 match 문 세트 내에서 허용되는 경로 세그먼트의 최대 경로 길이 | 100 |
중첩된 match 문 집합 내에서 허용되는 최대 경로 캡처 변수 수 | 20 |
| 최대 함수 호출 깊이 | 20 |
| 최대 함수 인수 수 | 7 |
함수당 let 변수 바인딩의 최대 수 | 10 |
| 재귀 또는 순환 함수 호출의 최대 수 | 0(허용되지 않음) |
| 요청당 평가되는 최대 표현식 수 | 1,000 |
| 규칙 세트의 최대 크기 | 규칙 세트는 두 가지 크기 제한을 준수해야 합니다.
|
지출 관리
예상치 못한 요금 청구를 피하려면 월예산과 알림을 설정하세요.
월 예산 설정
Cloud Firestore 비용을 추적하려면 Google Cloud Console에서 월예산을 만드세요. 예산은 사용량을 제한하지 않지만 해당 월의 계획된 비용에 도달하거나 초과할 때 알림을 받도록 설정할 수 있습니다.
예산을 설정하려면 Google Cloud Console의 결제 섹션으로 이동하여 Cloud Billing 계정의 예산을 만드세요. 기본 알림 설정을 사용하거나 알림을 수정하여 월예산의 다른 비율로 알림을 보낼 수 있습니다.
예산 및 예산 알림 설정 에 대해 자세히 알아보세요.
일일 지출 한도 설정
Cloud Firestore 사용량을 제한하려면 App Engine을 통해 일일 지출 한도를 설정하세요. App Engine을 사용하면 Cloud Firestore를 비롯한 App Engine 관련 리소스에 대한 일일 지출 한도 를 설정할 수 있습니다. App Engine 한도는 다른 Firebase 제품에는 적용되지 않습니다.