Erros de upgrade da versão principal no local do banco de dados

Para resolver violações de verificação pré-upgrade, incompatibilidades de extensão e erros de limite de recursos ao realizar um upgrade de versão principal no local no AlloyDB para PostgreSQL, aplique as correções recomendadas para as mensagens de erro retornadas pela operação de upgrade. Para ver as etapas gerais de solução de problemas de upgrade, consulte Resolver problemas de um upgrade de versão principal no local.

Erros comuns de upgrade da versão principal

As seções a seguir descrevem as mensagens de erro que podem ocorrer durante um upgrade de versão principal e como resolvê-las.

Erro: banco de dados: database_name. extension_violation: DEPRECATED, action_required: DELETE_EXTENSION

Descrição: o AlloyDB detecta uma extensão descontinuada. O erro indica quais extensões causaram um erro:

database_name. extension_violation: DEPRECATED_EXTENSION, action_required: DELETE_EXTENSION. Query format to delete the extensions: DROP EXTENSION {extension_name}; Violation list: [extensions]

Correção recomendada:exclua a extensão. O formato de consulta para excluir uma extensão é DROP EXTENSION {extension_name};.

Erro: banco de dados: database_name. extension_violation: INVALID_EXTENSION_VERSION, action_required: UPGRADE_EXTENSION

Descrição: o AlloyDB detecta uma versão de extensão inválida.

Correção recomendada:faça upgrade da extensão. O formato de consulta para fazer upgrade de uma extensão é ALTER EXTENSION {extension_name} UPDATE TO {target_version};.

Erro: o banco de dados database_name contém pg_largeobject

Descrição:o AlloyDB detecta pg_largeobject.

Correção recomendada:remova pg_largeobject antes de fazer upgrade do cluster do AlloyDB.

ERRO: falta de memória compartilhada

Descrição:se a instância não tiver memória compartilhada suficiente, é possível que você veja esta mensagem de erro. É mais provável que esse erro ocorra se você tiver mais de 10.000 tabelas.

Correção recomendada:antes de iniciar um upgrade, defina o valor da flag max_locks_per_transaction como aproximadamente o dobro do número de tabelas na instância. A instância é reiniciada quando você altera o valor dessa sinalização.

ERRO: conexões insuficientes

Descrição:se a instância não tiver capacidade de conexão suficiente, esta mensagem de erro poderá ser exibida.

Correção recomendada:recomendamos que você aumente o valor da sinalização max_connections pelo número de bancos de dados na instância. Quando você altera o valor dessa flag, a instância é reiniciada.

As verificações pré-upgrade estão falhando

Descrição:ao fazer upgrade do cluster do AlloyDB, o upgrade pode falhar devido a verificações prévias. Os detalhes sobre as violações estão na resposta da API na forma de logs_url. Você vai ser direcionado para a página do console do Google Cloud em que os registros estão presentes.

Correção recomendada:com base na mensagem de erro, consulte outros erros listados anteriormente neste documento para resolver o problema específico.

A seguir