Esta página foi traduzida pela API Cloud Translation.

Faça a gestão das cópias de segurança

Esta página descreve como realizar operações de cópia de segurança do Bigtable. Antes de ler esta página, deve conhecer as cópias de segurança.

Pode trabalhar com cópias de segurança do Bigtable através do seguinte:

A Google Cloud consola.
A CLI do Google Cloud.
As bibliotecas de cliente do Cloud Bigtable.

Antes de começar

Certifique-se de que tem ou que a conta de utilizador que está a usar tem as autorizações necessárias para a ação que precisa de executar.

Se planeia usar a CLI gcloud, instale a CLI gcloud para o Bigtable.

Use a cópia de segurança automática

Pode usar a CLI gcloud ou a Google Cloud consola para ativar a cópia de segurança automática. A cópia de segurança automatizada cria uma cópia de segurança diária da sua tabela com um período de retenção predefinido de sete dias. Para modificar o período de retenção na política de cópia de segurança automática de uma tabela, consulte o artigo Atualize uma política de cópia de segurança automática.

Os passos para eliminar, atualizar, copiar e restaurar uma cópia de segurança são os mesmos, quer a cópia de segurança seja criada manualmente ou como resultado de uma cópia de segurança automatizada.

Pode prolongar a data de validade de uma cópia de segurança ou de uma cópia de segurança. Para mais informações, consulte o artigo Modifique uma cópia de segurança ou uma cópia de segurança.

Considere os seguintes fatores se planear ativar a cópia de segurança automática:

Se um cluster for adicionado a uma instância que contenha uma tabela com a cópia de segurança automática ativada, não são criadas cópias de segurança diárias no cluster adicionado. Para criar cópias de segurança diárias em todos os clusters, incluindo o cluster adicionado recentemente, desative a cópia de segurança automática para a tabela e, em seguida, reative-a.
Se uma tabela com a cópia de segurança automática ativada for eliminada e, posteriormente, a eliminação for anulada, tem de reativar a cópia de segurança automática na tabela recuperada.
O restauro de uma cópia de segurança automática de uma tabela não ativa automaticamente a cópia de segurança automática na tabela restaurada. Tem de ativar manualmente a cópia de segurança automática.

Ative a cópia de segurança automática

Pode ativar a cópia de segurança automática através da consola ou da CLI Google Cloud. Quando a cópia de segurança automática está ativada, o Bigtable cria uma cópia de segurança padrão da tabela todos os dias em cada cluster na instância. Não pode usar a cópia de segurança automática para criar cópias de segurança a quente.

As cópias de segurança criadas como parte da cópia de segurança automática são atribuídas a IDs que começam com auto. Por exemplo, uma tabela com um ID de my-table teria um ID de cópia de segurança automático como auto.my-table.c7x3.20230220-145537, em que my-table é o ID da tabela truncado, c7x3 é o ID de hash exclusivo e 20230220-145537 é a data e a hora no formato UTC.

Para criar uma nova tabela com a cópia de segurança automática ativada, consulte o artigo Crie e faça a gestão de tabelas.

Consola

Abra a lista de instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância com a tabela da qual quer fazer uma cópia de segurança.
Clique em Tabelas no painel esquerdo.

A página Tabelas apresenta uma lista de tabelas na instância.
Na coluna Cópia de segurança automática da tabela, clique em Ativar. O Bigtable pode demorar até uma hora a começar a criar cópias de segurança.

gcloud

Para ativar a cópia de segurança automática de uma tabela, execute o comando gcloud bigtable tables update. Para mais informações sobre como ativar a cópia de segurança automática ao criar uma tabela, consulte o artigo Crie uma tabela.

Depois de ativar a política de cópia de segurança automática para uma tabela, a configuração atualizada pode demorar até uma hora a entrar em vigor.

gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--enable-automated-backup

Substitua o seguinte:

