할당량 및 한도

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

무료 할당량

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

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

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

표준 한도

다음 표에서는 Firestore에 적용되는 한도를 보여줍니다. 달리 명시하지 않는 한 엄격한 한도입니다.

컬렉션, 문서, 필드

한도 세부정보
컬렉션 ID 제약조건
  • 유효한 UTF-8 문자여야 합니다.
  • 1,500바이트 이하여야 합니다.
  • 슬래시(/)를 포함할 수 없습니다.
  • 마침표 하나(.) 또는 2개(..)로만 구성할 수 없습니다.
  • 정규 표현식(__.*__)과 일치할 수 없습니다.
하위 컬렉션 최대 심도 100
문서 ID 제약조건
  • 유효한 UTF-8 문자여야 합니다.
  • 1,500바이트 이하여야 합니다.
  • 슬래시(/)를 포함할 수 없습니다.
  • 마침표 하나(.) 또는 2개(..)로만 구성할 수 없습니다.
  • 정규 표현식(__.*__)과 일치할 수 없습니다.
  • Datastore 항목을 Firestore 데이터베이스로 가져오면 숫자 항목 ID가 __id[0-9]+__로 노출됩니다.
문서 이름 최대 크기 6KiB
문서 최대 크기 1MiB(1,048,576바이트)
필드 이름 제약조건 유효한 UTF-8 문자여야 합니다.
필드 이름 최대 크기 1,500바이트
필드 경로 제약조건
  • 마침표 하나(.)로 필드 이름을 구분해야 합니다.
  • 경로의 모든 필드 이름이 단순한 경우 문자열 하나로 전달할 수 있습니다. 그렇지 않을 경우에는 FieldPath 객체(예: 자바스크립트 FieldPath)로 전달해야 합니다.
단순한 필드 이름은 다음 조건을 모두 충족하는 이름입니다.
  • 문자(a-z, A-Z, 0-9)와 밑줄(_)만 포함
  • 0-9로 시작하지 않음
필드 경로 최대 크기 1,500바이트
필드 값 최대 크기 1MiB - 89바이트(1,048,487바이트)
지도 또는 배열의 필드 최대 심도 20

쓰기 및 트랜잭션

한도 세부정보
데이터베이스별 초당 최대 쓰기 수 10,000(초당 최대 10MiB)
최대 API 요청 크기 10MiB
Commit 작업에 전달하거나 트랜잭션에서 수행할 수 있는 최대 쓰기 수 500
단일 문서에서 Commit 작업 또는 트랜잭션으로 수행할 수 있는 최대 필드 변환 수 500
트랜잭션 제한 시간 270초(유휴 만료 시간 60초)

가벼운 한도

Firestore에서 아래 기준을 초과하는 것을 막을 수 없지만 초과할 경우 성능에 영향을 줍니다.

가벼운 한도 세부정보
문서에 대한 최대 지속 쓰기 속도

초당 1개

초당 1회 이상 쓰기 속도를 유지하면 지연 시간이 늘어나고 경합 오류가 발생합니다. 이는 엄격한 제한이 아니며 짧은 시간 동안 제한을 초과할 수 있습니다.

색인이 지정된 필드에 순차 값이 포함된 문서의 컬렉션 최대 쓰기 속도 초당 500회

실시간 업데이트

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

1,000,000

Firestore에서 이 가벼운 한도를 초과하는 것을 막을 수 없지만 초과할 경우 지연 시간과 오류율에 상당한 영향이 있습니다.

색인

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

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

각 문서의 최대 색인 항목 수

40,000

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

  • 단일 필드 색인 항목 수
  • 복합 색인 항목 수

Firestore에서 문서 및 색인 집합을 색인 항목으로 전환하는 방식을 확인하려면 색인 항목 개수 예시를 참조하세요.
색인 항목 최대 크기

7.5KiB

Firestore에서 색인 항목 크기를 계산하는 방식을 확인하려면 색인 항목 크기를 참조하세요.
문서의 색인 항목 크기 최대 총합

8MiB

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

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

    1,500바이트

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

    내보내기/가져오기

    다음 한도는 관리형 가져오기 및 내보내기 작업에 적용됩니다.

    한도 세부정보
    프로젝트에 분당 허용되는 내보내기 및 가져오기 요청 최대 총합 20
    최대 내보내기 및 가져오기 동시 실행 수 50
    내보내기 및 가져오기 요청의 최대 컬렉션 ID 필터 수 100

    보안 규칙

    한도 세부정보
    요청당 최대 exists(), get(), getAfter() 호출 수
    • 단일 문서 요청 및 쿼리 요청의 경우 10입니다.

    • 여러 문서 읽기, 트랜잭션, 일괄 쓰기의 경우 20입니다. 이전의 한도인 10도 각 작업에 적용됩니다.

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

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

    일부 문서 액세스 호출은 캐시될 수 있으며 캐시된 호출은 한도에 적용되지 않습니다.
    중첩된 match 문 최대 심도 10
    중첩된 match 문 집합 내에서 허용되는 최대 경로 길이(경로 세그먼트) 100
    중첩된 match 문 집합 내에서 허용되는 최대 경로 캡처 변수 개수 20
    함수 호출 최대 심도 20
    최대 함수 인수 개수 7
    함수당 최대 let 변수 결합 개수 10
    재귀 또는 순환 함수 호출의 최대 개수 0(허용되지 않음)
    요청당 평가되는 최대 표현식 수 1,000
    규칙 세트의 최대 크기 규칙 세트는 다음 두 가지 크기 제한을 준수해야 합니다.
    • Firebase Console 또는 firebase deploy를 사용하여 CLI에서 게시된 규칙 세트 텍스트 소스 크기는 256KB로 제한됩니다.
    • Firebase가 소스를 처리하고 백엔드에서 활성화할 때 생성되는 컴파일된 규칙 세트의 크기는 250KB로 제한됩니다.

    사용량 모니터링

    App Engine 할당량 페이지에서 일일 Firestore 사용량을 확인할 수 있습니다.

    할당량 페이지로 이동