Zarządzaj Cloud Firestore za pomocą konsoli Firebase

Podczas korzystania z konsoli Firebase możesz wykonać następujące czynności w Cloud Firestore:

  • Przeglądaj, dodawaj, edytuj i usuwaj dane.
  • Utwórz i zaktualizuj reguły bezpieczeństwa Cloud Firestore.
  • Zarządzaj indeksami.
  • Monitoruj użycie.

Wyświetl dane

Możesz wyświetlić 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ę :

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

Filtruj dokumenty w kolekcji

Aby przefiltrować dokumenty znajdujące się w kolekcji, użyj przycisku Filtruj listę .

Kliknij przycisk Filtruj listę, aby przefiltrować wymienione dokumenty.

Nieistniejące dokumenty przodków

Dokument może istnieć nawet wtedy, gdy nie istnieje jeden lub więcej jego przodków. Na przykład dokument pod ścieżką /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 nadrzędny w następujący sposób:

  • Na liście dokumentów kolekcji identyfikatory nieistniejących dokumentów nadrzędnych są pisane kursywą .
  • W panelu informacyjnym nieistniejącego dokumentu nadrzędnego przeglądarka danych wskazuje, że dokument nie istnieje.

Nieistniejący dokument nadrzędny w konsoli.

Zapytanie o dane

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

  1. Przejdź do strony Dane Cloud Firestore

  2. Kliknij kartę Kreator zapytań .

  3. Wybierz zakres zapytania .

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

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

    W tabeli automatycznie zostaną wyświetlone dokumenty z określonej kolekcji lub grupy kolekcji.

  4. Kliknij opcję Dodaj do zapytania , aby przefiltrować zwrócony zestaw dokumentów. Domyślnie Konstruktor zapytań dodaje klauzulę WHERE . Możesz zmodyfikować tę klauzulę za pomocą rozwijanych 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 jej przycisk Usuń . Aby usunąć wszystkie klauzule zapytania, kliknij opcję Wyczyść .

  5. Kliknij opcję Uruchom , aby pobrać wyniki z bazy danych.

Wymagania i ograniczenia dotyczące zapytań

Podczas korzystania z Konstruktora zapytań należy pamiętać o następujących wymaganiach i ograniczeniach dotyczących zapytań.

  • Wszystkie zapytania muszą być obsługiwane przez jeden lub więcej indeksów. Jeśli baza danych nie może znaleźć indeksu obsługującego zapytanie, zwróci błąd zawierający łącze do zbudowania wymaganego indeksu.

  • Klauzule ORDER BY muszą odpowiadać polom klauzul 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 z czymkolwiek innym niż równość ( == ), dodaj klauzulę ORDER BY dla tego pola.

  • Klauzule zapytania dotyczące zakresu ( < , <= , > , >= ) i nierówne ( != , not-in ) muszą filtrować w tym samym polu.

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

  1. Kliknij opcję Dodaj kolekcję , następnie wprowadź nazwę kolekcji i kliknij Dalej .
  2. Wprowadź konkretny identyfikator dokumentu lub kliknij opcję Auto ID , a następnie dodaj pola na dane w swoim dokumencie.
  3. Kliknij Zapisz . Twoja 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 podzbiory.
  2. Kliknij pole, aby edytować jego wartość. Aby dodać pola lub podzbiory do wybranego dokumentu, kliknij Dodaj pole lub Dodaj kolekcję .

Usunąć 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 opcję Usuń kolekcję .

Kliknij opcję Usuń kolekcję z menu w kolumnie Dokumenty

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 opcję Usuń dokument lub Usuń pola dokumentu .

Usunięcie dokumentu powoduje usunięcie wszystkich zagnieżdżonych danych w tym dokumencie, w tym wszelkich podkolekcji. Jednakże usunięcie pól dokumentu nie powoduje usunięcia jego podzbiorów.

Kliknij Usuń dokument lub Usuń pola dokumentu z menu kontekstowego w kolumnie szczegółów dokumentu

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 regułami bezpieczeństwa Cloud Firestore

Aby dodać, edytować i usunąć 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 utworzyć nowe indeksy dla swoich zapytań i zarządzać istniejącymi indeksami z 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. Użyj panelu, aby ocenić wykorzystanie w różnych okresach czasu.