W konsoli Firebase możesz wykonywać te czynności dotyczące Cloud Firestore:
- Wyświetlanie, dodawanie, edytowanie i usuwanie danych.
- Utwórz i zaktualizuj Cloud Firestore Security Rules.
- Zarządzaj indeksami.
- Monitorowanie wykorzystania.
Wyświetl dane
Wszystkie dane Cloud Firestore możesz wyświetlić w konsoli Firebase. Na karcie Cloud Firestore Dane kliknij dokument lub kolekcję, aby otworzyć dane zapisane w tym elemencie.
Otwórz konkretną ścieżkę
Aby otworzyć dokument lub kolekcję w określonej ścieżce, użyj przycisku
Edytuj ścieżkę:Filtrowanie dokumentów w kolekcji
Aby filtrować dokumenty wymienione w kolekcji, kliknij przycisk Lista filtrów
.Nieistniejące dokumenty nadrzędne
Dokument może istnieć, nawet jeśli jeden lub więcej jego przodków nie istnieje. Na przykład dokument o ścieżce /mycoll/mydoc/mysubcoll/mysubdoc
może istnieć, nawet jeśli dokument nadrzędny /mycoll/mydoc
nie istnieje. Wyświetlany w Cloud Firestore podgląd danych przedstawia nieistniejący dokument nadrzędny w ten sposób:
- Na liście dokumentów kolekcji identyfikatory dokumentów nieistniejących dokumentów nadrzędnych są pogrubione.
- W panelu informacji nieistniejącego dokumentu nadrzędnego podgląd danych wskazuje, że dokument nie istnieje.
Dane zapytania
Zapytania o dokumenty możesz wysyłać na karcie Kreator zapytań na stronie Cloud Firestore Dane.
Kliknij kartę Konstruktor zapytań.
Wybierz zakres zapytania.
Aby wysłać zapytanie do pojedynczej kolekcji, kliknij Kolekcja. W polu tekstowym wpisz ścieżkę do kolekcji.
Wybierz Grupa kolekcji, aby wysłać zapytanie dotyczące wszystkich kolekcji o tym samym identyfikatorze. W polu Grupa kolekcji wpisz identyfikator grupy kolekcji.
Tabela automatycznie wyświetli dokumenty z wybranej kolekcji lub grupy kolekcji.
Aby odfiltrować zwrócony zestaw dokumentów, kliknij Dodaj do zapytania. Domyślnie konstruktor zapytań dodaje klauzulę
WHERE
. Możesz ją zmodyfikować za pomocą menu i pól tekstowych lub zmienić na jedną z pozostałych dostępnych klauzul. Aby tworzyć bardziej złożone zapytania, kliknij Dodaj do zapytania.Aby usunąć element zapytania, kliknij przycisk usuwania
. Aby usunąć wszystkie klauzule zapytania, kliknij Wyczyść.Aby pobrać wyniki z bazy danych, kliknij Uruchom.
Wymagania i ograniczenia dotyczące zapytań
Podczas korzystania z Kreatora zapytań pamiętaj o tych wymaganiach i ograniczeniach dotyczących zapytań.
Wszystkie zapytania muszą być obsługiwane przez co najmniej 1 indeks. Jeśli baza danych nie może znaleźć indeksu, który obsługuje zapytanie, zwróci błąd zawierający link do utworzenia wymaganego indeksu.
Klauzule
ORDER BY
muszą być zgodne z pola w klauzulachWHERE
i występować w tej samej kolejności. Domyślnie wyniki są sortowane według identyfikatora dokumentu. Jeśli filtrujesz według dowolnego innego pola za pomocą czegoś innego niż równość (==
), dodaj do tego pola klauzulęORDER BY
.Klauzule zapytania oparte na zakresie (
<
,<=
,>
,>=
) i nierówności (!=
,not-in
) muszą się filtrować w tym samym polu.
Więcej informacji o ograniczeniach znajdziesz w sekcji Ograniczenia zapytań.
Zarządzaj danymi
W Cloud Firestore dane są przechowywane w dokumentach, a dokumenty są porządkowane w kolekcje. Zanim zaczniesz dodawać dane, dowiedz się więcej o Cloud Firestore modelu danych.
W konsoli Firebase możesz dodawać, edytować i usuwać dokumenty oraz kolekcje. Aby zarządzać danymi, otwórz kartę Dane w sekcji Cloud Firestore:
Dodaj dane
- Kliknij Dodaj kolekcję, a następnie wpisz nazwę kolekcji i kliknij Dalej.
- Wpisz konkretny identyfikator dokumentu lub kliknij Identyfikator automatyczny, a następnie dodaj pola danych w dokumencie.
- Kliknij Zapisz. 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 podkolekcje.
- Kliknij pole, aby edytować jego wartość. Aby dodać pola lub kolekcje podrzędne do wybranego dokumentu, kliknij Dodaj pole lub Dodaj kolekcję.
Usuń dane
Aby usunąć kolekcję:
- Wybierz kolekcję, którą chcesz usunąć.
- Kliknij ikonę menu u góry kolumny dokumentów, a potem kliknij 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 Usuń dokument lub Usuń pola dokumentu.
Usunięcie dokumentu powoduje usunięcie wszystkich danych zagnieżdżonych w tym dokumencie, w tym wszystkich podkolekcji. Usunięcie pól dokumentu nie powoduje jednak usunięcia jego kolekcji podrzędnych.
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 Cloud Firestore Security Rules
Aby dodawać, edytować i usuwać Cloud Firestore Security Rules w konsoli Firebase, otwórz kartę Reguły w sekcji Cloud Firestore. Dowiedz się więcej o konfigurowaniu i dostosowywaniu reguł.
Zarządzaj indeksami
Aby tworzyć nowe indeksy zapytań i zarządzać istniejącymi indeksami w konsoli Firebase, otwórz kartę Indeksy w sekcji Cloud Firestore. Dowiedz się więcej o zarządzaniu indeksami.
Monitorowanie wykorzystania
Aby monitorować wykorzystanie usługi Cloud Firestore, otwórz kartę Cloud Firestore Użycie w konsoli Firebase. W panelu możesz sprawdzać wykorzystanie w różnych okresach.