Gerenciamento de backups
Os backups do Bigtable ajudam a proteger suas tabelas contra perda acidental de dados, corrupção ou cenários de desastre. É possível criar, copiar, restaurar e monitorar esses backups usando o console do Google Cloud , a Google Cloud CLI ou as bibliotecas de cliente do Cloud Bigtable.
Antes de começar
Antes de começar, consulte Backups e Visão geral das edições para ver os recursos disponíveis apenas na edição Enterprise Plus.
Certifique-se de que você ou a conta de usuário que está usando tenham as permissões necessárias para a ação que você precisa executar.
Se você planeja usar a CLI gcloud, instale a CLI gcloud para Bigtable.
Usar o backup automático
Use a CLI gcloud ou o console do Google Cloud para ativar o backup automatizado. Por padrão, o backup automatizado cria um backup padrão diário da tabela com um período de armazenamento de sete dias. É possível personalizar uma política de backup automatizado das seguintes maneiras:
- Configure backups automáticos dinâmicos em instâncias de SSD especificando uma duração de manutenção dinâmica de 24 horas a 10 dias. Essa configuração obrigatória determina por quanto tempo cada backup diário permanece dinâmico antes de se tornar um backup padrão. Os backups automatizados ativos também têm um período de armazenamento padrão de sete dias. Para mais informações, consulte a seção Configurar backups automatizados dinâmicos deste documento.
- Modifique o período de armazenamento do backup para até 90 dias. Para mais informações, consulte a seção Atualizar uma política de backup automatizado deste documento.
- Selecione locais de cluster específicos em que o backup automatizado está ativado. Essa opção está disponível apenas na edição Enterprise Plus. Para mais informações, consulte a seção Configurar locais de cluster de backup automático deste documento.
As etapas para excluir, atualizar, copiar e restaurar um backup são as mesmas, seja ele criado manualmente ou como resultado de um backup automatizado.
É possível estender a data de validade de um backup ou de uma cópia de backup. Para mais informações, consulte Modificar um backup ou uma cópia de backup.
Se você planeja ativar o backup automatizado, considere os seguintes fatores:
- Se um cluster for adicionado a uma instância que contém uma tabela com o backup automatizado ativado, os backups diários não serão criados no cluster adicionado. Para criar backups diários em todos os clusters, incluindo o recém-adicionado, desative o backup automatizado da tabela e reative-o.
- Se uma tabela com backup automatizado ativado for excluída e, em seguida, recuperada, será necessário reativar o backup automatizado na tabela recuperada.
- A restauração de um backup automatizado de uma tabela não ativa automaticamente o backup automatizado na tabela restaurada. É necessário ativar manualmente o backup automatizado.
Ativar backup automático
É possível ativar o backup automatizado usando o console do Google Cloud ou a Google Cloud CLI. Quando você ativa o backup automatizado com as configurações padrão, o Bigtable cria um backup padrão diário da tabela em cada cluster na instância e o retém por sete dias.
Os backups que o Bigtable cria como parte do backup automatizado recebem
IDs que começam com auto. Por exemplo, uma tabela com um ID de
my-table tem um ID de backup automatizado 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 tabela com o backup automatizado ativado, consulte Criar e gerenciar tabelas.
Console
No console do Google Cloud , abra a lista de instâncias do Bigtable.
Clique na instância que contém a tabela que você quer copiar.
No menu de navegação do Bigtable, clique em Tabelas.
A página Tabelas exibe uma lista de tabelas na instância.
Para ativar o backup diário automatizado com as configurações padrão, na coluna Backup automatizado da tabela, clique em Ativar.
Pode levar até uma hora para o Bigtable começar a criar backups.
Opcional: para ativar o backup automatizado com configurações personalizadas, como backups automatizados ativos em instâncias de SSD, faça o seguinte:
- Na linha da tabela, clique em Editar.
- Na seção Configurar backup automatizado, selecione Ativar backup automatizado.
Também é possível atualizar uma política atual para mudar o tipo de backup, o período de armazenamento ou, na edição Enterprise Plus, os locais do cluster. Para mais informações, consulte as seções Atualizar uma política de backup automatizado e Configurar backups automatizados dinâmicos deste documento.
gcloud
Para ativar o backup automatizado de uma tabela, execute o comando gcloud bigtable
tables update. Para mais informações sobre como ativar o backup automatizado ao criar uma tabela, consulte Criar uma tabela.
Depois que a política de backup automático é ativada em uma tabela, pode levar até uma hora para que a configuração tenha efeito.
gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--enable-automated-backup
Substitua:
TABLE_ID: o ID da tabela que você quer fazer backup.INSTANCE_ID: identificador permanente da instância
Opcional: é possível atualizar a política de backup automatizado para especificar um período de armazenamento personalizado ou configurar backups automatizados em instâncias de SSD. Na edição Enterprise Plus, é possível ativar backups automatizados para clusters em locais específicos. Para mais informações, consulte as seções Atualizar uma política de backup automatizado e Configurar backups automatizados dinâmicos deste documento.
Desativar o backup automático
Depois que a política de backup automático é desativada em uma tabela, pode levar até 1 hora para que a configuração tenha efeito. Os backups criados antes da alteração da política são mantidos até expirarem, a menos que você os exclua.
Console
No console do Google Cloud , abra a lista de instâncias do Bigtable.
Clique na instância que contém a tabela com o backup automatizado que você quer desativar.
No menu de navegação do Bigtable, clique em Tabelas.
A página Tabelas exibe uma lista de tabelas na instância.
Na linha da tabela em que você quer desativar o backup automático, clique em Editar.
No painel Editar tabela, na seção Configurar backup automático, desmarque Ativar backup automático.
Clique em Salvar.
gcloud
Para desativar o backup automatizado 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:
TABLE_ID: o ID da tabelaINSTANCE_ID: identificador permanente da instância
Ver política de backup automatizada
É possível visualizar a política de backup automático de uma tabela usando o console doGoogle Cloud ou a Google Cloud CLI.
Console
No console do Google Cloud , abra a lista de instâncias do Bigtable.
Clique na instância que contém a tabela com a política de backup automático que você quer visualizar.
No menu de navegação do Bigtable, clique em Tabelas.
Na página Tabelas, a coluna Backup automatizado mostra Não ativado se o backup automatizado não estiver ativado ou mostra o tipo de backup (Padrão ou Ativo) se o backup automatizado estiver ativado. Na edição Enterprise Plus, se os backups automatizados estiverem configurados para clusters específicos, a coluna também listará as Zonas com backup. Também é possível ver esse resumo na página de visão geral da tabela clicando no ID da tabela.
Opcional: para ver a configuração completa da política, na linha da tabela, clique em Editar.
No painel Editar tabela, a seção Configurar backup automatizado mostra a configuração Tipo de backup (e a duração de Definir acesso frequente como padrão se Acesso frequente estiver selecionado), o Período de retenção e a configuração Selecionar clusters para fazer backup. Para fechar o painel sem fazer mudanças, clique em Cancelar.
gcloud
Para conferir a política de backup automatizado de uma tabela, execute o
comando gcloud bigtable instances tables describe:
gcloud bigtable instances tables describe TABLE_ID \
--instance=INSTANCE_ID
Substitua:
TABLE_ID: o ID da tabelaINSTANCE_ID: identificador permanente da instância
A saída será assim:
automatedBackupPolicy:
frequency: 86400s
keepHotDuration: 172800s
retentionPeriod: 604800s
locations: us-central1-a,us-east1-b,europe-west1-c
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'
Observe o seguinte:
- O campo
automatedBackupPolicyfica ausente quando o backup automatizado não está ativado para uma tabela. - O campo
keepHotDurationsó está presente quando você configura a política para criar backups automáticos dinâmicos. Quando presente, ele indica por quanto tempo cada backup automatizado permanece dinâmico antes de fazer a transição para um backup padrão. Se a política criar backups padrão, o campo não estará presente. - O campo
retentionPeriodindica o período de armazenamento de backups criados automaticamente. É possível modificar o período de armazenamento de um backup individual para até 90 dias na edição Enterprise ou até 365 dias na edição Enterprise Plus, a partir do horário de criação do backup. Para atualizar o período de armazenamento de backup, consulte Modificar um backup ou uma cópia de backup. - O campo
locationssó está presente quando os backups automatizados para clusters em locais específicos estão ativados na edição Enterprise Plus. Quando presente, indica a lista de locais de cluster em que os backups automatizados estão ativados. Se os backups automáticos estiverem ativados em todos os locais (padrão), o campo não estará presente.
Atualizar uma política de backup automatizada
As mudanças na política de backup automatizado não se aplicam retroativamente aos backups atuais. As novas configurações da política de backup se aplicam apenas aos backups subsequentes.
É possível configurar um período de armazenamento personalizado de até 90 dias nas edições Enterprise e Enterprise Plus. Em instâncias SSD, é possível configurar backups automáticos dinâmicos especificando uma duração de retenção dinâmica, que define por quanto tempo os backups automáticos permanecem dinâmicos antes de fazer a transição para backups padrão. Na edição Enterprise Plus, também é possível selecionar locais de cluster específicos para backups automatizados. Para mais informações sobre backups automatizados dinâmicos, consulte Configurar backups automatizados dinâmicos.
Para atualizar o período de armazenamento ou a data de validade de um backup, incluindo um backup automatizado, consulte Modificar um backup ou uma cópia de backup.
Console
No console do Google Cloud , abra a lista de instâncias do Bigtable.
Clique na instância que contém a tabela com a política de backup automatizado que você quer atualizar.
No menu de navegação do Bigtable, clique em Tabelas.
A página Tabelas exibe uma lista de tabelas na instância.
Na linha da tabela que você quer atualizar, clique em Editar.
No painel Editar tabela, na seção Configurar backup automático, verifique se a opção Ativar backup automático está selecionada e atualize uma das seguintes configurações:
- Na seção Tipo de backup, selecione Padrão ou Hot. Não é possível selecionar Hot em instâncias de HDD ou em tabelas com armazenamento em níveis ativado. Se você selecionar Dinâmico, no campo Definir dinâmico como padrão, para especificar o número de dias que cada backup automatizado permanece dinâmico antes de fazer a transição automática para um backup padrão, insira um número inteiro de 1 a 10 (até o período de armazenamento).
- Na seção Configuração de backup, no campo Período de retenção, insira um número inteiro de 3 a 90 para especificar o número de dias que o Bigtable retém backups (até 90 dias).
- A edição Enterprise Plus: na seção Configuração de backup, na lista Selecionar clusters para fazer backup, selecione os clusters em que você quer que o Bigtable crie backups diários e clique em OK.
Clique em Salvar.
gcloud
Para modificar a política de backup automático de uma tabela, use o comando
gcloud bigtable tables update
com uma ou mais das seguintes flags:
--automated-backup-retention-period: define um período de armazenamento personalizado.--automated-backup-keep-hot-duration: em instâncias SSD, configura o Bigtable para criar backups automatizados dinâmicos e especifica por quanto tempo eles permanecem dinâmicos antes de fazer a transição para backups padrão.--automated-backup-locations: na edição Enterprise Plus, ativa o backup automatizado apenas para clusters nos locais especificados.
gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--automated-backup-retention-period=RETENTION_PERIOD \
--automated-backup-keep-hot-duration=KEEP_HOT_DURATION \
--automated-backup-locations=BACKUP_LOCATIONS
Substitua:
TABLE_ID: o ID da tabela que tem backup automatizado.INSTANCE_ID: identificador permanente da instânciaRETENTION_PERIOD: um período de até 90 dias. O valor precisa ser expresso como um número com uma unidade dem,houd(minutos, horas ou dias), como15dpara 15 dias.Exemplos:
72hou15d.KEEP_HOT_DURATION: o tempo que os backups automáticos permanecem dinâmicos antes de serem convertidos em backups padrão, de24h(1 dia) a10d(10 dias), sem exceder o período de armazenamento da política. Expresse o valor como um número com uma unidade des,m,houd(segundos, minutos, horas ou dias). O Bigtable só aceita essa flag em instâncias SSD e em tabelas sem armazenamento em níveis ativado.Exemplos:
24hou2d.BACKUP_LOCATIONS: uma lista separada por vírgulas de locais de cluster em que você quer ativar o backup automatizado. Se não for definido, os backups serão padronizados para todos os clusters na instância da tabela.Exemplo:
us-central1-a,us-east1-b,europe-west1-c
Configurar backups automáticos dinâmicos
É possível configurar backups automáticos ativos usando o console do Google Cloud ou a Google Cloud CLI ao criar uma tabela, ativar o backup automático ou atualizar uma política de backup automático. Ao configurar backups automáticos dinâmicos, você especifica uma duração de retenção dinâmica que determina por quanto tempo cada backup diário permanece dinâmico antes de fazer a transição para um backup padrão. Por exemplo, para manter apenas o backup diário mais recente, defina a duração de manutenção como 24 horas (1 dia) para que cada backup diário seja transferido para um backup padrão após a criação do próximo backup diário. Para mais informações sobre como configurar o backup automatizado ao criar uma tabela, consulte Criar uma tabela.
Considere os seguintes requisitos e limitações ao configurar backups automatizados ativos:
- A tabela precisa estar em uma instância de SSD. O Bigtable não é compatível com backups automatizados ativos em instâncias de HDD.
- O Bigtable não oferece suporte a backups automatizados ativos para tabelas com armazenamento em níveis ativado. Para mais informações, consulte Visão geral do armazenamento em níveis.
- A duração de manutenção precisa ser de pelo menos 24 horas (
24hou1d, ou 1 dia no console do Google Cloud ) e no máximo 10 dias (10d), e não pode exceder o período de armazenamento da política. Para ativar backups automáticos em uma tabela em um cluster que usa mais de 400 TB de armazenamento SSD, entre em contato com o Cloud Customer Care. Para mais informações, consulte Limites de backups.
Console
Para configurar backups automatizados ativos para uma tabela atual:
No console do Google Cloud , abra a lista de instâncias do Bigtable.
Clique na instância de SSD que contém a tabela que você quer configurar.
No menu de navegação do Bigtable, clique em Tabelas.
A página Tabelas exibe uma lista de tabelas na instância.
Na linha da tabela, clique em Editar.
No painel Editar tabela, na seção Configurar backup automatizado, verifique se a caixa de seleção Ativar backup automatizado está marcada.
Na seção Tipo de backup, selecione Ativo.
No campo Definir dinâmico como padrão, insira um número inteiro de 1 a 10 para especificar o número de dias que cada backup automatizado permanece dinâmico antes de fazer a transição automática para um backup padrão. O padrão é 3 dias. Esse valor não pode exceder o número de dias no campo Período de armazenamento.
Opcional: na seção Configuração de backup, insira um número inteiro de 3 a 90 no campo Período de armazenamento ou, na edição Enterprise Plus, selecione clusters específicos na lista Selecionar clusters para fazer backup e clique em OK.
Clique em Salvar.
Para interromper a manutenção de backups automatizados subsequentes e reverter a política para criar backups padrão, abra o painel Editar tabela, selecione Padrão na seção Tipo de backup e clique em Salvar. Mudar o tipo de backup não afeta os backups que já foram criados. Os backups dinâmicos atuais permanecem dinâmicos até que o período de transição expire.
gcloud
Para configurar backups automatizados de acesso frequente para uma tabela, execute o comando gcloud bigtable tables update usando a flag --automated-backup-keep-hot-duration:
gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--automated-backup-keep-hot-duration=KEEP_HOT_DURATION
Substitua:
TABLE_ID: o ID da tabela a ser configurada.INSTANCE_ID: identificador permanente da instânciaKEEP_HOT_DURATION: o tempo que os backups automáticos permanecem dinâmicos antes de serem convertidos em backups padrão, de24h(1 dia) a10d(10 dias), sem exceder o período de armazenamento da política. Expresse o valor como um número com uma unidade des,m,houd(segundos, minutos, horas ou dias), como24hou2d. Se o backup automático ainda não estiver ativado na tabela, inclua também a flag--automated-backup-retention-periodao executar o comandogcloud bigtable tables update. Caso contrário, o comando falhará com um erro de período de armazenamento ausente.
Para parar de manter os backups automatizados ativos e reverter a política para criar
backups padrão, execute o comando gcloud bigtable tables update
usando a flag --clear-automated-backup-keep-hot-duration.
Limpar a duração de manutenção não afeta os backups que já foram
criados. Os backups dinâmicos atuais permanecem dinâmicos até que a duração de manutenção expire e eles sejam transferidos para backups padrão.
gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--clear-automated-backup-keep-hot-duration
Substitua:
TABLE_ID: o ID da tabela a ser configurada.INSTANCE_ID: identificador permanente da instância
Configurar locais de cluster de backup automatizado
Por padrão, quando você ativa o backup automatizado para uma tabela em uma instância que tem vários clusters, o Bigtable cria um backup diário em cada cluster na instância. Na edição Enterprise Plus, é possível configurar seletivamente o backup automatizado para criar backups diários em clusters em locais específicos.
É possível configurar os locais de cluster de backup automatizado ao criar uma tabela, ativar o backup automatizado ou atualizar uma política de backup automatizado.
Console
No console do Google Cloud , abra a lista de instâncias do Bigtable.
Clique na instância que contém a tabela que você quer configurar.
No menu de navegação do Bigtable, clique em Tabelas.
Na página Tabelas, na linha da tabela, clique em Editar.
No painel Editar tabela, na seção Configurar backup automatizado, verifique se a opção Ativar backup automatizado está selecionada.
Na seção Configuração de backup, na lista Selecionar clusters para fazer backup, selecione os clusters em que você quer que o Bigtable crie backups diários e clique em OK.
Clique em Salvar.
Para voltar a criar backups diários em todos os clusters da instância, abra o painel Editar tabela, selecione todos os clusters na lista Selecionar clusters para backup, clique em OK e em Salvar.
gcloud
Para especificar locais de cluster para backup automatizado, execute o comando gcloud bigtable tables update usando a flag --automated-backup-locations:
gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--automated-backup-locations=BACKUP_LOCATIONS
Substitua:
TABLE_ID: o ID da tabela a ser configurada.INSTANCE_ID: identificador permanente da instânciaBACKUP_LOCATIONS: uma lista separada por vírgulas de locais de cluster em que você quer ativar o backup automatizado, comous-central1-a,us-east1-b.
Para remover os locais personalizados de backup automático e voltar a criar backups
em todos os locais de cluster da instância, execute o
comando gcloud bigtable tables update usando a
flag --clear-automated-backup-locations:
gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--clear-automated-backup-locations
Substitua:
TABLE_ID: o ID da tabela a ser configurada.INSTANCE_ID: identificador permanente da instância
Ver logs de eventos
Quando o backup automatizado está ativado, o Bigtable emite um log de eventos do sistema quando um backup é criado. Ele também emite um log de eventos se a criação do backup estiver atrasada.
Para ver os logs de eventos do sistema de backup automatizado na página de visão geral do cluster do Bigtable no console, faça o seguinte:
No console do Google Cloud , abra a lista de instâncias do Bigtable.
Clique no código da instância.
Clique no ID do cluster.
Se os logs de eventos de backup automatizado foram criados na última hora, eles serão exibidos no painel Logs.
Opcional: para conferir logs de eventos mais antigos, clique na seta ao lado de 1 hora e selecione outro período.
Para conferir os logs de eventos do sistema de backup automatizado na Análise de registros, siga estas etapas:
Acesse a Análise de registros:
Acessar a Análise de registros.
Selecione o projeto do Google Cloud apropriado.
Para ver os eventos de criação de backup, insira 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 os eventos de atraso de backup, insira 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 a esta:
Automated backup is delayed for table ab-test on cluster my-cluster-staging-c1.
Criar um backup padrão
É possível criar um backup padrão de uma tabela usando a Google Cloud CLI, o console ou uma das bibliotecas de cliente do Bigtable. Também é possível ativar o backup automatizado para que o Bigtable crie um backup padrão diário para você. Para mais informações, consulte Ativar o backup automatizado.
Console
No console do Google Cloud , acesse a página Instâncias do Bigtable.
Clique na instância que contém a tabela com que você quer fazer backup.
No painel de navegação à esquerda, clique em Backups.
Clique em Criar backup.
Na lista ID da tabela, selecione a tabela que você quer salvar em backup. Se você clicar em Criar backup no menu Ação da tabela na página de visão geral da tabela, o Bigtable preencherá a tabela.
Se você usa replicação, selecione o ID do cluster. Se você clicar em Criar backup ao lado de um ID de cluster na página de visão geral do cluster, o Bigtable preencherá a tabela e o cluster.
Insira um ID exclusivo para o backup.
Na seção Tipo de backup, selecione Padrão.
Defina uma data de validade selecionando uma das opções.
Clique em Criar.
O console do Google Cloud exibe a página de Backups filtrados para mostrar o backup e os detalhes dele.
Opcional: para conferir o status do backup, clique na guia Atividade.
Depois que o Bigtable terminar de fazer backup dos dados, o status Backup concluído vai aparecer na coluna Status.
gcloud
Se você não souber o ID da instância, use o comando
bigtable instances listpara ver uma lista das instâncias do projeto:gcloud bigtable instances listVeja a lista de backups da instância que contém a tabela que você quer copiar para escolher um ID de backup que ainda não esteja em uso no cluster pretendido:
gcloud bigtable backups list --instance=INSTANCE_ID \ --cluster=CLUSTER_IDSubstitua:
INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do cluster
Veja a lista de tabelas para confirmar o ID da tabela que você quer fazer backup:
gcloud bigtable instances tables list --instances=INSTANCE_IDSubstitua
INSTANCE_IDpelo identificador permanente da instância.Execute o comando
gcloud bigtable instances backups createpara criar um backup da tabela, fornecendo uma data de validade ou um período de armazenamento:gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \ --cluster=CLUSTER_ID \ --table=TABLE_ID \ --expiration-date=EXPIRATION_DATE \ --retention-period=RETENTION_PERIODSubstitua:
BACKUP_ID: o ID que você atribui ao backup.INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do clusterTABLE_ID: o ID da tabela que será copiada.EXPIRATION_DATE: uma data no futuro, até 90 dias na edição Enterprise ou até 365 dias na edição Enterprise Plus. O valor precisa ser formatado como um carimbo de data/hora UTC "Zulu", com precisão de nanossegundos, por exemplo,2022-10-02T15:01:23.045123456Z.RETENTION_PERIOD: um período de até 90 dias na edição Enterprise ou até 365 dias na edição Enterprise Plus. O valor precisa ser expresso como um número com uma unidade dem,houd(minutos, horas ou dias), como36hou15d.
O comando aceita a seguinte sinalização opcional:
--async: retorna o ID da operação ao terminal antes que a operação seja concluída. Isso é útil se você quiser verificar o status da operação.
Veja a lista de backups para conferir se o seu foi criado:
gcloud bigtable backups list --instance=INSTANCE_ID \ --cluster=CLUSTER_IDSubstitua:
INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do cluster
Se o backup não estiver listado, verifique o status da operação.
O status
Readyindica que o backup foi concluído.
Criar um backup dinâmico
É possível criar um backup dinâmico sob demanda usando o console do Google Cloud ou a Google Cloud CLI. Também é possível configurar backups automáticos dinâmicos para que o Bigtable crie um backup dinâmico diário para você. Para mais informações, consulte Configurar backups automatizados ativos.
Não é possível criar um backup dinâmico para uma tabela que tenha o armazenamento em níveis (pré-lançamento) ativado. Para mais informações, consulte Visão geral do armazenamento em níveis.
Console
É possível criar um backup dinâmico de uma tabela usando o console do Google Cloud da seguinte maneira:
No console do Google Cloud , acesse a página Instâncias do Bigtable.
Clique na instância que contém a tabela que você quer copiar.
No painel de navegação à esquerda, clique em Backups.
Clique em Criar backup.
Na lista ID da tabela, selecione a tabela que você quer salvar em backup. Se você clicar em Criar backup no menu Ação da tabela na página de visão geral da tabela, o Bigtable preencherá a tabela.
Se você usa replicação, selecione o ID do cluster. Se você clicar em Criar backup ao lado de um ID de cluster na página de visão geral do cluster, o Bigtable preencherá a tabela e o cluster.
No campo ID do backup, insira um ID exclusivo para o backup.
Na seção Tipo de backup, selecione Ativo.
Na lista Definir acesso frequente como padrão, selecione uma das seguintes opções:
- Para manter o backup ativo até que ele expire, selecione Nunca.
- Para converter o backup dinâmico em padrão após três dias, selecione 3 dias.
- Para especificar uma data e hora personalizadas para converter o backup dinâmico em padrão, selecione Personalizado. Esse valor precisa ser de pelo menos 24 horas após o momento em que o Bigtable cria o backup.
Clique em Criar.
O console do Google Cloud exibe a página de Backups filtrados para mostrar o backup e os detalhes dele.
Opcional: para conferir o status do backup, clique na guia Atividade.
Depois que o Bigtable terminar de fazer backup dos dados, o status Backup concluído vai aparecer na coluna Status.
gcloud
Se você não souber o ID da instância, use o comando
bigtable instances listpara ver uma lista das instâncias do projeto:gcloud bigtable instances listVeja a lista de backups da instância que contém a tabela que você quer copiar para escolher um ID de backup que ainda não esteja em uso no cluster pretendido:
gcloud bigtable backups list --instance=INSTANCE_ID \ --cluster=CLUSTER_IDSubstitua:
INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do cluster
Veja a lista de tabelas para confirmar o ID da tabela que você quer fazer backup:
gcloud bigtable instances tables list --instances=INSTANCE_IDSubstitua
INSTANCE_IDpelo identificador permanente da instância.Execute o comando
gcloud bigtable instances backups createpara criar um backup dinâmico da tabela, fornecendo uma data de validade ou um período de armazenamento:gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \ --cluster=CLUSTER_ID \ --table=TABLE_ID \ --expiration-date=EXPIRATION_DATE \ --retention-period=RETENTION_PERIOD \ --backup-type=HOTSubstitua:
BACKUP_ID: o ID que você atribui ao backup.INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do clusterTABLE_ID: o ID da tabela que será copiada.EXPIRATION_DATE: uma data no futuro que seja 90 dias ou menos na edição Enterprise ou 365 dias ou menos na edição Enterprise Plus. A data precisa ser formatada como um carimbo de data/hora UTC "Zulu", precisamente medido em nanossegundos, por exemplo,2022-10-02T15:01:23.045123456Z.RETENTION_PERIOD: um período de até 90 dias na edição Enterprise ou até 365 dias na edição Enterprise Plus, expresso como um número com uma unidade dem,houd(minutos, horas ou dias), como36hou89d.
O comando aceita as sinalizações opcionais a seguir:
--hot-to-standard-time=HOT_TO_STANDARD_TIME: a data e a hora em que o Bigtable converte o backup de backup dinâmico para padrão, formatado como um carimbo de data/hora UTC "Zulu" (por exemplo,2024-08-02T15:01:23.045123456Z) ou como uma duração relativa (por exemplo,+P30Dpara 30 dias; consultegcloud topic datetimes). Esse valor precisa ser de pelo menos 24 horas após o horário de criação do backup.--async: retorna o ID da operação ao terminal antes que a operação seja concluída. Isso é útil se você quiser verificar o status da operação.
Veja a lista de backups para conferir se o seu foi criado:
gcloud bigtable backups list --instance=INSTANCE_ID \ --cluster=CLUSTER_IDSubstitua:
INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do cluster
Se o backup não estiver listado, verifique o status da operação.
O status
Readyindica que o backup foi concluído.
Restaurar a partir de um backup
Uma nova tabela restaurada de um backup não tem o backup automatizado ativado, mesmo que a tabela de origem tenha. Se você quiser um backup automatizado na nova tabela, será necessário ativá-lo.
As etapas para restaurar de um backup são as mesmas, seja ele padrão ou dinâmico. O Bigtable restaura um backup dinâmico para o desempenho de produção mais rapidamente do que um backup padrão.
Console
Não é possível restaurar para um projeto diferente usando o console do Google Cloud . Se precisar, use a CLI gcloud.
No console do Google Cloud , acesse a página Instâncias do Bigtable.
Clique na instância que contém o backup que você quer restaurar.
No painel de navegação à esquerda, clique em Backups.
Clique em Restaurar no backup que você quer executar essa tarefa.
Selecione a instância que quer restaurar.
As instâncias que não têm armazenamento suficiente para a nova tabela ficam indisponíveis. Se você não tiver permissão para criar uma tabela em uma instância, ela não estará disponível. Passe o mouse sobre o ícone para ver mais informações.
Se você restaurar a partir de um backup protegido por CMEK, a instância de destino também precisará ser protegida por CMEK.
Se você restaurar um backup de uma tabela com granularidade de carimbo de data/hora de microssegundos, a instância de destino precisará ser do Enterprise Plus.
Não é possível restaurar para um projeto diferente usando o console doGoogle Cloud . Se necessário, use a CLI gcloud.
Insira um ID exclusivo para a tabela que será criada a partir do backup. Não é possível alterar esse ID mais tarde.
Clique em Restaurar.
O console exibe a página Tabelas filtrada para mostrar a nova tabela.
O console exibe o status de restauração de cada cluster. Quando a coluna de status de todos os clusters mostrar Ready, a tabela foi restaurada e replicada para todos os clusters da instância.
gcloud
Se você não souber o ID da instância, use o comando
bigtable instances listpara ver uma lista das instâncias do projeto:gcloud bigtable instances listVeja a lista de backups da instância que contém o backup para verificar se ele existe:
gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \ --cluster=CLUSTER_IDSubstitua:
INSTANCE_ID_SOURCE: o ID permanente da instância de origemCLUSTER_ID: identificador permanente do cluster
Veja a lista de tabelas na instância de destino para poder escolher um ID para a nova tabela que ainda não está em uso:
gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATIONSubstitua
INSTANCE_ID_DESTINATIONpelo ID permanente da instância de destino.Execute o comando
gcloud bigtable instances tables restorepara restaurar o backup em uma nova tabela:gcloud bigtable instances tables restore \ --source=projects/PROJECT_ID_SOURCE/instances/INSTANCE_ID_SOURCE/clusters/CLUSTER_ID/backups/BACKUP_ID \ --destination=TABLE_ID_NEW \ --destination-instance=INSTANCE_ID_DESTINATIONSubstitua:
PROJECT_ID_SOURCE: o ID do projeto que contém o backup a ser restauradoINSTANCE_ID_SOURCE: o ID permanente da instância de origemCLUSTER_ID: identificador permanente do clusterBACKUP_ID: o ID do backup que você quer restaurar.TABLE_ID_NEW: o ID da nova tabela.INSTANCE_ID_DESTINATION: o ID permanente da instância de destino
O comando aceita as sinalizações opcionais a seguir:
--project=PROJECT_ID_DESTINATION: o ID do projeto em que você quer restaurar. Se você não especificar essa opção, o backup será restaurado para uma nova tabela na mesma instância em que foi criado.--async: retorna o ID da operação ao terminal antes que a operação seja concluída. Isso é útil se você quiser verificar o status da operação.
Veja a lista de tabelas para conferir se a tabela foi criada:
gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATIONSubstitua
INSTANCE_ID_DESTINATIONpelo ID permanente da instância de destino.Se o backup não estiver listado, verifique o status da operação.
Criar uma cópia de um backup
Console
You are not able to create a copy of a backup in a different project
using the console. If you need to do so, use the
gcloud CLI instead.
No console do Google Cloud , acesse a página Instâncias do Bigtable.
Clique na instância que contém o backup que você quer copiar.
No painel de navegação à esquerda, clique em Backups.
No backup que você quer copiar, expanda o menu "Mais" ao lado da palavra Restaurar e clique em Copiar.
Clique em Copiar no backup que você quer copiar.
Se o backup for uma cópia de outro, Copiar não estará disponível.
Selecione a instância de destino.
Não é possível criar uma cópia de um backup em um projeto diferente usando o console. Se precisar, use a CLI gcloud.
As instâncias que não têm armazenamento suficiente para a cópia de backup ficam indisponíveis. Se você não tiver permissão para criar um backup em uma instância, ela não estará disponível. Passe o cursor sobre o ícone para ver mais informações.
Se você restaurar a partir de um backup protegido por CMEK, a instância de destino também precisará ser protegida por CMEK.
Selecione o cluster de destino.
Como qualquer backup, uma cópia de backup é armazenada em apenas um cluster em uma instância, mesmo que ela use replicação.
Insira um ID exclusivo para a cópia que será criada a partir do backup. Não é possível alterar esse ID mais tarde.
Defina um prazo de validade para a cópia de backup, fornecendo um valor para Hora e selecionando uma Unidade no menu suspenso.
Clique em Copiar.
Para ver a cópia, clique em Ver cópia.
O console exibe a página Backups da instância de destino, filtrada para a cópia de backup recém-criada. Quando a coluna de status exibe Pronto, a cópia está completa e pronta para outras operações.
gcloud
Se você não souber o ID da instância, use o comando
bigtable instances listpara ver uma lista das instâncias do projeto:gcloud bigtable instances listVeja a lista de backups da instância de origem que contém o backup para verificar se o backup que você quer copiar existe:
gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \ --cluster=CLUSTER_ID_SOURCESubstitua:
INSTANCE_ID_SOURCE: o ID permanente da instância de origemCLUSTER_ID_SOURCE: o ID do cluster em que o backup de origem está armazenado.
Veja a lista de backups na instância de destino para escolher um ID para a cópia que ainda não esteja em uso:
gcloud bigtable backups list --instances=INSTANCE_ID_DESTINATIONSubstitua
INSTANCE_ID_DESTINATIONpelo ID permanente da instância de destino.Execute o comando
gcloud bigtable backups copypara criar a cópia de backup: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_DESTINATIONAnexe o comando com uma das seguintes opções:
--retention-period=RETENTION_PERIOD--expiration-date=EXPIRATION_DATE
Substitua:
PROJECT_ID_SOURCE: o projeto que contém o backup a ser copiado.INSTANCE_ID_SOURCE: o ID permanente da instância de origemCLUSTER_ID_SOURCE: o ID do cluster em que o backup de origem está armazenado.BACKUP_ID_SOURCE: o ID do backup a ser copiado.PROJECT_ID_DESTINATION: o projeto em que você quer colocar a cópiaINSTANCE_ID_DESTINATION: o ID permanente da instância de destinoCLUSTER_ID_DESTINATION: o ID do cluster na instância de destino em que você quer armazenar a cópia.BACKUP_ID_DESTINATION: o ID que você atribui à cópia do backupRETENTION_PERIOD: o time to live (TTL) da cópia de backup, expresso como um número e uma unidade (douh). Precisa ser de pelo menos 6 horas e no máximo 30 dias a partir do momento em que o backup de origem foi criado. Os exemplos incluem5dpor cinco dias ou15hpor 15 horas. Use essa data ou uma data de validade.EXPIRATION_DATE: a data e a hora em que a cópia de backup expira, formatada como2022-09-01T10:00:00.0Z. Precisa ser de pelo menos 6 horas e no máximo 30 dias a partir do momento em que o backup de origem foi criado.
O comando aceita a seguinte sinalização opcional:
--async: retorna o ID da operação ao terminal antes que a operação seja concluída. Isso é útil se você quiser verificar o status da operação.
Se uma mensagem de tempo limite for retornada, talvez o backup tenha sido bem-sucedido e a cópia tenha sido criada.
Veja a lista de backups para conferir se a cópia foi criada:
gcloud bigtable backups list --instances=INSTANCE_ID_DESTINATIONSubstitua
INSTANCE_ID_DESTINATIONpelo ID permanente da instância de destino.Se o backup não estiver listado, verifique o status da operação.
Em casos raros de falha na operação de cópia do backup devido a limitações de capacidade, tente novamente com um cluster de destino diferente. Se essa operação também falhar, entre em contato com o Suporte.
Verificar o status de uma operação
Console
No console do Google Cloud , acesse a página Instâncias do Bigtable.
Clique na instância que contém o backup.
No painel de navegação à esquerda, clique em Backups.
Na página Backups, clique em Atividade. A coluna de status exibe o status atual de cada operação.
Os status da operação ao restaurar uma tabela incluem:
- Esperando para copiar
- Restaurando backup
- Inicializando
- Pronto: otimizando
- Pronto
Os status das operações ao criar um backup incluem:
- Criando backup
- Backup concluído
Os status das operações ao copiar um backup incluem:
- Copiando backup
- Backup copiado
gcloud
Para verificar o status de uma operação de backup ou restauração, você precisa do código exclusivo da operação. Veja a seguir um exemplo de ID de operação:
`instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635`
Depois de executar um comando para criar um backup ou restaurar para uma nova tabela usando a opção --async, o terminal exibirá o código da operação.
Copie o ID da operação.
Execute o comando
gcloud bigtable operations describe:gcloud bigtable operations describe OPERATION_IDSubstitua
OPERATION_IDpelo ID da operação que você copiou.Exemplo:
gcloud bigtable operations describe \ instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635Execute esse comando em intervalos de alguns instantes até que o valor de
DONEsejaTRUE.
Se você não souber o ID da operação, porque não executou o comando ou está em uma janela do terminal diferente, é possível ver uma lista de operações da instância e determinar qual operação você quer verificar.
Veja uma lista de atividades de operação recentes para a instância que contém a tabela que você está fazendo backup ou restaurando:
gcloud bigtable operations list --instance=INSTANCE_IDSubstitua
INSTANCE_IDpelo identificador permanente da instância.O terminal exibe uma lista de operações nas colunas
NAME,START_TIME,END_TIMEeDONE. O valor na colunaNAMEé o ID da operação.Começando com o primeiro item da lista, copie o ID da operação.
Use
gcloud bigtable operations describepara ver os metadados da operação:gcloud bigtable operations describe OPERATION_IDSubstitua
OPERATION_IDpelo ID da operação que você copiou.Exemplo:
gcloud bigtable operations describe \ instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635Se os metadados de uma operação mostrarem um valor para
backupInfo, você encontrou a operação correta e pode repetir esse comando de vez em quando até que o valor deDONEsejaTRUE.Se os metadados não mostrarem um valor para
backupInfo, verifique a próxima operação na lista de operações exibida na Etapa 1.
Modificar um backup ou uma cópia de backup
É possível modificar a data de validade ou o período de armazenamento de um backup, seja ele criado manualmente ou por uma política de backup automatizado, ou de uma cópia de backup. Na edição Enterprise, é possível estender a data de validade de um backup em até 90 dias a partir do horário de criação do backup. Na edição Enterprise Plus, é possível estender a data de validade para até 365 dias a partir do horário de criação do backup. Também é possível converter um backup dinâmico em um backup padrão.
Console
No console do Google Cloud , acesse a página Instâncias do Bigtable.
Clique na instância que contém o backup.
No painel de navegação à esquerda, clique em Backups.
Para mudar a data e hora de validade de um backup, siga estas etapas:
No backup que você quer modificar, clique no menu ao lado de Restaurar e clique em Editar.
Na seção Expiração do backup, defina a data e a hora e clique em Salvar.
Para definir a data e a hora da transição de dinâmico para padrão de um backup dinâmico, siga estas etapas:
No backup dinâmico que você quer modificar, clique no menu ao lado de Restaurar e em Editar.
Na seção Atualizar de Hot para Standard, defina a data e a hora e clique em Salvar.
gcloud
A CLI gcloud permite modificar a data de validade ou o período de um backup ou cópia de backup. Também é possível converter um backup dinâmico em um backup padrão.
Veja uma lista de backups:
gcloud bigtable backups list --instance=INSTANCE_IDSubstitua
INSTANCE_IDpelo identificador permanente da instância.No terminal, é exibida uma lista de backups.
Anote os IDs de backup e de cluster para o backup que você precisa atualizar.
Execute o comando
gcloud bigtable backups updatepara adicionar uma nova data de validade ou período de armazenamento ou para converter um backup dinâmico em um backup padrão:gcloud bigtable backups update BACKUP_ID \ --instance=INSTANCE_ID \ --cluster=CLUSTER_ID \ --expiration-date=EXPIRATION_DATE \ --retention-period=RETENTION_PERIODSubstitua:
BACKUP_ID: o ID exclusivo de um backup.INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do clusterEXPIRATION_DATE: uma data no futuro, até 90 dias na edição Enterprise ou até 365 dias na edição Enterprise Plus. O valor precisa ser formatado como um carimbo de data/hora UTC "Zulu", com precisão de nanossegundos, por exemplo,2019-10-02T15:01:23.045123456Z.RETENTION_PERIOD: para backups, um período de até 90 dias na edição Enterprise ou até 365 dias na edição Enterprise Plus. Para cópias de backup, um período de até 30 dias. O valor precisa ser expresso como um número com uma unidade dem,houd(minutos, horas ou dias), por exemplo,36hou89d.
O comando aceita a seguinte sinalização opcional:
--hot-to-standard-time=HOT_TO_STANDARD_TIME: a data e a hora em que o Bigtable deve converter o backup dinâmico em um backup padrão. Esse valor precisa ser pelo menos 24 horas após o horário de criação do backup, por exemplo,2024-08-02T15:01:23.045123456Z.
Como alternativa, é possível fornecer uma data e hora de duração relativa, como
+P30Dpara 30 dias. Para mais informações, consultegcloud topic datetimes.Execute o comando
gcloud bigtable instances backups describepara verificar se você atualizou com êxito a expiração:gcloud bigtable backups describe BACKUP_ID \ --instance=INSTANCE_ID \ --cluster=CLUSTER_IDSubstitua:
BACKUP_ID: o ID exclusivo de um backup.INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: identificador permanente do cluster
Excluir um backup
Se você quiser excluir um backup depois de criar uma cópia dele, verifique o status para confirmar se a operação de cópia foi concluída.
Console
No console do Google Cloud , acesse a página Instâncias do Bigtable.
Clique na instância que contém o backup.
No painel de navegação à esquerda, clique em Backups.
Para o backup que você precisa excluir, expanda o menu "Mais" ao lado da palavra Restaurar e clique em Excluir.
Digite o ID do backup no campo Confirmar exclusão e clique em Excluir.
gcloud
Veja uma lista de backups:
gcloud bigtable backups list --instance=INSTANCE_IDSubstitua
INSTANCE_IDpelo identificador permanente da instância.No terminal, é exibida uma lista de backups.
Anote o ID de backup e o ID do cluster em que ele está armazenado.
Execute o comando
gcloud bigtable instances backups delete:gcloud bigtable backups delete BACKUP_ID \ --instance=INSTANCE_ID \ --cluster=CLUSTER_IDSubstitua:
BACKUP_ID: o ID do backup que você anotou.INSTANCE_ID: identificador permanente da instânciaCLUSTER_ID: o ID do cluster que você anotou
A seguir
- Leia mais sobre backups.
- Saiba como importar e exportar dados do Bigtable.
- Consulte a seção do Bigtable em Como arquitetar a recuperação de desastres para interrupções da infraestrutura em nuvem.