TABLE_ID: ID da tabela da qual vai ser feita uma cópia de segurança.
INSTANCE_ID: O identificador permanente da instância.

Opcional: para ativar a cópia de segurança automática de uma tabela e definir um período de retenção diferente do predefinido de sete dias, use a flag --automated-backup-retention-period em vez da flag --enable-automated-backup:

gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--automated-backup-retention-period=RETENTION_PERIOD

Substitua RETENTION_PERIOD por um valor de, pelo menos, 3 dias e até 90 dias, expresso como um número com uma unidade de m, h ou d (minutos, horas ou dias), como 15d para 15 dias.

Desative a cópia de segurança automática

Depois de desativar a política de cópia de segurança automática para uma tabela, a configuração atualizada pode demorar até uma hora a entrar em vigor. As cópias de segurança criadas antes da alteração da política são mantidas até expirarem, a menos que as elimine.

Consola

Abra a lista de instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância que contém a tabela para a qual quer desativar a cópia de segurança automática.
Clique em Tabelas.

A página Tabelas apresenta uma lista de tabelas na instância.
Na linha da tabela para a qual quer desativar a cópia de segurança automática, clique em Editar.
Desmarque a caixa de verificação Ativar cópia de segurança automática.
Clique em Guardar.

gcloud

Para desativar a cópia de segurança automática de uma tabela, execute o comando gcloud bigtable instances tables update.

gcloud bigtable instances tables update TABLE_ID \
--instance=INSTANCE_ID \
--disable-automated-backup

Substitua o seguinte:

TABLE_ID: ID da tabela.
INSTANCE_ID: O identificador permanente da instância.

Veja a política de cópia de segurança automática

Para ver a política de cópia de segurança automática de uma tabela, execute o comando gcloud bigtable instances tables describe.

gcloud bigtable instances tables describe TABLE_ID \
--instance=INSTANCE_ID

Substitua o seguinte:

TABLE_ID: ID da tabela.
INSTANCE_ID: O identificador permanente da instância.

O resultado tem um aspeto semelhante ao seguinte:

automatedBackupPolicy:
  retentionPeriod: 3d
  frequency: 24h
columnFamilies:
  my-family: {}
createTime: '2023-02-07T20:10:55.613546Z'
granularity: MILLIS
name: projects/my-project/instances/my-instance/tables/my-table
updateTime: '2023-02-07T20:10:55.613546Z'

Tenha em conta o seguinte:

O campo automatedBackupPolicy está ausente quando a cópia de segurança automática não está ativada para uma tabela.
O retentionPeriod indica o período de retenção das cópias de segurança criadas automaticamente. Pode modificar o período de retenção de uma cópia de segurança para até 90 dias a partir da hora de criação da cópia de segurança. Para atualizar o período de retenção da cópia de segurança, consulte o artigo Modifique uma cópia de segurança ou uma cópia de segurança.

Atualize uma política de cópia de segurança automática

As alterações a uma política de cópia de segurança automática aplicam-se às cópias de segurança criadas após a alteração.

Consola

Abra a lista de instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância que contém a tabela cuja política de cópia de segurança automática quer atualizar.
Clique em Tabelas.

A página Tabelas apresenta uma lista de tabelas na instância.
Na linha da tabela para a qual quer configurar a política de cópia de segurança automática, clique em Editar. É apresentado o painel de propriedades da tabela.
Em Configurar cópia de segurança automática, no campo Período de retenção, introduza um número inteiro de 3 a 90 para especificar o número de dias que o Bigtable deve reter as cópias de segurança após a alteração ser guardada.
Clique em Guardar.

gcloud

Para modificar a política de cópia de segurança automática de uma tabela, use o comando gcloud bigtable tables update com a flag --automated-backup-retention-period.

gcloud bigtable tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --automated-backup-retention-period=retention-period=RETENTION_PERIOD

Substitua o seguinte:

