Datenbanken erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Cloud Firestore Datenbanken erstellen, aktualisieren und löschen. Sie können mehrere Cloud Firestore Datenbanken pro Projekt erstellen. Mehrere Datenbanken können verwendet werden, um Produktions- und Testumgebungen einzurichten, Kundendaten zu isolieren und Daten zu regionalisieren.

Kostenlose Nutzung

Cloud Firestore bietet eine kostenlose Stufe mit der Sie gebührenfrei Ihre ersten Schritte machen können.

Die kostenlose Stufe gilt nur für eine Cloud Firestore Datenbank pro Projekt. Die erste Datenbank, die in einem Projekt ohne Datenbank der kostenlosen Stufe erstellt wird, erhält die kostenlose Stufe. Wenn die Datenbank mit der kostenlosen Stufe gelöscht wird, erhält die nächste erstellte Datenbank die kostenlose Stufe.

Hinweis

Sie müssen die folgenden Schritte ausführen, bevor Sie eine Datenbank erstellen:

1. Falls noch nicht geschehen, erstellen Sie ein Firebase-Projekt: Klicken Sie in der Firebase Console auf Projekt hinzufügen und folgen Sie der Anleitung auf dem Bildschirm, um ein Firebase-Projekt zu erstellen oder Firebase-Dienste für ein vorhandenes Google Cloud Projekt hinzuzufügen.

2. Weisen Sie die entsprechenden IAM-Rollen zu, wie im nächsten Abschnitt beschrieben.

Erforderliche Rollen

Zum Erstellen und Verwalten von Datenbanken benötigen Sie die Owner oder Datastore Owner IAM-Rolle. Diese Rollen gewähren die erforderlichen Berechtigungen.

Erforderliche Berechtigungen

Zum Verwalten von Datenbanken benötigen Sie die folgenden Berechtigungen:

• Datenbank erstellen: datastore.databases.create
• Datenbankkonfiguration lesen: datastore.databases.getMetadata
• Datenbank konfigurieren: datastore.databases.update
• Datenbank löschen: datastore.databases.delete
• Datenbank klonen: datastore.databases.clone

Datenbank erstellen

Verwenden Sie eine der folgenden Methoden, um eine Cloud Firestore Datenbank zu erstellen:

firebase firestore:databases:create --edition enterprise DATABASE_ID \n--location=LOCATION \n[--firestore-data-access FIRESTORE_ACCESS] \n[--mongodb-compatible-data-access MONGODB_ACCESS] \n[--realtime-updates REALTIME_UPDATES]

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--edition=enterprise \
--enable-mongodb-compatible-data-access

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--edition=enterprise \
--delete-protection

resource "google_firestore_database" "database" {
  name             = "DATABASE_ID"
  location_id      = "LOCATION"
  type             = "FIRESTORE_NATIVE"
  database_edition = "ENTERPRISE"

  // Optional
  delete_protection_state = "DELETE_PROTECTION_STATE"
}

Datenbank-ID

Gültige Datenbank-IDs entsprechen den folgenden Anforderungen:

• Sie enthalten nur Buchstaben, Zahlen und Bindestriche (-).
• Buchstaben müssen Kleinbuchstaben sein.
• Das erste Zeichen muss ein Buchstabe sein.
• Das letzte Zeichen muss ein Buchstabe oder eine Zahl sein.
• Mindestens 4 Zeichen.
• Maximal 63 Zeichen.
• Sie dürfen keine UUID sein oder einer UUID ähneln. Verwenden Sie beispielsweise keine ID wie f47ac10b-58cc-0372-8567-0e02b2c3d479.

Wenn Sie eine Datenbank löschen, können Sie die Datenbank-ID erst nach fünf Minuten wiederverwenden.

Schutzmaßnahme löschen

Verwenden Sie den Löschschutz, um das versehentliche Löschen einer Datenbank zu verhindern. Der Löschschutz funktioniert so:

• Sie können eine Datenbank mit aktiviertem Löschschutz erst löschen, wenn Sie den Löschschutz deaktivieren.
• Der Löschschutz ist standardmäßig deaktiviert.
• Sie können den Löschschutz beim Erstellen der Datenbank aktivieren oder Sie können eine Datenbankkonfiguration aktualisieren, um den Lö101schschutz zu aktivieren.

Datenbanken auflisten

Verwenden Sie eine der folgenden Methoden, um Ihre Datenbanken aufzulisten:

gcloud firestore databases list

Datenbankdetails ansehen

Verwenden Sie eine der folgenden Methoden, um Details zu einer einzelnen Datenbank aufzurufen:

gcloud firestore databases describe --database=DATABASE_ID

Datenbankkonfiguration aktualisieren

Verwenden Sie den gcloud firestore databases update Befehl, um die Konfigurationseinstellungen einer Datenbank zu aktualisieren.

Mit diesem Befehl können Sie den Löschschutz ändern, aktivieren oder deaktivieren.

Einstellung für den Löschschutz aktualisieren

