Zarządzanie Cloud Firestore za pomocą konsoli Firebase

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.

Ostrzeżenie: chociaż w konsoli pojawiają się nieistniejące dokumenty elementów nadrzędnych, nie pojawiają się one w zapytaniach ani zrzutach. Musisz utworzyć dokument, aby uwzględnić go w wynikach zapytania.

Dane zapytań

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

1. Otwórz stronę Dane w Cloud Firestore

2. Kliknij kartę Kreator zapytań.

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

4. 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ść.

   Uwaga: zapytania muszą spełniać wymagania i ograniczenia Cloud Firestore dotyczące zapytań. W przeciwnym razie zapytanie zakończy się niepowodzeniem i strona zwróci błąd z informacją o przyczynach niepowodzenia zapytania.

5. 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 klauzulach WHERE 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:

Uwaga: operacje odczytu, zapisu i usuwania wykonywane w konsoli są wliczane do wykorzystania Cloud Firestore. Niektóre działania w konsoli, takie jak wyświetlanie dokumentu zawierającego wiele pól, mogą powodować wygenerowanie kilku operacji.

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 na dane 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ć zawarte w niej dokumenty, a potem kliknij dokument, aby wyświetlić jego pola i kolekcje podrzędne.
2. 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ę:

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 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:

1. Wybierz dokument, aby wyświetlić jego pola.
2. 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.