Halaman ini menjelaskan cara menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) yang dibuat secara manual untuk Spanner.
Untuk mempelajari CMEK lebih lanjut, lihat Ringkasan kunci enkripsi yang dikelola pelanggan (CMEK).
Membuat database yang mendukung CMEK
Buat kunci di Cloud Key Management Service (Cloud KMS). Anda dapat menggunakan jenis kunci berikut yang memiliki tingkat perlindungan yang berbeda di Spanner:
Kunci harus berada di lokasi yang sama dengan instance Spanner Anda. Misalnya, jika konfigurasi instance Spanner Anda berada di
us-west1, lokasi key ring Cloud KMS Anda juga harus berada dius-west1.Tidak semua konfigurasi instance multi-region Spanner memiliki lokasi key ring Cloud KMS yang sesuai. Untuk database Spanner dalam konfigurasi instance kustom, dual-region, atau multi-region, Anda dapat menggunakan beberapa kunci Cloud KMS regional (single-region) untuk melindungi database Anda. Contoh:
- Jika database Spanner Anda berada dalam konfigurasi instance multi-region
nam14, Anda dapat membuat kunci Cloud KMS dius-east4,northamerica-northeast1, danus-east1. - Jika database Anda berada dalam konfigurasi instance kustom yang menggunakan
nam3sebagai konfigurasi instance dasar dengan replika hanya baca tambahan dius-central2, Anda dapat membuat kunci Cloud KMS dius-east4,us-east1,us-central1, danus-central2.
Opsional: Untuk melihat daftar lokasi replika dalam konfigurasi instance Spanner, gunakan perintah
gcloud spanner instances get-locations:gcloud spanner instances get-locations <var>INSTANCE_ID</var>Untuk informasi selengkapnya, lihat referensi berikut:
- Jika database Spanner Anda berada dalam konfigurasi instance multi-region
Berikan akses Spanner ke kunci.
Di Cloud Shell, buat dan tampilkan agen layanan, atau tampilkan jika akun sudah ada:
gcloud beta services identity create --service=spanner.googleapis.com \ --project=PROJECT_IDJika Anda diminta untuk menginstal komponen gcloud Beta Commands, ketik
Y. Setelah penginstalan, perintah akan otomatis dimulai ulang.Perintah
gcloud services identitymembuat atau mendapatkan agen layanan yang dapat digunakan Spanner untuk mengakses kunci Cloud KMS atas nama Anda.ID akun layanan diformat seperti alamat email:
Service identity created: service-xxx@gcp-sa-spanner.Berikan peran Cloud KMS CryptoKey Encrypter/Decrypter(
cloudkms.cryptoKeyEncrypterDecrypter) ke akun layanan untuk setiap region (--location) dalam konfigurasi instance Spanner Anda. Untuk melakukannya, jalankan perintahgcloud kms keys add-iam-policybinding: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.cryptoKeyEncrypterDecrypterBerikut adalah contoh output:
Updated IAM policy for key [KMS_KEY]Jika Anda menggunakan beberapa kunci Cloud KMS untuk melindungi database, jalankan perintah
gcloud kms keys add-iam-policybindinguntuk semua kunci Anda.Peran ini memastikan bahwa akun layanan memiliki izin untuk mengenkripsi dan mendekripsi dengan kunci Cloud KMS. Untuk mengetahui informasi selengkapnya, lihat Izin dan peran Cloud KMS.
Buat database dan tentukan kunci Cloud KMS Anda.
Konsol
Gunakan konsol untuk membuat database dalam konfigurasi instance regional.
Di konsol Google Cloud , buka halaman Instances.
Klik instance tempat Anda ingin membuat database.
Klik Create database dan lengkapi kolom yang wajib diisi.
Klik Tampilkan opsi enkripsi.
Pilih Cloud KMS key.
Pilih kunci dari menu drop-down.
Daftar kunci dibatasi untuk project Google Cloud saat ini. Untuk menggunakan kunci dari project Google Cloud yang berbeda, buat database menggunakan gcloud CLI, bukan konsolGoogle Cloud .
Setelah database dibuat, Anda dapat memverifikasi bahwa database tersebut mengaktifkan CMEK dengan melihat halaman Database overview.