Verwenden Sie den Befehl gcloud firestore databases update mit dem Flag --delete-protection, um den Löschschutz für eine Datenbank zu aktivieren. Beispiel:

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

Ersetzen Sie DATABASE_ID durch eine Datenbank-ID.

Verwenden Sie den Befehl gcloud firestore databases update mit dem Flag --no-delete-protection, um den Löschschutz für eine Datenbank zu deaktivieren. Beispiel:

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

Ersetzen Sie DATABASE_ID durch eine Datenbank-ID.

Datenbank löschen

Verwenden Sie die Console oder das Befehlszeilentool, um eine Datenbank zu löschen. Für das Löschen einer Datenbank fallen keine Gebühren an.

Wenn der Löschschutz für die Datenbank aktiviert ist, müssen Sie zuerst den Löschschutz deaktivieren.

gcloud firestore databases delete --database=DATABASE_ID

Datenbank klonen

Sie können eine vorhandene Datenbank zu einem ausgewählten Zeitstempel in eine neue Datenbank klonen:

• Die geklonte Datenbank ist eine neue Datenbank, die am selben Speicherort wie die Quelldatenbank erstellt wird.

  Zum Erstellen eines Klons verwendet Cloud Firestore Daten der Wiederherstellung zu einem bestimmten Zeitpunkt (Point-in-Time Recovery, PITR) der Quelldatenbank. Die geklonte Datenbank enthält alle Daten und Indexe.

• Standardmäßig wird die geklonte Datenbank auf dieselbe Weise wie die Quelldatenbank verschlüsselt, entweder mit der Standardverschlüsselung von Google oder mit der CMEK-Verschlüsselung. Sie können einen anderen Verschlüsselungstyp angeben oder einen anderen Schlüssel für die CMEK-Verschlüsselung verwenden.

• Der Zeitstempel hat eine Granularität von einer Minute und gibt einen Zeitpunkt in der Vergangenheit an, im Zeitraum, der durch das PITR-Fensterdefiniert ist:

  • Wenn PITR für Ihre Datenbank aktiviert ist, können Sie eine beliebige Minute der letzten 7 Tage auswählen (oder weniger, wenn PITR vor weniger als 7 Tagen aktiviert wurde).
  • Wenn PITR nicht aktiviert ist, können Sie eine beliebige Minute der letzten Stunde auswählen.
  • Den frühesten Zeitstempel, den Sie auswählen können, finden Sie in der Beschreibung Ihrer Datenbank.

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/example-source-db' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--tags=key1=value1,key2=value2

gcloud firestore databases clone \
--source-database='projects/example-project/databases/example-source-db' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

Zugriffsberechtigungen pro Datenbank konfigurieren

Mit IAM-Bedingungen können Sie Zugriffsberechtigungen auf Datenbankebene konfigurieren. In den folgenden Beispielen wird die Google Cloud CLI verwendet, um bedingten Zugriff für eine oder mehrere Datenbanken zuzuweisen. Sie können IAM-Bedingungen auch in der Google Cloud Console definieren.

Vorhandene IAM-Richtlinien ansehen

gcloud projects get-iam-policy PROJECT_ID

Setzen Sie PROJECT_ID auf Ihre Projekt-ID.

Zugriff auf eine Datenbank gewähren

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'

Legen Sie Folgendes fest:

• PROJECT_ID: Ihre Projekt-ID.
• EMAIL: eine E-Mail-Adresse, die für ein bestimmtes Konto steht. Beispiel: alice@example.com.
• DATABASE_ID: eine Datenbank-ID.
• TITLE: ein optionaler Titel für den Ausdruck.
• DESCRIPTION: eine optionale Beschreibung des Ausdrucks.

Zugriff auf alle Datenbanken außer einer gewähren

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'

Legen Sie Folgendes fest:

• PROJECT_ID: Ihre Projekt-ID.
• EMAIL: eine E-Mail-Adresse, die für ein bestimmtes Konto steht. Beispiel: alice@example.com.
• DATABASE_ID: eine Datenbank-ID.
• TITLE: ein optionaler Titel für den Ausdruck.
• DESCRIPTION: eine optionale Beschreibung des Ausdrucks.

Richtlinien für ein bestimmtes Mitglied und eine bestimmte Rolle entfernen

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

Legen Sie Folgendes fest:

• PROJECT_ID: Ihre Projekt-ID.
• EMAIL: eine E-Mail-Adresse, die für ein bestimmtes Konto steht. Beispiel: alice@example.com.

Beschränkungen

Sie können maximal 100 Datenbanken pro Projekt haben. Sie können den Support kontaktieren, um eine Erhöhung dieses Limits zu beantragen.

Nächste Schritte

• Führen Sie die Kurzanleitung aus: Datenbank erstellen und eine Verbindung dazu herstellen.
• Informationen zu Verhaltensunterschieden.
• Informationen zu Cloud Monitoring Messwerten für Cloud Firestore.