Auf dieser Seite wird beschrieben, wie Sie manuell erstellte kundenverwaltete Verschlüsselungsschlüssel (CMEK) für Spanner verwenden.
Weitere Informationen zu CMEK finden Sie in der Übersicht über kundenverwaltete Verschlüsselungsschlüssel (CMEK).
CMEK-fähige Datenbank erstellen
Erstellen Sie einen Schlüssel im Cloud Key Management Service (Cloud KMS). Sie können die folgenden Schlüsseltypen mit unterschiedlichen Schutzstufen in Spanner verwenden:
Der Schlüssel muss sich am selben Standort wie Ihre Spanner-Instanz befinden. Wenn sich Ihre Spanner-Instanzkonfiguration beispielsweise in
us-west1befindet, muss sich der Speicherort des Cloud KMS-Schlüsselbunds ebenfalls inus-west1befinden.Nicht jede multiregionale Instanzkonfiguration von Spanner hat einen entsprechenden Cloud KMS-Schlüsselbundstandort. Für Spanner-Datenbanken in benutzerdefinierten, biregionalen oder multiregionalen Instanzkonfigurationen können Sie mehrere regionale (einzelne Regionen) Cloud KMS-Schlüssel verwenden, um Ihre Datenbank zu schützen. Beispiel:
- Wenn sich Ihre Spanner-Datenbank in der multiregionalen Instanzkonfiguration
nam14befindet, können Sie Cloud KMS-Schlüssel inus-east4,northamerica-northeast1undus-east1erstellen. - Wenn sich Ihre Datenbank in einer benutzerdefinierten Instanzkonfiguration befindet, die
nam3als Basisinstanzkonfiguration mit einem zusätzlichen schreibgeschützten Replikat inus-central2verwendet, können Sie Cloud KMS-Schlüssel inus-east4,us-east1,us-central1undus-central2erstellen.
Optional: Mit dem Befehl
gcloud spanner instances get-locationskönnen Sie eine Liste der Replikatstandorte in Ihrer Spanner-Instanzkonfiguration aufrufen:gcloud spanner instances get-locations <var>INSTANCE_ID</var>Weitere Informationen finden Sie in den folgenden Ressourcen:
- Wenn sich Ihre Spanner-Datenbank in der multiregionalen Instanzkonfiguration
Gewähren Sie Cloud Spanner Zugriff auf den Schlüssel.
Erstellen Sie in Cloud Shell den Dienst-Agent und rufen Sie ihn auf oder rufen Sie ihn auf, wenn das Konto bereits vorhanden ist:
gcloud beta services identity create --service=spanner.googleapis.com \ --project=PROJECT_IDWenn Sie aufgefordert werden, die Komponente gcloud Beta Commands zu installieren, geben Sie
Yein. Nach der Installation wird der Befehl automatisch neu gestartet.Mit dem Befehl
gcloud services identitywird der Dienst-Agent erstellt oder abgerufen, den Cloud Spanner verwenden kann, um in Ihrem Namen auf den Cloud KMS-Schlüssel zuzugreifen.Die Dienstkonto-ID ist wie eine E-Mail-Adresse formatiert:
Service identity created: service-xxx@gcp-sa-spanner.Weisen Sie dem Dienstkonto für jede Region (
--location) in Ihrer Spanner-Instanzkonfiguration die Rolle Cloud KMS CryptoKey Encrypter/Decrypter (cloudkms.cryptoKeyEncrypterDecrypter) zu. Führen Sie dazu den Befehlgcloud kms keys add-iam-policybindingaus:gcloud kms keys add-iam-policy-binding KMS_KEY \ --location KMS_KEY_LOCATION \ --keyring KMS_KEY_RING \ --project=PROJECT_ID \ --member serviceAccount:service-xxx@gcp-sa-spanner. \ --role roles/cloudkms.cryptoKeyEncrypterDecrypterHier ein Beispiel für die Ausgabe:
Updated IAM policy for key [KMS_KEY]Wenn Sie mehrere Cloud KMS-Schlüssel zum Schutz Ihrer Datenbank verwenden, führen Sie den Befehl
gcloud kms keys add-iam-policybindingfür alle Schlüssel aus.Diese Rolle sorgt dafür, dass das Dienstkonto die Berechtigung hat, mit dem Cloud KMS-Schlüssel sowohl zu verschlüsseln als auch zu entschlüsseln. Weitere Informationen finden Sie unter Cloud KMS-Berechtigungen und -Rollen.
Erstellen Sie die Datenbank und geben Sie Ihren Cloud KMS-Schlüssel an.
Console
Verwenden Sie die Console, um Datenbanken in regionalen Instanzkonfigurationen zu erstellen.
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Klicken Sie auf die Instanz, in der Sie eine Datenbank erstellen möchten.
Klicken Sie auf Datenbank erstellen und füllen Sie die Pflichtfelder aus.
Klicken Sie auf Verschlüsselungsoptionen anzeigen.
Wählen Sie Cloud KMS-Schlüssel aus.
Wählen Sie einen Schlüssel aus der Drop-down-Liste aus.
Die Liste der Schlüssel ist auf das aktuelle Projekt von Google Cloud beschränkt. Wenn Sie einen Schlüssel aus einem anderen Google Cloud -Projekt verwenden möchten, erstellen Sie die Datenbank mit der gcloud CLI anstelle derGoogle Cloud Console.
Nachdem die Datenbank erstellt wurde, können Sie auf der Seite Datenbankübersicht prüfen, ob CMEK für die Datenbank aktiviert ist.

