Podczas korzystania z konsoli Firebase możesz wykonać następujące czynności w Cloud Firestore:
- Przeglądaj, dodawaj, edytuj i usuwaj dane.
- Twórz i aktualizuj reguły bezpieczeństwa Cloud Firestore.
- Zarządzaj indeksami.
- Monitoruj użycie.
Wyświetl dane
Możesz przeglądać 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 filtrować dokumenty wymienione w kolekcji, użyj przycisku Filtruj listę
.Nieistniejące dokumenty przodków
Dokument może istnieć, nawet jeśli jeden lub więcej jego przodków nie istnieje. Na przykład dokument w ścieżce /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 przodka w następujący sposób:
- Na liście dokumentów kolekcji identyfikatory dokumentów nieistniejących dokumentów przodków są pisane kursywą .
- W panelu informacyjnym nieistniejącego dokumentu przodka przeglądarka danych wskazuje, że dokument nie istnieje.
Dane zapytania
Możesz wyszukiwać dokumenty na karcie Konstruktor zapytań na stronie Dane Cloud Firestore.
Kliknij kartę Konstruktor zapytań .
Wybierz zakres zapytania .
Wybierz Kolekcję , aby wykonać zapytanie dotyczące pojedynczej kolekcji. W polu tekstowym wprowadź ścieżkę do kolekcji.
Wybierz grupę kolekcji , aby wysłać zapytanie do wszystkich kolekcji o tym samym identyfikatorze. W polu Grupa kolekcji wprowadź identyfikator grupy kolekcji.
W tabeli zostaną automatycznie wyświetlone dokumenty z określonej kolekcji lub grupy kolekcji.
Kliknij Dodaj do zapytania , aby przefiltrować zwrócony zestaw dokumentów. Domyślnie Konstruktor zapytań dodaje klauzulę
WHERE
. Możesz zmodyfikować tę klauzulę za pomocą list rozwijanych i pól tekstowych lub zmienić 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 usuwania
. Aby usunąć wszystkie klauzule zapytania, kliknij Wyczyść .Kliknij Uruchom , aby pobrać wyniki z bazy danych.
Wymagania i ograniczenia zapytań
Podczas korzystania z Kreatora zapytań należy pamiętać o następujących wymaganiach i ograniczeniach dotyczących zapytań.
Wszystkie zapytania muszą być obsługiwane przez co najmniej jeden indeks. Jeśli baza danych nie może znaleźć indeksu do obsługi zapytania, zwróci błąd zawierający link do zbudowania wymaganego indeksu.
Klauzule
ORDER BY
muszą pasować do pól w klauzulachWHERE
i występować w tej samej kolejności. Domyślnie wyniki są uporządkowane według identyfikatora dokumentu. Jeśli filtrujesz według dowolnego innego pola zawierającego coś innego niż równość (==
), dodaj klauzulęORDER BY
dla tego pola.Klauzule zapytania Range (
<
,<=
,>
,>=
) i not equals (!=
,not-in
) muszą filtrować według tego samego pola.
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ę , a następnie wprowadź nazwę kolekcji i kliknij przycisk Dalej .
- Wprowadź określony identyfikator dokumentu lub kliknij Automatyczny identyfikator , a następnie dodaj pola danych w 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 podkolekcje.
- Kliknij pole, aby edytować jego wartość. Aby dodać pola lub podkolekcje 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 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 danych zagnieżdżonych w tym dokumencie, w tym wszelkich podkolekcji. Jednak usunięcie pól dokumentu nie powoduje usunięcia jego podkolekcji.
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 dodawać, edytować i usuwać 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 tworzyć nowe indeksy dla swoich zapytań i zarządzać istniejącymi indeksami z poziomu 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. Korzystaj z pulpitu nawigacyjnego, aby mierzyć wykorzystanie w różnych okresach.