Zarządzanie Cloud Firestore za pomocą konsoli Firebase

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

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

Wyświetl dane

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

Filtrowanie dokumentów w kolekcji

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

Nieistniejące dokumenty nadrzędne

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

W Cloud Firestoreprzeglądarce danych nieistniejący dokument nadrzędny jest wyświetlany 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.

Wykonaj zapytanie o dane

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

1. Otwórz Cloud Firestore stronę Dane

2. Kliknij kartę Konstruktor zapytań.

3. Wybierz zakres zapytania.

   Aby wysłać zapytanie dotyczące pojedynczej kolekcji, kliknij 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 zbiór dokumentów, kliknij Dodaj do zapytania. Domyślnie konstruktor zapytań dodaje klauzulę WHERE. Możesz zmodyfikować ten zapis, korzystając z menu i pól tekstowych, lub wybrać jeden z innych dostępnych zapisów. 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. 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 obsługującego 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 dotyczące 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ę 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 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 zmodyfikować 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ę.

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 wszystkich podkolekcji. Usunięcie pól dokumentu nie powoduje jednak usunięcia jego kolekcji podrzędnych.

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 dodawać, edytować i usuwać Cloud Firestore Security Rules w konsoli Firebase, otwórz kartę Bazy danych i pamięć > Firestore > Reguły. Dowiedz się więcej o konfigurowaniu i dostosowywaniu reguł.

Zarządzaj indeksami

Aby utworzyć nowe indeksy zapytań i zarządzać dotychczasowymi indeksami w konsoli Firebase, otwórz Bazy danych i miejsce na dane > Firestore > kartę 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. Użyj tego panelu, aby ocenić wykorzystanie w różnych okresach.