TABLE_ID: o ID da tabela que tem uma cópia de segurança automática.
INSTANCE_ID: O identificador permanente da instância.
RETENTION_PERIOD: um período de até 90 dias, expresso como um número com uma unidade de m, h ou d (minutos, horas ou dias).

Exemplos: 72h ou 89d

Veja registos de eventos

Quando a cópia de segurança automática está ativada, o Bigtable emite registos de eventos do sistema quando é criada uma cópia de segurança. Também emite um registo de eventos se a criação da cópia de segurança for atrasada.

Para ver os registos de eventos do sistema de cópia de segurança automatizada na página de vista geral do cluster do Bigtable na consola, faça o seguinte:

Abra a lista de instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique no ID da instância.
Clique no ID do cluster.

Se foram criados registos de eventos de cópia de segurança automatizados na última hora, estes são apresentados no painel Registos.
Opcional: para ver registos de eventos mais antigos, clique na seta junto a 1 hora e selecione outro intervalo de tempo.

Para ver registos de eventos do sistema de cópia de segurança automatizada no Logs Explorer, siga estes passos:

Navegue para o Explorador de registos:

Aceda ao Explorador de registos

Selecione o Google Cloud projeto adequado.

Para ver eventos de criação de cópias de segurança, introduza o seguinte no campo Consulta:

resource.type="audited_resource" resource.labels.service="bigtableadmin.googleapis.com"
resource.labels.method="CreateAutomatedBackup"

Clique em Executar consulta.

Para ver eventos de atraso da cópia de segurança, introduza o seguinte no campo Consulta:

resource.type="audited_resource" resource.labels.service="bigtableadmin.googleapis.com"
resource.labels.method="DelayedAutomatedBackup"

Clique em Executar consulta.

O resultado da consulta inclui uma mensagem semelhante à seguinte:
```
Automated backup is delayed for table ab-test on cluster my-cluster-staging-c1.
```

Crie uma cópia de segurança padrão

Pode criar uma cópia de segurança padrão de uma tabela através da Google Cloud CLI, da consola ou de uma das bibliotecas de cliente do Bigtable. Também pode ativar a cópia de segurança automática para permitir que o Bigtable crie uma cópia de segurança padrão diária para si.

Consola

Aceda à página Instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância que contém a tabela da qual quer fazer uma cópia de segurança.
No painel de navegação do lado esquerdo, clique em Tabelas.
Clique em Criar cópia de segurança para a tabela da qual quer fazer uma cópia de segurança.
Se estiver a usar a replicação, use o menu pendente para escolher o ID do cluster que deve armazenar a cópia de segurança. (Se clicou em Criar cópia de segurança junto a um ID do cluster em vez de um ID da instância na página Tabelas, o cluster é pré-selecionado.)
Introduza um ID exclusivo para a cópia de segurança.
Defina uma data de validade.
Clique em Criar.

A consola apresenta a página Cópias de segurança filtrada para mostrar a cópia de segurança e os respetivos detalhes.
Clique em Atividade para ver o estado da cópia de segurança.

A coluna de estado apresenta Cópia de segurança concluída quando a cópia de segurança tiver sido concluída.

gcloud

Para todos os comandos, substitua os valores reais pelos seguintes:

INSTANCE_ID: O identificador permanente da instância.
CLUSTER_ID: O identificador permanente do cluster.
TABLE_ID: o ID da tabela da qual vai ser feita uma cópia de segurança.
BACKUP_ID: o ID que atribui à cópia de segurança.
EXPIRATION_DATE: uma data que está a 90 dias ou menos no futuro, formatada como uma indicação de tempo UTC "Zulu", precisa até aos nanosegundos.

Exemplo: 2022-10-02T15:01:23.045123456Z
RETENTION_PERIOD: um período de até 90 dias, expresso como um número com uma unidade de m, h ou d (minutos, horas ou dias).

