Zarządzanie Cloud Firestore za pomocą konsoli Firebase

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świetlać w konsoli Firebase. Na karcie Cloud Firestore Dane kliknij dokument lub kolekcję, aby otworzyć dane zapisane w tym elemencie.

Otwieranie konkretnej ścieżki

Aby otworzyć dokument lub kolekcję w określonej ścieżce, użyj przycisku Edytuj ścieżkę:

Aby otworzyć konkretny dokument lub kolekcję, kliknij przycisk Edytuj ścieżkę.

Filtrowanie dokumentów w kolekcji

Aby filtrować dokumenty w kolekcji, użyj przycisku Filtruj listę.

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

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 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 podpowiadacz danych informuje, że dokument nie istnieje.

w konsoli nie ma dokumentu nadrzędnego;

Dane zapytania

Zapytania o dokumenty możesz wysyłać na karcie Kreator zapytań na stronie Cloud Firestore Dane.

  1. Otwórz stronę Cloud Firestore Dane

  2. Kliknij kartę Konstruktor zapytań.

  3. Wybierz zakres zapytania.

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

    Aby wysłać zapytanie do wszystkich kolekcji o tym samym identyfikatorze, wybierz Grupa kolekcji. W polu Grupa kolekcji wpisz identyfikator grupy kolekcji.

    Tabela automatycznie wyświetli dokumenty z wybranej 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ę za pomocą menu i pól tekstowych lub wybrać jedną z innych 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ść.

  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 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 klauzulach WHERE 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 z zakresem (<, <=, >, >=) 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

  1. Kliknij Dodaj kolekcję, a następnie wpisz nazwę kolekcji i kliknij Dalej.
  2. Wpisz konkretny identyfikator dokumentu lub kliknij Identyfikator automatyczny, a następnie dodaj pola 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 potem 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 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 podkolekcji.

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

Aby usunąć konkretne pole w dokumencie:

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

Aby usunąć pole z dokumentu, kliknij ikonę usuwania

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 Cloud Firestore, otwórz Cloud Firestore kartę Użycie w konsoli Firebase. W panelu możesz sprawdzać wykorzystanie w różnych okresach.