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

Esta página descreve como gerir as cópias de segurança da sua instância que usa a opção de cópias de segurança padrão. Isto inclui como agendar e desativar cópias de segurança automáticas, criar e gerir cópias de segurança a pedido e ver cópias de segurança da sua instância do Cloud SQL. Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Gerir cópias de segurança melhoradas.

Para mais informações sobre o funcionamento das cópias de segurança, consulte o artigo Vista geral das cópias de segurança do Cloud SQL. Para mais informações sobre as opções de cópia de segurança disponíveis para as suas instâncias do Cloud SQL, consulte o artigo Escolha a sua opção de cópia de segurança.

Crie uma cópia de segurança a pedido

Para criar uma cópia de segurança a pedido:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Selecione Cópias de segurança no menu de navegação do SQL.
  4. Clique em Criar cópia de segurança.
  5. Na página Criar cópia de segurança, adicione uma descrição, se necessário, e clique em Criar.

gcloud

Crie a cópia de segurança:

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME

Pode fornecer uma descrição da cópia de segurança através do parâmetro --description.

Para criar uma cópia de segurança numa localização personalizada:

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME \
--location=BACKUP_LOCATION

REST v1

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Configure cópias de segurança automáticas

As cópias de segurança automáticas são feitas de acordo com uma cadência programada enquanto a instância está em execução. Também pode definir o período de retenção das suas cópias de segurança automáticas. Para mais informações sobre o funcionamento das cópias de segurança automáticas, consulte o artigo Cópias de segurança automáticas.

Agende cópias de segurança automáticas

Para agendar cópias de segurança automáticas para uma instância:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Selecione Cópias de segurança no menu de navegação do SQL.
  4. Clique em Editar junto a Definições.
  5. Escolha um período para fazer automaticamente uma cópia de segurança dos seus dados.
  6. Clique em Guardar.

gcloud

  1. Edite a instância para especificar uma hora de início da cópia de segurança: 
    gcloud sql instances patch INSTANCE_NAME --backup-start-time=HH:MM
     O parâmetro backup-start-time é especificado num formato de hora de 24 horas, no fuso horário UTC±00, e especifica o início de um período de cópia de segurança de 4 horas. As cópias de segurança podem começar em qualquer altura durante o período de cópia de segurança.
  2. Confirme as alterações: 
    gcloud sql instances describe INSTANCE_NAME
     Na secção backupConfiguration, confirme que vê enabled: true e a hora que especificou.

Terraform

Para criar uma cópia de segurança de uma base de dados, use um recurso do Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-backup"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled    = true
      start_time = "20:55"
    }
  }
}

Aplique as alterações

Para aplicar a configuração do Terraform num Google Cloud projeto, conclua os passos nas secções seguintes.

Prepare o Cloud Shell

  1. Inicie o Cloud Shell.

  2. Defina o Google Cloud projeto predefinido onde quer aplicar as suas configurações do Terraform.

    Só tem de executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    As variáveis de ambiente são substituídas se definir valores explícitos no ficheiro de configuração do Terraform.

Prepare o diretório

Cada ficheiro de configuração do Terraform tem de ter o seu próprio diretório (também denominado módulo raiz).

  1. No Cloud Shell, crie um diretório e um novo ficheiro nesse diretório. O nome do ficheiro tem de ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o ficheiro é denominado main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se estiver a seguir um tutorial, pode copiar o código de exemplo em cada secção ou passo.

    Copie o exemplo de código para o ficheiro main.tf criado recentemente.

    Opcionalmente, copie o código do GitHub. Isto é recomendado quando o fragmento do Terraform faz parte de uma solução completa.

  3. Reveja e modifique os parâmetros de exemplo para aplicar ao seu ambiente.
  4. Guarde as alterações.
  5. Inicialize o Terraform. Só tem de fazer isto uma vez por diretório. 
    terraform init

    Opcionalmente, para usar a versão mais recente do fornecedor Google, inclua a opção -upgrade: 

    terraform init -upgrade

Aplique as alterações

  1. Reveja a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expetativas: 
    terraform plan

    Faça correções à configuração conforme necessário.

  2. Aplique a configuração do Terraform executando o seguinte comando e introduzindo yes no comando: 
    terraform apply

    Aguarde até que o Terraform apresente a mensagem "Apply complete!" (Aplicação concluída!).

  3. Abra o seu Google Cloud projeto para ver os resultados. Na Google Cloud consola, navegue para os seus recursos na IU para se certificar de que o Terraform os criou ou atualizou.

