Upgrade no local

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

Fazer mudanças no local em uma instância do Cloud SQL

É possível usar mudanças no local para fazer upgrade ou downgrade da edição da instância do Cloud SQL, do tipo de máquina, do tipo de armazenamento ou 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 mais recente.

Se a instância estiver usando uma versão anterior do PostgreSQL, faça upgrade para o PostgreSQL 12 ou mais recente. 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

Diferentes edições oferecem suporte a diferentes tipos de máquinas que usam opções de armazenamento diferentes. 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áquinas mais antigos.

Quando você faz uma mudança na edição ou no tipo de máquina que está usando, o tipo de armazenamento também pode mudar, o que pode resultar em algum 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 de 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 edição Enterprise que armazena os registros prévios de escrita usados para a PITR no disco, o processo de upgrade para o Cloud SQL edição Enterprise Plus vai mover o local de armazenamento desses registros do disco para o Cloud Storage. Para determinar o local atual dos registros prévios de escrita da PITR da 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

Esta seção mostra como mudar a edição da instância do Cloud SQL no local para ou da edição Cloud SQL Enterprise Plus. A edição Cloud SQL Enterprise Plus oferece alguns benefícios e melhorias de performance que a edição Cloud SQL Enterprise não oferece. 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 quase zero. A mudança de volta para o Cloud SQL Enterprise Edition resultará em um tempo de inatividade maior. Nenhum dos processos exige a mudança dos endpoints aos quais os aplicativos se conectam.

Use o procedimento nesta seção para fazer upgrade de uma instância do Cloud SQL edição Enterprise para o Cloud SQL edição Enterprise Plus ou para fazer downgrade de uma instância do Cloud SQL edição Enterprise Plus para o Cloud SQL edição 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

A mudança da edição da instância do Cloud SQL pode exigir a mudança da série de máquinas, o que, por sua vez, afeta o tipo de armazenamento.

Mudanças de máquina

Ao mudar de edição, também é necessário 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 com suporte do Cloud SQL.

Ao fazer upgrade do Cloud SQL Enterprise para o Cloud SQL Enterprise Plus, é possível 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, é possível 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 mudar a edição. Depois de escolher editar a instância, acesse a subseção Máquina de Configuração da máquina na área Personalizar sua instância. Usando o menu suspenso, é possível selecionar um tipo de máquina diferente. Também é possível escolher um número diferente de vCPUs e ativar ou desativar o cache de dados, se apropriado.

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

Mudanças de armazenamento

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

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

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

O Google Cloud Hyperdisk Balanced define valores e limites de IOPS e capacidade de processamento padrão 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 prévios de escrita para a PITR

Se a instância do Cloud SQL edição Enterprise armazenar registros de transação para PITR no disco, iniciar o processo de upgrade para o Cloud SQL edição Enterprise Plus vai 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 transactionLogRetentionDays configuração da PITR 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 edição Enterprise Plus armazenar os registros de transação para a PITR no Cloud Storage, os registros permanecerão no Cloud Storage. 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.