Exemplos: 36h ou 89d

Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto:
```
gcloud bigtable instances list
```
Veja a lista de cópias de segurança da instância que contém a tabela da qual quer fazer uma cópia de segurança, para poder escolher um ID de cópia de segurança que ainda não esteja a ser usado no cluster pretendido.
```
gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```
Veja a lista de tabelas para confirmar o ID da tabela da qual quer fazer uma cópia de segurança.
```
gcloud bigtable instances tables list --instances=INSTANCE_ID
```
Execute o comando gcloud bigtable instances backups create para criar uma cópia de segurança da tabela, indicando uma data de validade ou um período de retenção de até 90 dias.
```
gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --table=TABLE_ID \
  --async \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD
```
A flag --async é opcional. Use-o se quiser que o terminal devolva o ID da operação antes de a operação estar concluída. Isto é útil se quiser verificar o estado da operação.
Veja a lista de cópias de segurança para verificar se a sua cópia de segurança foi criada.
```
gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```
Se a cópia de segurança não estiver na lista, verifique o estado da operação.

Um estado de Ready indica que a cópia de segurança está concluída.

Crie uma cópia de segurança a quente

gcloud

Para todos os comandos, substitua os valores reais pelos seguintes:

INSTANCE_ID: O identificador permanente da instância.
CLUSTER_ID: O identificador permanente do cluster.
TABLE_ID: o ID da tabela da qual vai ser feita uma cópia de segurança.
BACKUP_ID: o ID que atribui à cópia de segurança.
EXPIRATION_DATE: uma data que está a 90 dias ou menos no futuro, formatada como uma indicação de tempo UTC "Zulu", precisa até aos nanosegundos.

Exemplo: 2022-10-02T15:01:23.045123456Z
RETENTION_PERIOD: um período de até 90 dias, expresso como um número com uma unidade de m, h ou d (minutos, horas ou dias).

Exemplos: 36h ou 89d
HOT_TO_STANDARD_TIME: (Opcional) a data e a hora em que o Bigtable deve converter a cópia de segurança de uma cópia de segurança ativa para uma cópia de segurança padrão. Este valor tem de ser, pelo menos, 24 horas após a hora de criação da cópia de segurança.

Exemplo: 2024-08-02T15:01:23.045123456Z

Em alternativa, pode indicar uma data e hora de duração relativa. Para mais informações, consulte o tópico gcloud datetimes.

Exemplo: +P30D durante 30 dias

Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto:
```
gcloud bigtable instances list
```
Veja a lista de cópias de segurança da instância que contém a tabela da qual quer fazer uma cópia de segurança, para poder escolher um ID de cópia de segurança que ainda não esteja a ser usado no cluster pretendido.
```
gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```
Veja a lista de tabelas para confirmar o ID da tabela da qual quer fazer uma cópia de segurança.
```
gcloud bigtable instances tables list --instances=INSTANCE_ID
```
Execute o comando gcloud bigtable instances backups create para criar uma cópia de segurança ativa da tabela, indicando uma data de validade ou um período de retenção de até 90 dias.
```
gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --table=TABLE_ID \
  --async \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD \
  --backup-type=HOT \
  --hot-to-standard-time=HOT_TO_STANDARD_TIME
```
A flag --async é opcional. Use-o se quiser que o terminal devolva o ID da operação antes de a operação estar concluída. Isto é útil se quiser verificar o estado da operação.
Veja a lista de cópias de segurança para verificar se a sua cópia de segurança foi criada.
```
gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```
Se a cópia de segurança não estiver na lista, verifique o estado da operação.

Um estado de Ready indica que a cópia de segurança está concluída.

Restauro a partir de cópia de segurança

Uma nova tabela restaurada a partir de uma cópia de segurança não tem a cópia de segurança automática ativada, mesmo que a tabela de origem a tivesse. Se quiser uma cópia de segurança automatizada na nova tabela, tem de a ativar.

