Podczas korzystania z konsoli Firebase możesz wykonać następujące czynności w Cloud Firestore:
- Przeglądaj, dodawaj, edytuj i usuwaj dane.
- Utwórz i zaktualizuj reguły bezpieczeństwa Cloud Firestore.
- Zarządzaj indeksami.
- Monitoruj użycie.
Wyświetl dane
Możesz wyświetlić wszystkie dane Cloud Firestore w konsoli Firebase. Na karcie Dane Cloud Firestore kliknij dokument lub kolekcję, aby otworzyć dane zagnieżdżone w tym elemencie.
Otwórz określoną ścieżkę
Aby otworzyć dokument lub kolekcję w określonej ścieżce, użyj przycisku Edytuj ścieżkę
:Filtruj dokumenty w kolekcji
Aby przefiltrować dokumenty znajdujące się w kolekcji, użyj przycisku Filtruj listę
.Nieistniejące dokumenty przodków
Dokument może istnieć nawet wtedy, gdy nie istnieje jeden lub więcej jego przodków. Na przykład dokument pod ścieżką /mycoll/mydoc/mysubcoll/mysubdoc
może istnieć, nawet jeśli dokument nadrzędny /mycoll/mydoc
nie istnieje. Przeglądarka danych Cloud Firestore wyświetla nieistniejący dokument nadrzędny w następujący sposób:
- Na liście dokumentów kolekcji identyfikatory nieistniejących dokumentów nadrzędnych są pisane kursywą .
- W panelu informacyjnym nieistniejącego dokumentu nadrzędnego przeglądarka danych wskazuje, że dokument nie istnieje.
Zapytanie o dane
Możesz wyszukiwać dokumenty na karcie Konstruktor zapytań na stronie Dane Cloud Firestore.
Kliknij kartę Kreator zapytań .
Wybierz zakres zapytania .
Wybierz opcję Kolekcja , aby wysłać zapytanie do pojedynczej kolekcji. W polu tekstowym wpisz ścieżkę do kolekcji.
Wybierz pozycję Grupa kolekcji , aby wysłać zapytanie do wszystkich kolekcji o tym samym identyfikatorze. W polu Grupa kolekcji wprowadź identyfikator grupy kolekcji.
W tabeli automatycznie zostaną wyświetlone dokumenty z określonej kolekcji lub grupy kolekcji.
Kliknij opcję Dodaj do zapytania , aby przefiltrować zwrócony zestaw dokumentów. Domyślnie Konstruktor zapytań dodaje klauzulę
WHERE
. Możesz zmodyfikować tę klauzulę za pomocą rozwijanych menu i pól tekstowych lub zmienić ją na jedną z innych dostępnych klauzul. Aby kontynuować tworzenie bardziej złożonych zapytań, kliknij Dodaj do zapytania .Aby usunąć klauzulę zapytania, kliknij jej przycisk Usuń
. Aby usunąć wszystkie klauzule zapytania, kliknij opcję Wyczyść .Kliknij opcję Uruchom , aby pobrać wyniki z bazy danych.
Wymagania i ograniczenia dotyczące zapytań
Podczas korzystania z Konstruktora zapytań należy pamiętać o następujących wymaganiach i ograniczeniach dotyczących zapytań.
Wszystkie zapytania muszą być obsługiwane przez jeden lub więcej indeksów. Jeśli baza danych nie może znaleźć indeksu obsługującego zapytanie, zwróci błąd zawierający łącze do zbudowania wymaganego indeksu.
Klauzule
ORDER BY
muszą odpowiadać polom klauzulWHERE
i występować w tej samej kolejności. Domyślnie wyniki są uporządkowane według identyfikatora dokumentu. Jeśli filtrujesz według innego pola z czymkolwiek innym niż równość (==
), dodaj klauzulęORDER BY
dla tego pola.Klauzule zapytania dotyczące zakresu (
<
,<=
,>
,>=
) i nierówne (!=
,not-in
) muszą filtrować w tym samym polu.
Aby zapoznać się z dodatkowymi ograniczeniami, zobacz Ograniczenia zapytań .
Zarządzaj danymi
W Cloud Firestore przechowujesz dane w dokumentach i organizujesz je w kolekcje. Zanim zaczniesz dodawać dane, dowiedz się więcej o modelu danych Cloud Firestore .
Możesz dodawać, edytować i usuwać dokumenty i kolekcje z poziomu konsoli Firebase. Aby zarządzać swoimi danymi, otwórz zakładkę Dane w sekcji Cloud Firestore :
Dodaj dane
- Kliknij opcję Dodaj kolekcję , następnie wprowadź nazwę kolekcji i kliknij Dalej .
- Wprowadź konkretny identyfikator dokumentu lub kliknij opcję Auto ID , a następnie dodaj pola na dane w swoim dokumencie.
- Kliknij Zapisz . Twoja nowa kolekcja i dokument pojawią się w przeglądarce danych.
- Aby dodać więcej dokumentów do kolekcji, kliknij Dodaj dokument .
Edytuj dane
- Kliknij kolekcję, aby wyświetlić jej dokumenty, a następnie kliknij dokument, aby wyświetlić jego pola i podzbiory.
- Kliknij pole, aby edytować jego wartość. Aby dodać pola lub podzbiory do wybranego dokumentu, kliknij Dodaj pole lub Dodaj kolekcję .
Usunąć dane
Aby usunąć kolekcję:
- Wybierz kolekcję, którą chcesz usunąć.
- Kliknij ikonę menu u góry kolumny dokumentów, a następnie kliknij opcję Usuń kolekcję .
Aby usunąć dokument lub wszystkie jego pola:
- Wybierz dokument, który chcesz usunąć.
- Kliknij ikonę menu u góry kolumny szczegółów dokumentu. Wybierz opcję Usuń dokument lub Usuń pola dokumentu .
Usunięcie dokumentu powoduje usunięcie wszystkich zagnieżdżonych danych w tym dokumencie, w tym wszelkich podkolekcji. Jednakże usunięcie pól dokumentu nie powoduje usunięcia jego podzbiorów.
Aby usunąć określone pole w dokumencie:
- Wybierz dokument, aby wyświetlić jego pola.
- Kliknij ikonę usuwania obok pola, które chcesz usunąć.
Zarządzaj regułami bezpieczeństwa Cloud Firestore
Aby dodać, edytować i usunąć reguły bezpieczeństwa Cloud Firestore z konsoli Firebase, przejdź do karty Reguły w sekcji Cloud Firestore . Dowiedz się więcej o konfigurowaniu i dostosowywaniu reguł .
Zarządzaj indeksami
Aby utworzyć nowe indeksy dla swoich zapytań i zarządzać istniejącymi indeksami z konsoli Firebase, przejdź do zakładki Indeksy w sekcji Cloud Firestore . Dowiedz się więcej o zarządzaniu indeksami .
Monitoruj użycie
Aby monitorować użycie Cloud Firestore, otwórz kartę Użycie Cloud Firestore w konsoli Firebase. Użyj panelu, aby ocenić wykorzystanie w różnych okresach czasu.