Tworzenie zapisanych zapytań i zarządzanie nimi

Z tego artykułu dowiesz się, jak tworzyć zapisane zapytania i nimi zarządzać. Gdy tworzysz zapytania w konsoli Firebase, możesz je zapisywać i nimi zarządzać. 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 przypisanie Ci w projekcie tych ról uprawnień:

  • 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 administrować zapisanymi zapytaniami, wyświetlać je, 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 wstępnie zdefiniowane role zawierają uprawnienia wymagane do korzystania z zapisanych zapytań. Więcej informacji o wymaganych uprawnieniach znajdziesz w sekcji Wymagane uprawnienia.

Wymagane uprawnienia

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

Czynność Wymagane uprawnienia IAM
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 wstępnie zdefiniowanych ról.

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

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

Tworzenie zapisanego zapytania

Aby utworzyć zapisane zapytanie:

  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ą 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:

  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

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

  1. W edytorze zapytań kliknij Zapisane zapytania .
  2. Obok zapisanego zapytania, które chcesz usunąć, kliknij  Wyświetl działania. 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. Obok zapisanego zapytania, które chcesz usunąć, kliknij  Wyświetl działania.
  3. Aby usunąć zapisane zapytanie, kliknij Usuń zapytanie.
  4. W oknie Usuń zapytanie kliknij Usuń.

Co dalej?