Os passos para restaurar a partir de uma cópia de segurança são os mesmos, quer a cópia de segurança seja padrão ou rápida. O Bigtable restaura uma cópia de segurança ativa para o desempenho de produção mais rapidamente do que uma cópia de segurança padrão.

Consola

Não pode fazer o restauro para um projeto diferente através da Google Cloud consola. Se precisar de o fazer, use a CLI gcloud.

Aceda à página Instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância que contém a cópia de segurança que quer restaurar.
No painel de navegação do lado esquerdo, clique em Cópias de segurança.
Clique em Restaurar para a cópia de segurança que quer restaurar.
Selecione a instância para a qual quer restaurar.

As instâncias que não têm armazenamento suficiente para a nova tabela estão indisponíveis. Se não tiver autorização para criar uma tabela numa instância, a instância fica indisponível. Passe o cursor do rato sobre o ícone para ver mais informações.

Se restaurar a partir de uma cópia de segurança protegida por CMEK, a instância de destino também tem de estar protegida por CMEK.

Não pode restaurar para um projeto diferente através da consolaGoogle Cloud . Se precisar, use a CLI gcloud.
Introduza um ID exclusivo para a tabela que vai ser criada a partir da cópia de segurança. Não pode alterar este ID mais tarde.
Clique em Restaurar.

A consola apresenta a página Tabelas filtrada para mostrar a nova tabela.

A consola apresenta o estado do restauro de cada cluster. Quando a coluna de estado de todos os clusters mostra Pronto, a tabela foi restaurada e replicada para todos os clusters na instância.

gcloud

Para todos os comandos, substitua os valores reais pelos seguintes:

PROJECT_ID_SOURCE: o ID do projeto que contém a cópia de segurança a partir da qual vai ser feito o restauro.
INSTANCE_ID_SOURCE: o ID permanente da instância de origem.
PROJECT_ID_DESTINATION: o ID do projeto para o qual quer fazer o restauro. Esta flag é opcional. Se não especificar esta opção, a cópia de segurança é restaurada para uma nova tabela na mesma instância em que foi criada.
INSTANCE_ID_DESTINATION: o ID permanente da instância de destino.
CLUSTER_ID: O identificador permanente do cluster.
BACKUP_ID: o ID da cópia de segurança a partir da qual quer fazer o restauro.
TABLE_ID_NEW: o ID da nova tabela.

Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto:
```
gcloud bigtable instances list
```
Veja a lista de cópias de segurança da instância que contém a cópia de segurança para verificar se a cópia de segurança existe.
```
gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \
  --cluster=CLUSTER_ID_SOURCE
```
Veja a lista de tabelas na instância de destino para poder escolher um ID para a nova tabela que ainda não esteja a ser usado.
```
gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATION
```
Execute o comando gcloud bigtable instances tables restore para restaurar a partir da cópia de segurança para uma nova tabela.
```
gcloud bigtable instances tables restore \
--source=projects/PROJECT_ID_SOURCE/instances/INSTANCE_ID_SOURCE/clusters/CLUSTER_ID/backups/BACKUP_ID \
--async \
--destination=TABLE_ID_NEW \
--destination-instance=INSTANCE_ID_DESTINATION \
--project=PROJECT_ID_DESTINATION
```
A flag --async é opcional. Use-o se quiser que o terminal devolva o ID da operação antes de a operação estar concluída. Isto é útil se quiser verificar o estado da operação.

Veja a lista de tabelas para verificar se a sua tabela foi criada.

gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATION

Se a cópia de segurança não estiver na lista, verifique o estado da operação.

Crie uma cópia de uma cópia de segurança

Consola

Não pode criar uma cópia de uma cópia de segurança num projeto diferente através da consola. Se precisar de o fazer, use a CLI gcloud.

Aceda à página Instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância que contém a cópia de segurança que quer copiar.
No painel de navegação do lado esquerdo, clique em Cópias de segurança.
Para a cópia de segurança que quer copiar, expanda o menu Mais junto à palavra Restaurar e, de seguida, clique em Copiar.
Clique em Copiar para a cópia de segurança da qual quer criar uma cópia.