Eliminar as alterações

Para eliminar as alterações, faça o seguinte:

  1. Para desativar a proteção contra eliminação, no ficheiro de configuração do Terraform, defina o argumento deletion_protection como false. 
    deletion_protection =  "false"
  2. Aplique a configuração do Terraform atualizada executando o seguinte comando e introduzindo yes no comando: 
    terraform apply

  1. Remova os recursos aplicados anteriormente com a sua configuração do Terraform executando o seguinte comando e introduzindo yes no comando:

    terraform destroy

REST v1

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
  • INSTANCE_NAME: o nome da instância principal ou de réplica de leitura que está a configurar para alta disponibilidade
  • START_TIME: a hora (em horas e minutos)

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON do pedido: 

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Defina a retenção de cópias de segurança automáticas

Para definir o número de cópias de segurança automáticas a reter:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Selecione Cópias de segurança no menu de navegação do SQL.
  4. Clique em Edit.
  5. Na secção Automatizar cópias de segurança, expanda Opções avançadas.
  6. Introduza o Número de cópias de segurança a armazenar de cada vez.

    O número não pode ser inferior aos dias de retenção de registos PITR.

  7. Clique em Guardar.

gcloud

Edite a instância para definir o número de cópias de segurança automáticas a reter. O número não pode ser inferior ao predefinido (sete). 

gcloud sql instances patch INSTANCE_NAME \
--retained-backups-count=NUM_TO_RETAIN

Terraform

Para especificar o número de cópias de segurança automáticas a reter para uma instância da base de dados, use um recurso do Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-backup-retention"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled = true
      backup_retention_settings {
        retained_backups = 365
        retention_unit   = "COUNT"
      }
    }
  }
}

REST v1beta4

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • unit: opcional: a unidade de retenção pode ser um número inteiro ou uma string. Os valores atualmente suportados (e predefinidos) são 1 ou "COUNT".
  • num-to-retain: o número de cópias de segurança automáticas a reter. O número não pode ser inferior ao predefinido (7).
  • 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 do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Desative as cópias de segurança automáticas

Para desativar as cópias de segurança automáticas de uma instância:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Selecione Cópias de segurança no menu de navegação do SQL.
  4. Clique em Gerir cópias de segurança automáticas
  5. Desmarque a opção Automatizar cópias de segurança.
  6. Clique em Guardar.

gcloud

Edite a instância para desativar as cópias de segurança:

gcloud sql instances patch INSTANCE_NAME \
--no-backup

REST v1

REST v1beta4

Elimine uma cópia de segurança

Pode eliminar cópias de segurança automáticas e a pedido.

A eliminação de uma cópia de segurança pode não libertar tanto espaço quanto o tamanho da cópia de segurança. Isto acontece porque as cópias de segurança são incrementais. Por isso, a eliminação de uma cópia de segurança mais antiga pode transferir alguns dos respetivos conteúdos para uma cópia de segurança mais recente para preservar a integridade da cópia de segurança mais recente.

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Selecione Cópias de segurança no menu de navegação do SQL.
  4. Clique em mais ações Ícone Mais ações. para a cópia de segurança que quer eliminar.
  5. Selecione Eliminar.
  6. Na janela Eliminar cópia de segurança, escreva Delete no campo e clique em Eliminar.

gcloud

Elimine uma cópia de segurança de uma instância do Cloud SQL:

gcloud beta sql backups delete BACKUP_ID \
--instance INSTANCE_NAME

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

REST v1

  1. Liste as cópias de segurança para obter o ID da cópia de segurança que quer eliminar:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • 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 o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  2. Elimine a cópia de segurança:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-id: o ID da instância
    • backup-id: o ID da cópia de segurança

    Método HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

  1. Liste as cópias de segurança para obter o ID da cópia de segurança que quer eliminar:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • 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 o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  2. Elimine a cópia de segurança:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-id: o ID da instância
    • backup-id: o ID da cópia de segurança

    Método HTTP e URL: 

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

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

Defina uma localização personalizada para as cópias de segurança

Use apenas uma localização de cópia de segurança personalizada se for exigido por regulamentos. Se não for obrigatório, use a localização de cópia de segurança multirregional predefinida.

Pode usar uma localização personalizada para cópias de segurança automáticas e a pedido. Para ver uma lista completa de valores de localização válidos, consulte as localizações de instâncias.

