Atualize uma instância para a edição Cloud SQL Enterprise Plus usando uma atualização local, Atualize uma instância para a edição Cloud SQL Enterprise Plus usando uma atualização local, Atualize uma instância para a edição Cloud SQL Enterprise Plus usando uma atualização local, Atualize uma instância para a edição Cloud SQL Enterprise Plus usando uma atualização local


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

A atualização para a edição Cloud SQL Enterprise Plus oferece diversos benefícios e melhorias de desempenho. Para mais informações, consulte Introdução às edições do Cloud SQL para PostgreSQL .

Para habilitar esses aprimoramentos em suas instâncias existentes do Cloud SQL Enterprise Edition, você precisa atualizá-las para o Cloud SQL Enterprise Plus Edition. O processo de atualização leva alguns minutos e tem tempo de inatividade praticamente zero. A migração para o Cloud SQL Enterprise Edition pode levar até 60 segundos de inatividade.

Além disso, esse processo de atualização não exige que você altere os endpoints aos quais seus aplicativos se conectam.

Antes de começar

  • Verifique se você está executando uma instância do Cloud SQL Enterprise Edition no PostgreSQL 12 ou posterior.

    Se a sua instância estiver em uma versão anterior do PostgreSQL, você deverá atualizá-la para o PostgreSQL 12 ou posterior. Para obter mais informações, consulte Atualizar a versão principal do banco de dados no local .

Verifique o local de armazenamento dos logs de transações usados ​​para PITR

Todas as instâncias da edição Cloud SQL Enterprise Plus são habilitadas automaticamente com a recuperação pontual (PITR). Se a instância da edição Cloud SQL Enterprise que você deseja atualizar armazenar os logs de gravação antecipada usados ​​para PITR em disco, o processo de atualização para a edição Cloud SQL Enterprise Plus alternará o local de armazenamento dos logs de gravação antecipada do disco para o Cloud Storage.

Antes de atualizar para a edição Cloud SQL Enterprise Plus, verifique se a sua instância do Cloud SQL Enterprise passará pela troca de local de armazenamento dos logs de gravação antecipada usados ​​para PITR. Para obter mais informações e instruções sobre como verificar sua instância, consulte Verificar o local de armazenamento dos logs de transações usados ​​para PITR .

Para obter mais informações sobre como alternar o local de armazenamento do log de transações no processo de atualização, consulte Local de armazenamento de logs de transações usados ​​para PITR .

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

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

Console

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

    Acesse Instâncias do Cloud SQL

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Clique em Editar .
  4. Na seção Escolha uma edição do Cloud SQL , clique em Atualizar .
  5. No painel Atualizar para Enterprise Plus , insira sua ID de instância e clique em Atualizar edição .

Como alternativa, você também pode atualizar uma instância clicando em Atualizar na seção Configuração da página Visão geral da instância.

gcloud

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

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

Opcional: você também pode habilitar o cache de dados para sua instância adicionando o sinalizador --enable-data-cache .

Substitua o seguinte:

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

DESCANSAR

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

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

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

Opcional: você pode habilitar 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "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 atualiza sua instância para a edição Enterprise do Cloud SQL e aciona uma operação de reinicialização.

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

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

Opcional: você pode habilitar 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "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 de logs de transações usados ​​para PITR

Se a sua instância da edição Cloud SQL Enterprise armazenar logs de transações para PITR no disco, iniciar o processo de atualização para a edição Cloud SQL Enterprise Plus alternará o local de armazenamento desses logs para o Cloud Storage.

As seguintes condições se aplicam ao processo de troca de local:

  • O processo leva aproximadamente a duração da configuração PITR transactionLogRetentionDays para concluir a mudança para o Cloud Storage.
  • Durante a migração para o Cloud Storage, recomendamos que você não modifique a configuração PITR transactionLogRetentionDays . Mesmo que você aumente transactionLogRetentionDays , os logs de gravação antecipada não serão retidos no disco por mais tempo do que o padrão de 7 dias para uma instância da edição Enterprise do Cloud SQL.

Padrões de backup e armazenamento de log 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 padrão de retenção do log de transações para todas as instâncias atualizadas aumenta para 14 dias. Para esse aumento, e qualquer outro aumento configurado para o período de retenção do log de transações, são necessários até o valor novo e aumentado para atingir a janela de retenção completa do PITR. Por exemplo, se o valor antigo para os dias de retenção do log de transações for 7 e o novo valor for aumentado para 14, a janela do PITR para os primeiros 7 dias após a atualização será de apenas 7 dias. No 8º dia, a janela do PITR passa a ser de 8 dias, no 9º dia passa a ser de 9 dias, até que a janela de retenção seja finalmente aumentada para 14 dias no 14º dia.

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

Se você atualizar para a edição Cloud SQL Enterprise Plus após realizar uma atualização da versão principal, não poderá executar o PITR para um ponto no tempo anterior à atualização da versão principal. Essa limitação se aplica mesmo que o seu período de retenção cubra esse período. Você pode restaurar sua instância para um ponto no tempo posterior ao início da atualização da versão principal.

Mudar para a edição Cloud SQL Enterprise

Console

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

    Acesse Instâncias do Cloud SQL

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Clique em Editar .
  4. Na seção Escolha uma edição do Cloud SQL , clique em Mudar para Enterprise .
  5. No painel Mudar para Enterprise , insira sua ID de instância e clique em Mudar edição .

Como alternativa, você também pode mudar para a edição Enterprise do Cloud SQL clicando em Alternar 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 alterar sua instância para a edição Enterprise do Cloud SQL:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID
Substitua o seguinte:

DESCANSAR

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

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "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 altera sua instância para a edição Enterprise do Cloud SQL e aciona uma operação de reinicialização.

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "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 backup e armazenamento de logs da edição Enterprise do Cloud SQL

A mudança para a edição Enterprise do Cloud SQL não altera o local de armazenamento dos logs de transações usados ​​para o PITR. Se a sua instância da edição Enterprise Plus do Cloud SQL armazenar seus logs de transações para o PITR no Cloud Storage, os logs permanecerão no Cloud Storage. No entanto, em vez de armazenar 14 dias de logs de transações para o PITR por padrão, o padrão é alterado para 7 dias. A configuração de backup não é alterada.

Gerar o ponto final de gravação automaticamente

Um ponto de extremidade de gravação é um nome de serviço de nome de domínio (DNS) global que é resolvido automaticamente para o endereço IP da instância primária atual do Cloud SQL. Esse ponto de extremidade redireciona as conexões de entrada para a nova instância primária automaticamente em caso de uma operação de failover de réplica. Você pode usar o ponto de extremidade de gravação em uma string de conexão SQL em vez de um endereço IP. Ao usar um ponto de extremidade de gravação, você evita a necessidade de fazer alterações na conexão do aplicativo quando ocorre uma interrupção regional.

Se você atualizar sua instância que tem um endereço IP privado na nova arquitetura de rede para a edição Cloud SQL Enterprise Plus e habilitar a API DNS para suaGoogle Cloud projeto, o Cloud SQL gera o ponto de extremidade de gravação automaticamente para você. No entanto, o certificado do servidor associado à instância não terá o ponto de extremidade de gravação (nome DNS global) adicionado. Portanto, se você quiser verificar o nome DNS, precisará rotacionar o certificado . Após a conclusão da rotação deste certificado, o Cloud SQL adiciona o nome DNS ao certificado. Você pode usar o nome DNS para verificação de identidade do servidor.

O que vem a seguir