gcloud
Führen Sie den Befehl gcloud spanner databases create aus, um eine CMEK-fähige Datenbank in einer regionalen, benutzerdefinierten oder multiregionalen Instanzkonfiguration zu erstellen:
gcloud spanner databases create DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--ddl="CREATE TABLE Users (Id INT64 NOT NULL, FirstName STRING(100) NOT NULL, LastName STRING(100) NOT NULL,) PRIMARY KEY (Id)" \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEYRING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Führen Sie den Befehl gcloud spanner databases describe aus, um zu prüfen, ob CMEK für eine Datenbank aktiviert ist:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDDatenbanken mit aktiviertem CMEK enthalten ein Feld für encryptionConfig, wie in der folgenden Beispielausgabe gezeigt:
encryptionConfig:
kmsKeyNames:projects/my-kms-project/locations/eur5/keyRings/my-kms-key-ring/cryptoKeys/my-kms-key
name: projects/my-spanner-project/instances/my-instance/databases/my-db
state: READY
Clientbibliotheken
C#
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
C++
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
Go
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
Java
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
Node.js
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
PHP
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
Python
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
Ruby
So erstellen Sie eine CMEK-fähige Datenbank in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Datenbank in einer multiregionalen Instanzkonfiguration:
Konfiguration der Datenbankverschlüsselung ändern
Sie können die Verschlüsselungskonfiguration einer vorhandenen Spanner-Datenbank ohne Ausfallzeiten mit der gcloud CLI, der REST API oder der RPC API ändern. Sie können die folgenden Änderungen an der Verschlüsselungskonfiguration einer vorhandenen Datenbank vornehmen:
- CMEK für eine Datenbank aktivieren, die Google-owned and Google-managed encryption keyverwendet.
- Ändern der Cloud KMS-Schlüssel in einer CMEK-fähigen Datenbank, einschließlich des Wechsels zwischen einem multiregionalen Schlüssel und mehreren regionalen Schlüsseln oder des Ersetzens eines oder mehrerer regionaler Schlüssel. Wenn Sie einen regionalen Schlüssel ersetzen, werden alle Daten der Datenbank neu verschlüsselt, nicht nur die Daten in dieser Region.
- CMEK entfernen und eine Datenbank auf Google-owned and Google-managed encryption keyzurücksetzen.
Während der erneuten Verschlüsselung im Hintergrund kann es bei einer kleinen Anzahl von Transaktionen zu einem wiederholbaren ABORTED-Fehler kommen. Spanner-Clientbibliotheken wiederholen diese Transaktionen automatisch. Wenn Sie die REST- oder RPC-API direkt verwenden, wiederholen Sie diese Transaktionen in Ihrer Anwendung.
Wenn Sie von einem einzelnen multiregionalen Schlüssel zu mehreren regionalen Schlüsseln wechseln, ändert sich das Verhalten beim Widerrufen von Schlüsseln. Wenn Sie einen einzelnen Schlüssel oder alle regionalen Schlüssel gleichzeitig deaktivieren, ist die Datenbank in der Regel innerhalb einer Stunde nicht mehr zugänglich. Wenn Sie nur einen Teil der regionalen Schlüssel deaktivieren, kann es bis zu 24 Stunden dauern, bis die Datenbank nicht mehr zugänglich ist. Weitere Informationen finden Sie unter Schlüssel deaktivieren.
CMEK aktivieren oder Cloud KMS-Schlüssel ändern
So aktivieren Sie CMEK für eine vorhandene Datenbank oder ändern die Cloud KMS-Schlüssel für eine CMEK-fähige Datenbank:
Erstellen Sie Ihre Ziel-Cloud KMS-Schlüssel an den erforderlichen Standorten und weisen Sie dem Spanner-Dienst-Agenten Ihres Projekts die Rolle Cloud KMS CryptoKey Encrypter/Decrypter (
roles/cloudkms.cryptoKeyEncrypterDecrypter) für jeden Zielschlüssel zu, wie in den Schritten 1 und 2 von CMEK-fähige Datenbank erstellen beschrieben.Aktualisieren Sie die Verschlüsselungskonfiguration der Datenbank:
gcloud
Führen Sie den Befehl
gcloud spanner databases updateaus und geben Sie die vollständig qualifizierten Ressourcennamen Ihrer Cloud KMS-Zielschlüssel mit dem Flag--kms-keysan.Für einen Schlüssel für eine einzelne Region oder mehrere Regionen:
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY"Wenn Sie mehrere regionale Schlüssel in einer benutzerdefinierten, biregionalen oder multiregionalen Instanzkonfiguration verwenden, geben Sie eine durch Kommas getrennte Liste mit allen erforderlichen Cloud KMS-Schlüsselressourcennamen für alle Regionen in Ihrer Instanzkonfiguration an, auch wenn Sie nur einen Teil der Schlüssel ersetzen:
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3"REST
Rufen Sie die Methode
projects.instances.databases.patchmitupdateMask=encryption_configauf und geben Sie das Ziel-encryptionConfigan.Für einen Schlüssel für eine einzelne Region oder mehrere Regionen:
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY" ] } }Geben Sie für mehrere regionale Schlüssel in einer benutzerdefinierten, biregionalen oder multiregionalen Instanzkonfiguration ein Array an, das alle erforderlichen Cloud KMS-Schlüsselressourcennamen für alle Regionen in Ihrer Instanzkonfiguration enthält, auch wenn Sie nur einen Teil der Schlüssel ersetzen:
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3" ] } }Warten Sie, bis die erneute Verschlüsselung im Hintergrund abgeschlossen ist, bevor Sie die Verschlüsselungskonfiguration der Datenbank noch einmal ändern oder vorherige Cloud KMS-Schlüssel deaktivieren, widerrufen oder löschen. Behalten Sie die Schlüssel auch, wenn Sie sie möglicherweise zum Wiederherstellen von Sicherungen benötigen. Informationen dazu, wie Sie feststellen, ob die erneute Verschlüsselung im Hintergrund abgeschlossen ist, finden Sie unter Abschluss der erneuten Verschlüsselung im Hintergrund prüfen.
Datenbank auf Google-owned and Google-managed encryption keyzurücksetzen
So entfernen Sie CMEK aus einer vorhandenen Datenbank und setzen sie aufGoogle-owned and Google-managed encryption keyzurück:
Aktualisieren Sie die Verschlüsselungskonfiguration der Datenbank, um die Cloud KMS-Schlüssel zu löschen:
gcloud
Führen Sie den Befehl
gcloud spanner databases updatemit dem Flag--clear-kms-keysaus:gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --clear-kms-keysREST
Rufen Sie die Methode
projects.instances.databases.patchmitupdateMask=encryption_configund einem leerenencryptionConfigauf:PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": {} }Warten Sie, bis die erneute Verschlüsselung im Hintergrund abgeschlossen ist, bevor Sie die Verschlüsselungskonfiguration der Datenbank noch einmal ändern oder vorherige Cloud KMS-Schlüssel deaktivieren, widerrufen oder löschen. Behalten Sie die Schlüssel auch, wenn Sie sie möglicherweise zum Wiederherstellen von Sicherungen benötigen. Informationen dazu, wie Sie feststellen, ob die erneute Verschlüsselung im Hintergrund abgeschlossen ist, finden Sie unter Abschluss der erneuten Verschlüsselung im Hintergrund prüfen.
Abschluss der Neuverschlüsselung im Hintergrund prüfen
Der Datenbankaktualisierungsvorgang ist abgeschlossen, wenn der neue encryptionConfig gespeichert wurde. Spanner verschlüsselt vorhandene Datenbankdaten asynchron im Hintergrund neu. Die erneute Verschlüsselung im Hintergrund kann mehrere Stunden dauern. Das Ändern oder Entfernen von Schlüsseln dauert länger als das Hinzufügen von CMEK. Bei größeren Datenbanken kann es noch länger dauern.
Führen Sie den Befehl gcloud spanner databases describe aus, um den Status der erneuten Verschlüsselung im Hintergrund zu prüfen:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--format="yaml(encryptionConfig,encryptionInfo)"Anhand der Ausgabe von encryptionInfo können Sie feststellen, ob die erneute Verschlüsselung im Hintergrund abgeschlossen ist:
- Cloud KMS-Schlüssel ändern: Während die erneute Verschlüsselung im Hintergrund läuft, werden in
encryptionInfosowohl die vorherige als auch die aktualisierte Cloud KMS-Schlüsselversion aufgeführt. Die Neuverschlüsselung ist abgeschlossen, wennencryptionInfonur Schlüsselversionen auflistet, die zu den Zielschlüsseln inencryptionConfiggehören. Bei Datenbanken mit mehreren regionalen Schlüsseln verlassen vorherige SchlüsselversionenencryptionInfojeweils eine Region nach der anderen. Warten Sie daher, bis kein Eintrag mehr auf eine vorherige Schlüsselversion verweist. - Zurücksetzen auf Google-owned and Google-managed encryption key: Während die erneute Verschlüsselung im Hintergrund läuft, werden in
encryptionInfoweiterhin die vorherigen Cloud KMS-Schlüsselversionen aufgeführt. Die erneute Verschlüsselung ist abgeschlossen, wennencryptionInfokeineCUSTOMER_MANAGED_ENCRYPTION-Einträge mehr enthält. - CMEK für eine Datenbank aktivieren, die Google-owned and Google-managed encryption keyverwendet hat:
encryptionInfoist nach der Änderung möglicherweise einige Minuten lang leer. Anschließend werden die neuen Cloud KMS-Schlüsselversionen aufgelistet, nachdem sie verwendet wurden. Dies kann geschehen, bevor alle bereits vorhandenen Daten, die durchGoogle-owned and Google-managed encryption key geschützt sind, im Hintergrund neu verschlüsselt wurden.encryptionInfogibt nicht an, wann die erneute Verschlüsselung der vorhandenen Daten abgeschlossen ist.
Verwendete Schlüsselversionen ansehen
Das Feld encryption_info der Datenbank enthält Informationen zu Schlüsselversionen.
Wenn eine Schlüsselversion in Cloud KMS rotiert, wird encryption_info aktualisiert, sobald die neue Version verwendet wird. Wenn Sie die Verschlüsselungskonfiguration der Datenbank ändern, listet encryption_info die noch verwendeten Schlüsselversionen auf, einschließlich der vorherigen Schlüsselversionen, bis die erneute Verschlüsselung im Hintergrund abgeschlossen ist. Weitere Informationen finden Sie unter Abschluss der erneuten Verschlüsselung im Hintergrund prüfen.
Console
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Klicken Sie auf die Instanz, die die Datenbank enthält, die Sie aufrufen möchten.
Klicken Sie auf die Datenbank.
Verschlüsselungsinformationen werden auf der Seite Datenbankdetails angezeigt.

