Nesta página, descrevemos como usar chaves de criptografia gerenciadas pelo cliente (CMEK) criadas manualmente para o Spanner.
Para saber mais sobre CMEK, consulte a Visão geral das chaves de criptografia gerenciadas pelo cliente (CMEK).
Criar um banco de dados com CMEK ativado
Crie uma chave no Cloud Key Management Service (Cloud KMS). É possível usar os seguintes tipos de chave que têm diferentes níveis de proteção no Spanner:
A chave precisa estar no mesmo local que a instância do Spanner. Por exemplo, se a configuração da instância do Spanner estiver em
us-west1, o local do keyring do Cloud KMS também precisará serus-west1.Nem todas as configurações de instância multirregional do Spanner têm um local de keyring do Cloud KMS correspondente. Para bancos de dados do Spanner em configurações de instância personalizadas, birregionais ou multirregionais, é possível usar várias chaves regionais (região única) do Cloud KMS para proteger seu banco de dados. Exemplo:
- Se o banco de dados do Spanner estiver na configuração de instância multirregional
nam14, será possível criar chaves do Cloud KMS emus-east4,northamerica-northeast1eus-east1. - Se o banco de dados estiver em uma configuração de instância personalizada que use
nam3como a configuração de instância base com uma réplica somente leitura adicional emus-central2, será possível criar chaves do Cloud KMS emus-east4,us-east1,us-central1eus-central2.
Opcional: para ver uma lista dos locais de réplica na configuração da instância do Spanner, use o comando
gcloud spanner instances get-locations:gcloud spanner instances get-locations <var>INSTANCE_ID</var>Para saber mais, acesse os recursos a seguir:
- Se o banco de dados do Spanner estiver na configuração de instância multirregional
Conceda ao Spanner acesso à chave.
No Cloud Shell, crie e exiba o agente de serviço ou exiba-o se a conta já existir:
gcloud beta services identity create --service=spanner.googleapis.com \ --project=PROJECT_IDSe aparecer uma solicitação para instalar o componente gcloud Beta Commands, digite
Y. Após a instalação, o comando é reiniciado automaticamente.O comando
gcloud services identitycria ou recebe o agente de serviço que o Spanner pode usar para acessar a chave do Cloud KMS em seu nome.O ID da conta de serviço é formatado como um endereço de e-mail:
Service identity created: service-xxx@gcp-sa-spanner.Conceda o papel de Criptografador/Descriptografador de CryptoKey do Cloud KMS (
cloudkms.cryptoKeyEncrypterDecrypter) à conta de serviço de cada região (--location) na configuração da instância do Spanner. Para fazer isso, execute o comandogcloud 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.cryptoKeyEncrypterDecrypterConfira um exemplo de saída:
Updated IAM policy for key [KMS_KEY]Se você estiver usando várias chaves do Cloud KMS para proteger o banco de dados, execute o comando
gcloud kms keys add-iam-policybindingpara todas as chaves.Esse papel garante que a conta de serviço tenha permissão para criptografar e descriptografar com a chave do Cloud KMS. Para mais informações, consulte Permissões e papéis do Cloud KMS.
Crie o banco de dados e especifique a chave do Cloud KMS.
Console
Use o console para criar bancos de dados em configurações de instâncias regionais.
No console do Google Cloud , acesse a página Instâncias.
Clique na instância em que você quer criar um banco de dados.
Clique em Criar banco de dados e preencha os campos obrigatórios.
Clique em Mostrar opções de criptografia.
Selecione Chave do Cloud KMS.
Selecione uma chave na lista suspensa.
A lista de chaves é limitada ao projeto do Google Cloud atual. Para usar uma chave de um projeto do Google Cloud diferente, crie o banco de dados usando a CLI gcloud em vez do console doGoogle Cloud .
Depois que o banco de dados for criado, é possível verificar se ele está com CMEK ativado acessando a página Visão geral do banco de dados.

