콘솔로 이동

사용량 및 한도

이 가이드를 참조하여 Cloud Firestore 한도를 이해하고, 주의사항을 포함한 Cloud Firestore 비용에 대한 자세한 내용은 Cloud Firestore 가격 책정을 참조하세요.

사용량 모니터링

Cloud Firestore 사용량을 모니터링하려면 Firebase Console에서 Cloud Firestore 사용량을 여세요. 대시보드를 사용하여 여러 기간에 걸친 사용량을 측정할 수 있습니다.

Google Cloud Platform Console의 사용량 세부정보

Firebase 프로젝트를 만들면 Google Cloud Platform에도 프로젝트가 생성됩니다. Cloud Platform Console의 App Engine 할당량 페이지에서 저장된 데이터 및 네트워크 이그레스와 같은 추가 Cloud Firestore 사용량 정보를 추적합니다.

무료 할당량

Cloud Firestore는 무료 할당량을 제공하므로 비용을 들이지 않고도 시작할 수 있습니다. 무료 할당량은 아래에 나와 있습니다. 할당량이 더 필요하다면 Cloud Platform 프로젝트에 결제 기능을 사용 설정해야 합니다.

할당량은 일 단위로 적용되며 태평양 표준시 자정에 재설정됩니다.

무료 등급 할당량
저장된 데이터 1GiB
문서 읽기 50,000/일
문서 쓰기 20,000/일
문서 삭제 20,000/일
네트워크 송신 10GiB/월

표준 한도

다음 표에서는 Cloud Firestore 사용 시 적용되는 제한사항을 보여줍니다.

컬렉션, 문서, 필드

한도 세부정보
컬렉션 ID 제약조건
  • 유효한 UTF-8 문자여야 합니다.
  • 1,500바이트 이하여야 합니다.
  • 슬래시(/)를 포함할 수 없습니다.
  • 마침표 하나(.) 또는 두 개(..)로만 구성될 수 없습니다.
  • 다음 정규 표현식과 일치할 수 없음: __.*__
하위 컬렉션 최대 심도 100
문서 ID 제약조건
  • 유효한 UTF-8 문자여야 합니다.
  • 1,500바이트 이하여야 합니다.
  • 슬래시(/)를 포함할 수 없습니다.
  • 마침표 하나(.) 또는 두 개(..)로만 구성될 수 없습니다.
  • 다음 정규 표현식과 일치할 수 없음: __.*__
문서 이름 최대 크기 6KiB
문서 최대 크기 1MiB(1,048,576바이트)
필드 이름 제약조건 유효한 UTF-8 문자여야 합니다.
필드 이름 최대 크기 1,500바이트
필드 경로 제약조건
  • 마침표 하나(.)로 필드 이름을 구분해야 합니다.
  • 필드 이름이 다음 요구사항을 충족하지 않는 한, 필드 이름을 각각 백틱으로 묶어야 합니다.
    • 필드 이름에 문자(a-z, A-Z), 0-9, 밑줄(_)만 포함되어 있습니다.
    • 필드 이름이 0-9로 시작되지 않습니다.
필드 경로 최대 크기 1,500바이트
필드 값 최대 크기 1MiB - 89바이트(1,048,487바이트)
지도 또는 배열의 필드 최대 심도 20

쓰기 및 트랜잭션

한도 세부정보
최대 API 요청 크기 10MiB
데이터베이스별 초당 최대 쓰기 수 10,000개(초당 최대 10MiB)
문서 최대 쓰기 속도 초당 1개
색인이 생성된 필드에 순차 값이 포함된 문서의 컬렉션 최대 쓰기 속도 초당 500개
Commit 작업에 전달하거나 트랜잭션에서 수행할 수 있는 최대 쓰기 수 500
단일 문서에서 Commit 작업 또는 트랜잭션으로 수행할 수 있는 최대 필드 변환 수 500
트랜젝션 제한 시간 270초(유휴 만료 시간 60초)

실시간 업데이트

한도 세부정보
데이터베이스당 모바일/웹 클라이언트 최대 동시 연결 수 1,000,000

