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

На этой странице описано, как создавать и управлять сохраненными запросами. При написании запросов в Cloud Firestore Studio вы можете сохранять и управлять ими. Дополнительную информацию см. в разделе «Обзор сохраненных запросов» .

Функция сохранения запросов доступна только в консоли Google Cloud.

Требуемые роли

Чтобы получить необходимые разрешения для использования сохраненных запросов, попросите администратора предоставить вам следующие роли управления идентификацией и доступом (IAM) в проекте:

  • Для просмотра сохраненных запросов: Cloud Datastore Viewer ( roles/datastore.viewer )
  • Для просмотра, создания, изменения и удаления сохраненных запросов: Пользователь облачного хранилища данных ( roles/datastore.user )
  • Для администрирования, просмотра, создания, изменения и удаления сохраненных запросов: Владелец Cloud Datastore ( roles/datastore.owner ). Эта роль обладает широкими правами доступа и предоставляет полный доступ к Cloud Firestore только для администраторов.

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

Эти предопределенные роли содержат разрешения, необходимые для использования сохраненных запросов. Для получения дополнительной информации о необходимых разрешениях см. раздел «Необходимые разрешения» .

Необходимые разрешения

Для создания, просмотра, изменения и удаления сохраненных запросов необходимы следующие разрешения IAM на уровне проекта:

Действие Необходимые разрешения IAM
Создавайте сохраненные запросы
  • databasesconsole.studioQueries.create
Просмотреть сохраненные запросы
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Изменить сохраненные запросы
  • databasesconsole.studioQueries.update
Удалить сохраненные запросы
  • databasesconsole.studioQueries.delete
Администрирование сохраненных запросов
(Только для использования администраторами)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

Эти разрешения также можно получить, используя пользовательские роли или другие предопределенные роли .

Роль пользователя Studio Query User ( roles/databasesconsole.studioQueryUser ) предоставляет доступ к созданию, просмотру и записи сохраненных запросов. Эта роль удовлетворяет потребности большинства пользователей.

Предоставляйте роль администратора запросов Studio ( roles/databasesconsole.studioQueryAdmin ) только администраторам. Дополнительную информацию об управлении идентификацией и доступом Cloud Firestore IAM см. в разделе «Управление идентификацией и доступом» .

Создайте сохраненный запрос

Для создания сохраненного запроса выполните следующие действия:

  1. Перейдите на страницу «Все базы данных» в консоли Google Cloud.
    Все базы данных
  2. Выберите базу данных Cloud Firestore , в которой вы хотите создать сохраненный запрос.
  3. В навигационном меню нажмите Cloud Firestore Studio .
  4. В панели «Проводник» на странице Cloud Firestore Studio перейдите в раздел «Коллекции» .
  5. Щелкните по коллекции, чтобы открыть новую вкладку редактора. При желании вы можете щелкнуть «Действия просмотра рядом с коллекцией. Затем щелкните «Запрос к коллекции» , чтобы открыть новую вкладку редактора.
  6. В редакторе запросов введите запрос.
  7. Нажмите « Сохранить ».
  8. В диалоговом окне «Сохранить запрос» введите имя для сохраненного запроса.
  9. Нажмите « Сохранить ».

Откройте и выполните сохраненный запрос.

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

  1. В панели «Проводник» на странице Cloud Firestore Studio перейдите в раздел «Запросы» .
  2. Щелкните сохраненный запрос, чтобы открыть его в новой вкладке редактора. При желании вы можете щелкнуть «Действия просмотра рядом с сохраненным запросом. Затем щелкните «Открыть запрос» , чтобы открыть его в новой вкладке редактора.
  3. Нажмите «Выполнить» .

Обновить сохраненный запрос

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

  1. В панели «Проводник» на странице Cloud Firestore Studio перейдите в раздел «Запросы» .
  2. Щелкните сохраненный запрос, чтобы открыть его в новой вкладке редактора. При желании вы можете щелкнуть «Действия просмотра рядом с сохраненным запросом. Затем щелкните «Открыть запрос» , чтобы открыть его в новой вкладке редактора.
  3. Измените запрос.
  4. Чтобы сохранить измененный запрос, нажмите «Сохранить» .

Просмотр и управление списком всех сохраненных запросов.

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

  1. Перейдите на страницу «Все базы данных» в консоли Google Cloud.
    Все базы данных
  2. Выберите любую базу данных. Поскольку сохраненный запрос является дочерним элементом проекта, при наличии необходимой роли вы можете просмотреть все сохраненные запросы в проекте из любой базы данных.
  1. Выберите любую базу данных.
  2. В панели «Проводник» на странице Cloud Firestore Studio перейдите в раздел «Запросы» .
  3. Нажмите кнопку Действия просмотра » рядом с сохраненным запросом. Затем нажмите кнопку «Управление запросами» .

    Открывается страница «Сохраненные запросы» . На этой странице перечислены все сохраненные запросы в этом проекте, включая сохраненные запросы для других продуктов Google Cloud .

На странице «Сохраненные запросы» вы можете искать, фильтровать, просматривать и удалять запросы. Редактировать существующие запросы на этой странице нельзя.

Удалить сохраненный запрос

Удалить сохраненный запрос можно на странице Cloud Firestore Studio или на странице «Сохраненные запросы» в консоли Google Cloud.

  1. В панели «Проводник» на странице Cloud Firestore Studio перейдите в раздел «Запросы» .
  2. Нажмите кнопку Действия просмотра » рядом с сохраненным запросом, который вы хотите удалить. Затем, чтобы удалить сохраненный запрос, нажмите кнопку «Удалить запрос» .
  3. В диалоговом окне «Удалить запрос» нажмите «Удалить» .

Вы также можете удалить сохраненный запрос на странице «Сохраненные запросы» . Чтобы удалить сохраненный запрос на странице «Сохраненные запросы» , выполните следующие действия:

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

Что дальше?