O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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 da predefinição 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 os 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 a partir 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 for apresentada, 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á 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 uma 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 da 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
```