gcloud
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional, personalizada ou multirregional, execute o comando 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 ... ]Para verificar se um banco de dados está com CMEK ativado, execute o comando
gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDOs bancos de dados com CMEK ativado incluem um campo para encryptionConfig, conforme mostrado no
exemplo de saída a seguir:
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
Bibliotecas de cliente
C#
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
C++
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
Go
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
Java
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
Node.js
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
PHP
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
Python
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
Ruby
Para criar um banco de dados com CMEK ativado em uma configuração de instância regional:
Para criar um banco de dados com CMEK ativado em uma configuração de instância multirregional:
Mudar a configuração de criptografia do banco de dados
É possível mudar a configuração de criptografia de um banco de dados do Spanner sem tempo de inatividade usando a CLI gcloud, a API REST ou a API RPC. É possível fazer as seguintes alterações na configuração de criptografia em um banco de dados existente:
- Ative a CMEK em um banco de dados que usa Google-owned and Google-managed encryption key.
- Alterar as chaves do Cloud KMS em um banco de dados com CMEK, incluindo alternar entre uma chave multirregional e várias chaves regionais ou substituir uma ou mais chaves regionais. A substituição de qualquer chave regional criptografa novamente todos os dados do banco de dados, não apenas os dados dessa região.
- Remover a CMEK e reverter um banco de dados para Google-owned and Google-managed encryption key.
Durante a recriptografia em segundo plano, um pequeno número de transações pode falhar
com um erro ABORTED que pode ser repetido. As bibliotecas de cliente do Spanner tentam realizar essas transações novamente de modo automático. Se você usar a API REST ou RPC diretamente,
tente realizar essas transações novamente no aplicativo.
A mudança de uma única chave multirregional para várias chaves regionais altera o comportamento da revogação de chaves. A desativação de uma única chave ou de todas as chaves regionais de uma só vez geralmente torna o banco de dados inacessível em uma hora. Se você desativar apenas um subconjunto de chaves regionais, o banco de dados poderá levar até 24 horas para ficar inacessível. Para mais informações, consulte Desativar a chave.
Ativar CMEK ou alterar chaves do Cloud KMS
Para ativar a CMEK em um banco de dados atual ou alterar as chaves do Cloud KMS em um banco de dados com CMEK ativado, siga estas etapas:
Crie as chaves de destino do Cloud KMS nos locais necessários e conceda o papel de criptografador/descriptografador de CryptoKey do Cloud KMS (
roles/cloudkms.cryptoKeyEncrypterDecrypter) em cada chave de destino ao agente de serviço do Spanner do seu projeto, conforme descrito nas etapas 1 e 2 de Criar um banco de dados com CMEK.Atualize a configuração de criptografia do banco de dados:
gcloud
Execute o comando
gcloud spanner databases updatee especifique os nomes de recursos totalmente qualificados das chaves de destino do Cloud KMS usando a flag--kms-keys.Para uma chave de região única ou multirregional:
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"Para várias chaves regionais em uma configuração de instância personalizada, birregional ou multirregional, especifique uma lista separada por vírgulas que contenha o conjunto completo de nomes de recursos de chave do Cloud KMS necessários para todas as regiões na configuração da instância, mesmo que você esteja substituindo apenas um subconjunto das chaves:
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
Chame o método
projects.instances.databases.patchcomupdateMask=encryption_confige especifique oencryptionConfigde destino.Para uma chave de região única ou multirregional:
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" ] } }Para várias chaves regionais em uma configuração de instância personalizada, birregional ou multirregional, especifique uma matriz que contenha o conjunto completo de nomes de recursos de chave do Cloud KMS necessários para todas as regiões na configuração da instância, mesmo que você esteja substituindo apenas um subconjunto das chaves:
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" ] } }Aguarde até que a nova criptografia em segundo plano seja concluída antes de alterar a configuração de criptografia do banco de dados novamente ou antes de desativar, revogar ou destruir as chaves anteriores do Cloud KMS. Além disso, mantenha as chaves se precisar delas para restaurar backups. Para determinar se a nova criptografia em segundo plano foi concluída, consulte Verificar a conclusão da nova criptografia em segundo plano.
Reverter um banco de dados para Google-owned and Google-managed encryption key
Para remover a CMEK de um banco de dados e revertê-lo para Google-owned and Google-managed encryption key, siga estas etapas:
Atualize a configuração de criptografia do banco de dados para limpar as chaves do Cloud KMS:
gcloud
Execute o comando
gcloud spanner databases updatecom a flag--clear-kms-keys:gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --clear-kms-keysREST
Chame o método
projects.instances.databases.patchcomupdateMask=encryption_confige umencryptionConfigvazio:PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": {} }Aguarde até que a nova criptografia em segundo plano seja concluída antes de alterar a configuração de criptografia do banco de dados novamente ou antes de desativar, revogar ou destruir as chaves anteriores do Cloud KMS. Além disso, mantenha as chaves se precisar delas para restaurar backups. Para determinar se a nova criptografia em segundo plano foi concluída, consulte Verificar a conclusão da nova criptografia em segundo plano.
Verificar a conclusão da recriptografia em segundo plano
A operação de atualização do banco de dados é concluída quando a nova encryptionConfig é
salva, enquanto o Spanner criptografa novamente os dados do banco de dados
de forma assíncrona em segundo plano. A nova criptografia em segundo plano pode levar várias
horas. Alterar ou remover chaves leva mais tempo do que adicionar CMEK, e bancos de dados maiores podem levar mais tempo.
Para verificar o status da nova criptografia em segundo plano, execute o comando
gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--format="yaml(encryptionConfig,encryptionInfo)"Use a saída encryptionInfo para determinar se a nova criptografia em segundo plano foi
concluída:
- Alteração de chaves do Cloud KMS: enquanto a nova criptografia em segundo plano está em
andamento, o
encryptionInfolista as versões anterior e atualizada da chave do Cloud KMS. A nova criptografia é concluída quandoencryptionInfolista apenas as versões de chave que pertencem às chaves de destino emencryptionConfig. Para bancos de dados com várias chaves regionais, as versões de chave anteriores saem deencryptionInfouma região por vez. Portanto, aguarde até que nenhuma entrada faça referência a uma versão de chave anterior. - Reversão para Google-owned and Google-managed encryption key: enquanto a nova criptografia em segundo plano está em andamento, o
encryptionInfocontinua listando as versões anteriores da chave do Cloud KMS. A nova criptografia é concluída quandoencryptionInfonão lista mais entradasCUSTOMER_MANAGED_ENCRYPTION. - Ativar a CMEK em um banco de dados que usou Google-owned and Google-managed encryption key:
encryptionInfopode ficar vazio por alguns minutos após a mudança. Em seguida, ele lista as novas versões de chave do Cloud KMS depois que elas estão em uso, o que pode aparecer antes que todos os dados preexistentes protegidos por Google-owned and Google-managed encryption key tenham terminado de ser criptografados novamente em segundo plano.encryptionInfonão indica quando a nova criptografia dos dados preexistentes é concluída.
Ver as versões de chaves em uso
O campo encryption_info do banco de dados mostra informações sobre as versões de chave.
Quando uma versão de chave é alternada no Cloud KMS, o encryption_info é atualizado assim que
a nova versão é usada. Quando você altera a configuração de criptografia do banco de dados, o encryption_info lista as versões de chave ainda em uso, que podem incluir as versões anteriores, até que a nova criptografia em segundo plano seja concluída. Para mais informações, consulte
Verificar a conclusão da nova criptografia em segundo plano.
Console
No console do Google Cloud , acesse a página Instâncias.
Clique na instância que contém o banco de dados que você quer visualizar.
Clique no banco de dados.
As informações de criptografia são exibidas na página Detalhes do banco de dados.

