Zarządzanie Cloud Firestore za pomocą konsoli Firebase

W Cloud Firestore możesz wykonywać te czynności za pomocą konsoli Firebase:

• wyświetlać, dodawać, edytować i usuwać dane;
• Tworzenie i aktualizowanie Cloud Firestore Security Rules.
• Zarządzanie indeksami.
• Monitorowanie wykorzystania.

Wyświetl dane

Wszystkie dane Cloud Firestore możesz wyświetlić w konsoli Firebase. Na karcie Bazy danych i pamięć masowa > Firestore > Dane 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ę create:

Filtrowanie dokumentów w kolekcji

Aby przefiltrować dokumenty na liście w kolekcji, użyj przycisku Filtruj listę filter_list.

Nieistniejące dokumenty nadrzędne

Dokument może istnieć, nawet jeśli nie istnieje co najmniej 1 z jego elementów nadrzędnych. Na przykład dokument w ścieżce /mycoll/mydoc/mysubcoll/mysubdoc może istnieć, nawet jeśli nie istnieje dokument nadrzędny /mycoll/mydoc.

Przeglądarka danych Cloud Firestore wyświetla nieistniejący dokument nadrzędny w ten sposób:

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

Wykonaj zapytanie o dane

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

1. Otwórz stronę Dane Cloud Firestore

2. Kliknij kartę Kreator zapytań.

3. Wybierz zakres zapytania.

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

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

   Tabela automatycznie wyświetli dokumenty z określonej kolekcji lub grupy kolekcji.

4. Kliknij Dodaj do zapytania, aby przefiltrować zwrócony zestaw dokumentów. Domyślnie kreator 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 cancel. Aby usunąć wszystkie klauzule zapytania, kliknij Wyczyść.

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

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 obsługującego zapytanie, zwraca błąd zawierający link do utworzenia wymaganego indeksu.

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

• Klauzule zapytania dotyczące zakresu (<, <=, >, >=) i nierówności (!=, not-in) muszą filtrować według tego samego pola.

Informacje o dodatkowych ograniczeniach 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 modelu danych Cloud Firestore.

W konsoli Firebase możesz dodawać, edytować i usuwać dokumenty oraz kolekcje. Aby zarządzać danymi, otwórz kartę Bazy danych i miejsce na dane > Firestore > Dane.

Dodaj dane

1. Kliknij Dodaj kolekcję, wpisz nazwę kolekcji i kliknij Dalej.
2. Wpisz konkretny identyfikator dokumentu lub kliknij Automatyczny identyfikator, a następnie dodaj pola danych w dokumencie.
3. Kliknij Zapisz. Nowa kolekcja i dokument pojawią się w widoku 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 zmienić jego wartość. Aby dodać pola lub podkolekcje do wybranego dokumentu, kliknij Dodaj pole lub Dodaj kolekcję.

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ę.

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

Usunięcie dokumentu powoduje usunięcie wszystkich zagnieżdżonych w nim danych, w tym podkolekcji. Usunięcie pól dokumentu nie powoduje jednak usunięcia jego podkolekcji.

Aby usunąć konkretne pole w dokumencie:

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

Zarządzaj usługą Cloud Firestore Security Rules

Aby dodać, edytować i usunąć Cloud Firestore Security Rules w konsoli Firebase, otwórz kartę Bazy danych i miejsce na dane > Firestore > Reguły. 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ę Bazy danych i miejsce na dane > Firestore > Indeksy. Dowiedz się więcej o zarządzaniu indeksami.

Monitorowanie wykorzystania

Aby monitorować wykorzystanie Cloud Firestore w konsoli Firebase, otwórz kartę Bazy danych i miejsce na dane > Firestore > Użycie. Za pomocą tego panelu możesz ocenić wykorzystanie w różnych okresach.