Criar e gerenciar backups automáticos e sob demanda

Nesta página, descrevemos como programar e desativar backups automáticos, criar e gerenciar backups sob demanda e visualizar backups para sua instância do Cloud SQL.

Para mais informações sobre como os backups funcionam, consulte Visão geral dos backups.

Como criar um backup sob demanda

Para criar um backup sob demanda:

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Selecione a guia Backups.
  4. Clique em Criar backup.
  5. Na página Criar backup, adicione uma descrição, se necessário, e clique em Criar.

gcloud

Crie o backup:

gcloud sql backups create --async --instance [INSTANCE_NAME]

Para fornecer uma descrição do backup, use o parâmetro --description.

Para criar um backup em um local personalizado:

gcloud sql backups create --async --instance [INSTANCE_NAME] --location [BACKUP_LOCATION]

REST v1beta4

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • project-id: o ID do projeto
  • instance-id: o ID da instância

Método HTTP e URL:

POST https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Como programar backups automáticos

Para programar backups automáticos de uma instância:

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Selecione a guia Backups.
  4. Clique em Editar, ao lado de "Configurações".
  5. Escolha uma janela de tempo para fazer o backup automático dos dados.
  6. Clique em Save.

gcloud

  1. Edite a instância para especificar o horário de início do backup:
    gcloud sql instances patch [INSTANCE_NAME] --backup-start-time [HH:MM]
    O parâmetro "horário de início do backup" é especificado no formato de 24 horas, no fuso horário UTC±00, e especifica o início de uma janela de backup de 4 horas. Os backups podem começar a qualquer momento durante a janela de backup.
  2. Confirme as alterações:
    gcloud sql instances describe [INSTANCE_NAME]
    Em backupConfiguration, confirme se você vê enabled: true e a hora especificada.

v1beta4 REST

É possível ativar o pointInTimeRecovery ao mesmo tempo, definindo pointInTimeRecoveryEnabled como true no objeto backupConfiguration.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • project-id: o ID do projeto
  • instance-id: o ID da instância
  • start-time: o horário no formato "HH:MM"

Método HTTP e URL:

PATCH https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "start-time",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Como definir um local personalizado para backups

Use um local de backup personalizado somente se exigido pela regulamentação. Se não for necessário, use o local padrão de backup multirregional.

É possível usar um local personalizado para backups automáticos e sob demanda. Para uma lista completa de valores de local válidos, consulte Locais de instância.

Para atualizar uma instância com um local personalizado:

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Clique em EDITAR.
  4. Em Opções de configuração, expanda Backups.
  5. Expanda Opções de local.
  6. Clique em Multirregião (padrão) ou Região.
  7. Selecione o local no menu suspenso Local.
  8. Clique em Salvar.

gcloud

Para informações de referência, consulte gcloud sql instances patch.

gcloud sql instances patch [INSTANCE_NAME] --backup-location=[BACKUP_LOCATION]
  

REST v1beta4

Use o parâmetro settings.backupConfiguration.location da instância para o local do backup.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • region: a região do projeto
  • backup-region: a região de backup
  • project-id: o ID do projeto
  • instance-id: o ID da instância

Método HTTP e URL:

PATCH https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

