콘솔로 이동

저장소 크기 계산

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

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

문자열 크기

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

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

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

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

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

문서 이름 크기

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

  • 문서 이름의 전체 문자열 크기(정수 ID는 각각 8바이트)
  • 추가 16바이트

숫자 ID가 사용된 Task라는 컬렉션의 문서는 다음과 같습니다.

Task id:5730082031140864

크기는 5 + 8 + 16 = 29바이트입니다.

  • Task 컬렉션 ID에 5바이트
  • 숫자 ID에 8바이트
  • 추가 16바이트

문자열 ID가 사용된 Task라는 컬렉션의 문서는 다음과 같습니다.

Task name:my_task_id

크기는 5 + 11 + 16 = 32바이트입니다.

  • Task 컬렉션 ID에 5바이트
  • my_task_id 문자열 ID에 11바이트
  • 추가 16바이트

필드 크기

필드 크기는 다음 항목의 총합입니다.

  • 필드 이름의 문자열 크기
  • 필드 값의 크기

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

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

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

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

문서 크기

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

숫자 ID가 사용된 Task 컬렉션의 문서에 대한 예는 다음과 같습니다.

Task id:5730082031140864
 - "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

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

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

색인 항목 크기

색인 항목의 크기는 다음 항목의 총합입니다.

  • 색인 생성된 문서의 문서 이름 크기
  • 색인이 생성된 필드 크기의 총합
  • 색인이 자동 생성되는 경우 색인이 생성된 문서의 컬렉션 ID 크기(복합 색인에는 적용되지 않음)
  • 추가 32바이트

문서의 모든 필드를 포함하는 대신 색인에 필요한 필드만 저장한다는 점을 제외하고는 문서 크기와 동일한 패턴이 사용됩니다. 또한 색인 항목의 크기는 1500바이트를 초과하지 않습니다.

위의 예와 같은 문서를 사용할 경우:

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

done이 색인이 생성된 필드인 경우 단일 필드 done의 자동 색인 항목은 색인 항목의 문서 이름, done 필드 이름 및 값, Task 컬렉션 ID, 32바이트로 구성됩니다. 이 색인 항목의 총 크기는 72바이트입니다.

  • 문서 이름에 29바이트
  • done 필드 이름과 부울 값에 6바이트
  • Task 컬렉션 ID에 5바이트
  • 추가 32바이트

기본적으로 Cloud Firestore에서는 각 문서의 필드마다 오름차순 및 내림차순의 단일 필드 색인이 각각 1개씩 자동으로 미리 정의됩니다. 따라서 이 문서는 오름차순의 단일 필드 done 색인에 대한 72바이트 색인 항목과 내림차순의 단일 필드 done 색인에 대한 72바이트 색인 항목을 갖게 됩니다.

동일한 문서를 사용해 donepriority 필드(모두 오름차순)를 사용하는 복합 색인의 크기에 대해 생각해 보세요. 이 색인의 색인 항목 총 크기는 84바이트입니다.

  • 문서 이름에 29바이트
  • done 필드 이름 및 부울 값에 6바이트
  • priority 필드 이름 및 정수 값에 17바이트
  • 추가 32바이트

다음 과정

Cloud Firestore 가격 책정에 대해 알아보세요.