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. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Selecione Backups no menu de navegação do SQL.
  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 v1

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://sqladmin.googleapis.com/v1/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:

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://sqladmin.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. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Selecione Backups no menu de navegação do SQL.
  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 backup-start-time é especificado em 24 horas, no fuso horário UTC±00, e especifica o início de uma janela de backup de quatro 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
    Na seção backupConfiguration, confirme se você vê enabled: true e a hora especificada.

REST v1

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 (primária ou réplica);
  • start-time: o horário no formato "HH:MM"

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

É possível ativar a geração de registros binários ao mesmo tempo, definindo pointInTimeEnabled para true no objeto backupConfiguration.

REST v1beta4

É possível ativar a geração de registros binários ao mesmo tempo, definindo binaryLogEnabled para 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 (primária ou réplica);
  • start-time: o horário no formato "HH:MM"

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "start-time",
      "enabled": true,
      "binaryLogEnabled": 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. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Clique em Editar.
  4. Na seção 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 v1

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://sqladmin.googleapis.com/v1/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:

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://sqladmin.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 uma lista de backups

Para visualizar uma lista de backups e detalhes sobre um backup, use as seguintes opções.

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

Console

  1. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Selecione Backups no menu de navegação do SQL para ver os backups recentes, o horário de criação e o tipo de backup.

gcloud

  • 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.

  • Visualize os detalhes de um backup especificando o backup ID na saída do comando backups list.
    gcloud sql backups describe BACKUP_ID \
    --instance INSTANCE_NAME
        

REST v1

É 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://sqladmin.googleapis.com/v1/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:

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://sqladmin.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 ver uma lista de backups durante uma interrupção

Quando uma instância está em uma região com interrupção, só é possível ver os backups dela usando um caractere curinga (-) com a API backupRuns.list. O caractere curinga retorna todos os backups no projeto. Consulte Como restaurar para uma instância diferente.

Quando há uma interrupção em uma região em que uma instância tem chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) ativadas, não é possível restaurar os backups dessa instância para uma região diferente. O motivo é que o Cloud SQL usa chaves regionais do Cloud KMS para criptografia quando a CMEK está ativada na instância. Para restaurar backups de uma instância da CMEK, o Cloud SQL precisa ter acesso à chave CMEK. Em uma interrupção regional, não há acesso às chaves do Cloud KMS nessa região.

gcloud

  1. Liste os backups de cada instância em um projeto:
    gcloud sql backups list --instance -

    O comando retorna informações semelhantes às seguintes:

    {
          "kind": "sql#backupRun",
          "status": "SUCCESSFUL",
          "enqueuedTime": "2020-01-21T11:25:33.818Z",
          "id": "backup-id",
          "startTime": "2020-01-21T11:25:33.858Z",
          "endTime": "2020-01-21T11:26:18.663Z",
          "type": "AUTOMATED",
          "windowStartTime": "2020-01-21T10:00:00.479Z",
          "instance": "instance-id",
          "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",
          "location": "us"
          "backupKind": "SNAPSHOT"
        }
  2. Encontre o backup da instância que você precisa. Para restaurar esse backup, consulte Como restaurar para uma instância diferente.

REST v1

  1. Liste todos os backups em um projeto:

    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 ou - para uma lista de todos os backups no projeto

    Método HTTP e URL:

    GET https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns

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

    Você receberá uma resposta JSON semelhante a esta:

  2. Encontre o backup da instância que você precisa. Para restaurar esse backup, consulte Como restaurar para uma instância diferente.

REST v1beta4

  1. Liste todos os backups em um projeto:

    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 ou - para uma lista de todos os backups no projeto

    Método HTTP e URL:

    GET https://sqladmin.googleapis.com/v2/projects/project-id/instances/-/backupRuns

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

    Você receberá uma resposta JSON semelhante a esta:

  2. Encontre o backup da instância que você precisa. Para restaurar esse backup, consulte Como restaurar para uma instância diferente.

Como visualizar locais para backups

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

Console

  1. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Selecione Backups no menu de navegação do SQL.
  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 v1

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://sqladmin.googleapis.com/v1/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.
 

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://sqladmin.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. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Selecione Backups no menu de navegação do SQL.
  4. Clique em Editar.
  5. Na seção Automatizar backups, expanda Opções avançadas.
  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: O número não pode ser menor que o padrão (sete).

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

REST v1beta4

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://sqladmin.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.

Nas instâncias do MySQL, a exclusão de um backup pode não liberar tanto espaço quanto o 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. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Selecione Backups no menu de navegação do SQL.
  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 v1

  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://sqladmin.googleapis.com/v1/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://sqladmin.googleapis.com/v1/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:

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://sqladmin.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://sqladmin.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. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Selecione Backups no menu de navegação do SQL.
  4. Clique em Gerenciar backups automáticos
  5. Desmarque a opção Automatizar os backups.
  6. Clique em Salvar e reiniciar.

gcloud

Edite a instância para desativar os backups:

gcloud sql instances patch INSTANCE_NAME 
--no-backup

REST v1

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://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

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://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "binaryLogEnabled": 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