gcloud
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional, kustom, atau multi-region, jalankan perintah gcloud spanner databases create:
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 ... ]Untuk memverifikasi bahwa database mengaktifkan CMEK, jalankan perintah gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDDatabase yang mendukung CMEK menyertakan kolom untuk encryptionConfig, seperti yang ditunjukkan dalam contoh output berikut:
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
Library klien
C#
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
C++
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
Go
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
Java
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
Node.js
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
PHP
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
Python
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
Ruby
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat database yang mendukung CMEK dalam konfigurasi instance multi-region:
Mengubah konfigurasi enkripsi database
Anda dapat mengubah konfigurasi enkripsi database Spanner yang ada tanpa periode nonaktif menggunakan gcloud CLI, REST API, atau RPC API. Anda dapat membuat perubahan konfigurasi enkripsi berikut pada database yang ada:
- Mengaktifkan CMEK di database yang menggunakan Google-owned and Google-managed encryption key.
- Mengubah kunci Cloud KMS pada database yang mendukung CMEK, termasuk beralih antara kunci multi-region dan beberapa kunci regional, atau mengganti satu atau beberapa kunci regional. Mengganti kunci regional apa pun akan mengenkripsi ulang semua data database, bukan hanya data di region tersebut.
- Menghapus CMEK dan mengembalikan database ke Google-owned and Google-managed encryption key.
Selama enkripsi ulang di latar belakang, sejumlah kecil transaksi mungkin gagal
dengan error ABORTED yang dapat dicoba ulang. Library klien Spanner mencoba ulang transaksi ini secara otomatis. Jika Anda menggunakan REST atau RPC API secara langsung,
coba lagi transaksi ini di aplikasi Anda.
Beralih dari satu kunci multi-region ke beberapa kunci regional akan mengubah perilaku pencabutan kunci. Menonaktifkan satu kunci, atau menonaktifkan semua kunci regional sekaligus, biasanya membuat database tidak dapat diakses dalam waktu satu jam. Jika Anda hanya menonaktifkan sebagian kunci regional, database mungkin memerlukan waktu hingga 24 jam untuk menjadi tidak dapat diakses. Untuk mengetahui informasi selengkapnya, lihat Menonaktifkan kunci.
Mengaktifkan CMEK atau mengubah kunci Cloud KMS
Untuk mengaktifkan CMEK pada database yang ada atau mengubah kunci Cloud KMS pada database yang mendukung CMEK, selesaikan langkah-langkah berikut:
Buat kunci Cloud KMS target Anda di lokasi yang diperlukan dan berikan peran Cloud KMS CryptoKey Encrypter/Decrypter (
roles/cloudkms.cryptoKeyEncrypterDecrypter) pada setiap kunci target ke agen layanan Spanner project Anda, seperti yang dijelaskan dalam langkah 1 dan 2 di Membuat database yang mendukung CMEK.Perbarui konfigurasi enkripsi database:
gcloud
Jalankan perintah
gcloud spanner databases updatedan tentukan nama resource yang sepenuhnya memenuhi syarat dari kunci Cloud KMS target Anda menggunakan flag--kms-keys.Untuk kunci satu region atau multi-region:
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"Untuk beberapa kunci regional dalam konfigurasi instance kustom, dual-region, atau multi-region, tentukan daftar yang dipisahkan koma yang berisi kumpulan lengkap nama resource kunci Cloud KMS yang diperlukan untuk semua region dalam konfigurasi instance Anda, meskipun Anda hanya mengganti sebagian kunci:
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
Panggil metode
projects.instances.databases.patchdenganupdateMask=encryption_configdan tentukanencryptionConfigtarget Anda.Untuk kunci satu region atau multi-region:
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" ] } }Untuk beberapa kunci regional dalam konfigurasi instance kustom, dual-region, atau multi-region, tentukan array yang berisi kumpulan lengkap nama resource kunci Cloud KMS yang diperlukan untuk semua region dalam konfigurasi instance Anda, meskipun Anda hanya mengganti sebagian kunci:
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" ] } }Tunggu hingga enkripsi ulang latar belakang selesai sebelum mengubah konfigurasi enkripsi database lagi, atau sebelum menonaktifkan, mencabut, atau menghancurkan kunci Cloud KMS sebelumnya. Simpan juga kunci jika Anda mungkin memerlukannya untuk memulihkan dari cadangan. Untuk menentukan apakah enkripsi ulang latar belakang telah selesai, lihat Memverifikasi penyelesaian enkripsi ulang latar belakang.
Mengembalikan database ke Google-owned and Google-managed encryption key
Untuk menghapus CMEK dari database yang ada dan mengembalikannya ke Google-owned and Google-managed encryption key, selesaikan langkah-langkah berikut:
Perbarui konfigurasi enkripsi database untuk menghapus kunci Cloud KMS-nya:
gcloud
Jalankan perintah
gcloud spanner databases updatedengan flag--clear-kms-keys:gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --clear-kms-keysREST
Panggil metode
projects.instances.databases.patchdenganupdateMask=encryption_configdanencryptionConfigkosong:PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": {} }Tunggu hingga enkripsi ulang latar belakang selesai sebelum mengubah konfigurasi enkripsi database lagi, atau sebelum menonaktifkan, mencabut, atau menghancurkan kunci Cloud KMS sebelumnya. Simpan juga kunci jika Anda mungkin memerlukannya untuk memulihkan dari cadangan. Untuk menentukan apakah enkripsi ulang latar belakang telah selesai, lihat Memverifikasi penyelesaian enkripsi ulang latar belakang.
Memverifikasi penyelesaian enkripsi ulang di latar belakang
Operasi update database selesai saat encryptionConfig baru disimpan, sementara Spanner mengenkripsi ulang data database yang ada secara asinkron di latar belakang. Enkripsi ulang latar belakang dapat memerlukan waktu beberapa jam. Mengubah atau menghapus kunci memerlukan waktu lebih lama daripada menambahkan CMEK, dan database yang lebih besar dapat memerlukan waktu lebih lama.
Untuk memeriksa status enkripsi ulang latar belakang, jalankan perintah
gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--format="yaml(encryptionConfig,encryptionInfo)"Gunakan output encryptionInfo untuk menentukan apakah enkripsi ulang latar belakang telah selesai:
- Mengubah kunci Cloud KMS: Saat enkripsi ulang latar belakang sedang berlangsung,
encryptionInfomencantumkan versi kunci Cloud KMS sebelumnya dan yang telah diperbarui. Enkripsi ulang selesai saatencryptionInfohanya mencantumkan versi kunci yang termasuk dalam kunci target diencryptionConfig. Untuk database dengan beberapa kunci regional, versi kunci sebelumnya akan meninggalkanencryptionInfosatu region pada satu waktu, jadi tunggu hingga tidak ada entri yang merujuk ke versi kunci sebelumnya. - Kembali ke Google-owned and Google-managed encryption key: Saat enkripsi ulang di latar belakang
sedang berlangsung,
encryptionInfoakan terus mencantumkan versi kunci Cloud KMS sebelumnya. Enkripsi ulang selesai saatencryptionInfotidak lagi mencantumkan entriCUSTOMER_MANAGED_ENCRYPTION. - Mengaktifkan CMEK di database yang menggunakan Google-owned and Google-managed encryption key:
encryptionInfomungkin kosong selama beberapa menit setelah perubahan. Kemudian, layanan ini mencantumkan versi kunci Cloud KMS baru setelah digunakan, yang mungkin muncul sebelum semua data yang sudah ada dan dilindungi oleh Google-owned and Google-managed encryption key selesai dienkripsi ulang di latar belakang.encryptionInfotidak menunjukkan kapan enkripsi ulang data yang sudah ada selesai.
Melihat versi kunci yang digunakan
Kolom encryption_info database menampilkan informasi tentang versi kunci.
Saat versi kunci dirotasi di Cloud KMS, encryption_info akan diupdate setelah versi baru digunakan. Saat Anda mengubah konfigurasi enkripsi database, encryption_info akan mencantumkan versi kunci yang masih digunakan, yang dapat mencakup versi kunci sebelumnya, hingga enkripsi ulang di latar belakang selesai. Untuk mengetahui informasi selengkapnya, lihat
Memverifikasi penyelesaian enkripsi ulang latar belakang.
Konsol
Di konsol Google Cloud , buka halaman Instances.
Klik instance yang berisi database yang ingin Anda lihat.
Klik database.
Informasi enkripsi ditampilkan di halaman Database details.

