Cloud Firestore zapewnia wydajność zapytań, wymagając indeksu dla każdego zapytania. Indeksy wymagane do najbardziej podstawowych zapytań są automatycznie utworzone dla Ciebie. Gdy używasz i testujesz swoją aplikację, Cloud Firestore generuje komunikaty o błędach, które pomagają tworzyć dodatkowe indeksy wymaga aplikacji. Na tej stronie dowiesz się, jak zarządzać kontem w indeksach z jednym polem i złożonym.
Tworzenie brakującego indeksu z poziomu komunikatu o błędzie
Jeśli spróbujesz zapytanie złożone z klauzulą zakresu, która nie jest mapowana na istniejący indeks, pojawi się błąd. Komunikat o błędzie zawiera bezpośredni link do utworzenia brak indeksu w konsoli Firebase.
Kliknij wygenerowany link do konsoli Firebase, wypełnione informacje i kliknij Utwórz.
Role i uprawnienia
Zanim utworzysz indeks w Cloud Firestore, sprawdź, czy masz przypisaną jedną z tych ról:
roles/datastore.ownerroles/datastore.indexAdminroles/editorroles/owner
Jeśli masz zdefiniowane role niestandardowe, przypisz wszystkie z tych uprawnień, aby tworzyć indeksy:
datastore.indexes.createdatastore.indexes.deletedatastore.indexes.getdatastore.indexes.listdatastore.indexes.update
Korzystanie z konsoli Firebase
Aby ręcznie utworzyć nowy indeks w konsoli Firebase:
- Otwórz sekcję Cloud Firestore w konsoli Firebase.
- Otwórz kartę Indeksy i kliknij Dodaj indeks.
- Wpisz nazwę zbioru i ustaw pola, według których chcesz uporządkować indeks.
- Kliknij Utwórz.
Pola indeksu muszą być zgodne z ograniczeniami dotyczącymi ścieżek pól.
W zależności od rozmiaru zapytania kompilowanie indeksów może potrwać kilka minut. Po utworzeniu indeksów możesz je zobaczyć w Indeksy złożone. Jeśli nadal są tworzone, konsola Firebase zawiera paska stanu budynku.
Usuń indeksy
Aby usunąć indeks:
- Otwórz sekcję Cloud Firestore w konsoli Firebase.
- Kliknij kartę Indeksy.
- Najedź kursorem na indeks, który chcesz usunąć, i wybierz Usuń z menu kontekstowego.
- Aby potwierdzić, że chcesz go usunąć, w alercie kliknij Usuń.
Używanie interfejsu wiersza poleceń Firebase
Możesz też wdrażać indeksy za pomocą interfejsu wiersza poleceń Firebase.
Zacznij od uruchomienia firebase init firestore w katalogu projektu.
Podczas konfiguracji interfejs wiersza poleceń Firebase generuje plik JSON z domyślną wartością
dla indeksów w prawidłowym formacie. Edytuj plik, aby dodać więcej indeksów i wdrożyć go
za pomocą polecenia firebase deploy.
Aby wdrożyć tylko indeksy i reguły Cloud Firestore, dodaj parametr
flaga --only firestore.
Jeśli wprowadzisz zmiany w indeksach za pomocą konsoli Firebase, pamiętaj o zaktualizowaniu pliku indeksów lokalnych. Więcej informacji: dokumentację definicji indeksu JSON.
Użyj Terraform
Tworzenie indeksów w bazie danych
Baza danych Cloud Firestore może zawierać indeks pojedynczego pola lub indeks złożony. Możesz zmodyfikować plik konfiguracji Terraform, aby utworzyć indeks dla bazy danych.
Indeks jednego pola
Ten przykładowy plik konfiguracji Terraform tworzy indeks z jednym polem w polu name w kolekcji chatrooms:
firestore.tf,
resource "random_id" "variable"{
byte_length = 8
}
resource "google_firestore_field" "single-index" {
project = "project-id"
database = "database-id"
collection = "chatrooms_${random_id.variable.hex}"
field = "name"
index_config {
indexes {
order = "ASCENDING"
query_scope = "COLLECTION_GROUP"
}
indexes {
array_config = "CONTAINS"
}
}
ttl_config {}
}
- Zastąp project-id identyfikatorem projektu. Identyfikatory projektów muszą być unikalne.
- Zastąp database-id identyfikatorem bazy danych.
Indeks złożony
Ten przykładowy plik konfiguracji Terraform tworzy indeks złożony dla kombinacji pól name i description w kolekcji chatrooms:
firestore.tf,
resource "google_firestore_index" "composite-index" {
project = "project-id"
database = "database-id"
collection = "chatrooms"
fields {
field_path = "name"
order = "ASCENDING"
}
fields {
field_path = "description"
order = "DESCENDING"
}
}
- Zastąp project-id identyfikatorem projektu. Identyfikatory projektów muszą być unikalne.
- Zastąp database-id identyfikatorem bazy danych.
Czas kompilacji indeksu
Aby utworzyć indeks, Cloud Firestore musi skonfigurować indeks, a następnie uzupełnić indeks dotychczasowymi danymi. Czas kompilacji indeksu to suma czasu konfiguracji i czas uzupełniania:
Konfigurowanie indeksu może potrwać kilka minut. Minimalna kompilacja czas indeksowania to kilka minut, nawet w przypadku pustej bazy danych.
Czas uzupełniania zależy od tego, ile istniejących danych należy do nowego indeksu. więcej wartości pól zgodnych z definicją indeksu, tym dłużej zajmuje uzupełnij indeks.
Kompilacje indeksu to długo trwające operacje.
Po rozpoczęciu kompilacji indeksu Cloud Firestore przypisze
i nadać operacji unikalną nazwę. Nazwy operacji mają prefiks projects/[PROJECT_ID]/databases/(default)/operations/,
np.:
projects/project-id/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg
Możesz jednak pominąć ten prefiks podczas określania nazwy operacji dla
polecenie describe.
Wyświetlam listę wszystkich długo trwających operacji
Aby wyświetlić listę długo trwających operacji, użyj lista operacji gcloud Firestore . To polecenie zawiera listę bieżących i niedawno zakończonych operacji. Operacje są wyświetlane przez kilka dni po ich zakończeniu:
gcloud firestore operations list
Sprawdź stan operacji
Zamiast podawać wszystkie długotrwałe operacje, możesz podać szczegóły w jednej operacji:
gcloud firestore operations describe operation-name
Szacowanie czasu ukończenia
W trakcie wykonywania operacji sprawdzaj wartość pola state
ogólny stan operacji.
Żądanie dotyczące stanu długo trwającej operacji również zwraca wskaźniki
workEstimated i workCompleted. Te dane są zwracane dla liczby
dokumentów. workEstimated pokazuje szacunkową łączną liczbę dokumentów
. workCompleted
pokazuje liczbę przetworzonych dokumentów do tej pory. Po jej zakończeniu
workCompleted odzwierciedla łączną liczbę dokumentów, które zostały
aktualnie przetworzono, co może się różnić od wartości workEstimated.
Aby uzyskać przybliżone oszacowanie postępu, podziel workCompleted przez workEstimated.
szacunki mogą być niedokładne, ponieważ zależą od opóźnionych statystyk
kolekcji.
Oto na przykład stan postępu kompilacji indeksu:
{
"operations": [
{
"name": "projects/project-id/operations/AyAyMDBiM2U5NTgwZDAtZGIyYi0zYjc0LTIzYWEtZjg1ZGdWFmZWQHEjF0c2Flc3UtcmV4ZWRuaS1uaW1kYRUKSBI",
"metadata": {
"@type": "type.googleapis.com/google.firestore.admin.v1.IndexOperationMetadata",
"common": {
"operationType": "CREATE_INDEX",
"startTime": "2020-06-23T16:52:25.697539Z",
"state": "PROCESSING"
},
"progressDocuments": {
"workCompleted": "219327",
"workEstimated": "2198182"
}
},
},
...
Po zakończeniu operacji jej opis będzie zawierał ciąg "done":
true. Sprawdź wartość w polu state dla:
wyniku operacji. Jeśli w odpowiedzi pole done nie jest ustawione,
to jego wartość wynosi false. Nie zależą od istnienia wartości done.
dla trwających operacji.
Błędy tworzenia indeksu
Podczas zarządzania indeksami złożonymi i wykluczenia indeksu pojedynczego pola. Operacja indeksowania może się nie powieść, jeśli Cloud Firestore napotka problem z danymi, które będzie indeksować. Większość często oznacza to, że trafisz na limit indeksów. Dla: na przykład operacja mogła osiągnąć maksymalną liczbę wpisów indeksu na dokument.
Jeśli nie uda się utworzyć indeksu, w konsoli zobaczysz komunikat o błędzie. Po Upewnij się, że nie trafisz żadnych limity indeksowania, spróbuj wykonać operację indeksowania ponownie.