Se a cópia de segurança for uma cópia de outra cópia de segurança, a opção Copiar não está disponível.
Selecione a instância de destino.

Não pode criar uma cópia de uma cópia de segurança num projeto diferente através da consola. Se precisar de o fazer, use a CLI gcloud.

As instâncias que não têm armazenamento suficiente para a cópia de segurança estão indisponíveis. Se não tiver autorização para criar uma cópia de segurança numa instância, a instância fica indisponível. Mantenha o ponteiro sobre o ícone para ver mais informações.

Se copiar uma cópia de segurança protegida por CMEK, a instância de destino também tem de estar protegida por CMEK.
Selecione o cluster de destino.

Tal como qualquer cópia de segurança, uma cópia de segurança é armazenada apenas num cluster numa instância, mesmo que essa instância use a replicação.
Introduza um ID exclusivo para a cópia que vai ser criada a partir da cópia de segurança. Não pode alterar este ID mais tarde.
Defina um prazo de validade para a cópia de segurança, indicando um valor para Tempo e selecionando uma Unidade no menu pendente.
Clique em Copiar.
Para ver a cópia, clique em Ver cópia.

A consola apresenta a página Cópias de segurança da instância de destino, filtrada pela cópia de segurança que acabou de criar. Quando a coluna de estado mostra Pronto, a cópia está concluída e pronta para operações adicionais.

gcloud

Para todos os comandos, substitua os valores reais pelos seguintes:

PROJECT_ID_SOURCE: o projeto que contém a cópia de segurança a copiar.
INSTANCE_ID_SOURCE: o ID permanente da instância de origem.
CLUSTER_ID_SOURCE: o ID do cluster onde a cópia de segurança de origem está armazenada.
BACKUP_ID_SOURCE: o ID da cópia de segurança a copiar.
PROJECT_ID_DESTINATION: o projeto onde quer colocar a cópia.
INSTANCE_ID_DESTINATION: o ID permanente da instância de destino.
CLUSTER_ID_DESTINATION: o ID do cluster na instância de destino onde quer armazenar a cópia.
BACKUP_ID_DESTINATION: o ID que atribui à cópia da cópia de segurança.
RETENTION_PERIOD: o tempo de vida da cópia de segurança, expresso como um número e uma unidade (d ou h). Exemplos: 5d durante cinco dias ou 15h durante 15 horas. Use esta opção ou uma data de validade.
EXPIRATION_DATE: a data e a hora em que a cópia de segurança expira, no formato 2022-09-01T10:00:00.0Z.

Se não souber o ID da instância, use o comando bigtable instances list para ver uma lista das instâncias do seu projeto:
```
gcloud bigtable instances list
```
Veja a lista de cópias de segurança da instância de origem que contém a cópia de segurança para verificar se a cópia de segurança que quer copiar existe.
```
gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \
--cluster=CLUSTER_ID_SOURCE
```
Veja a lista de cópias de segurança na instância de destino para poder escolher um ID para a cópia que ainda não esteja a ser usado.
```
gcloud bigtable backups list --instances=DESTINATION_INSTANCE
```
Execute o comando gcloud bigtable instances backups copy para criar a cópia de segurança.
```
gcloud bigtable backups copy \
  --source-project=PROJECT_ID_SOURCE \
  --source-instance=INSTANCE_ID_SOURCE \
  --source-cluster=CLUSTER_ID_SOURCE \
  --source-backup=BACKUP_ID_SOURCE \
  --destination-project=PROJECT_ID_DESTINATION \
  --destination-instance=INSTANCE_ID_DESTINATION \
  --destination-cluster=CLUSTER_ID_DESTINATION \
  --destination-backup=BACKUP_ID_DESTINATION \
```
Acrescente um dos seguintes elementos ao comando:
- --retention-period`=RETENTION_PERIOD: período de retenção da cópia de segurança. Tem de ser, pelo menos, 6 horas e, no máximo, 30 dias a partir do momento em que foi criada a cópia de segurança de origem.
- --expiration-date`=EXPIRATION_DATE: data de validade da cópia de segurança. Tem de ser, pelo menos, 6 horas e, no máximo, 30 dias a partir do momento em que foi criada a cópia de segurança de origem.
Opcionalmente, pode adicionar --async ao comando. Use-o se quiser que o terminal devolva o ID da operação antes de a operação estar concluída. Isto é útil se quiser verificar o estado da operação.

