Управляйте Cloud Firestore с помощью консоли Firebase

В консоли Firebase в Cloud Firestore можно выполнять следующие действия:

• Просмотр, добавление, редактирование и удаление данных.
• Создавайте и обновляйте Cloud Firestore Security Rules .
• Управление индексами.
• Мониторинг использования.

Просмотреть данные

Все данные Cloud Firestore можно просмотреть в консоли Firebase. На вкладке « Данные Cloud Firestore щелкните документ или коллекцию, чтобы открыть данные, вложенные в этот элемент.

Откройте определенный путь

Чтобы открыть документ или коллекцию по указанному пути, используйте кнопку «Изменить путь» .

Фильтрация документов в коллекции

Для фильтрации документов, перечисленных в коллекции, используйте кнопку « Фильтровать список» ).

Несуществующие документы о предках

Документ может существовать, даже если один или несколько его предков не существуют. Например, документ по пути /mycoll/mydoc/mysubcoll/mysubdoc может существовать, даже если родительский документ /mycoll/mydoc отсутствует. В средстве просмотра данных Cloud Firestore несуществующий родительский документ отображается следующим образом:

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

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

Данные запроса

Запросы к документам можно выполнять на вкладке «Конструктор запросов» на странице данных Cloud Firestore .

1. Перейдите на страницу «Данные Cloud Firestore .

2. Перейдите на вкладку «Конструктор запросов» .

3. Выберите область запроса .

   Выберите «Коллекция» , чтобы выполнить запрос к одной коллекции. В текстовом поле введите путь к коллекции.

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

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

4. Нажмите «Добавить в запрос», чтобы отфильтровать возвращаемый набор документов. По умолчанию конструктор запросов добавляет условие WHERE . Вы можете изменить это условие, используя раскрывающиеся списки и текстовые поля, или выбрать одно из других доступных условий. Чтобы продолжить создание более сложных запросов, нажмите «Добавить в запрос» .

   Чтобы удалить условие запроса, нажмите кнопку удалить). Чтобы удалить все условия запроса, нажмите кнопку «Очистить» .

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

5. Нажмите «Выполнить» , чтобы получить результаты из вашей базы данных.

Требования и ограничения запроса

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

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

• Условия ORDER BY должны соответствовать полям в условиях WHERE и располагаться в том же порядке. По умолчанию результаты сортируются по идентификатору документа. Если вы фильтруете по любому другому полю, имеющему значение, отличное от равенства ( == ), добавьте условие ORDER BY для этого поля.

• В условиях запроса, содержащих операторы Range ( < , <= , > , >= ) и Not Equals ( != , not-in ), фильтрация должна осуществляться по одному и тому же полю.

Дополнительные ограничения см. в разделе «Ограничения запросов» .

Управление данными

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

Вы можете добавлять, редактировать и удалять документы и коллекции из консоли Firebase. Для управления данными откройте вкладку «Данные» в разделе Cloud Firestore :

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

Добавить данные

1. Нажмите «Добавить коллекцию» , затем введите название вашей коллекции и нажмите «Далее» .
2. Введите конкретный идентификатор документа или нажмите «Автоматический идентификатор» , затем добавьте поля для данных в вашем документе.
3. Нажмите «Сохранить» . Ваша новая коллекция и документ отобразятся в окне просмотра данных.
4. Чтобы добавить в коллекцию больше документов, нажмите «Добавить документ» .

Редактировать данные

1. Щелкните по коллекции, чтобы просмотреть ее документы, затем щелкните по документу, чтобы просмотреть его поля и подколлекции.
2. Щелкните по полю, чтобы изменить его значение. Чтобы добавить поля или подколлекции в выбранный документ, нажмите «Добавить поле» или «Добавить коллекцию» .

Удалить данные

Чтобы удалить коллекцию:

1. Выберите коллекцию, которую хотите удалить.
2. Щелкните значок меню в верхней части столбца документов, затем щелкните «Удалить коллекцию» .

Чтобы удалить документ или все его поля:

1. Выберите документ, который хотите удалить.
2. Щелкните значок меню в верхней части столбца с подробными сведениями о документе. Выберите «Удалить документ» или «Удалить поля документа» .

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

Чтобы удалить определенное поле в документе:

1. Выберите документ, чтобы просмотреть его поля.
2. Нажмите на значок удаления рядом с полем, которое хотите удалить.

Управление Cloud Firestore Security Rules

Чтобы добавлять, редактировать и удалять Cloud Firestore Security Rules из консоли Firebase, перейдите на вкладку «Правила» в разделе Cloud Firestore . Подробнее о настройке и персонализации правил можно узнать здесь.

Управление индексами

Чтобы создавать новые индексы для ваших запросов и управлять существующими индексами из консоли Firebase, перейдите на вкладку «Индексы» в разделе Cloud Firestore . Подробнее об управлении индексами можно узнать здесь.

Мониторинг использования

Чтобы отслеживать использование Cloud Firestore , откройте вкладку « Использование Cloud Firestore в консоли Firebase. Используйте панель мониторинга для оценки использования за разные периоды времени.