Upgrade no local

Nesta página, descrevemos como fazer upgrades e downgrades no local das suas instâncias do Cloud SQL.

Fazer mudanças in loco em uma instância do Cloud SQL

É possível usar mudanças no local para fazer upgrade ou downgrade da edição, do tipo de máquina ou do tipo de armazenamento da instância do Cloud SQL ou para fazer upgrade da versão do banco de dados. Fazer mudanças no local é a maneira mais fácil e menos propensa a erros de reconfigurar uma instância.

Antes de começar

Verifique se a instância está executando o PostgreSQL 12 ou uma versão mais recente.

Se a instância estiver usando uma versão anterior do PostgreSQL, faça upgrade para o PostgreSQL 12 ou posterior. Para mais informações, consulte Fazer upgrade da versão principal do banco de dados no local.

Esteja ciente das possíveis mudanças de armazenamento relacionadas ao tipo de máquina

Cada edição é compatível com tipos de máquinas diferentes que usam opções de armazenamento distintas. Os tipos de máquina C4 e C4A de alta performance usam o armazenamento Hyperdisk Balanced em vez de uma das opções de disco permanente usadas por tipos de máquina mais antigos.

Quando você muda a edição ou o tipo de máquina que está usando, o tipo de armazenamento também pode mudar, o que pode resultar em tempo de inatividade e uma mudança nos custos de armazenamento. Ao migrar para o Google Cloud Hyperdisk Balanced, há outras opções de configuração que podem ser especificadas. Para mais informações, consulte Mudanças no armazenamento.

Esteja ciente das mudanças no armazenamento de registros de transações da PITR

Se você estiver fazendo upgrade de uma instância do Cloud SQL Enterprise que armazena os registros prévios de escrita usados para a PITR no disco, saiba que o processo de upgrade para o Cloud SQL Enterprise Plus move o local de armazenamento desses registros do disco para o Cloud Storage. Para determinar o local atual dos registros de transações de gravação antecipada da PITR da sua instância, consulte Verificar o local de armazenamento dos registros de transações usados para a PITR.

Para uma explicação completa de como os upgrades no local podem afetar o local dos registros prévios de escrita, consulte Mudanças no local de armazenamento dos registros prévios de escrita para a PITR.

Mudar a edição de uma instância no local

Nesta seção, mostramos como mudar a edição da sua instância do Cloud SQL no local para ou da edição Cloud SQL Enterprise Plus. A edição Enterprise Plus do Cloud SQL oferece alguns benefícios e melhorias de desempenho que a edição Enterprise não tem. Para mais informações sobre as edições do Cloud SQL, consulte Visão geral das edições do Cloud SQL.

O upgrade para o Cloud SQL Enterprise Plus leva alguns minutos para ser concluído e tem um tempo de inatividade perto de zero. A troca de volta para o Cloud SQL Enterprise Edition vai resultar em um tempo de inatividade maior. Nenhum dos processos exige a mudança dos endpoints aos quais seus aplicativos se conectam.

Use o procedimento nesta seção para fazer upgrade de uma instância do Cloud SQL Enterprise para o Cloud SQL Enterprise Plus ou downgrade de uma instância do Cloud SQL Enterprise Plus para o Cloud SQL Enterprise.

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

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

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/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/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/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/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Opções para mudanças no local

Mudar a edição da instância do Cloud SQL pode exigir a alteração da série de máquinas, o que afeta o tipo de armazenamento.

Mudanças na máquina

Ao mudar de edição, você também precisa mudar o tipo de máquina. Consulte Escolher uma série de máquinas para mais informações sobre as séries de máquinas compatíveis com o Cloud SQL.

Ao fazer upgrade do Cloud SQL Enterprise para o Cloud SQL Enterprise Plus, você pode escolher entre as séries de máquinas N2, C4A e C4.

Ao fazer downgrade do Cloud SQL Enterprise Plus para o Cloud SQL Enterprise, você pode escolher entre um núcleo dedicado de uso geral e uma série de máquinas N4.

Também é possível mudar o tipo de máquina sem alterar a edição. Depois de escolher editar sua instância, acesse a subseção Máquina de Configuração da máquina na área Personalizar sua instância. Use o menu suspenso para selecionar um tipo de máquina diferente. Você também pode escolher um número diferente de vCPUs e ativar ou desativar o cache de dados, se necessário.

Para mais informações gerais, consulte também a documentação do Compute Engine sobre as séries de máquinas N2, C4A, C4 e N4.

Mudanças no armazenamento

Se você estiver mudando de uma série de máquinas de uso geral ou N2 para uma série N4, C4A ou C4, seu armazenamento será migrado de unidade de estado sólido (SSD) para o armazenamento Google Cloud Hyperdisk equilibrado. Essa atualização geralmente exige um tempo de inatividade mínimo.

O armazenamento equilibrado do Google Cloud Hyperdisk pode ser personalizado para seu caso de uso definindo o seguinte:

• Capacidade de armazenamento
• IOPS provisionadas
• Capacidade de processamento provisionada

O Hyperdisk Balanced do Google Cloud define valores padrão de IOPS e capacidade de processamento, além de limites com base na configuração da instância, que inclui o tipo de máquina e a capacidade de armazenamento. A capacidade de armazenamento limita o valor padrão, e o tipo de máquina define o valor máximo para IOPS e capacidade de processamento. Consulte Escolher uma opção de armazenamento para mais detalhes.

Mudanças de local dos registros de gravação antecipada para PITR

Se a instância do Cloud SQL Enterprise armazenar registros de transação para PITR no disco, iniciar o processo de upgrade para o Cloud SQL Enterprise Plus mudará o local de armazenamento desses registros para o Cloud Storage.

As seguintes condições se aplicam à mudança de local:

• O processo leva aproximadamente a duração da configuração da PITR transactionLogRetentionDays para concluir a mudança para o Cloud Storage.
• Durante a mudança para o Cloud Storage, recomendamos que você não modifique a configuração da PITR transactionLogRetentionDays. Mesmo que você aumente transactionLogRetentionDays, os registros prévios de escrita não serão mantidos no disco por mais do que o padrão de sete dias para uma instância do Cloud SQL edição Enterprise.

Padrões de armazenamento de backups e registros do Cloud SQL edição Enterprise Plus

Mudar para o Cloud SQL edição Enterprise não muda o local de armazenamento dos registros de transações usados para a PITR. Se a instância do Cloud SQL Enterprise Plus armazenar os registros de transação para a PITR no Cloud Storage, eles vão permanecer lá. No entanto, em vez de armazenar 14 dias de registros de transações para a PITR por padrão, o padrão mudará para sete dias. A configuração do backup não é alterada.