Tworzenie zapisanych zapytań i zarządzanie nimi

Aby ponownie używać typowych operacji na bazie danych i udostępniać je w różnych sesjach, możesz tworzyć, porządkować i zarządzać zapisanymi zapytaniami w konsoli Firebase. Więcej informacji znajdziesz w artykule Omówienie zapisanych zapytań.

Funkcja zapisanych zapytań jest dostępna tylko w konsoli, a nie przy użyciu interfejsów API.

Wymagane role

Aby uzyskać uprawnienia potrzebne do korzystania z zapisanych zapytań, poproś administratora o przyznanie Ci następujących ról Identity and Access Management (IAM) w projekcie:

  • Aby wyświetlić zapisane zapytania: Wyświetlający Cloud Datastore (roles/datastore.viewer)
  • Aby wyświetlać, tworzyć, modyfikować i usuwać zapisane zapytania: Użytkownik Cloud Datastore (roles/datastore.user)
  • Aby zarządzać zapisanymi zapytaniami oraz je wyświetlać, tworzyć, modyfikować i usuwać: Właściciel Cloud Datastore (roles/datastore.owner). Ta rola ma szerokie uprawnienia i zapewnia pełny dostęp do Cloud Firestore. Jest przeznaczona tylko dla administratorów.

Więcej informacji o przyznawaniu ról znajdziesz w artykule o zarządzaniu dostępem do projektów, folderów i organizacji.

Te role zdefiniowane zawierają uprawnienia wymagane do korzystania z zapisanych zapytań. Więcej informacji o wymaganych uprawnieniach znajdziesz w odpowiednim artykule.

Wymagane uprawnienia

Aby tworzyć, wyświetlać, modyfikować i usuwać zapisane zapytania, musisz mieć te uprawnienia uprawnień na poziomie projektu:

Czynność Wymagane uprawnienia
Tworzenie zapisanych zapytań
  • databasesconsole.studioQueries.create
Wyświetlanie zapisanych zapytań
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Modyfikowanie zapisanych zapytań
  • databasesconsole.studioQueries.update
Usuwanie zapisanych zapytań
  • databasesconsole.studioQueries.delete
Zarządzanie zapisanymi zapytaniami
(tylko dla administratorów)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

Uprawnienia te możesz też uzyskać, używając ról niestandardowych lub innych ról zdefiniowanych.

Rola Użytkownik zapytań w Studio (roles/databasesconsole.studioQueryUser) zapewnia dostęp do tworzenia, wyświetlania i zapisywania zapytań. Ta rola spełnia potrzeby większości użytkowników.

Przypisz rolę Administrator zapytań Studio (roles/databasesconsole.studioQueryAdmin) tylko administratorom. Więcej informacji o Cloud Firestore IAM znajdziesz w artykule Identity and Access Management.

Tworzenie zapisanego zapytania

Aby utworzyć zapisane zapytanie, wykonaj te czynności:

  1. W konsoli Firebase otwórz stronę Cloud Firestore.
    Cloud Firestore
  2. Wybierz bazę danych, w której chcesz utworzyć zapisane zapytanie. Baza danych musi być instancją w wersji Enterprise.
  3. Kliknij kartę Edytor zapytań.
  4. W edytorze zapytań wpisz zapytanie.
  5. Kliknij Zapisz.
  6. W oknie Zapisz zapytanie wpisz nazwę zapisanego zapytania.
  7. Kliknij Zapisz.

Otwieranie i uruchamianie zapisanego zapytania

Aby otworzyć zapisane zapytanie jako nowe zapytanie, wykonaj te czynności:

  1. W edytorze zapytań kliknij Zapisane zapytania ().
  2. Kliknij zapisane zapytanie, aby otworzyć je w nowej karcie edytora. Opcjonalnie możesz kliknąć Wyświetl działania obok zapisanego zapytania. Następnie kliknij Otwórz zapytanie, aby otworzyć je w nowej karcie edytora.
  3. Kliknij Wykonaj.

Aktualizowanie zapisanego zapytania

Aby zaktualizować istniejące zapisane zapytanie, wykonaj te czynności:

  1. W edytorze zapytań kliknij Zapisane zapytania ().
  2. Kliknij zapisane zapytanie, aby otworzyć je w nowej karcie edytora. Opcjonalnie możesz kliknąć Wyświetl działania obok zapisanego zapytania. Następnie kliknij Otwórz zapytanie, aby otworzyć je w nowej karcie edytora.
  3. Zmodyfikuj zapytanie.
  4. Aby zapisać zmodyfikowane zapytanie, kliknij Zapisz.

Wyświetlanie listy wszystkich zapisanych zapytań i zarządzanie nią

Aby wyświetlić listę wszystkich zapisanych zapytań w projekcie, wykonaj te czynności:

W konsoli Google Cloud otwórz stronę Zapisane zapytania.

Otwórz stronę Zapisane zapytania

Na stronie Zapisane zapytania możesz wyszukiwać, filtrować, wyświetlać i usuwać zapytania. Nie możesz edytować istniejącego zapytania na stronie Zapisane zapytania.

Usuwanie zapisanego zapytania

Zapisane zapytanie możesz usunąć na stronie Cloud Firestore Studio lub Zapisane zapytania w konsoli Google Cloud.

  1. W edytorze zapytań kliknij Zapisane zapytania ().
  2. Kliknij Wyświetl działania obok zapisanego zapytania, które chcesz usunąć. Następnie, aby usunąć zapisane zapytanie, kliknij Usuń zapytanie.
  3. W oknie Usuń zapytanie kliknij Usuń.

Zapisane zapytanie możesz też usunąć na stronie Zapisane zapytania. Aby usunąć zapisane zapytanie na stronie Zapisane zapytania, wykonaj te czynności:

  1. Otwórz stronę Zapisane zapytania.
  2. Kliknij Wyświetl działania obok zapisanego zapytania, które chcesz usunąć.
  3. Aby usunąć zapisane zapytanie, kliknij Usuń zapytanie.
  4. W oknie Usuń zapytanie kliknij Usuń.

Co dalej?