할당량 및 한도

이 페이지에서는 Cloud Firestore의 요청 할당량 및 한도에 대해 다룹니다.

베타 버전의 제한사항

다음 표에서는 베타 기간에만 적용되는 Cloud Firestore 제한사항을 보여줍니다.

한도 세부정보
데이터베이스별 초당 최대 쓰기 수(베타) 2,500개(초당 최대 2.5MiB)
데이터베이스당 모바일/웹 클라이언트 최대 동시 연결 수(베타) 10만 개

무료 용량

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
문서 최대 쓰기 속도 초당 1개
색인이 생성된 필드에 순차 값이 포함된 문서의 컬렉션 최대 쓰기 속도 초당 500개
Commit 작업에 전달하거나 트랜잭션에 기록할 수 있는 최대 문서 수 500
트랜젝션 제한 시간 270초(유휴 만료 시간 60초)

색인

한도 세부정보
문서의 복합 색인 항목 크기 최대 총합 2MiB
데이터베이스의 최대 복합 색인 수 200회

문서의 다음 항목에 대한 최대 총합:

  • 단일 필드 색인 항목 수
  • 복합 색인 항목 수
20,000개

보안 규칙

한도 세부정보
검증당 고유한 exists(), get(), getAfter()의 최대 호출 수

각각 3개로 제한되지만 합쳐서 총 5개로 제한됩니다. 동일한 문서에 대한 여러 요청은 개별적인 요청으로 집계되지 않습니다.

트랜잭션이나 일괄 쓰기에서 쓰기 작업이나 쓰기 작업 모음에 대한 규칙을 검증하는 경우에는 쓰기 대상에 대한 요청이 한도에 포함되지 않습니다.

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

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.