Resolver problemas de upgrade de versão principal no local

Este documento descreve como resolver problemas que podem ocorrer ao fazer upgrade do banco de dados do AlloyDB para PostgreSQL para uma versão principal no local. Para mais informações, consulte Fazer upgrade da versão principal de um banco de dados no local. Para saber mais sobre erros de upgrade de versão principal no local, consulte Erros de upgrade de versão principal no local do banco de dados.

Para analisar falhas de upgrade, identifique a etapa de upgrade com falha na resposta e use as informações neste documento para identificar possíveis resoluções.

O AlloyDB valida sua solicitação de forma síncrona e retorna uma mensagem de erro se uma das seguintes condições for verdadeira:

  • A solicitação é inválida. Por exemplo, se a versão principal de destino fornecida não tiver suporte ou for menor ou igual à versão principal atual.
  • Os recursos do cluster estão em um estado em que o upgrade da versão principal não pode ser acionado. Por exemplo, se o cluster ou qualquer uma das instâncias associadas não estiver em um estado READY.

Se a solicitação for válida, o upgrade poderá falhar pelos seguintes motivos:

  • As verificações pré-upgrade realizadas em vários estágios podem falhar, o que indica que violações foram detectadas. Você precisa resolver essas violações antes de reiniciar o upgrade.
  • Erros internos significam que você precisa tentar o upgrade novamente. Se as tentativas falharem, entre em contato com o suporte do Google Cloud.

Falhas na verificação pré-upgrade do AlloyDB

As falhas na verificação pré-upgrade podem acontecer durante qualquer uma das seguintes etapas:

  • Verificações de pré-upgrade do AlloyDB (ALLOYDB_PRECHECK)
  • Verificações pg_upgrade (PG_UPGRADE_CHECK)
  • Upgrades de cluster principal (PRIMARY_INSTANCE_UPGRADE)

As falhas na verificação pré-upgrade são problemas que o AlloyDB detecta durante a fase de validação pré-upgrade, o que pode causar a falha do upgrade de versão principal no local. Por exemplo, o AlloyDB verifica incompatibilidades de extensão entre a versão principal atual e a de destino.

As mensagens de erro são preenchidas no logs_url na resposta da operação de upgrade. Para acessar esses registros, navegue até o Explorador de registros no console do Google Cloud. Para mais informações, consulte Conferir os registros de upgrade.

Para conferir as falhas e as mensagens de erro correspondentes que podem aparecer nos registros, consulte Erros de upgrade da versão principal do banco de dados no local.

Confira a seguir um exemplo do resumo gerado nos registros pelas verificações de pré-upgrade do AlloyDB:

Total number of databases checked for custom checks: 
Total number of databases containing pg_largeobject: 
Total number of databases containing extensions compatibility violation:

Falhas na verificação de pg_upgrade

O PG_UPGRADE_CHECK verifica violações usando o utilitário padrão pg_upgrade. Essa verificação de upgrade inclui inconsistências de dados que surgem devido a vários fatores, incluindo diferenças em estruturas de dados específicas da versão, alterações na codificação e ordenação, modificações em tipos de dados e ajustes no catálogo do sistema.

Vários arquivos, como tables_with_oids.txt e tables_using_reg.txt, que são gerados durante a pg_upgrade, são exportados para postgres_upgrade. É possível filtrar esses arquivos usando o rótulo labels.FILE_NAME.

Os nomes de arquivos que podem conter erros incluem:

Nome do arquivo Descrição

tables_with_oids.txt

Esse arquivo contém tabelas listadas com identificadores de objeto (OIDs). Exclua ou modifique as tabelas para que não usem OIDs.

tables_using_composite.txt

Esse arquivo contém tabelas listadas usando tipos compostos definidos pelo sistema. Exclua ou modifique as tabelas para que elas não usem esses tipos compostos.

tables_using_unknown.txt

Esse arquivo contém tabelas listadas usando o tipo de dados UNKNOWN. Exclua ou modifique as tabelas para que não usem esse tipo de dado.

tables_using_sql_identifier.txt

Esse arquivo contém tabelas listadas usando o tipo de dados SQL_IDENTIFIER. Exclua ou modifique as tabelas para que não usem esse tipo de dado.

tables_using_reg.txt

Esse arquivo contém tabelas listadas usando o tipo de dados REG*, por exemplo, REGCOLLATION ou REGNAMESPACE. Exclua ou modifique as tabelas para que não usem esse tipo de dado.

postfix_ops.txt

Esse arquivo contém tabelas listadas com operadores postfix (uniário direito). Exclua ou modifique as tabelas para que não usem esses operadores.

Falhas de pg_upgrade

A estrutura dos registros PG_UPGRADE é semelhante à estrutura dos registros PG_UPGRADE_CHECK.

Confira a seguir um exemplo de registro com o rótulo labels.FILE_NAME=pg_upgrade_dump*.log:

pg_upgrade_dump: error: query failed: ERROR: out of shared memory
HINT: You might need to increase max_locks_per_transaction.

A seguir