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 fazer downgrade de uma instância do Cloud SQL Enterprise Plus para o Cloud SQL Enterprise.

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

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, com uma inatividade esperada de menos de 60 segundos. Além disso, esse processo não exige que os aplicativos alterem os endpoints aos quais se conectam.

Antes de começar

Verifique se você está executando uma instância da edição do Cloud SQL Enterprise no PostgreSQL 12 ou mais recente.

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

Verifique se a instância usa uma unidade de estado sólido (SSD).

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

Opcional: também é possível ativar o cache de dados na instância adicionando a sinalização --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.

Opcional: você pode ativar o cache de dados definindo o parâmetro dataCacheEnabled como true.

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.

Opcional: você pode ativar o cache de dados definindo o parâmetro dataCacheEnabled como true.

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

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

A seguir

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