이 페이지에서는 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 |
| 벡터 | 측정기준당 8바이트 |
예를 들어 done이라는 이름의 부울 필드는 6바이트를 사용합니다.
done필드 이름에 5바이트- 부울 값에 1바이트
문서 크기
문서의 크기는 다음 항목의 총합입니다.
문자열 문서 ID가 my_task_id인 하위 컬렉션 users/jeff/tasks에 있는 문서의 예입니다.
- "type": "Personal" - "done": false - "priority": 1 - "description": "Learn Cloud Firestore"
필드의 총 크기는 71바이트입니다.
| 필드 이름 및 값 | 바이트 단위의 필드 크기 |
|---|---|
"type": "Personal" |
14 필드 이름에 5 + 필드 문자열 값에 9 |
"done": false |
6 필드 이름에 5 + 필드의 부울 값에 1 |
"priority": 1 |
17 필드 이름에 9 + 필드의 정수 값에 8 |
"description": "Learn Cloud Firestore" |
34 필드 이름에 12 + 필드 문자열 값에 21 |
따라서 문서 크기는 44 + 71 + 32 = 147바이트입니다.
- 문서 이름에 44바이트
- 필드에 71바이트
- 추가 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"
done 및 priority 필드의 색인을 생성하는 컬렉션 범위가 지정된 복합 색인의 경우 이 색인에 있는 항목의 총 크기는 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"
done 및 priority 필드의 색인을 생성하는 컬렉션 그룹 범위가 지정된 복합 색인의 경우 이 색인에 있는 색인 항목의 총 크기는 85바이트입니다.
- 문서 이름
users/jeff/tasks/my_task_id에 44바이트 - 부울 필드 값에 1바이트
- 정수 필드 값에 8바이트
- 추가 32바이트