Типы индексов в Cloud Firestore

Индексы являются важным фактором производительности базы данных. Подобно индексу книги, который сопоставляет темы в книге с номерами страниц, индекс базы данных сопоставляет элементы в базе данных с их местоположениями в базе данных. Когда вы отправляете запрос к базе данных, база данных может использовать индекс для быстрого поиска местоположений запрошенных вами элементов.

На этой странице описаны два типа индексов, которые использует Cloud Firestore: индексы одного поля и составные индексы .

Индекс каждого запроса

Если для запроса не существует индекса, большинство баз данных просматривают свое содержимое элемент за элементом — медленный процесс, который замедляется еще больше по мере роста базы данных. Cloud Firestore гарантирует высокую производительность запросов за счет использования индексов для всех запросов. В результате производительность запроса зависит от размера набора результатов, а не от количества элементов в базе данных.

Меньше управления индексами, больше разработки приложений

Cloud Firestore включает в себя функции, которые сокращают время, необходимое для управления индексами. Индексы, необходимые для большинства основных запросов, создаются автоматически. Когда вы используете и тестируете свое приложение, Cloud Firestore помогает вам определить и создать дополнительные индексы, необходимые вашему приложению.

Типы индексов

Cloud Firestore использует два типа индексов: однополевые и составные . Помимо количества проиндексированных полей, индексы с одним полем и составные индексы различаются по способу управления ими.

Индексы с одним полем

Индекс с одним полем хранит отсортированное сопоставление всех документов в коллекции, содержащих определенное поле. Каждая запись в индексе с одним полем записывает значение документа для определенного поля и расположение документа в базе данных. Cloud Firestore использует эти индексы для выполнения многих базовых запросов. Вы управляете индексами с одним полем, настраивая параметры автоматического индексирования вашей базы данных и исключения индексов.

Автоматическое индексирование

По умолчанию Cloud Firestore автоматически поддерживает индексы отдельных полей для каждого поля в документе и каждого подполя на карте. Cloud Firestore использует следующие настройки по умолчанию для индексов с одним полем:

• Для каждого поля, не являющегося массивом и не являющегося картой, Cloud Firestore определяет два индекса одного поля области коллекции : один в восходящем режиме и один в нисходящем режиме.

• Для каждого поля карты Cloud Firestore создает следующее:

  • Один возрастающий индекс области коллекции для каждого подполя, не являющегося массивом или картой.
  • Один нисходящий индекс области коллекции для каждого подполя, не являющегося массивом или картой.
  • Один массив области коллекции содержит индекс для каждого подполя массива.
  • Cloud Firestore рекурсивно индексирует каждое подполе карты.

• Для каждого поля массива в документе Cloud Firestore создает и поддерживает индекс, содержащий массив.

• Индексы с одним полем в области группы сбора не поддерживаются по умолчанию.

Исключения для индекса для одного поля

Вы можете исключить поле из настроек автоматического индексирования , создав исключение индекса для одного поля. Исключение индексации переопределяет автоматические настройки индексирования всей базы данных. Исключение может включить индекс с одним полем, который в противном случае был бы отключен вашими настройками автоматического индексирования, или отключить индекс с одним полем, который в противном случае был бы включен автоматическим индексированием. Случаи, когда исключения могут быть полезны, см. в рекомендациях по индексированию .

Используйте значение пути к полю * , чтобы добавить исключения индекса на уровне коллекции для всех полей в группе коллекций. Например, для comments группы сбора задайте путь к полю * , чтобы он соответствовал всем полям в группе сбора comments , и отключите индексацию всех полей в группе сбора. Затем вы можете добавить исключения для индексации только тех полей, которые необходимы для ваших запросов. Уменьшение количества индексированных полей снижает затраты на хранение и может повысить производительность записи.

Если вы создаете исключение индекса для одного поля для поля карты, подполя карты наследуют эти настройки. Однако вы можете определить исключения из индекса одного поля для определенных подполей. Если вы удалите исключение для подполя, это подполе унаследует настройки исключения своего родительского элемента, если они существуют, или настройки всей базы данных, если родительских исключений не существует.

Чтобы создавать исключения для индексов для одного поля и управлять ими, см. раздел «Управление индексами в Cloud Firestore» .

Составные индексы

