Типы индексов в 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 возвращает сообщение об ошибке со ссылкой, по которой вы можете перейти, чтобы создать отсутствующий индекс.

Вы также можете определять составные индексы и управлять ими вручную с помощью консоли или интерфейса командной строки Firebase . Дополнительные сведения о создании составных индексов и управлении ими см. в разделе Управление индексами .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Поля, используемые в фильтрах равенства
• Поля, используемые в порядках сортировки
• Поля, используемые в фильтрах диапазона и неравенства (которые еще не включены в порядок сортировки)
• Поля, используемые в агрегатах (которые еще не включены в порядок сортировки и фильтры диапазона и неравенства)

Cloud Firestore вычисляет результаты запросов следующим образом:

1. Идентифицирует индекс, соответствующий коллекции запроса, свойствам фильтра, операторам фильтра и порядкам сортировки.
2. Определяет индексную позицию, с которой начинается сканирование. Начальная позиция начинается с фильтров равенства запроса и заканчивается фильтрами диапазона и неравенства в первом поле orderBy .
3. Начинает сканирование индекса, возвращая каждый документ, удовлетворяющий всем фильтрам, пока процесс сканирования не выполнит одно из следующих действий:
   • Обнаруживает документ, который не соответствует условиям фильтра, и подтверждает, что любой последующий документ никогда не будет полностью соответствовать условиям фильтра.
   • Достигает конца индекса.
   • Собирает максимальное количество результатов, запрошенных запросом.

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

Автоматически создавая для вас индексы с одним полем, 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

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

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

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

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

Использовать объединение индексов

Хотя 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")

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

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

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

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

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

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