gcloud
Sie können die encryption_info einer Datenbank abrufen, indem Sie den Befehl gcloud spanner databases describe oder gcloud spanner databases list ausführen. Beispiel:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDHier ein Beispiel für die Ausgabe:
name: projects/my-project/instances/test-instance/databases/example-db
encryptionInfo:
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key1-location/keyRings/my-kms-key-ring1/cryptoKeys/my-kms-key1/cryptoKeyVersions/1
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key2-location/keyRings/my-kms-key-ring2/cryptoKeys/my-kms-key2/cryptoKeyVersions/1
Schlüssel deaktivieren
Deaktivieren Sie die verwendeten Schlüsselversionen. Folgen Sie dazu dieser Anleitung für jede Schlüsselversion.
Warten Sie, bis die Änderung wirksam wird. Es kann bis zu drei Stunden dauern, bis die Deaktivierung eines Schlüssels wirksam wird.
Führen Sie eine Abfrage in der Datenbank mit deaktiviertem CMEK aus, um zu prüfen, ob die Datenbank nicht mehr zugänglich ist:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Die folgende Fehlermeldung wird angezeigt:
KMS key required by the Spanner resource is not accessible.
Schlüssel aktivieren
Aktivieren Sie die Schlüsselversionen, die von der Datenbank verwendet werden, indem Sie dieser Anleitung für jede Schlüsselversion folgen.
Warten Sie, bis die Änderung wirksam wird. Es kann bis zu drei Stunden dauern, bis die Aktivierung eines Schlüssels wirksam wird.
Führen Sie eine Abfrage in der CMEK-fähigen Datenbank aus, um zu prüfen, ob die Datenbank nicht mehr zugänglich ist:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Wenn die Änderung wirksam geworden ist, wird der Befehl erfolgreich ausgeführt.
Datenbank sichern
Sie können Spanner-Sicherungen verwenden, um Sicherungen Ihrer Datenbanken zu erstellen. Standardmäßig verwenden Spanner-Sicherungen, die aus einer Datenbank erstellt wurden, dieselbe Verschlüsselungskonfiguration wie die Datenbank selbst. Optional können Sie für eine Sicherung eine andere Verschlüsselungskonfiguration angeben.
Wenn eine Datenbank mehrere regionale Cloud KMS-Schlüssel verwendet, werden in den Sicherungen nur die Schlüssel für Regionen aufgeführt, in denen Daten gespeichert sind. Der Schlüssel der Witness-Region wird nicht aufgeführt, da Witness-Replikate keine Sicherungsdaten speichern.
Console
Verwenden Sie die Console, um Sicherungen in regionalen Instanzkonfigurationen zu erstellen.
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Klicken Sie auf den Instanznamen, der die Datenbank enthält, die Sie sichern möchten.
Klicken Sie auf die Datenbank.
Klicken Sie im Navigationsbereich auf Sichern/Wiederherstellen.
Klicken Sie auf dem Tab Sicherungen auf Sicherung erstellen.
Geben Sie einen Sicherungsnamen ein und wählen Sie ein Ablaufdatum aus.
Optional: Klicken Sie auf Verschlüsselungsoptionen anzeigen.
a. Wenn Sie für Ihre Sicherung eine andere Verschlüsselungskonfiguration verwenden möchten, klicken Sie auf den Schieberegler neben Vorhandene Verschlüsselung verwenden.
a. Wählen Sie Cloud KMS-Schlüssel aus.
a. Wählen Sie einen Schlüssel aus der Drop-down-Liste aus.
Die Liste der Schlüssel ist auf das aktuelle Projekt von Google Cloud beschränkt. Wenn Sie einen Schlüssel aus einem anderen Google Cloud -Projekt verwenden möchten, erstellen Sie die Datenbank mit der gcloud CLI anstelle der Google Cloud Console.
Klicken Sie auf Erstellen.
In der Tabelle Sicherungen werden Verschlüsselungsinformationen für jede Sicherung angezeigt.

