Zarządzaj bazami danych

Na tej stronie dowiesz się, jak tworzyć, aktualizować i usuwać bazy danych Cloud Firestore. W ramach projektu możesz utworzyć wiele baz danych Cloud Firestore. Do skonfigurowania środowiska produkcyjnego i testowania możesz użyć wielu baz danych środowiska w celu izolowania danych klientów i regionalizacji danych.

Baza danych (default)

Jeśli Twoja aplikacja nie wymaga wielu baz danych, użyj bazy danych (default).

Jeśli nie określisz bazy danych, biblioteki klienta Cloud Firestore a Google Cloud CLI domyślnie łączą się z bazą danych (default).

Wymagane role

Aby tworzyć bazy danych i nimi zarządzać, musisz mieć rolę Owner lub Datastore Owner w ramach funkcji zarządzania tożsamością i dostępem. Te role przyznają wymagane uprawnienia.

Wymagane uprawnienia

Aby zarządzać bazami danych, musisz mieć te uprawnienia:

• Tworzenie bazy danych: datastore.databases.create
• Czytanie konfiguracji bazy danych: datastore.databases.getMetadata
• Skonfiguruj bazę danych: datastore.databases.update
• Usunięcie bazy danych: datastore.databases.delete

Utwórz bazę danych

Aby utworzyć bazę danych, użyj jednej z tych metod:

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--type=DATABASE_TYPE \
[--delete-protection]

firebase firestore:databases:create DATABASE_ID \
--location=LOCATION \
[--delete-protection DELETE_PROTECTION_ENABLEMENT]

resource "google_firestore_database" "database" {
  project     = "project-id"
  name        = DATABASE_ID
  location_id = LOCATION
  type        = DATABASE_TYPE

  // Optional
  delete_protection_state = DELETE_PROTECTION_STATE
}

Identyfikator bazy danych

Prawidłowe identyfikatory bazy danych to (default) oraz te zgodne z :

• Obejmuje tylko litery, cyfry i łączniki (-).
• Litery muszą być małe.
• Pierwszy znak musi być literą.
• Ostatni znak musi być literą lub cyfrą.
• Minimum 4 znaki.
• Może mieć maksymalnie 63 znaki.
• Nie może być identyfikatorem UUID ani przypominać identyfikatora UUID. Nie używaj na przykład identyfikatora takiego jak f47ac10b-58cc-0372-8567-0e02b2c3d479

Po usunięciu bazy danych nie możesz od razu ponownie użyć identyfikatora bazy danych, dopóki nie upłynie 5 minut.

Zabezpieczenie przed usunięciem

Użyj ochrony przed usunięciem, aby zapobiec przypadkowemu usunięciu bazy danych. Nie możesz usunąć bazy danych z włączoną ochroną przed usunięciem, dopóki nie wyłączysz i ochrony przed usunięciem. Ochrona przed usunięciem jest domyślnie wyłączona. Możesz włączyć podczas tworzenia bazy danych albo zaktualizuj konfigurację bazy danych na włączyć ochronę przed usunięciem.

Konfigurowanie Cloud Firestore Security Rules dla baz danych

Użyj interfejsu wiersza poleceń Firebase, aby wdrożyć Cloud Firestore Security Rules w każdym baz danych. Zapoznaj się z przewodnikiem po zarządzaniu usługą Cloud Firestore Security Rules i jej wdrażaniem.

Dostęp do nazwanej bazy danych za pomocą biblioteki klienta

Nazwana baza danych obejmuje każdą bazę danych o nazwie innej niż (default). Domyślnie pakiety SDK Firebase i biblioteki klienta interfejsów API Google łączą się z (default) Cloud Firestore w projekcie. Aby utworzyć klienta połączonego z nazwaną bazą danych, ustaw identyfikator bazy danych podczas tworzenia wystąpienia klienta.

Wyświetlanie baz danych

Aby wyświetlić listę baz danych, użyj jednej z tych metod:

gcloud firestore databases list

firebase firestore:databases:list

Wyświetl szczegóły bazy danych

Aby wyświetlić szczegółowe informacje o pojedynczej bazie danych, użyj jednej z tych metod:

gcloud firestore databases describe --database=DATABASE_ID

firebase firestore:databases:get DATABASE_ID

Zastąp DATABASE_ID identyfikatorem bazy danych.

Aktualizowanie konfiguracji bazy danych

Aby zaktualizować ustawienia konfiguracji bazy danych, użyj gcloud firestore databases update . Użyj tego polecenia, aby włączyć lub wyłączyć ochronę przed usunięciem.

Zmień ustawienie ochrony przed usunięciem

Aby włączyć ochronę przed usunięciem w bazie danych, użyj gcloud firestore databases update z flagą --delete-protection. Przykład:

gcloud firestore databases update --database=DATABASE_ID --delete-protection

Zastąp DATABASE_ID identyfikatorem bazy danych.

Aby wyłączyć ochronę przed usunięciem w bazie danych, użyj gcloud firestore databases update z flagą --no-delete-protection. Przykład:

gcloud firestore databases update --database=DATABASE_ID --no-delete-protection

Zastąp DATABASE_ID identyfikatorem bazy danych.

Usuwanie bazy danych

Bazę danych możesz usunąć za pomocą konsoli lub narzędzia wiersza poleceń.

Jeśli w bazie danych włączona jest ochrona przed usunięciem, musisz najpierw wyłączyć tę ochronę.

Jeśli baza danych zawiera App Engine dane wyszukiwania lub elementy typu blob, musisz najpierw usunąć te dane.

Usunięcie bazy danych nie powoduje automatycznego usunięcia Eventarc aktywatorów dla tej bazy danych. Wyzwalacz przestaje dostarczać zdarzenia, ale nadal istnieje, dopóki go nie usuniesz.

gcloud firestore databases delete --database=DATABASE_ID

Konfigurowanie uprawnień dostępu do poszczególnych baz danych

Możesz użyć warunków Identity and Access Management, aby skonfigurować uprawnienia dostępu na poziomie bazy danych. W podanych niżej przykładach używamy interfejsu wiersza poleceń Google Cloud do przypisania dostępu warunkowego co najmniej jedną bazę danych. Możesz też zdefiniować warunki uprawnień w konsoli Google Cloud.

Wyświetl istniejące zasady uprawnień

gcloud projects get-iam-policy PROJECT_ID

Ustaw PROJECT_ID na identyfikator projektu.

Przyznawanie dostępu do bazy danych

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name=="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

Ustaw następujące opcje:

• PROJECT_ID: identyfikator projektu
• EMAIL: adres e-mail reprezentujący konkretne konto Google. Na przykład: alice@example.com.
• DATABASE_ID: identyfikator bazy danych.
• TITLE: opcjonalny tytuł wyrażenia.
• DESCRIPTION: opcjonalny opis wyrażenia.

Przyznaj dostęp do wszystkich baz danych oprócz jednej

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name!="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

Ustaw następujące opcje:

• PROJECT_ID: identyfikator projektu
• EMAIL: adres e-mail reprezentujący konkretne konto Google. Na przykład: alice@example.com.
• DATABASE_ID: identyfikator bazy danych.
• TITLE: opcjonalny tytuł wyrażenia.
• DESCRIPTION: opcjonalny opis wyrażenia.

Usuń zasady dotyczące danego użytkownika i danej roli

gcloud projects remove-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' --all

Ustaw te opcje:

• PROJECT_ID: identyfikator projektu
• EMAIL: adres e-mail powiązany z konkretnym kontem Google. Na przykład: alice@example.com.

Cloud Monitoring

Wskaźniki Cloud Firestore są raportowane w ramach 2 monitorowanych zasobów.

• firestore.googleapis.com/Database
• firestore_instance(starsza wersja)

Wskaźniki zbiorcze możesz sprawdzić na poziomie bazy danych w firestore.googleapis.com/Database. Dane podawane w sekcji firestore_instance są agregowane na poziomie projektu.

Ograniczenia

• Możesz mieć maksymalnie 100 baz danych na projekt. Aby poprosić o zwiększenie tego limitu, skontaktuj się z zespołem pomocy.
• Nie możesz usunąć bazy danych (default), jeśli zawiera ona dane z wyszukiwarki GAE. Aby usunąć dane wyszukiwania z GAE, użyj interfejsu index delete API. Jeśli dane wyszukiwania GAE zostały niedawno usunięte, może minąć trochę czasu, zanim będzie można usunąć bazę danych.
• Nie możesz usunąć bazy danych (default), jeśli zawiera ona obiekty blob. Aby usunąć dane z Blobstore, użyj interfejsu Blobstore delete API. Aby sprawdzić, czy Twoja baza danych (default) zawiera dane Blobstore, uruchom to zapytanie GQL w konsoli Google Cloud: SELECT * FROM __BlobInfo__.
• Nie możesz ponownie użyć identyfikatora bazy danych przez 5 minut od usunięcia.
• Funkcja w Cloud Functions w wersji 1 nie obsługuje nazwanych baz danych Firestore. Aby skonfigurować zdarzenia dla bazodan nazwanych, użyj reguł Cloud Firestore (2 generacji).
• Wyzwalacze funkcji Firestore w wersji 1 i wyzwalacze zdarzeń Firestore mogą przestać działać po usunięciu bazy danych, nawet jeśli zostanie utworzona nowa baza danych o tej samej nazwie.

Co dalej?

• Dodawanie danych
• Pozyskiwanie danych
• Usuwanie danych