gcloud
Para ver o encryption_info de um banco de dados, execute o comando
gcloud spanner databases describe
ou gcloud spanner databases list. Exemplo:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDConfira um exemplo de saída:
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
Desativar a chave
Desative as versões de chave em uso seguindo estas instruções para cada versão de chave.
Aguarde até que a mudança entre em vigor. A desativação de uma chave pode levar até três horas para ser propagada.
Para confirmar que o banco de dados não está mais acessível, execute uma consulta no banco de dados com CMEK desativada:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'A seguinte mensagem de erro é exibida:
KMS key required by the Spanner resource is not accessible.
Ativar a chave
Ative as versões de chave que estão em uso pelo banco de dados seguindo estas instruções para cada versão de chave.
Aguarde até que a mudança entre em vigor. A ativação de uma chave pode levar até três horas para ser propagada.
Para confirmar que o banco de dados não está mais acessível, execute uma consulta no banco de dados com CMEK ativado:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Se a alteração tiver entrado em vigor, o comando será executado com sucesso.
Fazer backup de um banco de dados
É possível usar os backups do Spanner para criar backups dos seus bancos de dados. Por padrão, os backups do Spanner criados com base em um banco de dados usam a mesma configuração de criptografia do próprio banco de dados. Se quiser, especifique uma configuração de criptografia diferente para um backup.
Se um banco de dados usar várias chaves regionais do Cloud KMS, os backups dele vão listar apenas as chaves das regiões que armazenam dados. A chave da região de testemunha não está listada porque as réplicas de testemunha não armazenam dados de backup.
Console
Use o console para criar backups em configurações de instâncias regionais.
No console do Google Cloud , acesse a página Instâncias.
Clique no nome da instância que contém o banco de dados que você quer copiar.
Clique no banco de dados.
No painel de navegação, clique em Backup/Restaurar.
Na guia Backups, clique em Criar backup.
Insira um nome para o backup e selecione uma data de validade.
Opcional: clique em Mostrar opções de criptografia.
a. Se você quiser usar uma configuração de criptografia diferente para o backup, clique no controle deslizante ao lado de Usar criptografia criada.
a. Selecione Chave do Cloud KMS.
a. Selecione uma chave na lista suspensa.
A lista de chaves é limitada ao projeto do Google Cloud atual. Para usar uma chave de um projeto Google Cloud diferente, crie o banco de dados usando a CLI gcloud em vez do console Google Cloud .
Clique em Criar.
A tabela Backups mostra informações de criptografia para cada backup.