Se for devolvida uma mensagem de tempo limite, a cópia de segurança pode ter sido bem-sucedida e a cópia pode ter sido criada.
Veja a lista de cópias de segurança para saber se a sua cópia foi criada.
```
gcloud bigtable backups list --instances=INSTANCE_ID_DESTINATION
```
Se a cópia de segurança não estiver na lista, verifique o estado da operação.

No caso raro de uma operação de cópia de segurança falhar devido a limitações de capacidade, experimente novamente com um cluster de destino diferente. Se essa operação também falhar, contacte o apoio técnico.

Verifique o estado de uma operação

Consola

Aceda à página Instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância que contém a cópia de segurança.
No painel de navegação do lado esquerdo, clique em Cópias de segurança.
Na página Cópias de segurança, clique em Atividade. A coluna de estado apresenta o estado atual de cada operação.

Os estados de operação ao restaurar uma tabela incluem o seguinte:

A aguardar para copiar
A restaurar cópia de segurança
A inicializar
Prontas para otimização
Pronto

Os estados de operação ao criar uma cópia de segurança incluem o seguinte:

A criar cópia de segurança…
Cópia de segurança concluída

Os estados de funcionamento ao copiar uma cópia de segurança incluem o seguinte:

A copiar cópia de segurança
Cópia de segurança copiada

gcloud

Para verificar o estado de uma operação de restauro ou de cópia de segurança, precisa do ID exclusivo da operação. Segue-se um exemplo de um ID da operação:

`instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635`

Depois de executar um comando para criar uma cópia de segurança ou restaurar para uma nova tabela através da opção --async, o terminal apresenta o ID da operação.

Copie o ID da operação.
Execute o comando gcloud bigtable operations describe substituindo o valor que copiou por OPERATION_ID.
```
gcloud bigtable operations describe OPERATION_ID
```
Exemplo:
```
gcloud bigtable operations describe \
instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635
```
Pode executar este comando a cada poucos momentos até que o valor de DONE seja TRUE.

Se não souber o ID da operação, quer porque não executou o comando agora mesmo ou porque está numa janela de terminal diferente, pode ver uma lista de operações para a instância e determinar que operação quer verificar.

Veja uma lista da atividade de operações recente para a instância que contém a tabela da qual está a fazer uma cópia de segurança ou para a qual está a restaurar, substituindo o ID da instância por INSTANCE_ID:
```
gcloud bigtable operations list --instance=INSTANCE_ID
```
O terminal apresenta uma lista de operações em colunas etiquetadas como NAME, START_TIME, END_TIME e DONE. O valor na coluna NAME é o ID da operação.
A partir do primeiro item da lista, copie o ID da operação.

Use gcloud bigtable operations describe para ver os metadados da operação.

gcloud bigtable operations describe OPERATION_ID

Exemplo:

gcloud bigtable operations describe \
instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635

Se os metadados de uma operação mostrarem um valor para backupInfo, encontrou a operação correta e pode repetir este comando com frequência até que o valor de DONE seja TRUE.

Se os metadados não mostrarem um valor para backupInfo, verifique a operação seguinte na lista de operações apresentada no passo 1.

Modifique uma cópia de segurança ou uma cópia da cópia de segurança