Para atualizar uma instância com uma localização personalizada:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. No menu de navegação do SQL, selecione Cópias de segurança.
  4. Junto a Definições, clique em Editar.
  5. Na secção Cópias de segurança automáticas, expanda Opções avançadas.
  6. Clique em Multirregional (predefinição) ou Região.
  7. Selecione a localização no menu pendente Localização.
  8. Clique em Guardar.

gcloud

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

gcloud sql instances patch INSTANCE_NAME \
--backup-location=BACKUP_LOCATION

Terraform

Para especificar uma localização personalizada para uma cópia de segurança de uma instância da base de dados, use um recurso do Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-with-backup-location"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled  = true
      location = "us-central1"
    }
  }
}

REST v1

Use o parâmetro settings.backupConfiguration.location da instância para a localização da cópia de segurança.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • region: a região do projeto
  • backup-region: a região da cópia de segurança
  • 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 do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Use o parâmetro settings.backupConfiguration.location da instância para a localização da cópia de segurança.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • region: a região do projeto
  • backup-region: a região da cópia de segurança
  • 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 do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Veja uma lista de cópias de segurança

Para ver uma lista de cópias de segurança e detalhes sobre uma cópia de segurança, use as seguintes opções.

A Google Cloud consola não mostra cópias de segurança ignoradas ou com falhas no histórico de cópias de segurança. Para ver as cópias de segurança ignoradas, use gcloud ou a API.

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Selecione Cópias de segurança no menu de navegação SQL para ver as cópias de segurança recentes, juntamente com a hora de criação e o tipo de cópia de segurança.

gcloud

  • Liste as cópias de segurança da instância: 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Pode filtrar e controlar os resultados através dos parâmetros de lista padrão. Para ver uma lista completa, consulte a página de referência do comando gcloud sql backups list.

  • Veja os detalhes de uma cópia de segurança especificando a cópia de segurança ID a partir do resultado do comando backups list. 
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

Também pode usar o Explorador de APIs na página BackupRuns:list para enviar o pedido da API REST.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Também pode usar o Explorador de APIs na página BackupRuns:list para enviar o pedido da API REST.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Veja uma lista de cópias de segurança durante uma indisponibilidade

Quando uma instância está numa região que está a ter uma indisponibilidade, só pode ver as cópias de segurança dessa instância através de um caráter universal (-) com a API backupRuns.list. A carta especial devolve todas as cópias de segurança no projeto. Consulte o artigo Restaurar para uma instância diferente.

Quando existe uma indisponibilidade numa região onde uma instância tem chaves de encriptação geridas pelo cliente (CMEK) ativadas, não pode restaurar as cópias de segurança dessa instância para uma região diferente. O motivo é que o Cloud SQL usa chaves regionais do Cloud KMS para a encriptação quando a CMEK está ativada na instância. Para restaurar cópias de segurança de uma instância com CMEK, o Cloud SQL tem de ter acesso à chave CMEK. Numa interrupção regional, não existe acesso às chaves do Cloud KMS nessa região.

gcloud

  1. Apresenta as cópias de segurança de cada instância num projeto: 
    gcloud sql backups list --instance -

    O comando devolve 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 a cópia de segurança da instância de que precisa. Para restaurar esta cópia de segurança, consulte Restaurar para uma instância diferente.

REST v1

  1. Apresenta todas as cópias de segurança num projeto:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do projeto
    • INSTANCE_ID: o ID da instância ou - para uma lista de todas as cópias de segurança no projeto

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/-/backupRuns

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  2. Encontre a cópia de segurança da instância de que precisa. Para restaurar esta cópia de segurança, consulte Restaurar para uma instância diferente.

REST v1beta4

  1. Apresenta todas as cópias de segurança num projeto:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-id: o ID da instância ou - para uma lista de todas as cópias de segurança no projeto

    Método HTTP e URL: 

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

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  2. Encontre a cópia de segurança da instância de que precisa. Para restaurar esta cópia de segurança, consulte Restaurar para uma instância diferente.

Veja os locais da cópia de segurança

Para ver as localizações das cópias de segurança feitas para uma instância, use backupRuns:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Selecione Cópias de segurança no menu de navegação do SQL.
  4. Na lista de cópias de segurança, a coluna Localização indica o tipo de localização (multirregião ou região) e a multirregião ou a região específica de cada cópia de segurança.