gcloud
Para criar um backup ativado para CMEK em uma configuração de instância regional, personalizada ou multirregional, execute o comando 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 ... ]
--asyncPara verificar se o backup criado está criptografado com CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDBibliotecas de cliente
C#
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
C++
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
Go
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
Java
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
Node.js
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
PHP
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
Python
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
Ruby
Para criar um backup com CMEK ativada em uma configuração de instância regional:
Para criar um backup ativado para CMEK em uma configuração de instância multirregional:
Copiar um backup
É possível copiar um backup do banco de dados do Spanner de uma instância para outra em uma região ou projeto diferente. Por padrão, um backup copiado usa a mesma configuração de criptografia, gerenciada pelo Google ou pelo cliente, que a criptografia do backup de origem. É possível modificar esse comportamento especificando uma configuração de criptografia diferente ao copiar o backup. Se você quiser que o backup copiado seja criptografado com CMEK ao copiar entre regiões, especifique as chaves do Cloud KMS correspondentes às regiões de destino.
Console
Use o console para copiar um backup em uma configuração de instância regional.
No console do Google Cloud , acesse a página Instâncias.
Clique no nome da instância que contém o banco de dados que você quer copiar.
Clique no banco de dados.
No painel de navegação, clique em Backup/Restaurar.
Na tabela Backups, selecione Ações para o backup e clique em Copiar.
Preencha o formulário escolhendo uma instância de destino, fornecendo um nome e selecionando uma data de validade para a cópia de backup.
Opcional: se quiser usar uma configuração de criptografia diferente para o backup, clique em Mostrar opções de criptografia.
a. Selecione Chave do Cloud KMS.
a. Selecione uma chave na lista suspensa.
A lista de chaves é limitada ao projeto do Google Cloud atual. Para usar uma chave de um projeto Google Cloud diferente, crie o banco de dados usando a CLI gcloud em vez do console Google Cloud .
Clique em Copiar.
gcloud
Para copiar um backup, com uma nova configuração de criptografia, para uma instância diferente
no mesmo projeto, execute o seguinte comando
gcloud spanner backups copy:
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 ... ]Para copiar um backup, com uma nova configuração de criptografia, para uma instância diferente
em um projeto diferente, execute o seguinte comando
gcloud spanner backups copy:
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 ... ]Para verificar se o backup copiado está criptografado com CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDBibliotecas de cliente
C#
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
C++
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
Go
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
Java
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
Node.js
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
PHP
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
Python
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
Ruby
Para copiar um backup ativado para CMEK em uma configuração de instância multirregional:
Restaurar a partir de um backup
É possível restaurar um backup de um banco de dados do Spanner em um novo banco de dados. Por padrão, os bancos de dados restaurados de um backup usam a mesma configuração de criptografia do próprio backup, mas é possível modificar esse comportamento especificando uma configuração de criptografia diferente para o banco de dados restaurado. Se o backup estiver protegido por CMEK, a versão da chave usada para criar o backup precisará estar disponível para que ele possa ser descriptografado.
Console
Use o console para restaurar um backup em uma configuração de instância regional.
No console do Google Cloud , acesse a página Instâncias.
Clique na instância que contém o banco de dados que você quer restaurar.
Clique no banco de dados.
No painel de navegação, clique em Backup/Restaurar.
Na tabela Backups, selecione Ações para seu backup e clique em Restaurar.
Selecione a instância a ser restaurada e nomeie o banco de dados restaurado.
Opcional: se você quiser usar uma configuração de criptografia diferente com o banco de dados restaurado, clique no controle deslizante ao lado de Usar criptografia atual.
a. Selecione Chave do Cloud KMS.
a. Selecione uma chave na lista suspensa.
A lista de chaves é limitada ao projeto do Google Cloud atual. Para usar uma chave de um projeto Google Cloud diferente, crie o banco de dados usando a CLI gcloud em vez do console Google Cloud .
Clique em Restaurar.
gcloud
Para restaurar um backup com uma nova configuração de criptografia, execute o seguinte comando
gcloud spanner databases restore:
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_NAMEPara verificar se o banco de dados restaurado está criptografado com CMEK:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDPara mais informações, consulte Restaurar de um backup.
Bibliotecas de cliente
C#
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
C++
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
Go
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
Java
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
Node.js
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
PHP
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
Python
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
Ruby
Para restaurar um backup com CMEK em uma configuração de instância regional:
Para restaurar um backup ativado para CMEK em uma configuração de instância multirregional:
Visualizar registros de auditoria para chave do Cloud KMS
Verifique se a geração de registros está ativada para a API Cloud KMS no seu projeto.
No console do Google Cloud , acesse a Análise de registros.
Limite as entradas de registro na chave do Cloud KMS adicionando as seguintes linhas ao criador de consultas:
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"Em operações normais, as ações de criptografia e descriptografia são registradas com gravidade
INFO. Essas entradas são registradas à medida que as zonas na instância do Spanner consultam a chave do Cloud KMS a cada cinco minutos.Se o Spanner não conseguir acessar a chave, as operações serão registradas como
ERROR.