gcloud
Anda bisa mendapatkan encryption_info database dengan menjalankan perintah
gcloud spanner databases describe
atau gcloud spanner databases list. Contoh:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDBerikut adalah contoh output:
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
Menonaktifkan kunci
Nonaktifkan versi kunci yang sedang digunakan dengan mengikuti petunjuk ini untuk setiap versi kunci.
Tunggu hingga perubahan diterapkan. Penonaktifan kunci dapat memerlukan waktu hingga tiga jam untuk diterapkan.
Untuk mengonfirmasi bahwa database tidak dapat diakses lagi, jalankan kueri di database yang CMEK-nya dinonaktifkan:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Pesan error berikut akan muncul:
KMS key required by the Spanner resource is not accessible.
Mengaktifkan kunci
Aktifkan versi kunci yang digunakan oleh database dengan mengikuti petunjuk ini untuk setiap versi kunci.
Tunggu hingga perubahan diterapkan. Pengaktifan kunci dapat memerlukan waktu hingga tiga jam untuk diterapkan.
Untuk mengonfirmasi bahwa database tidak dapat diakses lagi, jalankan kueri di database yang mendukung CMEK:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Jika perubahan telah diterapkan, perintah akan berhasil dijalankan.
Mencadangkan database
Anda dapat menggunakan cadangan Spanner untuk membuat cadangan database Anda. Secara default, cadangan Spanner yang dibuat dari database menggunakan konfigurasi enkripsi yang sama dengan database itu sendiri. Anda dapat menentukan konfigurasi enkripsi yang berbeda untuk cadangan.
Jika database menggunakan beberapa kunci Cloud KMS regional, cadangannya hanya mencantumkan kunci untuk region yang menyimpan data. Kunci region saksi tidak tercantum karena replika saksi tidak menyimpan data cadangan.
Konsol
Gunakan konsol untuk membuat cadangan dalam konfigurasi instance regional.
Di konsol Google Cloud , buka halaman Instances.
Klik nama instance yang berisi database yang ingin Anda cadangkan.
Klik database.
Di panel navigasi, klik Backup/Restore.
Di tab Backups, klik Create backup.
Masukkan nama cadangan dan pilih tanggal habis masa berlaku.
Opsional: Klik Tampilkan opsi enkripsi.
a. Jika Anda ingin menggunakan konfigurasi enkripsi yang berbeda untuk cadangan, klik penggeser di samping Use existing encryption.
a. Pilih Cloud KMS key.
a. Pilih kunci dari menu drop-down.
Daftar kunci dibatasi untuk project Google Cloud saat ini. Untuk menggunakan kunci dari project Google Cloud yang berbeda, buat database menggunakan gcloud CLI, bukan Google Cloud konsol.
Klik Create.
Tabel Cadangan menampilkan informasi enkripsi untuk setiap cadangan.

