排查主要版本就地升级问题

本文档介绍了如何排查在将 AlloyDB for PostgreSQL 数据库升级到主要版本就地升级时可能遇到的问题。如需了解详情，请参阅就地升级数据库主要版本。 如需了解主要版本就地升级错误，请参阅数据库主要版本就地升级错误。

如需分析升级失败问题，请从响应中确定失败的升级阶段，并使用本文档中的信息确定可能的解决方案。

AlloyDB 会同步验证您的请求，如果满足以下任一条件，则返回错误消息：

• 请求无效。例如，如果提供的目标主要版本不受支持或小于或等于当前主要版本。
• 集群资源处于无法触发主要版本升级的状态。例如，如果集群或任何关联的实例未处于 READY 状态。

如果请求有效，升级可能会因以下原因而失败：

• 在各个阶段执行的升级前检查可能会失败，这表示检测到违规行为。您必须先解决这些违规问题，然后才能重启升级。
• 内部错误意味着您需要重试升级。如果重试失败，请与 Google Cloud 支持团队联系。

AlloyDB 升级前检查失败

升级前检查失败可能发生在以下任何阶段：

• AlloyDB 升级前检查 (ALLOYDB_PRECHECK)
• pg_upgrade 检查 (PG_UPGRADE_CHECK)
• 主集群升级 (PRIMARY_INSTANCE_UPGRADE)

升级前检查失败是指 AlloyDB 在升级前验证阶段检测到的问题，这些问题可能会导致主要版本就地升级失败。例如，AlloyDB 会检查当前主要版本与目标主要版本之间的扩展程序不兼容问题。

错误消息会填充到升级操作响应的 logs_url 中。您可以在 Google Cloud 控制台中前往 Logs Explorer 查看这些日志。如需了解详情，请参阅查看升级日志。

如需查看您可能会在日志中看到的失败情况和相应错误消息，请参阅数据库主要版本就地升级错误。

以下是 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

pg_upgrade 检查失败

PG_UPGRADE_CHECK 使用标准 pg_upgrade 实用程序检查违规情况。此升级检查包括由各种因素引起的数据不一致，包括特定于版本的数据结构的差异、编码和排序规则的更改、数据类型的修改以及对系统目录的调整。

多个文件（例如在 pg_upgrade 期间生成的 tables_with_oids.txt 和 tables_using_reg.txt）会导出到 postgres_upgrade 日志文件。您可以使用 labels.FILE_NAME 标签过滤这些文件。

可能包含要解决的错误的文件名包括以下内容：

pg_upgrade 失败

PG_UPGRADE 日志的结构类似于 PG_UPGRADE_CHECK 日志的结构。

以下是带有标签 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.

后续步骤

• 了解数据库主要版本就地升级错误。
• 了解如何执行数据库主要版本就地升级。