Fazer upgrade de uma instância para o Cloud SQL edição Enterprise Plus usando o upgrade no local

MySQL | PostgreSQL | SQL Server

Nesta página, mostramos como usar o método de upgrade no local para fazer upgrade de uma instância da edição Cloud SQL Enterprise para o Cloud SQL Enterprise Plus. Além disso, também descrevemos o procedimento para trocar uma instância do Cloud SQL edição Enterprise Plus pelo Cloud SQL edição Enterprise.

O upgrade para o Cloud SQL Enterprise Plus oferece vários benefícios e melhorias de desempenho. Para mais informações, consulte Introdução às edições do Cloud SQL para MySQL.

Para ativar essas melhorias nas suas instâncias da edição Cloud SQL Enterprise, faça upgrade para o Cloud SQL Enterprise Plus. O processo de upgrade leva alguns minutos para ser concluído e tem um tempo de inatividade perto de zero. A troca pelo Cloud SQL edição Enterprise pode ter até 60 segundos de inatividade.

Além disso, esse processo de upgrade não exige mudar os endpoints aos quais seus aplicativos se conectam.

Antes de começar

Verifique se você está executando uma instância do Cloud SQL Enterprise no MySQL versão 8.0.31 ou mais recente.

Se a instância estiver em uma versão anterior do MySQL, faça upgrade da instância para o MySQL 8.0.31 ou posterior. Para mais informações, consulte Fazer upgrade da versão principal do banco de dados no local e Fazer upgrade da versão secundária do banco de dados.

Verificar o local de armazenamento dos registros de transações usados para a PITR

Todas as instâncias do Cloud SQL edição Enterprise Plus são ativadas automaticamente com a recuperação pontual (PITR, na sigla em inglês). Se a instância do Cloud SQL edição Enterprise que você quer fazer upgrade armazenar os registros binários usados para a PITR no disco, o processo de upgrade para o Cloud SQL edição Enterprise Plus mudará o local de armazenamento dos registros binários do disco para o Cloud Storage.

Antes de fazer upgrade para o Cloud SQL edição Enterprise Plus, verifique se a instância do Cloud SQL edição Enterprise passará pela mudança do local de armazenamento dos registros binários usados para a PITR. Para mais informações e instruções sobre como verificar sua instância, consulte Verificar o local de armazenamento dos registros de transações usados para a PITR.

Para mais informações sobre como mudar o local de armazenamento do registro de transações no processo de upgrade, consulte Local de armazenamento dos registros de transações usados para a PITR.

Fazer upgrade de uma instância para o Cloud SQL Enterprise Plus

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.

Console

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

Acesse Instâncias do Cloud SQL
Para abrir a página Visão geral de uma instância, clique no nome dela.
Clique em Editar.
Na seção Escolher uma edição do Cloud SQL, clique em Fazer upgrade.
No painel Fazer upgrade para o Enterprise Plus, insira o ID da instância e clique em Fazer upgrade da edição.

Outra possibilidade é fazer upgrade de uma instância clicando em Upgrade na seção Configuração da página Visão geral da instância.

gcloud

O exemplo de código a seguir mostra como fazer upgrade da sua instância para o Cloud SQL Enterprise Plus:

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

Observação: o Cloud SQL ativa o cache de dados da sua instância por padrão durante o processo de upgrade. Para desativá-lo, adicione a sinalização --no-enable-data-cache.

Substitua:

PROJECT_ID: o ID do projeto da instância que você quer fazer upgrade.
INSTANCE_ID: o nome da instância que você quer fazer upgrade.
MACHINE_TYPE: o tipo de máquina da instância para a qual você quer fazer upgrade. Para mais informações sobre os tipos de máquinas do Cloud SQL Enterprise Plus, consulte Tipos de máquinas para instâncias da edição Cloud SQL Enterprise Plus.

REST

O comando a seguir faz upgrade da instância para o Cloud SQL Enterprise e aciona uma operação de reinicialização.

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

PROJECT_ID: o ID do projeto da instância que você quer fazer upgrade.
INSTANCE_ID: o ID da instância que você quer fazer upgrade.
MACHINE_TYPE: o tipo de máquina da instância para a qual você quer fazer upgrade. Para mais informações sobre os tipos de máquinas do Cloud SQL Enterprise Plus, consulte Tipos de máquinas para instâncias da edição Cloud SQL Enterprise Plus.

Observação: o Cloud SQL ativa o cache de dados para sua instância por padrão durante o processo de upgrade. É possível desativá-lo definindo o parâmetro dataCacheEnabled como false.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

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

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

REST v1beta4

O comando a seguir faz upgrade da instância para o Cloud SQL Enterprise e aciona uma operação de reinicialização.

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

PROJECT_ID: o ID do projeto da instância que você quer fazer upgrade.
INSTANCE_ID: o ID da instância que você quer fazer upgrade.
MACHINE_TYPE: o tipo de máquina da instância para a qual você quer fazer upgrade. Para mais informações sobre os tipos de máquinas do Cloud SQL Enterprise Plus, consulte Tipos de máquinas para instâncias da edição Cloud SQL Enterprise Plus.

Observação: o Cloud SQL ativa o cache de dados para sua instância por padrão durante o processo de upgrade. É possível desativá-lo definindo o parâmetro dataCacheEnabled como false.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

Local de armazenamento dos registros de transações usados 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 mudará o local de armazenamento desses registros para o Cloud Storage.

