저장용량 크기 계산

이 페이지에서는 Cloud Firestore의 문서, 문서 이름, 필드, 색인 항목의 저장소 크기에 대해 설명합니다.

저장소 비용은 Cloud Firestore 가격 책정에서 확인할 수 있습니다.

문자열 크기

문자열 크기는 UTF-8로 인코딩된 바이트 수 +1로 계산됩니다.

다음 항목은 문자열로 저장됩니다.

  • 컬렉션 ID
  • 문자열 문서 ID
  • 문서 이름
  • 필드 이름
  • 문자열 필드 값

예를 들면 다음과 같습니다.

  • 컬렉션 ID tasks는 5바이트 + 1바이트를 사용해 총 6바이트입니다.
  • 필드 이름 description은 11바이트 + 1바이트를 사용해 총 12바이트입니다.

문서 ID 크기

문서 ID 크기는 문자열 ID인 경우 문자열 크기 또는 정수 ID인 경우 8바이트입니다.

문서 이름 크기

문서 이름의 크기는 다음 항목의 총합입니다.

  • 각 컬렉션 ID 크기 및 문서 경로의 문서 ID
  • 추가 16바이트

문자열 문서 ID가 my_task_id이고 하위 컬렉션 users/jeff/tasks에 있는 문서의 경우 문서 이름 크기는 6 + 5 + 6 + 11 + 16 = 44바이트입니다.

  • users 컬렉션 ID에 6바이트
  • jeff 문서 ID에 5바이트
  • tasks 컬렉션 ID에 6바이트
  • my_task_id 문서 ID에 11바이트
  • 추가 16바이트

필드 값 크기

다음 표에서는 필드 값의 크기를 유형별로 보여줍니다.

유형 크기
배열 값 크기의 총합
부울 1바이트
바이트 바이트 길이
날짜 및 시간 8바이트
부동 소수점 수 8바이트
지리적 지점 16바이트
정수 8바이트
지도 문서 크기와 같은 방식으로 계산된 지도 크기
Null 1바이트
참조 문서 이름 크기
텍스트 문자열 UTF-8로 인코딩된 바이트 수 + 1

예를 들어 done이라는 이름의 부울 필드는 6바이트를 사용합니다.

  • done 필드 이름에 5바이트
  • 부울 값에 1바이트

문서 크기

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

다음은 문자열 문서 ID가 my_task_id이고 하위 컬렉션 users/jeff/tasks의 문서에 대한 예입니다.

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

필드의 총 크기는 70바이트입니다.

필드 이름 및 값 바이트 단위의 필드 크기
"type": "Personal" 14
필드 이름에 5 + 필드 문자열 값에 9
"done": false 6
필드 이름에 5 + 필드의 부울 값에 1
"priority": 1 17
필드 이름에 9 + 필드의 정수 값에 8
"description": "Learn Cloud Firestore" 33
필드 이름에 12 + 필드 문자열 값에 21

따라서 문서 크기는 44 + 70 + 32 = 146바이트입니다.

  • 문서 이름에 44바이트
  • 필드에 70바이트
  • 추가 32바이트

색인 항목 크기

단일 필드 및 복합 색인의 경우 색인 항목 크기는 다음과 같이 계산됩니다.

단일 필드 색인 항목 크기

단일 필드 색인 항목의 크기는 색인 범위가 컬렉션인지, 컬렉션 그룹인지에 따라 달라집니다.

컬렉션 범위

컬렉션 범위가 지정된 단일 필드 색인 항목의 크기는 다음 항목의 총합입니다.

문자열 문서 ID가 my_task_id이고 하위 컬렉션 users/jeff/tasks에 있는 문서를 살펴보겠습니다.

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

done 필드의 색인을 생성하는 컬렉션 범위가 지정된 단일 필드 색인의 경우 이 색인에 있는 항목의 총 크기는 109바이트입니다.

  • 문서 이름 users/jeff/tasks/my_task_id에 44바이트
  • 상위 문서의 문서 이름 users/jeff에 27바이트
  • done 필드 이름에 5바이트
  • 부울 필드 값에 1바이트
  • 추가 32바이트

컬렉션 그룹 범위

컬렉션 그룹 범위가 지정된 단일 필드 색인 항목의 크기는 다음 항목의 총합입니다.

문자열 문서 ID가 my_task_id이고 하위 컬렉션 users/jeff/tasks에 있는 문서를 살펴보겠습니다.

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

done 필드의 색인을 생성하는 컬렉션 그룹 범위가 지정된 단일 필드 색인의 경우 이 색인에 있는 항목의 총 크기는 98바이트입니다.

  • 문서 이름 users/jeff/tasks/my_task_id에 44바이트
  • done 필드 이름에 5바이트
  • 부울 필드 값에 1바이트
  • 추가 48바이트

복합 색인 항목 크기

복합 색인의 항목 크기는 색인 범위가 컬렉션인지, 컬렉션 그룹인지에 따라 다릅니다.

컬렉션 범위

컬렉션 범위가 지정된 복합 색인의 색인 항목 크기는 다음 항목의 총합입니다.

문자열 문서 ID가 my_task_id이고 하위 컬렉션 users/jeff/tasks에 있는 문서를 살펴보겠습니다.

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

donepriority 필드의 색인을 생성하는 컬렉션 범위가 지정된 복합 색인의 경우 이 색인에 있는 항목의 총 크기는 112바이트입니다.

  • 문서 이름 users/jeff/tasks/my_task_id에 44바이트
  • 상위 문서의 문서 이름 users/jeff에 27바이트
  • 부울 필드 값에 1바이트
  • 정수 필드 값에 8바이트
  • 추가 32바이트

컬렉션 그룹 범위

컬렉션 그룹 범위가 지정된 복합 색인의 색인 항목 크기는 다음 항목의 총합입니다.

문자열 문서 ID가 my_task_id이고 하위 컬렉션 users/jeff/tasks에 있는 문서를 살펴보겠습니다.

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

donepriority 필드의 색인을 생성하는 컬렉션 그룹 범위가 지정된 복합 색인의 경우 이 색인에 있는 색인 항목의 총 크기는 85바이트입니다.

  • 문서 이름 users/jeff/tasks/my_task_id에 44바이트
  • 부울 필드 값에 1바이트
  • 정수 필드 값에 8바이트
  • 추가 32바이트

다음 과정

Cloud Firestore 가격 책정 알아보기