Auf dieser Seite wird beschrieben, wie Sie automatische Sicherungen planen und deaktivieren, On-Demand-Sicherungen erstellen und verwalten sowie Sicherungen Ihrer Cloud SQL-Instanz ansehen können.
Weitere Informationen zur Funktionsweise von Sicherungen finden Sie unter Sicherungen.
Bedarfsorientierte Sicherung erstellen
Eine On-Demand-Sicherung erstellen:
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Der Parameter backup-start-time wird im 24-Stunden-Format in der Zeitzone UTC±00 festgelegt und definiert den Beginn eines vierstündigen Sicherungszeitraums. Die Sicherungen können zu einem beliebigen Zeitpunkt innerhalb dieses Sicherungszeitraums gestartet werden.
Bestätigen Sie Ihre Änderungen:
gcloudsqlinstancesdescribeINSTANCE_NAME
Bestätigen Sie im Abschnitt backupConfiguration, dass enabled: true und die von Ihnen angegebene Zeit angezeigt werden.
Terraform
Verwenden Sie eine Terraform-Ressource, um eine Sicherung für eine Datenbank zu erstellen.
resource "google_sql_database_instance" "default" {
name = "sqlserver-instance-backup"
region = "us-central1"
database_version = "SQLSERVER_2019_STANDARD"
root_password = "INSERT-PASSWORD-HERE"
settings {
tier = "db-custom-2-7680"
backup_configuration {
enabled = true
start_time = "20:55"
}
}
# set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
# use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
deletion_protection = false
}
Änderungen anwenden
Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Google Cloud-Projekt anzuwenden.
Legen Sie das Google Cloud-Standardprojekt fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.
Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.
Verzeichnis vorbereiten
Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).
Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.
Kopieren Sie den Beispielcode in das neu erstellte main.tf.
Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.
Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
Speichern Sie die Änderungen.
Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.
terraform init
Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:
terraform init -upgrade
Änderungen anwenden
Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:
terraform plan
Korrigieren Sie die Konfiguration nach Bedarf.
Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
terraform apply
Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.
Öffnen Sie Ihr Google Cloud-Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Google Cloud Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.
Änderungen löschen
So löschen Sie das Projekt:
Um den Löschschutz zu deaktivieren, setzen Sie in der Terraform-Konfigurationsdatei das Argument deletion_protection auf false.
deletion_protection = "false"
Wenden Sie die aktualisierte Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
terraform apply
Entfernen Sie Ressourcen, die zuvor mit Ihrer Terraform-Konfiguration angewendet wurden, indem Sie den folgenden Befehl ausführen und yes an der Eingabeaufforderung eingeben:
terraform destroy
REST Version 1
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält
INSTANCE_NAME: der Name der primären Instanz oder der Lesereplikatinstanz, die Sie für Hochverfügbarkeit konfigurieren
Benutzerdefinierten Speicherort für Sicherungen festlegen
Verwenden Sie nur dann einen benutzerdefinierten Sicherungsspeicherort, wenn dies gesetzlich vorgeschrieben ist. Wenn dies nicht erforderlich ist, verwenden Sie den standardmäßigen multiregionalen Speicherort für Sicherungen.
Sowohl für On-Demand-Sicherungen als auch für automatische Sicherungen können Sie einen benutzerdefinierten Speicherort verwenden. Eine vollständige Liste der gültigen Standortwerte finden Sie unter Instanzstandorte.
So aktualisieren Sie eine Instanz mit einem benutzerdefinierten Standort:
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Verwenden Sie eine Terraform-Ressource, um einen benutzerdefinierten Speicherort für eine Datenbankinstanzsicherung anzugeben.
resource "google_sql_database_instance" "default" {
name = "sqlserver-instance-with-backup-location"
region = "us-central1"
database_version = "SQLSERVER_2019_STANDARD"
root_password = "INSERT-PASSWORD-HERE"
settings {
tier = "db-custom-2-7680"
backup_configuration {
enabled = true
location = "us-central1"
}
}
# set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
# use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
deletion_protection = false
}
Verwenden Sie die folgenden Optionen, um eine Liste der Sicherungen und Details zu einer Sicherung aufzurufen.
Die Google Cloud Console zeigt im Sicherungsverlauf keine übersprungenen oder fehlgeschlagenen Sicherungen an. Verwenden Sie gcloud oder die API, um sich übersprungene Sicherungen anzeigen zu lassen.
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Wählen Sie im SQL-Navigationsmenü Sicherungen aus, um sich aktuelle Sicherungen sowie den Erstellungszeitpunkt und die Art der Sicherung anzeigen zu lassen.
gcloud
Listen Sie die Sicherungen der Instanz auf:
gcloudsqlbackupslist\
--instanceINSTANCE_NAME
Sie können die Ergebnisse mithilfe der standardmäßigen Listenparameter filtern.
Eine vollständige Liste finden Sie auf der Befehlsreferenzseite zu
gcloud sql backups list.
Zeigen Sie die Details einer Sicherung an. Geben Sie dazu die Sicherungs-ID in der Ausgabe des Befehls backups list an.
Eine Liste der Sicherungen während eines Ausfalls aufrufen
Wenn sich eine Instanz in einer Region befindet, in der ein Ausfall vorliegt, können Sie Sicherungen für diese Instanz nur mithilfe eines Platzhalters (-) mit der backupRuns.list API aufrufen.
Mit dem Platzhalter werden alle Sicherungen im Projekt zurückgegeben. Siehe In einer anderen Instanz wiederherstellen.
Wenn ein Ausfall in einer Region auftritt, in der für eine Instanz vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) aktiviert sind, können Sie die Sicherungen für diese Instanz nicht in einer anderen Region wiederherstellen. Der Grund dafür ist, dass Cloud SQL regionale Cloud KMS-Schlüssel für die Verschlüsselung verwendet, wenn CMEK für die Instanz aktiviert ist. Zum Wiederherstellen von Sicherungen für eine CMEK-Instanz muss Cloud SQL Zugriff auf den CMEK haben. Bei einem regionalen Ausfall besteht kein Zugriff auf die Cloud KMS-Schlüssel in dieser Region.
gcloud
Listen Sie die Sicherungen für jede Instanz in einem Projekt auf:
Suchen Sie die Sicherung für die Instanz, die Sie benötigen. Informationen zum Wiederherstellen dieser Sicherung finden Sie unter In einer anderen Instanz wiederherstellen.
REST Version 1
Listen Sie alle Sicherungen in einem Projekt auf:
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
project-id: die Projekt-ID
instance-id: die Instanz-ID oder - für eine Liste aller Sicherungen im Projekt
HTTP-Methode und URL:
GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/-/backupRuns
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Suchen Sie die Sicherung für die Instanz, die Sie benötigen. Informationen zum Wiederherstellen dieser Sicherung finden Sie unter In einer anderen Instanz wiederherstellen.
REST v1beta4
Listen Sie alle Sicherungen in einem Projekt auf:
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
project-id: die Projekt-ID
instance-id: die Instanz-ID oder - für eine Liste aller Sicherungen im Projekt
HTTP-Methode und URL:
GET https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Suchen Sie die Sicherung für die Instanz, die Sie benötigen. Informationen zum Wiederherstellen dieser Sicherung finden Sie unter In einer anderen Instanz wiederherstellen.
Sicherungsstandorte ansehen
Verwenden Sie backupRuns, um die Speicherorte der für eine Instanz erstellten Sicherungen aufzurufen:
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Wählen Sie im SQL-Navigationsmenü die Option Sicherungen aus.
In der Liste der Sicherungen werden in der Spalte Standort der Typ des Standorts (Multi-Region oder Region) und die jeweilige Multi-Region oder Region für jede Sicherung angezeigt.
Sie können die Ergebnisse mithilfe der standardmäßigen Listenparameter filtern.
Eine vollständige Liste finden Sie auf der Befehlsreferenzseite zu
gcloud sql backups list.
Sie können die Details einer einzelnen Sicherung mit der ID aus der Ausgabe des Befehls backups list auflisten.
BACKUP_ID: die ID der Sicherung. Sie finden diese ID in der Ausgabe des Befehls gcloud sql backups list.
INSTANCE_NAME: der Name der Instanz.
PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält.
In der Ausgabe wird im Parameter maxChargeableBytes die Größe der Sicherung in Byte angezeigt.
REST
Liste der Sicherungen abrufen
In diesem Beispiel wird eine Liste aller Sicherungen angezeigt, die mit einem Google Cloud-Projekt verknüpft sind. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie auf der Seite backupRuns.list.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält
INSTANCE_NAME: Name der Instanz
HTTP-Methode und URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Antwort
{
"name": "projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns",
"kind": "sql#backupRun",
"enqueuedTime": "2024-04-24T22:16:02.208Z",
"id": "INSTANCE_ID",
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
"type": "AUTOMATED",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/instances/INSTANCE_NAME/backupRuns",
"location": "us",
"description": "get a list of backups",
"instance": "INSTANCE_NAME"
}
Details zu einer Sicherung aufrufen
In diesem Beispiel werden die Details zu einer Sicherung, einschließlich der Sicherungsgröße, angezeigt. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie auf der Seite backupRuns.get.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält.
INSTANCE_NAME: der Name der Instanz.
BACKUP_ID: die Sicherungs-ID. Sie erhalten diese ID aus der Ausgabe des vorherigen Aufrufs.
HTTP-Methode und URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns/BACKUP_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Wählen Sie im SQL-Navigationsmenü die Option Sicherungen aus.
Klicken Sie auf Bearbeiten.
Maximieren Sie im Abschnitt Automatische Sicherungen die Option Erweiterte Optionen.
Geben Sie die Anzahl der Datensicherungen für die Synchronisierung ein.
Die Zahl darf nicht unter der Standardeinstellung (sieben) liegen.
Klicken Sie auf Speichern.
gcloud
Legen Sie die Anzahl der automatischen Sicherungen fest, die Sie beibehalten möchten.
Die Zahl darf nicht unter der Standardeinstellung (sieben) liegen.
Verwenden Sie eine Terraform-Ressource, um die Anzahl der automatischen Sicherungen anzugeben, die für eine Datenbankinstanz beibehalten werden sollen.
resource "google_sql_database_instance" "default" {
name = "sqlserver-instance-backup-retention"
region = "us-central1"
database_version = "SQLSERVER_2019_STANDARD"
root_password = "INSERT-PASSWORD-HERE"
settings {
tier = "db-custom-2-7680"
backup_configuration {
enabled = true
backup_retention_settings {
retained_backups = 365
retention_unit = "COUNT"
}
}
}
# set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
# use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
deletion_protection = false
}
REST v1beta4
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
unit: Optional: Die Aufbewahrungseinheit kann entweder eine Ganzzahl oder ein String sein. Die derzeit unterstützten Werte (und Standardwerte) sind 1 oder „COUNT“.
num-to-retain: Die Anzahl der automatischen Sicherungen, die aufbewahrt werden sollen. Die Zahl darf nicht unter der Standardeinstellung (sieben) liegen.
Sie können sowohl automatische als auch On-Demand-Sicherungen löschen.
Beim Löschen einer Sicherung wird gegebenenfalls weniger Speicherplatz freigegeben, als die Sicherung groß war. Dies liegt daran, dass Sicherungen inkrementell erstellt werden. Das heißt, wenn eine ältere Sicherung gelöscht wird, können einige ihrer Inhalte in eine neuere Sicherung verschoben werden, um deren Vollständigkeit zu gewährleisten.
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-12-05 (UTC)."],[],[]]
.