本文档介绍了在 AlloyDB for PostgreSQL 中执行数据库就地升级时可能遇到的错误。还会提供建议的解决方法。如需了解详情，请参阅排查就地升级主要版本时出现的问题。
错误：数据库：database_name。extension_violation：已废弃，action_required：DELETE_EXTENSION
说明：AlloyDB 检测到已废弃的扩展程序。错误会指明哪些扩展程序导致了错误：
Database:. extension_violation: INVALID_EXTENSION_VERSION, action_required: UPGRADE_EXTENSION."+ " Query format to upgrade the extensions: ALTER EXTENSION {extension_name} UPDATE TO {target_version};. Violation list: [ ]
建议的解决方法：删除该扩展程序。用于删除扩展程序的查询格式为 DROP EXTENSION {extension_name};。
错误：数据库：database_name。extension_violation: INVALID_VERSION, action_required: UPGRADE_EXTENSION
说明：AlloyDB 检测到无效的扩展程序版本。
建议的解决方法：升级扩展程序。用于升级扩展程序的查询格式为 ALTER EXTENSION {extension_name} UPDATE TO {target_version};。
错误：数据库：database_name 包含 pg_largeobject
说明：AlloyDB 检测到 pg_largeobject。
建议的解决方法：在升级 AlloyDB 集群之前移除 pg_largeobject。
ERROR: out of shared memory
说明：如果实例的共享内存不足，您可能会看到此错误消息。如果您有超过 10,000 个表，则更有可能发生此错误。
建议的解决方法：在开始升级之前，请将 max_locks_per_transaction 标志的值设置为实例中表数的大约两倍。更改此标志的值时，实例将重启。
错误：连接数不足
说明：如果您的实例没有足够的连接容量，您可能会看到此错误消息。
建议的解决方法：我们建议您根据实例中的数据库数量增加 max_connections 标志值。更改此标志的值时，实例将重启。
升级前检查失败
说明：升级 AlloyDB 集群时，升级可能会因升级前检查而失败。有关违规行为的详细信息以 logs_url 的形式显示在 API 响应中。系统会将您定向至包含日志的 Google Cloud 控制台页面。
建议的解决方法：移除扩展程序。
后续步骤
- 排查主要版本就地升级问题。
- 了解如何就地升级数据库主要版本。