네이티브 모드: 할당량 및 한도

이 페이지에서는 네이티브 모드의 Cloud Firestore의 요청 할당량과 Enterprise 버전 한도를 설명합니다.

무료 등급 사용량

네이티브 모드의 Cloud Firestore는 네이티브 모드의 Cloud Firestore를 무료로 시작할 수 있는 무료 등급을 제공합니다. 무료 등급 금액은 다음 표에 나와 있습니다.

무료 등급 금액은 일 단위로 적용되며 태평양 표준시를 기준으로 자정에 재설정됩니다.

무료 등급은 프로젝트당 하나의 Cloud Firestore 데이터베이스에만 적용됩니다. 무료 등급 데이터베이스가 없는 프로젝트에서 생성된 첫 번째 데이터베이스에는 무료 등급이 부여됩니다. 무료 등급이 적용된 데이터베이스가 삭제되면 다음에 생성되는 데이터베이스에 무료 등급이 적용됩니다.

무료 등급 Quota
저장된 데이터 1GiB
단위 읽기 50,000/일
실시간 업데이트 단위 50,000/일
단위 작성 40,000/일
아웃바운드 데이터 전송 10GiB/월

표준 한도

다음 표에서는 네이티브 모드의 Cloud Firestore에 적용되는 한도를 보여줍니다. 달리 명시하지 않는 한 엄격한 한도입니다.

데이터베이스

한도 세부정보
프로젝트당 최대 데이터베이스 수

100

지원팀에 문의하여 이 한도 상향을 요청할 수 있습니다.

프로젝트당 최대 고객 관리 암호화 키(CMEK) 데이터베이스 수

0

이 기능은 허용 목록에 있으므로 기본적으로 할당량은 0입니다. CMEK 액세스 요청 양식을 작성하여 할당량 증가를 요청할 수 있습니다.

컬렉션, 문서, 필드

한도 세부정보
컬렉션 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바이트
필드 경로 제약조건
  • 마침표 하나(.)로 필드 이름을 구분해야 합니다.
  • 점으로 구분된(.) 세그먼트 문자열로 전달될 수 있습니다. 여기서 각 세그먼트는 간단한 필드 이름이나 따옴표로 묶인 필드 이름(아래에 정의됨)입니다.
단순한 필드 이름은 다음 조건을 모두 충족하는 이름입니다.
  • 문자(a-z, A-Z, 0-9)와 밑줄(_)만 포함
  • 0-9로 시작하지 않음
따옴표로 묶인 필드 이름은 백틱 문자(`)로 시작하고 끝납니다. 예를 들어 foo.`x&y`는 foo 필드 아래에 중첩된 x&y 필드를 참조합니다. 백틱 문자로 필드 이름을 구성하려면 백틱 문자를 백슬래시 문자(\)로 이스케이프 처리합니다. 편의상 필드 경로를 FieldPath 객체로 전달하여 따옴표로 묶인 필드 이름을 피할 수 있습니다(예시는 자바스크립트 FieldPath 참조).
필드 경로 최대 크기 1,500바이트
필드 값 최대 크기 1MiB - 89바이트(1,048,487바이트)
지도 또는 배열의 필드 최대 심도

20

맵 및 배열 필드는 객체의 전체 심도에 1단계를 추가합니다. 예를 들어 다음 객체의 총 심도는 3단계입니다. 


{
  nested_map: {         #depth 1
    nested_array: [     #depth 2
      {
        foo: "bar"      #depth 3
      }
    ]
  }
}

쓰기 및 트랜잭션

한도 세부정보
최대 API 요청 크기 10MiB
트랜젝션 제한 시간 270초(유휴 만료 시간 60초)
단일 문서에서 Commit 작업 또는 트랜잭션으로 수행할 수 있는 최대 필드 변환 수 500

색인

한도 세부정보
데이터베이스의 최대 색인 수

각 문서의 최대 색인 항목 수

40,000
색인의 최대 필드 수 100
색인 항목의 최대 크기

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

8MiB

TTL(수명)

한도 세부정보
데이터베이스의 최대 단일 필드 구성 수

  • Google Cloud 프로젝트에 결제를 사용 설정하지 않은 경우 200개입니다.

    할당량이 더 필요하다면 Google Cloud 프로젝트에 결제를 사용 설정해야 합니다.

  • Google Cloud 프로젝트에 결제를 사용 설정하면 1,000개입니다.

하나의 필드 수준 구성은 동일한 필드에 여러 구성을 포함할 수 있습니다. 예를 들어 동일한 필드의 단일 필드 색인 생성 예외와 TTL 정책은 한도에서 1개의 필드 구성으로 집계됩니다.

내보내기/가져오기

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

한도 세부정보
프로젝트에 분당 허용되는 내보내기 및 가져오기 요청 최대 총합 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로 제한됩니다.