Z tego artykułu dowiesz się, jak tworzyć zapisane zapytania i nimi zarządzać. Gdy piszesz zapytania w Cloud FirestoreStudio, 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 Google Cloud.
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, ale 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 |
|---|---|
| Tworzenie zapisanych zapytań |
|
| Wyświetlanie zapisanych zapytań |
|
| Modyfikowanie zapisanych zapytań |
|
| Usuwanie zapisanych zapytań |
|
| Zarządzanie zapisanymi zapytaniami (tylko dla administratorów) |
|
Uprawnienia te możesz też uzyskać, używając ról niestandardowych lub innych wstępnie zdefiniowanych ról.
Rola Użytkownik zapytań 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:
- W konsoli Google Cloud otwórz stronę Wszystkie bazy danych.
Wszystkie bazy danych - Wybierz Cloud Firestore bazę danych, w której chcesz utworzyć zapisane zapytanie.
- W menu nawigacyjnym kliknij Cloud Firestore Studio.
- W panelu Eksplorator na stronie Cloud Firestore Studio otwórz sekcję Kolekcje.
- Kliknij kolekcję, aby otworzyć nową kartę edytora. Opcjonalnie możesz kliknąć Wyświetl działania obok kolekcji. Następnie kliknij Kolekcja zapytań, aby otworzyć nową kartę edytora.
- W edytorze zapytań wpisz zapytanie.
- Kliknij Zapisz.
- W oknie Zapisz zapytanie wpisz nazwę zapisanego zapytania.
- Kliknij Zapisz.
Otwieranie i uruchamianie zapisanego zapytania
Aby otworzyć zapisane zapytanie jako nowe zapytanie, wykonaj te czynności:
- W panelu Eksplorator na stronie Cloud Firestore Studio otwórz sekcję Zapytania.
- 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.
- Kliknij Wykonaj.
Aktualizowanie zapisanego zapytania
Aby zaktualizować zapisane zapytanie, wykonaj te czynności:
- W panelu Eksplorator na stronie Cloud Firestore Studio otwórz sekcję Zapytania.
- 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.
- Zmodyfikuj zapytanie.
- 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ę Wszystkie bazy danych.
Wszystkie bazy danych - Wybierz dowolną bazę danych. Zapisane zapytanie jest elementem podrzędnym projektu, więc jeśli masz odpowiednią rolę, możesz wyświetlić wszystkie zapisane zapytania w projekcie z dowolnej bazy danych.
- Wybierz dowolną bazę danych.
- W panelu Eksplorator na stronie Cloud Firestore Studio otwórz sekcję Zapytania.
- Obok zapisanego zapytania kliknij
Wyświetl działania. Następnie kliknij Zarządzaj zapytaniami.
Otworzy się strona Zapisane zapytania. Na tej stronie znajdziesz listę wszystkich zapisanych zapytań w tym projekcie, w tym zapisanych zapytań dotyczących innych usług Google Cloud.
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.
- W panelu Eksplorator na stronie Cloud Firestore Studio otwórz sekcję Zapytania.
- Obok zapisanego zapytania, które chcesz usunąć, kliknij Wyświetl działania. Aby usunąć zapisane zapytanie, kliknij Usuń zapytanie.
- 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:
- Otwórz stronę Zapisane zapytania.
- Obok zapisanego zapytania, które chcesz usunąć, kliknij Wyświetl działania.
- Aby usunąć zapisane zapytanie, kliknij Usuń zapytanie.
- W oknie Usuń zapytanie kliknij Usuń.
Co dalej?
- Dowiedz się więcej o zapisanych zapytaniach.