gcloud

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

  1. Liste as cópias de segurança da instância: 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Pode filtrar e controlar os resultados através dos parâmetros de lista padrão. Para ver uma lista completa, consulte a página de referência do comando gcloud sql backups list.

  2. Para listar os detalhes de uma cópia de segurança, use o ID a partir da saída do comando backups list. 
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Nos exemplos anteriores:
  • REGION é a região da instância original.
  • BACKUP_LOCATION é a localização onde quer que o Cloud SQL armazene a cópia de segurança.

REST v1beta4

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Nos exemplos anteriores:
  • REGION é a região da instância original.
  • BACKUP_LOCATION é a localização onde quer que o Cloud SQL armazene a cópia de segurança.

Ver tamanho da cópia de segurança

Pode ver o tamanho de uma cópia de segurança de uma instância do Cloud SQL através da CLI gcloud ou da API.

gcloud

  1. Para obter uma lista de todas as cópias de segurança associadas a um Google Cloud projeto, use o comando gcloud sql backups list:

    gcloud sql backups list

  2. Para ver o tamanho de uma cópia de segurança, use o comando gcloud sql backups describe:

    gcloud sql backups describe BACKUP_ID \
--instance=INSTANCE_NAME \
--project=PROJECT_ID

    Faça as seguintes substituições:

    • BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir da saída da execução do comando gcloud sql backups list.
    • INSTANCE_NAME: o nome da instância.
    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância.

    Na saída, o parâmetro maxChargeableBytes apresenta o tamanho da cópia de segurança (em bytes).

REST

Aceda a uma lista de cópias de segurança

Use este exemplo para obter uma lista de todas as cópias de segurança associadas a um Google Cloud projeto. Para ver uma lista completa de parâmetros para esta chamada, consulte a página backupRuns.list.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
  • INSTANCE_NAME: o nome da instância

Método HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Veja detalhes sobre uma cópia de segurança

Use este exemplo para ver os detalhes sobre uma cópia de segurança, incluindo o tamanho da cópia de segurança. Para ver uma lista completa de parâmetros para esta chamada, consulte a página backupRuns.get.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância.
  • INSTANCE_NAME: o nome da instância.
  • BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.

Método HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns/BACKUP_ID

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

Configure as cópias de segurança finais

Pode definir a sua instância para fazer automaticamente uma cópia de segurança ativando a definição da instância de cópia de segurança final e definindo o período de retenção da cópia de segurança final. Se não ativar a cópia de segurança final para a sua instância antes da eliminação, também pode fazer uma cópia de segurança final quando eliminar a instância. Para mais informações sobre como funcionam as cópias de segurança finais, consulte o artigo Cópia de segurança final.

Para gerir uma cópia de segurança final após a eliminação da instância, consulte o artigo Gerir cópias de segurança de instâncias eliminadas.

Ative a cópia de segurança final

Para ativar as cópias de segurança finais de uma instância, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Encontre a instância para a qual quer ativar a cópia de segurança final. Para abrir a página Vista geral da instância, clique no nome da instância.

  3. Clique em Edit.

  4. Em Personalize a sua instância, expanda Proteção de dados.

  5. Para ativar a cópia de segurança final, selecione a caixa Cópia de segurança final na eliminação da instância em Proteção contra eliminação de instâncias.

    O período de retenção predefinido é de 30 dias. Para alterar esta opção, introduza um número entre 1 e 365 na caixa Dias de retenção.

  6. Clique em Guardar.

gcloud

Use o comando gcloud sql instances para ativar a cópia de segurança final.

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup \
  --final-backup-retention-days=RETENTION_DAYS

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância do Cloud SQL.
  • RETENTION_DAYS: o número de dias para reter a cópia de segurança final. Este valor pode variar entre 1 e 365 dias, e a predefinição é de 30 dias.

REST v1

Para ativar as cópias de segurança finais, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância
  • RETENTION_DAYS: o número de dias para reter as cópias de segurança finais

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON do pedido: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Para ativar as cópias de segurança finais, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância
  • RETENTION_DAYS: o número de dias para reter as cópias de segurança finais

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON do pedido: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Defina a retenção da cópia de segurança final