gcloud
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional, kustom, atau multi-region, jalankan perintah gcloud spanner backups create:
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 ... ]
--asyncUntuk memverifikasi bahwa cadangan yang dibuat dienkripsi dengan CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDLibrary klien
C#
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
C++
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Go
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Java
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Node.js
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
PHP
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Python
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Ruby
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk membuat cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Menyalin cadangan
Anda dapat menyalin cadangan database Spanner dari satu instance ke instance lain di region atau project yang berbeda. Secara default, cadangan yang disalin menggunakan konfigurasi enkripsi yang sama, baik yang dikelola Google maupun yang dikelola pelanggan, seperti enkripsi cadangan sumbernya. Anda dapat mengganti perilaku ini dengan menentukan konfigurasi enkripsi yang berbeda saat menyalin cadangan. Jika Anda ingin cadangan yang disalin dienkripsi dengan CMEK saat menyalin di seluruh region, tentukan kunci Cloud KMS yang sesuai dengan region tujuan.
Konsol
Gunakan konsol untuk menyalin cadangan dalam konfigurasi instance regional.
Di konsol Google Cloud , buka halaman Instances.
Klik nama instance yang berisi database yang ingin Anda cadangkan.
Klik database.
Di panel navigasi, klik Backup/Restore.
Di tabel Backups, pilih Actions untuk cadangan Anda, lalu klik Copy.
Isi formulir dengan memilih instance tujuan, memberikan nama, dan memilih tanggal habis masa berlaku untuk salinan cadangan.
Opsional: Jika Anda ingin menggunakan konfigurasi enkripsi yang berbeda untuk cadangan, klik Show encryption options.
a. Pilih Cloud KMS key.
a. Pilih kunci dari menu drop-down.
Daftar kunci dibatasi untuk project Google Cloud saat ini. Untuk menggunakan kunci dari project Google Cloud yang berbeda, buat database menggunakan gcloud CLI, bukan Google Cloud konsol.
Klik Copy.
gcloud
Untuk menyalin cadangan, dengan konfigurasi enkripsi baru, ke instance lain
dalam project yang sama, jalankan perintah gcloud spanner backups copy
berikut:
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 ... ]Untuk menyalin cadangan, dengan konfigurasi enkripsi baru, ke instance lain
dalam project yang berbeda, jalankan perintah gcloud spanner backups copy
berikut:
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 ... ]Untuk memverifikasi bahwa cadangan yang disalin dienkripsi dengan CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDLibrary klien
C#
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
C++
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
Go
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
Java
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
Node.js
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
PHP
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
Python
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
Ruby
Untuk menyalin cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
Memulihkan dari cadangan
Anda dapat memulihkan cadangan database Spanner ke database baru. Secara default, database yang dipulihkan dari cadangan menggunakan konfigurasi enkripsi yang sama dengan cadangan itu sendiri, tetapi Anda dapat mengganti perilaku ini dengan menentukan konfigurasi enkripsi yang berbeda untuk database yang dipulihkan. Jika cadangan dilindungi oleh CMEK, versi kunci yang digunakan untuk membuat cadangan harus tersedia agar dapat didekripsi.
Konsol
Gunakan konsol untuk memulihkan cadangan dalam konfigurasi instance regional.
Di konsol Google Cloud , buka halaman Instances.
Klik instance yang berisi database yang ingin Anda pulihkan.
Klik database.
Di panel navigasi, klik Backup/Restore.
Di tabel Backups, pilih Actions untuk cadangan Anda, lalu klik Restore.
Pilih instance yang akan dipulihkan dan beri nama database yang dipulihkan.
Opsional: Jika Anda ingin menggunakan konfigurasi enkripsi yang berbeda dengan database yang dipulihkan, klik penggeser di samping Use existing encryption.
a. Pilih Cloud KMS key.
a. Pilih kunci dari menu drop-down.
Daftar kunci dibatasi untuk project Google Cloud saat ini. Untuk menggunakan kunci dari project Google Cloud yang berbeda, buat database menggunakan gcloud CLI, bukan Google Cloud konsol.
Klik Pulihkan.
gcloud
Untuk memulihkan cadangan, dengan konfigurasi enkripsi baru, jalankan perintah
gcloud spanner databases restore
berikut:
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_NAMEUntuk memverifikasi bahwa database yang dipulihkan dienkripsi dengan CMEK:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDUntuk mengetahui informasi selengkapnya, lihat Memulihkan dari cadangan.
Library klien
C#
Untuk memulihkan cadangan yang diaktifkan CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
C++
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Go
Untuk memulihkan cadangan yang diaktifkan CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Java
Untuk memulihkan cadangan yang diaktifkan CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Node.js
Untuk memulihkan cadangan yang diaktifkan CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang diaktifkan CMEK dalam konfigurasi instance multi-region:
PHP
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Python
Untuk memulihkan cadangan yang diaktifkan CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Ruby
Untuk memulihkan cadangan yang diaktifkan CMEK dalam konfigurasi instance regional:
Untuk memulihkan cadangan yang mendukung CMEK dalam konfigurasi instance multi-region:
Melihat log audit untuk kunci Cloud KMS
Pastikan logging diaktifkan untuk Cloud KMS API di project Anda.
Di konsol Google Cloud , buka Logs Explorer.
Batasi entri log ke kunci Cloud KMS Anda dengan menambahkan baris berikut ke Pembuat kueri:
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"Dalam operasi normal, tindakan enkripsi dan dekripsi dicatat ke dalam log dengan tingkat keparahan
INFO. Entri ini dicatat ke dalam log saat zona di instance Spanner Anda melakukan polling pada kunci Cloud KMS sekitar setiap lima menit.Jika Spanner gagal mengakses kunci, operasi akan dicatat ke dalam log sebagai
ERROR.