Расчеты размера хранилища

На этой странице описан размер хранилища документов, имена документов, поля и записи индекса в Cloud Firestore.

О стоимости этого хранилища можно узнать на сайте Cloud Firestore Pricing .

Размер строки

Размеры строк рассчитываются как количество байтов в кодировке UTF-8 + 1.

Следующие данные сохраняются в виде строк:

  • Идентификаторы коллекций
  • Идентификаторы строковых документов
  • Названия документов
  • Имена полей
  • Значения строковых полей

Например:

  • tasks идентификатора коллекции используют 5 байт + 1 байт, всего 6 байтов.
  • description имени поля занимает 11 байт + 1 байт, всего 12 байт.

Размер идентификатора документа

Размер идентификатора документа — это либо размер строки для строкового идентификатора, либо 8 байтов для целочисленного идентификатора.

Размер имени документа

Размер имени документа представляет собой сумму:

  • Размер каждого идентификатора коллекции и идентификатора документа в пути к документу.
  • 16 дополнительных байт

Для документа в подколлекции users/jeff/tasks со строковым идентификатором документа my_task_id размер имени документа составляет 6 + 5 + 6 + 11 + 16 = 44 байта:

  • 6 байт для идентификатора коллекции users
  • 5 байт для идентификатора документа jeff
  • 6 байт для идентификатора коллекции tasks
  • 11 байт для идентификатора документа my_task_id
  • 16 дополнительных байт

Размер значения поля

В следующей таблице показан размер значений полей по типам.

Тип Размер
Множество Сумма размеров его значений
логическое значение 1 байт
Байты Длина байта
Дата и время 8 байт
Число с плавающей запятой 8 байт
Географическая точка 16 байт
Целое число 8 байт
карта Размер карты рассчитывается так же, как и размер документа.
Нулевой 1 байт
Ссылка Размер имени документа
Текстовая строка Количество байтов в кодировке UTF-8 + 1

Например, логическое поле с именем done будет занимать 6 байт:

  • 5 байт для имени done поля
  • 1 байт для логического значения

Размер документа

Размер документа – это сумма:

Этот пример относится к документу в подколлекции users/jeff/tasks со строковым идентификатором документа my_task_id :

 - "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 для имени поля + 22 для строкового значения поля.

Итак, размер документа равен 44 + 71 + 32 = 147 байт:

  • 44 байта для имени документа
  • 71 байт для полей
  • 32 дополнительных байта

Размер записи индекса

Размеры записей индекса рассчитываются следующим образом для индексов с одним полем и составных индексов.

Размер записи индекса с одним полем

Размер записи индекса с одним полем зависит от того, относится ли индекс к коллекции или к группе коллекций.

Объем коллекции

Размер записи в индексе с одним полем с областью сбора представляет собой сумму:

Рассмотрим документ в подколлекции users/jeff/tasks со строковым идентификатором документа my_task_id :

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

Для индекса с одним полем и областью коллекции, индексирующей done поле, общий размер записи в этом индексе составляет 109 байт:

  • 44 байта для имени документа users/jeff/tasks/my_task_id
  • 27 байт для имени документа родительского документа users/jeff
  • 5 байт для имени done поля
  • 1 байт для значения логического поля
  • 32 дополнительных байта

Область действия группы сбора

Размер записи в индексе с одним полем в области группы сбора представляет собой сумму:

Рассмотрим документ в подколлекции users/jeff/tasks со строковым идентификатором документа my_task_id :

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

Для индекса с одним полем и областью группы сбора, который индексирует done поле, общий размер записи в этом индексе составляет 98 байт:

  • 44 байта для имени документа users/jeff/tasks/my_task_id
  • 5 байт для имени done поля
  • 1 байт для значения логического поля
  • 48 дополнительных байтов

Размер записи составного индекса

Размер записи в составном индексе зависит от того, относится ли индекс к коллекции или к группе коллекций.

Объем коллекции

Размер записи индекса в составном индексе с областью сбора представляет собой сумму:

Рассмотрим документ в подколлекции users/jeff/tasks со строковым идентификатором документа my_task_id :

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

Для составного индекса с областью сбора, который индексирует поля done и priority (оба по возрастанию), общий размер записи в этом индексе составляет 112 байт:

  • 44 байта для имени документа users/jeff/tasks/my_task_id
  • 27 байт для имени документа родительского документа users/jeff
  • 1 байт для значения логического поля
  • 8 байт для значения целочисленного поля
  • 32 дополнительных байта

Область действия группы сбора

Размер записи индекса в составном индексе с областью действия группы сбора представляет собой сумму:

Рассмотрим документ в подколлекции users/jeff/tasks со строковым идентификатором документа my_task_id :

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

Для составного индекса с областью действия группы сбора, который индексирует поля done и priority (оба по возрастанию), общий размер записи индекса в этом индексе составляет 85 байт:

  • 44 байта для имени документа users/jeff/tasks/my_task_id
  • 1 байт для значения логического поля
  • 8 байт для значения целочисленного поля
  • 32 дополнительных байта

Что дальше

Узнайте о ценах на Cloud Firestore .