색인

다음의 한도는 단일 필드 색인복합 색인에 적용됩니다.

한도 세부정보
데이터베이스의 최대 복합 색인 수 200
데이터베이스의 최대 단일 필드 색인 예외 수 200

각 문서의 최대 색인 항목 수

40,000

색인 항목 수는 문서 내 다음 항목의 총합입니다.

  • 단일 필드 색인 항목 수
  • 복합 색인 항목 수
색인 항목의 최대 크기

7.5KiB

Cloud Firestore에서 색인 항목 크기를 계산하는 방식을 확인하려면 색인 항목 크기를 참조하세요.

문서의 색인 항목 크기 최대 총합

8MiB

전체 크기는 문서의 다음 항목에 대한 총합입니다.

  • 문서의 단일 필드 색인 항목 크기 총합
  • 문서의 복합 필드 색인 항목 크기 총합
  • 색인 필드 값의 최대 크기

    1,500바이트

    1,500바이트를 초과하는 필드 값은 잘립니다. 잘린 필드 값을 포함하는 쿼리는 일관성 없는 결과를 반환할 수 있습니다.

    보안 규칙

    한도 세부정보
    요청당 최대 exists(), get(), getAfter() 호출 수
    • 단일 문서 요청 및 쿼리 요청의 경우 10입니다.
    • 여러 문서 읽기, 트랜잭션, 일괄 쓰기의 경우 20입니다. 이전의 한도인 10도 각 작업에 적용됩니다.

      예를 들어 3번의 쓰기 작업으로 일괄 쓰기 요청을 만들고 보안 규칙이 2번의 문서 액세스 호출을 사용하여 각 쓰기를 검증한다고 가정해 봅니다. 이 경우 각 쓰기는 10번의 액세스 호출 중 2번을 사용하고 일괄 쓰기 요청은 20번의 액세스 호출 중 6번을 사용합니다.

    한도 중 하나라도 초과하면 권한 거부 오류가 발생합니다.

    일부 문서 액세스 호출은 캐시될 수 있으며 캐시된 호출은 한도에 적용되지 않습니다.

    함수 호출 최대 심도 20
    재귀 또는 순환 함수 호출의 최대 개수 0(허용되지 않음)
    요청당 평가되는 최대 표현 수 1,000
    규칙 세트의 최대 크기 64KB

    지출 관리

    예기치 않게 과다한 요금이 청구되지 않게 하려면 지출 한도 및 알림을 설정하세요.

    일일 지출 한도 설정

    Cloud Firestore 사용량을 제한하려면 Google App Engine을 통해 일일 지출 한도를 설정합니다. App Engine을 사용하면 Cloud Firestore를 비롯한 App Engine 관련 리소스를 통해 일일 지출 한도를 설정할 수 있습니다. App Engine 한도는 기타 다른 Firebase 제품에는 적용되지 않습니다.

    1. Cloud Platform Console에서 프로젝트에 아직 결제를 사용 설정하지 않았다면 지금 사용 설정합니다.
    2. Cloud Platform 콘솔의 App Engine 애플리케이션 설정 페이지로 이동합니다.
    3. 수정을 클릭하고 일일 지출 한도를 설정합니다.
    4. 저장을 클릭합니다. 새 한도가 즉시 적용되고 매일 재설정됩니다.

    월 예산 설정

    Cloud Firestore 비용을 추적하려면 Cloud Platform 콘솔에서 월 예산을 만드세요. 예산에 따라 사용량이 제한되지는 않지만, 계획된 월 비용에 근접하거나 이를 초과할 때 알림을 받도록 설정할 수 있습니다.

    예산을 설정하려면 Cloud Platform 콘솔에서 결제 섹션으로 이동하고 결제 계정의 예산을 만듭니다. 기본 알림 설정을 사용할 수도 있고, 알림을 받을 월 예산 비율을 변경할 수도 있습니다.

    Cloud Platform Console에서 예산을 설정하는 방법에 관해 자세히 알아보세요.