Za pomocą konsoli Firebase możesz wykonać te działania w Cloud Firestore:
- wyświetlać, dodawać, edytować i usuwać dane;
- Tworzenie i aktualizowanie reguł zabezpieczeń Cloud Firestore.
- Zarządzaj indeksami.
- Monitoruj wykorzystanie.
Wyświetl dane
Wszystkie swoje dane Cloud Firestore możesz wyświetlić w konsoli Firebase. Na karcie Dane w Cloud Firestore kliknij dokument lub kolekcję, aby otworzyć dane zagnieżdżone 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 elementów nadrzędnych
Dokument może istnieć nawet wtedy, gdy nie ma żadnego
jego elementów nadrzędnych. 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 elementu nadrzędnego w ten sposób:
- Na liście dokumentów w kolekcji identyfikatory nieistniejących dokumentów elementów nadrzędnych są pisane kursywą.
- W panelu informacyjnym dokumentu o nieistniejącym elemencie nadrzędnym przeglądarka danych wskazuje, że taki dokument nie istnieje.
Dane zapytań
Zapytania o dokumenty możesz wysyłać na karcie Kreator zapytań na stronie Dane Cloud Firestore.
Kliknij kartę Kreator zapytań.
Wybierz zakres zapytania.
Wybierz Kolekcja, aby wysłać zapytanie dotyczące pojedynczej kolekcji. 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.
W tabeli automatycznie wyświetlą się dokumenty z określonej kolekcji lub grupy kolekcji.
Aby przefiltrować 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 kontynuować tworzenie bardziej złożonych zapytań, kliknij Dodaj do zapytania.Aby usunąć klauzulę zapytania, kliknij jej przycisk usuwania
. Aby usunąć wszystkie klauzule zapytań, kliknij Wyczyść.Kliknij Uruchom, aby pobrać wyniki z bazy danych.
Wymagania i ograniczenia dotyczące zapytań
Korzystając z konstruktora zapytań, pamiętaj o poniższych wymaganiach i ograniczeniach dotyczących zapytań.
Wszystkie zapytania muszą być obsługiwane przez co najmniej 1 indeks. Jeśli baza danych nie znajdzie indeksu obsługującego zapytanie, zwróci błąd z linkiem do utworzenia wymaganego indeksu.
Klauzule
ORDER BY
muszą pasować do pól w klauzulachWHERE
i mieć tę samą kolejność. Wyniki są domyślnie uporządkowane według identyfikatora dokumentu. Jeśli filtrujesz według dowolnego innego pola, które ma wartość inną niż równość (==
), dodaj do tego pola klauzulęORDER BY
.Wszystkie klauzule zapytań typu „zakres” (
<
,<=
,>
,>=
) i różne od (!=
,not-in
) muszą filtrować według tego samego pola.
Dodatkowe ograniczenia znajdziesz w sekcji Ograniczenia zapytań.
Zarządzaj danymi
W Cloud Firestore możesz przechowywać dane w dokumentach i porządkować je w kolekcje. Zanim zaczniesz dodawać dane, dowiedz się więcej o modelu danych Cloud Firestore.
W konsoli Firebase możesz dodawać, edytować i usuwać dokumenty oraz kolekcje. Aby zarządzać swoimi danymi, otwórz kartę Dane w sekcji Cloud Firestore:
Dodaj dane
- Kliknij Dodaj kolekcję, wpisz nazwę kolekcji i kliknij Dalej.
- Wpisz konkretny identyfikator dokumentu lub kliknij Automatyczny identyfikator, a następnie dodaj pola na dane 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ć zawarte w niej dokumenty, a potem kliknij dokument, aby wyświetlić jego pola i kolekcje podrzędne.
- 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 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 z informacjami o dokumencie. Wybierz Usuń dokument lub Usuń pola dokumentu.
Usunięcie dokumentu powoduje usunięcie wszystkich zagnieżdżonych danych 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ądzanie regułami zabezpieczeń Cloud Firestore
Aby w konsoli Firebase dodawać, edytować i usuwać reguły zabezpieczeń Cloud Firestore, otwórz kartę Reguły w sekcji Cloud Firestore. Dowiedz się więcej o konfigurowaniu i dostosowywaniu reguł.
Zarządzaj indeksami
Aby utworzyć nowe indeksy dla zapytań i zarządzać istniejącymi indeksami z poziomu konsoli Firebase, otwórz kartę Indeksy w sekcji Cloud Firestore. Dowiedz się więcej o zarządzaniu indeksami.
Monitorowanie wykorzystania
Aby monitorować wykorzystanie Cloud Firestore, otwórz kartę Użycie Cloud Firestore w konsoli Firebase. Używaj panelu do mierzenia wykorzystania w różnych okresach.