As seguintes condições se aplicam ao processo de 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.
Se você tiver valores definidos para a flag expire_logs_days ou binlog_expire_logs_seconds na instância, eles serão preservados.
Durante a mudança para o Cloud Storage, não é possível modificar os valores das flags expire_logs_days ou binlog_expire_logs_seconds na instância.
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 binários 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.
Enquanto a mudança estiver em andamento, o Cloud SQL só manterá registros no disco pelo valor mínimo de um dos seguintes itens:
- A configuração da PITR transactionLogRetentionDays antes da mudança, sete dias por padrão
- As flags expire_logs_days ou binlog_expire_logs_seconds definidas manualmente na instância
Após a mudança, o Cloud SQL manterá a mesma quantidade de registros binários no disco que você tinha antes da mudança a menos que você tenha definido as flags expire_logs_days ou binlog_expire_logs_seconds na instância. Se você tiver definido essas sinalizações, o Cloud SQL manterá registros binários no disco com base no valor mínimo da configuração transactionLogRetentionDays ou no valor das flags.

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

Depois que a mudança para o Cloud Storage for concluída em uma instância, o Cloud SQL ainda manterá cópias de registros binários no disco para fins de replicação. Armazenar registros binários no disco pode ser útil quando você quer navegar por registros binários com o utilitário mysqlbinlog.

Se você configurou as flags expire_logs_days e binlog_expire_logs_seconds na instância antes do upgrade, os valores configurados permanecerão intactos.

Como os registros binários usados para executar a PITR estão armazenados no Cloud Storage depois da mudança, verifique se os valores das flags refletem a retenção dos registros de transações no disco esperado. O Cloud SQL só mantém registros no disco pelo valor mínimo de um dos seguintes itens:

a definição da configuração PITR de transactionLogRetentionDays antes da mudança, sete dias por padrão
As flags expire_logs_days ou binlog_expire_logs_seconds definidas manualmente na instância

Se você quiser economizar espaço em disco, depois que o upgrade for concluído, configure o valor da flag expire_logs_days ou binlog_expire_logs_seconds para o equivalente de um dia para reduzir o tamanho do disco alocado e os custos de armazenamento em disco. Para mais informações sobre o armazenamento de registros de transações e a PITR, consulte Armazenamento de registros para PITR.

Após a conclusão do upgrade para o Cloud SQL Enterprise Plus, o período de armazenamento padrão do registro de transações de todas as instâncias atualizadas será aumentado para 14 dias. Para esse e qualquer outro aumento que você configurar para o período de armazenamento do registro de transações, é necessário um valor novo e maior para alcançar a janela de armazenamento completa da PITR. Por exemplo, se o valor antigo dos dias de armazenamento do registro de transações for 7 e o novo valor aumentar para 14, a janela da PITR nos primeiros sete dias após o upgrade será de apenas sete dias. No oitavo dia, a janela da PITR vira oito dias. No nono dia, ela vira nove dias, até que a janela de armazenamento seja finalmente aumentada para 14 dias no 14º dia.

Além disso, o número padrão de backups automatizados aumenta de 8 para 15.

Se você fizer upgrade para o Cloud SQL edição Enterprise Plus após um upgrade da versão principal, não será possível executar a PITR para um momento anterior ao upgrade da versão principal. Essa limitação é aplicável mesmo que o período de armazenamento inclua esse período. É possível restaurar a instância para um momento após o início do upgrade da versão principal.

Mudar para o Cloud SQL edição Enterprise

Console

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

Acesse Instâncias do Cloud SQL
Para abrir a página Visão geral de uma instância, clique no nome dela.
Clique em Editar.
Na seção Escolher uma edição do Cloud SQL, clique em Mudar para Enterprise.
No painel Mudar para Enterprise, digite o ID da instância e clique em Trocar de edição.

Outra possibilidade é mudar para o Cloud SQL edição Enterprise clicando em Mudar para Enterprise na seção Configuração da página Visão geral da instância.

gcloud

O exemplo de código a seguir mostra como mudar sua instância para o Cloud SQL edição Enterprise:

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

Substitua:

PROJECT_ID: o ID do projeto da instância.
INSTANCE_ID: o nome da instância.
MACHINE_TYPE: o tipo de máquina da instância para a qual você quer alternar. Para mais informações sobre os tipos de máquinas do Cloud SQL Enterprise, consulte Tipos de máquinas das instâncias da edição Cloud SQL Enterprise.

REST

O comando a seguir muda sua instância para o Cloud SQL edição Enterprise e aciona uma operação de reinicialização.

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

PROJECT_ID: o ID do projeto da instância.
INSTANCE_ID: o ID da instância.
MACHINE_TYPE: o tipo de máquina da instância para a qual você quer alternar. Para mais informações sobre os tipos de máquinas do Cloud SQL Enterprise, consulte Tipos de máquinas das instâncias da edição Cloud SQL Enterprise.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

REST v1beta4

O comando a seguir muda sua instância para o Cloud SQL edição Enterprise e aciona uma operação de reinicialização.

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

PROJECT_ID: o ID do projeto da instância.
INSTANCE_ID: o ID da instância.
MACHINE_TYPE: o tipo de máquina da instância para a qual você quer alternar. Para mais informações sobre os tipos de máquinas do Cloud SQL Enterprise, consulte Tipos de máquinas das instâncias da edição Cloud SQL Enterprise.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

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

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.

A seguir

Saiba mais sobre a edição Cloud SQL Enterprise Plus.