Zarządzanie Cloud Firestore za pomocą konsoli Firebase

W Cloud Firestore możesz wykonać te czynności, korzystając z konsoli Firebase:

  • wyświetlać, dodawać, edytować i usuwać dane;
  • Tworzenie i aktualizowanie Cloud Firestore Security Rules.
  • Zarządzaj indeksami.
  • Monitoruj wykorzystanie.

Wyświetl dane

Wszystkie dane Cloud Firestore możesz wyświetlać w konsoli Firebase. Na karcie Cloud Firestore Dane kliknij dokument lub kolekcję, aby otworzyć dane zagnieżdżone w tym elemencie.

Otwieranie określonej ścieżki

Aby otworzyć dokument lub kolekcję w określonej ścieżce, kliknij przycisk Edytuj ścieżkę :

Kliknij przycisk Edytuj ścieżkę, aby otworzyć konkretny dokument lub kolekcję.

Filtrowanie dokumentów w kolekcji

Aby przefiltrować dokumenty na liście w kolekcji, kliknij przycisk Filtruj listę .

Kliknij przycisk Filtruj listę, aby przefiltrować wyświetlone dokumenty.

Nieistniejące dokumenty przodków

Dokument może istnieć, nawet jeśli nie ma jednego lub większej liczby 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. Cloud Firestore Przeglądarka danych wyświetla nieistniejący dokument nadrzędny w ten sposób:

  • Na liście dokumentów w kolekcji identyfikatory dokumentów nadrzędnych, które nie istnieją, są pisane kursywą.
  • W panelu informacji o nieistniejącym dokumencie nadrzędnym przeglądarka danych wskazuje, że dokument nie istnieje.

Nieistniejący dokument nadrzędny w konsoli.

Wysyłanie zapytań o dane

Możesz wyszukiwać dokumenty na karcie Kreator zapytań na stronie Cloud Firestore Dane.

  1. Otwórz Cloud Firestorestronę Dane

  2. Kliknij kartę Konstruktor zapytań.

  3. Wybierz zakres zapytania.

    Aby wysłać zapytanie do pojedynczej kolekcji, wybierz Kolekcja. W polu tekstowym wpisz ścieżkę do kolekcji.

    Wybierz Grupę kolekcji, aby wysłać zapytanie do wszystkich kolekcji o tym samym identyfikatorze. W polu Grupa kolekcji wpisz identyfikator grupy kolekcji.

    Tabela będzie automatycznie wyświetlać dokumenty z określonej kolekcji lub grupy kolekcji.

  4. Aby odfiltrować zwrócony zestaw dokumentów, kliknij Dodaj do zapytania. Domyślnie konstruktor zapytań dodaje klauzulę WHERE. Możesz zmodyfikować tę klauzulę, korzystając z 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 przycisk usuwania . Aby usunąć wszystkie klauzule zapytania, kliknij Wyczyść.

  5. 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 w bazie danych nie ma indeksu, który obsługuje zapytanie, zwracany jest błąd zawierający link do utworzenia wymaganego indeksu.

  • Klauzule ORDER BY muszą być zgodne z polami w klauzulach WHERE 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 za pomocą operatora innego niż równość (==), dodaj klauzulę ORDER BY dla tego pola.

  • Klauzule zapytania zakresu (<, <=, >, >=) i nierówności (!=, not-in) muszą filtrować to samo pole.

Dodatkowe ograniczenia znajdziesz w sekcji Ograniczenia zapytań.

Zarządzaj danymi

W Cloud Firestore dane są przechowywane w dokumentach, które są pogrupowane w kolekcje. Zanim zaczniesz dodawać dane, dowiedz się więcej o Cloud Firestore modelu danych.

Dokumenty i kolekcje możesz dodawać, edytować i usuwać w konsoli Firebase. Aby zarządzać danymi, otwórz kartę Dane w sekcji Cloud Firestore:

Dodaj dane

  1. Kliknij Dodaj kolekcję, a następnie wpisz nazwę kolekcji i kliknij Dalej.
  2. Wpisz konkretny identyfikator dokumentu lub kliknij Automatyczny identyfikator, a następnie dodaj pola dla danych w dokumencie.
  3. Kliknij Zapisz. Nowa kolekcja i dokument pojawią się w przeglądarce danych.
  4. Aby dodać więcej dokumentów do kolekcji, kliknij Dodaj dokument.

Edytuj dane

  1. Kliknij kolekcję, aby wyświetlić jej dokumenty, a następnie kliknij dokument, aby wyświetlić jego pola i podkolekcje.
  2. Kliknij pole, aby edytować jego wartość. Aby dodać pola lub podzbiory do wybranego dokumentu, kliknij Dodaj pole lub Dodaj zbiór.

Usuń dane

Aby usunąć kolekcję:

  1. Wybierz kolekcję, którą chcesz usunąć.
  2. Kliknij ikonę menu u góry kolumny dokumentów, a następnie kliknij Usuń kolekcję.

W menu w kolumnie dokumentów kliknij Usuń kolekcję.

Aby usunąć dokument lub wszystkie jego pola:

  1. Wybierz dokument, który chcesz usunąć.
  2. Kliknij ikonę menu u góry kolumny ze szczegółami dokumentu. Kliknij 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 podzbiorów.

W kolumnie ze szczegółami dokumentu kliknij Usuń dokument lub Usuń pola dokumentu w menu kontekstowym.

Aby usunąć określone pole w dokumencie:

  1. Wybierz dokument, aby wyświetlić jego pola.
  2. Kliknij ikonę usuwania obok pola, które chcesz usunąć.

Kliknij ikonę usuwania, aby usunąć pole z dokumentu.

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 utworzyć nowe indeksy dla 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 Cloud Firestore, otwórz kartę Cloud Firestore Wykorzystanie w konsoli Firebase. Na panelu możesz sprawdzić wykorzystanie w różnych okresach.