{
  "region": "region"
  "settings":
  {
    "backupConfiguration":
    {
      "location": "backup-region",
      "enabled": true,
    }
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Como visualizar backups

O Console do Cloud não exibe backups ignorados ou com falha no histórico de backup. Para ver os backups ignorados, use a ferramenta de linha de comando "gcloud" ou a API.

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Selecione a guia Backups para visualizar os backups recentes, o horário de criação e o tipo de backup.

gcloud

  1. Liste os backups da instância:
    gcloud sql backups list --instance [INSTANCE_NAME]
    

    Você pode filtrar e controlar os resultados usando os parâmetros padrão da lista. Para uma lista completa, consulte a página de referência do comando gcloud sql backups list.

  2. Para listar os detalhes de um backup, use o ID da saída do comando backups list.
    gcloud sql backups describe [BACKUP_ID] --instance [INSTANCE_NAME]
    

REST v1beta4

É possível também usar o APIs Explorer na página BackupRuns:list para enviar a solicitação da API REST.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • project-id: o ID do projeto
  • instance-id: o ID da instância

Método HTTP e URL:

GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Como visualizar locais para backups

Para ver os locais dos backups feitos para uma instância, use backupRuns:

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Clique na guia Backups.
  4. Na lista de backups, a coluna Local lista o tipo de local (multirregião ou região) e a multirregião ou região específica de cada backup.

gcloud

Para informações de referência, consulte gcloud sql instances describe.

  1. Liste os backups da instância:
    gcloud sql backups list --instance [INSTANCE_NAME]
    

    Você pode filtrar e controlar os resultados usando os parâmetros padrão da lista. Para uma lista completa, consulte a página de referência do comando gcloud sql backups list.

  2. Para listar os detalhes de um backup, use o ID da saída do comando backups list.
    gcloud sql backups describe [BACKUP_ID] --instance [INSTANCE_NAME]
    
 

REST v1beta4

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • project-id: o ID do projeto
  • instance-id: o ID da instância

Método HTTP e URL:

GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Nos exemplos anteriores:
  • REGION é a região da instância original.
  • BACKUP_LOCATION é a região onde você quer que o Cloud SQL armazene o backup.

Como configurar a retenção de backup automatizada

Para definir o número de backups automáticos que serão mantidos:

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Selecione a guia Backups.
  4. Clique em Editar configurações.
  5. Expanda Opções avançadas em Automatizar backups.
  6. Informe o Número de backups a serem armazenados por vez.
  7. Clique em Save.

gcloud

Edite a instância para definir o número de backups automáticos a serem mantidos:

gcloud sql instances patch instance-name --retained-backups-count num-to-retain

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • unit: opcional: a unidade de retenção pode ser um número inteiro ou uma string. Os valores compatíveis (e padrão) atualmente são 1 ou "COUNT".
  • num-to-retain: o número de backups automáticos a serem retidos, de 1 a 365
  • project-id: o ID do projeto
  • instance-id: o ID da instância

Método HTTP e URL:

PATCH https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

{
  "settings":
  {
    "backupConfiguration":
    {
      "backupRetentionSettings":
      {
        "retentionUnit": unit,
        "retainedBackups": "num-to-retain"
      }
    }
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Como excluir um backup

É possível excluir backups automáticos e sob demanda.

A exclusão de um backup pode não liberar um espaço igual ao tamanho do backup. Isso ocorre porque os backups são incrementais. Portanto, a exclusão de um backup anterior pode transferir uma parte do conteúdo para um backup mais recente a fim de preservar a integridade do novo backup.

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Selecione a guia Backups.
  4. Clique em "Mais ações" Ícone "Mais ações". no backup a ser excluído.
  5. Selecione Excluir.
  6. Na janela "Excluir backup", digite Delete no campo e clique em Excluir.

gcloud

Para excluir um backup de uma instância do Cloud SQL:

gcloud beta sql backups delete [BACKUP_ID] --instance [INSTANCE_NAME]
      

Para uma lista completa de parâmetros, consulte a página de referência do comando gcloud beta sql backups delete.

REST v1beta4

  1. Liste os backups para ver o ID do backup que você quer excluir:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • project-id: o ID do projeto
    • instance-id: o ID da instância

    Método HTTP e URL:

    GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Exclua o backup:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • project-id: o ID do projeto
    • instance-id: o ID da instância
    • backup-id: o ID do backup

    Método HTTP e URL:

    DELETE https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

Como desativar backups automáticos

Para desativar backups automáticos de uma instância:

Console

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acesse a página "Instâncias" do Cloud SQL

  2. Clique na instância para abrir a respectiva página Visão geral.
  3. Selecione a guia Backups.
  4. Clique em Gerenciar backups automáticos
  5. Desmarque a opção Automatizar os backups.
  6. Clique em Salvar.

gcloud

Edite a instância para desativar os backups:

gcloud sql instances patch [INSTANCE_NAME] --no-backup

REST v1beta4

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • project-id: o ID do projeto
  • instance-id: o ID da instância

Método HTTP e URL:

PATCH https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Recuperação pontual

Saiba mais sobre a recuperação pontual.

A seguir