gcloud
Führen Sie den Befehl gcloud spanner backups create aus, um eine CMEK-fähige Sicherung in einer regionalen, benutzerdefinierten oder multiregionalen Instanzkonfiguration zu erstellen:
gcloud spanner backups create BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--database=DATABASE \
--retention-period=RETENTION_PERIOD \
--encryption-type=customer_managed_encryption \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEY_RING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]
--asyncSo prüfen Sie, ob die erstellte Sicherung CMEK-verschlüsselt ist:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDClientbibliotheken
C#
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
C++
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Go
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Java
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Node.js
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
PHP
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Python
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Ruby
So erstellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration:
So erstellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Sicherung kopieren
Sie können eine Sicherung Ihrer Spanner-Datenbank von einer Instanz in eine andere Instanz in einer anderen Region oder einem anderen Projekt kopieren. Standardmäßig wird für eine kopierte Sicherung dieselbe Verschlüsselungskonfiguration (entweder von Google verwaltet oder vom Kunden verwaltet) wie für die Verschlüsselung der Quellsicherung verwendet. Sie können dieses Verhalten überschreiben, indem Sie beim Kopieren der Sicherung eine andere Verschlüsselungskonfiguration angeben. Wenn Sie möchten, dass die kopierte Sicherung beim regionenübergreifenden Kopieren mit CMEK verschlüsselt wird, geben Sie die Cloud KMS-Schlüssel an, die den Zielregionen entsprechen.
Console
Verwenden Sie die Console, um eine Sicherung in einer regionalen Instanzkonfiguration zu kopieren.
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Klicken Sie auf den Instanznamen, der die Datenbank enthält, die Sie sichern möchten.
Klicken Sie auf die Datenbank.
Klicken Sie im Navigationsbereich auf Sichern/Wiederherstellen.
Wählen Sie in der Tabelle Sicherungen die Option Aktionen für Ihre Sicherung aus und klicken Sie auf Kopieren.
Füllen Sie das Formular aus, indem Sie eine Zielinstanz auswählen, einen Namen angeben und ein Ablaufdatum für die Sicherungskopie auswählen.
Optional: Wenn Sie für Ihre Sicherung eine andere Verschlüsselungskonfiguration verwenden möchten, klicken Sie auf Verschlüsselungsoptionen einblenden.
a. Wählen Sie Cloud KMS-Schlüssel aus.
a. Wählen Sie einen Schlüssel aus der Drop-down-Liste aus.
Die Liste der Schlüssel ist auf das aktuelle Projekt von Google Cloud beschränkt. Wenn Sie einen Schlüssel aus einem anderen Google Cloud -Projekt verwenden möchten, erstellen Sie die Datenbank mit der gcloud CLI anstelle der Google Cloud Console.
Klicken Sie auf Kopieren.
gcloud
Führen Sie den folgenden gcloud spanner backups copy-Befehl aus, um eine Sicherung mit einer neuen Verschlüsselungskonfiguration in eine andere Instanz im selben Projekt zu kopieren:
gcloud spanner backups copy --async \
--source-instance=INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAME \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-backup=DESTINATION_BACKUP_NAME \
--expiration-date=EXPIRATION_DATE \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Führen Sie den folgenden gcloud spanner backups copy-Befehl aus, um eine Sicherung mit einer neuen Verschlüsselungskonfiguration in eine andere Instanz in einem anderen Projekt zu kopieren:
gcloud spanner backups copy --async \
--source-backup=SOURCE_BACKUP_NAME \
--destination-backup=DESTINATION_BACKUP_NAME \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]So prüfen Sie, ob die kopierte Sicherung CMEK-verschlüsselt ist:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDClientbibliotheken
C#
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
C++
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Go
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Java
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Node.js
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
PHP
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Python
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Ruby
So kopieren Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration:
Aus einer Sicherung wiederherstellen
Sie können eine Sicherung einer Spanner-Datenbank in einer neuen Datenbank wiederherstellen. Standardmäßig verwenden Datenbanken, die aus einer Sicherung wiederhergestellt werden, dieselbe Verschlüsselungskonfiguration wie die Sicherung selbst. Sie können dieses Verhalten jedoch überschreiben, indem Sie eine andere Verschlüsselungskonfiguration für die wiederhergestellte Datenbank angeben. Wenn die Sicherung durch CMEK geschützt ist, muss die Schlüsselversion, die zum Erstellen der Sicherung verwendet wurde, verfügbar sein, damit sie entschlüsselt werden kann.
Console
Verwenden Sie die Console, um eine Sicherung in einer regionalen Instanzkonfiguration wiederherzustellen.
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Klicken Sie auf die Instanz, die die Datenbank enthält, die Sie wiederherstellen möchten.
Klicken Sie auf die Datenbank.
Klicken Sie im Navigationsbereich auf Sichern/Wiederherstellen.
Wählen Sie in der Tabelle Sicherungen die Option Aktionen für Ihre Sicherung aus und klicken Sie auf Wiederherstellen.
Wählen Sie die Instanz aus, die wiederhergestellt werden soll, und benennen Sie die wiederhergestellte Datenbank.
Optional: Wenn Sie für die wiederhergestellte Datenbank eine andere Verschlüsselungskonfiguration verwenden möchten, klicken Sie auf den Schieberegler neben Vorhandene Verschlüsselung verwenden.
a. Wählen Sie Cloud KMS-Schlüssel aus.
a. Wählen Sie einen Schlüssel aus der Drop-down-Liste aus.
Die Liste der Schlüssel ist auf das aktuelle Projekt von Google Cloud beschränkt. Wenn Sie einen Schlüssel aus einem anderen Google Cloud -Projekt verwenden möchten, erstellen Sie die Datenbank mit der gcloud CLI anstelle der Google Cloud Console.
Klicken Sie auf Wiederherstellen.
gcloud
Führen Sie den folgenden gcloud spanner databases restore-Befehl aus, um eine Sicherung mit einer neuen Verschlüsselungskonfiguration wiederherzustellen:
gcloud spanner databases restore --async \
--project=SPANNER_PROJECT_ID \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-database=DESTINATION_DATABASE_ID \
--source-instance=SOURCE_INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAMESo prüfen Sie, ob die wiederhergestellte Datenbank mit CMEK verschlüsselt ist:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDWeitere Informationen finden Sie unter Aus einer Sicherung wiederherstellen.
Clientbibliotheken
C#
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
C++
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
Go
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
Java
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
Node.js
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
PHP
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
Python
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
Ruby
So stellen Sie eine CMEK-fähige Sicherung in einer regionalen Instanzkonfiguration wieder her:
So stellen Sie eine CMEK-fähige Sicherung in einer multiregionalen Instanzkonfiguration wieder her:
Audit-Logs für den Cloud KMS-Schlüssel ansehen
Achten Sie darauf, dass für die Cloud KMS API in Ihrem Projekt Logging aktiviert ist.
Rufen Sie in der Google Cloud Console den Log-Explorer auf.
Beschränken Sie die Logeinträge auf Ihren Cloud KMS-Schlüssel, indem Sie dem Query Builder die folgenden Zeilen hinzufügen:
resource.type="cloudkms_cryptokey" resource.labels.location="KMS_KEY_LOCATION" resource.labels.key_ring_id="KMS_KEY_RING_ID" resource.labels.crypto_key_id="KMS_KEY_ID"Im Normalbetrieb werden Verschlüsselungs- und Entschlüsselungsaktionen mit dem Schweregrad
INFOprotokolliert. Diese Einträge werden protokolliert, wenn die Zonen in Ihrer Spanner-Instanz den Cloud KMS-Schlüssel etwa alle fünf Minuten abfragen.Wenn Spanner nicht auf den Schlüssel zugreifen kann, werden die Vorgänge als
ERRORprotokolliert.