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 da versão principal no local, consulte Erros de upgrade da versão principal no local do banco de dados.

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

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

  • A solicitação é inválida. Por exemplo, se a versão principal de destino fornecida não for compatível ou for menor ou igual à versão principal atual.
  • Os recursos do cluster estão em um estado em que não é possível acionar o upgrade da versão principal. 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árias etapas podem falhar, o que indica que violações foram detectadas. Resolva essas violações antes de reiniciar o upgrade.
  • Erros internos significam que é preciso tentar fazer o upgrade de novo. Se as novas 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 ocorrer durante qualquer uma das seguintes etapas:

  • Verificações de pré-upgrade do AlloyDB (ALLOYDB_PRECHECK)
  • Verificações de pg_upgrade (PG_UPGRADE_CHECK)
  • Upgrades do 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 no local da versão principal. 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 ver esses registros, navegue até o Explorador de registros no console do Google Cloud . Para mais informações, consulte Ver 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: 3
Total number of databases containing pg_largeobject: 0
Total number of databases containing event triggers permissions issue: 0
Total number of databases containing extensions compatibility violation: 1
Total number of databases containing search path violations: 0

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 pg_upgrade, são exportados para o arquivo de registro postgres_upgrade. É possível filtrar esses arquivos usando o rótulo labels.FILE_NAME.

Os nomes dos arquivos que podem conter erros incluem:

Nome do arquivo Descrição

tables_with_oids.txt

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

tables_using_composite.txt

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

tables_using_unknown.txt

Esse arquivo contém tabelas listadas com 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 com 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 com 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 as tabelas ou modifique-as para que não usem esses operadores.

Falhas de pg_upgrade

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

Confira abaixo 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