Составной индекс хранит отсортированное сопоставление всех документов в коллекции на основе упорядоченного списка индексируемых полей.

Cloud Firestore использует составные индексы для поддержки запросов, которые еще не поддерживаются индексами с одним полем.

Cloud Firestore не создает составные индексы автоматически, как это происходит с индексами с одним полем, из-за большого количества возможных комбинаций полей. Вместо этого Cloud Firestore помогает вам идентифицировать и создавать необходимые составные индексы при создании приложения.

Если вы попытаетесь выполнить приведенный выше запрос без предварительного создания необходимого индекса, Cloud Firestore вернет сообщение об ошибке, содержащее ссылку, по которой вы можете перейти, чтобы создать отсутствующий индекс. Это происходит каждый раз, когда вы пытаетесь выполнить запрос, не поддерживаемый индексом. Вы также можете определять составные индексы и управлять ими вручную с помощью консоли или интерфейса командной строки Firebase . Дополнительные сведения о создании составных индексов и управлении ими см. в разделе «Управление индексами» .

Режимы индексирования и области запросов

Вы настраиваете однополевые и составные индексы по-разному, но оба требуют настройки режимов индексирования и областей запросов для ваших индексов.

Индексные режимы

При определении индекса вы выбираете режим индексирования для каждого индексируемого поля. Режим индексирования каждого поля поддерживает определенные условия запроса для этого поля. Вы можете выбрать один из следующих режимов индексации:

Области запроса

Каждый индекс относится либо к коллекции, либо к группе коллекций. Это называется областью запроса индекса:

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

Cloud Firestore по умолчанию создает индексы с областью сбора. Эти индексы поддерживают запросы, возвращающие результаты из одной коллекции.

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

Группа коллекций включает в себя все коллекции с одинаковым идентификатором коллекции. Чтобы запустить запрос группы сбора , который возвращает отфильтрованные или упорядоченные результаты из группы сбора, необходимо создать соответствующий индекс с областью действия группы сбора.

Порядок по умолчанию и поле __name__

Помимо сортировки документов по режимам индексации, заданным для каждого поля (по возрастанию или убыванию), индексы применяют окончательную сортировку по полю __name__ каждого документа. В качестве значения поля __name__ устанавливается полный путь к документу. Это означает, что документы в наборе результатов с одинаковыми значениями полей сортируются по пути к документу.

По умолчанию поле __name__ сортируется в том же направлении, что и последнее отсортированное поле в определении индекса. Например:

Чтобы отсортировать результаты по направлению __name__ отличному от заданного по умолчанию, вам необходимо создать этот индекс.

Пример индексирования

Автоматически создавая для вас индексы с одним полем, Cloud Firestore позволяет вашему приложению быстро поддерживать самые основные запросы к базе данных. Индексы с одним полем позволяют выполнять простые запросы на основе значений полей и компараторов < , <= , == , >= , > и in . Для полей массива они позволяют выполнять запросы array-contains и array-contains-any .

Для иллюстрации рассмотрим следующие примеры с точки зрения создания индекса. Следующий фрагмент кода создает несколько документов city в коллекции cities и задает поля name , state , country , capital , population и tags для каждого документа:

var citiesRef = db.collection("cities");

citiesRef.doc("SF").set({
    name: "San Francisco", state: "CA", country: "USA",
    capital: false, population: 860000,
    regions: ["west_coast", "norcal"] });
citiesRef.doc("LA").set({
    name: "Los Angeles", state: "CA", country: "USA",
    capital: false, population: 3900000,
    regions: ["west_coast", "socal"] });
citiesRef.doc("DC").set({
    name: "Washington, D.C.", state: null, country: "USA",
    capital: true, population: 680000,
    regions: ["east_coast"] });
citiesRef.doc("TOK").set({
    name: "Tokyo", state: null, country: "Japan",
    capital: true, population: 9000000,
    regions: ["kanto", "honshu"] });
citiesRef.doc("BJ").set({
    name: "Beijing", state: null, country: "China",
    capital: true, population: 21500000,
    regions: ["jingjinji", "hebei"] });
test.firestore.js

Предполагая настройки автоматического индексирования по умолчанию, Cloud Firestore обновляет один восходящий индекс одного поля для каждого поля, не являющегося массивом, один нисходящий индекс одного поля для каждого поля, не являющегося массивом, и один массив, содержащий индекс одного поля для поля массива. Каждая строка в следующей таблице представляет запись в индексе с одним полем:

Запросы, поддерживаемые индексами с одним полем

Используя эти автоматически создаваемые индексы с одним полем, вы можете выполнять простые запросы, подобные следующим:

const stateQuery = citiesRef.where("state", "==", "CA");
const populationQuery = citiesRef.where("population", "<", 100000);
const nameQuery = citiesRef.where("name", ">=", "San Francisco");
test.firestore.js

Вы также можете in запросы на равенство ( == ):

citiesRef.where('country', 'in', ["USA", "Japan", "China"])

// Compound equality queries
citiesRef.where("state", "==", "CO").where("name", "==", "Denver")
citiesRef.where("country", "==", "USA")
         .where("capital", "==", false)
         .where("state", "==", "CA")
         .where("population", "==", 860000)

Если вам нужно запустить составной запрос, использующий сравнение диапазонов ( < , <= , > или >= ) или если вам нужно выполнить сортировку по другому полю, вы должны создать составной индекс для этого запроса.

Индекс array-contains позволяет запрашивать поле массива regions :

citiesRef.where("regions", "array-contains", "west_coast")
// array-contains-any and array-contains use the same indexes
citiesRef.where("regions", "array-contains-any", ["west_coast", "east_coast"])

Запросы, поддерживаемые составными индексами

Cloud Firestore использует составные индексы для поддержки составных запросов, которые еще не поддерживаются индексами с одним полем. Например, вам понадобится составной индекс для следующих запросов:

citiesRef.where("country", "==", "USA").orderBy("population", "asc")
citiesRef.where("country", "==", "USA").where("population", "<", 3800000)
citiesRef.where("country", "==", "USA").where("population", ">", 690000)
// in and == clauses use the same index
citiesRef.where("country", "in", ["USA", "Japan", "China"])
         .where("population", ">", 690000)

Для этих запросов требуется составной индекс, указанный ниже. Поскольку запрос использует равенство ( == или in ) для поля country , вы можете использовать режим индекса по возрастанию или убыванию для этого поля. По умолчанию в предложениях о неравенстве применяется порядок сортировки по возрастанию на основе поля в предложении о неравенстве.

Чтобы выполнить те же запросы, но с сортировкой по убыванию, вам понадобится дополнительный составной индекс в убывающем направлении для population :

citiesRef.where("country", "==", "USA").orderBy("population", "desc")

citiesRef.where("country", "==", "USA")
         .where("population", "<", 3800000)
         .orderBy("population", "desc")

citiesRef.where("country", "==", "USA")
         .where("population", ">", 690000)
         .orderBy("population", "desc")

citiesRef.where("country", "in", ["USA", "Japan", "China"])
         .where("population", ">", 690000)
         .orderBy("population", "desc")

Вам также необходимо создать составной индекс для объединения запроса array-contains или array-contains-any с дополнительными предложениями.

citiesRef.where("regions", "array-contains", "east_coast")
         .where("capital", "==", true)

// array-contains-any and array-contains use the same index
citiesRef.where("regions", "array-contains-any", ["west_coast", "east_coast"])
         .where("capital", "==", true)

Запросы, поддерживаемые индексами групп сбора

Чтобы продемонстрировать индекс с областью действия группы коллекций, представьте, что вы добавляете подколлекцию landmarks в некоторые city документы:

var citiesRef = db.collection("cities");

citiesRef.doc("SF").collection("landmarks").doc().set({
    name: "Golden Gate Bridge",
    category : "bridge" });
citiesRef.doc("SF").collection("landmarks").doc().set({
    name: "Golden Gate Park",
    category : "park" });

citiesRef.doc("DC").collection("landmarks").doc().set({
    name: "National Gallery of Art",
    category : "museum" });
citiesRef.doc("DC").collection("landmarks").doc().set({
    name: "National Mall",
    category : "park" });

Используя следующий индекс с одним полем и областью коллекции, вы можете запросить коллекцию landmarks одного города на основе поля category :

citiesRef.doc("SF").collection("landmarks").where("category", "==", "park")
citiesRef.doc("SF").collection("landmarks").where("category", "in", ["park", "museum"])