Para definir o período de retenção da cópia de segurança final de uma instância, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Encontre a instância para a qual quer ativar a cópia de segurança final. Para abrir a página Vista geral da instância, clique no nome da instância.

  3. Clique em Edit.

  4. Em Personalize a sua instância, expanda Proteção de dados.

  5. Para alterar o período de retenção da cópia de segurança final, introduza um número entre 1 e 365 na caixa Dias de retenção na definição Cópia de segurança final após a eliminação da instância.

    O período de retenção predefinido é de 30 dias.

  6. Clique em Guardar.

gcloud

Use o comando gcloud sql instances para atualizar a definição de dias de retenção da cópia de segurança final.

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup-retention-days=RETENTION_DAYS

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância do Cloud SQL.
  • RETENTION_DAYS: o número de dias para reter a cópia de segurança final. Este valor pode variar entre 1 e 365 dias, e a predefinição é de 30 dias.

REST v1

Para atualizar a definição de dias de retenção da cópia de segurança final, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância
  • RETENTION_DAYS: o número de dias para reter as cópias de segurança finais

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON do pedido: 

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Para atualizar a definição de dias de retenção da cópia de segurança final, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância
  • RETENTION_DAYS: o número de dias para reter as cópias de segurança finais

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON do pedido: 

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Desative a cópia de segurança final

Para desativar as cópias de segurança finais de uma instância, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Encontre a instância para a qual quer ativar a cópia de segurança final. Para abrir a página Vista geral da instância, clique no nome da instância.

  3. Clique em Edit.

  4. Em Personalize a sua instância, expanda Proteção de dados.

  5. Para desativar a cópia de segurança final, desmarque a caixa Cópia de segurança final na eliminação da instância em Proteção contra eliminação de instâncias.

  6. Clique em Guardar.

gcloud

Use o comando gcloud sql instances para desativar a cópia de segurança final.

  gcloud sql instances patch INSTANCE_NAME \
  --no-final-backup

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância do Cloud SQL.

REST v1

Para desativar as cópias de segurança finais, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON do pedido: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Para desativar as cópias de segurança finais, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 do pedido: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }s
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Configure cópias de segurança retidas

Pode definir a sua instância para reter automaticamente todas as cópias de segurança automatizadas e a pedido quando elimina a instância. Estas cópias de segurança são retidas com base no período de retenção da cópia de segurança no momento da eliminação. Para mais informações sobre como funcionam as cópias de segurança finais, consulte o artigo Cópia de segurança final.

Para gerir as cópias de segurança retidas após a eliminação da instância, consulte o artigo Gerir cópias de segurança de instâncias eliminadas.

Ative as cópias de segurança retidas

Para ativar as cópias de segurança retidas para uma instância, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Encontre a instância para a qual quer ativar as cópias de segurança retidas. Para abrir a página Vista geral da instância, clique no nome da instância.

  3. Clique em Edit.

  4. Em Personalize a sua instância, expanda Proteção de dados.

  5. Para ativar as cópias de segurança retidas, selecione a caixa Retain backups after instance deletion (Reter cópias de segurança após a eliminação da instância) em Instance deletion protection (Proteção contra eliminação de instâncias).

  6. Clique em Guardar.

gcloud

Use o comando gcloud sql instances para ativar as cópias de segurança retidas.

  gcloud sql instances patch INSTANCE_NAME \
  --retain-backups-on-delete

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância do Cloud SQL.

REST v1

Para ativar as cópias de segurança retidas, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON do pedido: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Para ativar as cópias de segurança retidas, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 do pedido: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Desative as cópias de segurança retidas

Para desativar as cópias de segurança retidas de uma instância, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Encontre a instância para a qual quer ativar as cópias de segurança retidas. Para abrir a página Vista geral da instância, clique no nome da instância.

  3. Clique em Edit.

  4. Em Personalize a sua instância, expanda Proteção de dados.

  5. Para desativar as cópias de segurança retidas, desmarque a caixa Reter cópias de segurança após a eliminação da instância em Proteção contra eliminação de instâncias.

  6. Clique em Guardar.

gcloud

Use o comando gcloud sql instances para desativar as cópias de segurança retidas.

  gcloud sql instances patch INSTANCE_NAME \
  --no-retain-backups-on-delete

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância do Cloud SQL.

REST v1

Para desativar as cópias de segurança retidas, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON do pedido: 

{
  "settings": {
    "retainBackupsOnDelete": false
    }
  }

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Para desativar as cópias de segurança retidas, faça o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • 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 do pedido: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

O que se segue?