Atualize uma instância para a edição Cloud SQL Enterprise Plus através da atualização no local

Esta página mostra como usar o método de atualização no local para atualizar uma instância da edição Cloud SQL Enterprise para a edição Cloud SQL Enterprise Plus. Além disso, também descreve o procedimento para mudar uma instância da edição Cloud SQL Enterprise Plus para a edição Cloud SQL Enterprise.

A atualização para a edição Cloud SQL Enterprise Plus oferece-lhe várias vantagens e melhorias de desempenho. Para mais informações, consulte o artigo Introdução às edições do Cloud SQL para PostgreSQL.

Para ativar estas melhorias nas suas instâncias existentes da edição Enterprise do Cloud SQL, tem de as atualizar para a edição Enterprise Plus do Cloud SQL. O processo de atualização demora alguns minutos a ser concluído e tem um tempo de inatividade quase nulo. A mudança para a edição Cloud SQL Enterprise pode demorar até 60 segundos de inatividade.

Além disso, este processo de atualização não requer que altere os pontos finais aos quais as suas aplicações se ligam.

Antes de começar

• Certifique-se de que está a executar uma instância da edição Enterprise do Cloud SQL no PostgreSQL 12 ou posterior.

  Se a sua instância tiver uma versão anterior do PostgreSQL, tem de a atualizar para o PostgreSQL 12 ou posterior. Para mais informações, consulte o artigo Atualize a versão principal da base de dados no local.

Verifique a localização de armazenamento dos registos de transações usados para a PITR

Todas as instâncias da edição Cloud SQL Enterprise Plus são ativadas automaticamente com a recuperação num determinado momento (PITR). Se a instância da edição Cloud SQL Enterprise que quer atualizar armazenar os registos de transações antecipadas usados para PITR no disco, o processo de atualização para a edição Cloud SQL Enterprise Plus muda a localização de armazenamento dos registos de transações antecipadas do disco para o Cloud Storage.

Antes de atualizar para a edição Cloud SQL Enterprise Plus, verifique se a sua instância da edição Cloud SQL Enterprise vai sofrer a mudança da localização de armazenamento para os registos de gravação antecipada usados para a PITR. Para mais informações e instruções sobre como verificar a sua instância, consulte o artigo Verifique a localização de armazenamento dos registos de transações usados para PITR.

Para mais informações sobre a mudança da localização de armazenamento do registo de transações no processo de atualização, consulte o artigo Localização de armazenamento dos registos de transações usados para PITR.

Atualize uma instância para a edição Cloud SQL Enterprise Plus

Use o procedimento nesta secção para atualizar uma instância da edição Enterprise do Cloud SQL para a edição Enterprise Plus do Cloud SQL.

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

Local de armazenamento dos registos de transações usados para PITR

Se a sua instância da edição Enterprise do Cloud SQL armazenar registos de transações para PITR no disco, o início do processo de atualização para a edição Enterprise Plus do Cloud SQL muda a localização de armazenamento destes registos para o Cloud Storage.

Aplicam-se as seguintes condições ao processo de mudança de localização:

• O processo demora aproximadamente a duração da definição de configuração transactionLogRetentionDays PITR para concluir a mudança para o Cloud Storage.
• Durante a mudança para o Cloud Storage, recomendamos que não modifique a definição de configuração do transactionLogRetentionDays PITR. Mesmo que aumente o valor, os transactionLogRetentionDaysregistos de escrita antecipada não são retidos no disco durante mais tempo do que o valor predefinido de 7 dias para uma instância da edição Enterprise do Cloud SQL.

Predefinições de armazenamento de registos e cópias de segurança da edição Cloud SQL Enterprise Plus

Após a conclusão da atualização para a edição Cloud SQL Enterprise Plus, o período de retenção predefinido dos registos de transações de todas as instâncias atualizadas é aumentado para 14 dias. Para este aumento e qualquer outro aumento que configurar para o período de retenção do registo de transações, demora até ao novo valor aumentado a atingir a janela de retenção completa do PITR. Por exemplo, se o valor antigo para os dias de retenção do registo de transações for 7 e o novo valor for aumentado para 14, o período para PITR durante os primeiros 7 dias após a atualização é de apenas 7 dias. No 8.º dia, o período para PITR passa a ser de 8 dias, no 9.º dia passa a ser de 9 dias, até que o período de retenção seja finalmente aumentado para 14 dias no 14.º dia.

Além disso, o número predefinido de cópias de segurança automáticas é aumentado de 8 para 15.

Se atualizar para a edição Cloud SQL Enterprise Plus depois de fazer uma atualização da versão principal, não pode fazer uma PITR para um momento anterior à atualização da versão principal. Esta limitação aplica-se mesmo que o seu período de retenção abranja esse período. Pode restaurar a sua instância para um momento específico após ter iniciado a atualização da versão principal.

Altere para a edição Cloud SQL Enterprise

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

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

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

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

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

Predefinições de armazenamento de registos e cópias de segurança da edição Enterprise do Cloud SQL

A mudança para a edição Enterprise do Cloud SQL não altera a localização de armazenamento dos registos de transações usados para a PITR. Se a sua instância da edição Cloud SQL Enterprise Plus armazenar os respetivos registos de transações para PITR no Cloud Storage, os registos permanecem no Cloud Storage. No entanto, em vez de armazenar 14 dias de registos de transações para a PITR por predefinição, a predefinição é alterada para 7 dias. A configuração da cópia de segurança não é alterada.

Gere o ponto final de gravação automaticamente

Um ponto final de gravação é um nome de serviço de nomes do domínio (DNS) global que é resolvido automaticamente para o endereço IP da instância principal atual do Cloud SQL. Este ponto final redireciona automaticamente as ligações recebidas para a nova instância principal em caso de uma operação de failover de réplica. Pode usar o ponto final de gravação numa string de ligação SQL em vez de um endereço IP. Ao usar um ponto final de gravação, pode evitar ter de fazer alterações à ligação da aplicação quando ocorre uma indisponibilidade regional.

Se ativar a API DNS para o seu Trusted Cloud projeto e atualizar a instância que tem um endereço IP privado na nova arquitetura de rede para a edição Cloud SQL Enterprise Plus, o Cloud SQL gera o ponto final de gravação automaticamente para si e adiciona o nome DNS ao certificado do servidor associado à instância. Pode usar o nome DNS para a validação da identidade do servidor.

O que se segue?

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