Consola

A Google Cloud consola não lhe permite modificar uma cópia de segurança, incluindo cópias.

gcloud

A CLI gcloud permite-lhe modificar a data de validade ou o período de uma cópia de segurança ou de uma cópia de segurança. Também pode converter uma cópia de segurança ativa numa cópia de segurança padrão.

Para todos os comandos, substitua os valores reais pelos seguintes:

INSTANCE_ID: O identificador permanente da instância.
CLUSTER_ID: O identificador permanente do cluster.
BACKUP_ID: o ID exclusivo de uma cópia de segurança.
EXPIRATION_DATE: Uma data que está a 90 dias ou menos no futuro, formatada como uma indicação de tempo UTC "Zulu", precisa até aos nanosegundos.

Exemplo: 2019-10-02T15:01:23.045123456Z
RETENTION_PERIOD: Um período de até 90 dias para cópias de segurança ou até 30 dias para cópias de segurança, expresso como um número com uma unidade de m, h ou d (minutos, horas ou dias).

Exemplos: 36h ou 89d
HOT_TO_STANDARD_TIME: (Opcional) a data e a hora em que o Bigtable deve converter a cópia de segurança de uma cópia de segurança ativa para uma cópia de segurança padrão. Este valor tem de ser, pelo menos, 24 horas após a hora de criação da cópia de segurança.

Exemplo: 2024-08-02T15:01:23.045123456Z

Em alternativa, pode indicar uma data e hora de duração relativa. Para mais informações, consulte o tópico gcloud datetimes.

Exemplo: +P30D durante 30 dias

Ver uma lista de cópias de segurança:
```
    gcloud bigtable backups list --instance=INSTANCE_ID
```
O terminal apresenta uma lista de cópias de segurança.
Tome nota dos IDs da cópia de segurança e do cluster da cópia de segurança que tem de atualizar.

Execute o comando gcloud bigtable instances backups update para adicionar uma nova data de validade ou período de retenção, ou para converter uma cópia de segurança ativa numa cópia de segurança padrão.

  gcloud bigtable backups update BACKUP_ID \
  --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD
  --hot-to-standard-time=HOT_TO_STANDARD_TIME

Execute o comando gcloud bigtable instances backups describe para verificar se atualizou com êxito a data de validade.
```
    gcloud bigtable backups describe BACKUP_ID \
    --instance=INSTANCE_ID \
    --cluster=CLUSTER_ID
```
```

Elimine uma cópia de segurança

Se quiser eliminar uma cópia de segurança depois de criar uma cópia da mesma, verifique o estado para confirmar que a operação de cópia está concluída.

Consola

Aceda à página Instâncias do Bigtable na Google Cloud consola.

Abra a lista de instâncias
Clique na instância que contém a cópia de segurança.
No painel de navegação do lado esquerdo, clique em Cópias de segurança.
Para a cópia de segurança que precisa de eliminar, expanda o menu Mais junto à palavra Restaurar e, de seguida, clique em Eliminar.
Introduza o ID da cópia de segurança no campo Confirmar eliminação e, de seguida, clique em Eliminar.

gcloud

Veja uma lista de cópias de segurança, substituindo o ID da instância por INSTANCE_ID:
```
gcloud bigtable backups list --instance=INSTANCE_ID
```
O terminal apresenta uma lista de cópias de segurança.
Anote o ID da cópia de segurança e o ID do cluster no qual está armazenada.
Execute o comando gcloud bigtable instances backups delete, substituindo o ID da cópia de segurança que anotou por BACKUP_ID e o ID do cluster por CLUSTER_ID.
```
gcloud bigtable backups delete BACKUP_ID \
  --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID
```

O que se segue?

Leia mais sobre as cópias de segurança.
Saiba como importar e exportar dados do Bigtable.
Reveja a secção Bigtable de Arquitetar a recuperação de desastres para interrupções da infraestrutura na nuvem.