Теперь представьте, что вы хотите запросить достопримечательности во всех городах. Чтобы выполнить этот запрос к группе коллекций, состоящей из всех коллекций landmarks , необходимо включить индекс landmarks с одним полем в области группы коллекций:

Если этот индекс включен, вы можете запросить группу сбора landmarks :

var landmarksGroupRef = db.collectionGroup("landmarks");

landmarksGroupRef.where("category", "==", "park")
landmarksGroupRef.where("category", "in", ["park", "museum"])

Чтобы запустить запрос группы сбора, который возвращает отфильтрованные или упорядоченные результаты, необходимо включить соответствующий индекс с одним полем или составной индекс с областью группы сбора. Однако запросы группы коллекций, которые не фильтруют и не упорядочивают результаты, не требуют каких-либо дополнительных определений индексов.

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

db.collectionGroup("landmarks").get()

Записи указателя

Настроенные индексы вашего проекта и структура документа определяют количество записей индекса для документа. Записи индекса учитываются в пределах лимита количества записей индекса .

В следующем примере показаны записи индекса документа.

Документ

/cities/SF

city_name : "San Francisco"
temperatures : {summer: 67, winter: 55}
neighborhoods : ["Mission", "Downtown", "Marina"]

Индексы с одним полем

• название города ASC
• название города DESC
• температура.лето ASC
• температура.лето DESC
• температура.зима ASC
• температура.зима DESC
• Районы Массив содержит (ASC и DESC)

Составные индексы

• название города ASC, районы ARRAY
• название города DESC, районы ARRAY

Записи указателя

Эта конфигурация индексирования приводит к появлению следующих 18 записей индекса для документа:

Индексы и цены

Индексы увеличивают затраты на хранение вашего приложения. Дополнительные сведения о том, как рассчитывается размер хранилища для индексов, см. в разделе Размер записи индекса .

Использование преимущества слияния индексов

Хотя Cloud Firestore использует индекс для каждого запроса, он не обязательно требует наличия одного индекса для каждого запроса. Для запросов с несколькими предложениями равенства ( == ) и, при необходимости, предложением orderBy , Cloud Firestore может повторно использовать существующие индексы. Cloud Firestore может объединять индексы для простых фильтров равенства для создания составных индексов, необходимых для более крупных запросов на равенство.

Вы можете снизить затраты на индексацию, определив ситуации, в которых можно воспользоваться преимуществами объединения индексов. Например, представьте себе коллекцию restaurants для приложения для оценки ресторанов:

• collections_bookmark рестораны

  • class бургертимейм

    name : "Burger Thyme"
category : "burgers"
city : "San Francisco"
editors_pick : true
star_rating : 4
    

Теперь представьте, что это приложение использует запросы, подобные приведенным ниже. Обратите внимание, что приложение использует комбинации условий равенства для category , city и editors_pick , при этом всегда сортируя по возрастанию star_rating :

db.collection("restaurants").where("category", "==", "burgers")
                            .orderBy("star_rating")

db.collection("restaurants").where("city", "==", "San Francisco")
                            .orderBy("star_rating")

db.collection("restaurants").where("category", "==", "burgers")
                            .where("city", "==", "San Francisco")
                            .orderBy("star_rating")

db.collection("restaurants").where("category", "==", "burgers")
                            .where("city", "==" "San Francisco")
                            .where("editors_pick", "==", true )
                            .orderBy("star_rating")

Вы можете создать индекс для каждого запроса:

В качестве лучшего решения вы можете уменьшить количество индексов, воспользовавшись возможностью Cloud Firestore объединять индексы для условий равенства:

Этот набор индексов не только меньше, но и поддерживает дополнительный запрос:

db.collection("restaurants").where("editors_pick", "==", true)
                            .orderBy("star_rating")

Ограничения индексации

К индексам применяются следующие ограничения. Все квоты и лимиты см. в разделе Квоты и лимиты .

Лучшие практики индексирования

Для большинства приложений вы можете полагаться на автоматическое индексирование и ссылки на сообщения об ошибках для управления индексами. Однако вы можете добавить исключения для одного поля в следующих случаях:

Для получения дополнительной информации о том, как решить проблемы индексации (разветвление индекса, ошибки INVALID_ARGUMENT ), посетите страницу устранения неполадок .