升级前兼容性/就绪检查

Oracle

-- Recommended method for 19c and later (AutoUpgrade analyze mode):
-- $ java -jar autoupgrade.jar -config db.cfg -mode analyze
-- Legacy/alternative: preupgrade script (produces a report only):
-- $ $NEW_ORACLE_HOME/jdk/bin/java -jar $NEW_ORACLE_HOME/rdbms/admin/preupgrade.jar FILE TEXT DIR /tmp

AutoUpgrade 'analyze' 模式在不修改数据的情况下生成升级前报告；列出必须修复的警告以及将自动解决的项目。务必在正式升级前运行。

PostgreSQL

# With the new version's binaries, compatibility check only (moves no data):
$ pg_upgrade \
    --old-datadir=/var/lib/pgsql/16/data \
    --new-datadir=/var/lib/pgsql/17/data \
    --old-bindir=/usr/pgsql-16/bin \
    --new-bindir=/usr/pgsql-17/bin \
    --check

--check 在不修改任何数据的情况下验证升级是否可行（报告缺失的扩展、不兼容的数据类型等）。--check 也可在旧集群运行时执行；正式升级需在两个集群都停止的情况下进行。

MySQL

-- 8.0 and later: Upgrade Checker utility (MySQL Shell):
-- $ mysqlsh -- util check-for-server-upgrade { --user=root --host=localhost }
-- Table consistency for legacy 5.7->8.0:
$ mysqlcheck --all-databases --check-upgrade -u root -p

MySQL Shell 的 util.checkForServerUpgrade() 会报告已移除的功能、保留字冲突和不兼容的定义。从 8.0 起，服务器在启动时自行完成数据字典升级；不再需要单独运行 mysql_upgrade。

SQL Server

-- Run from the desktop with Data Migration Assistant (DMA):
-- DmaCmd.exe /AssessmentName=... /AssessmentDatabases=...
-- (Produces compatibility/deprecated feature and blocker reports.)

Data Migration Assistant（DMA）取代了旧的 Upgrade Advisor；它按数据库报告已弃用的功能、重大变更和阻碍因素。在升级前运行并解决发现的问题。

MongoDB

// Verify the current Feature Compatibility Version (FCV):
db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })
// Compatibility items (deprecations) in the release notes are reviewed manually.

升级二进制版本之前，FCV 必须等于当前版本；否则升级会被阻止。MongoDB 没有自动的“弃用扫描器”；需手动查阅版本兼容性说明。

Redis

# Not applicable: Redis has no separate pre-upgrade readiness tool.
# Checklist: read the target version's release notes for RDB/AOF persistence format,
# changed configuration directives, and removed commands/arguments.

Redis 升级通常向前兼容；由于没有官方的就绪扫描工具，需根据发行说明手动检查 RDB/AOF 文件格式、已移除的配置指令和命令变更。

Elasticsearch

GET _migration/deprecations
# For a specific component: GET <index>/_migration/deprecations

Deprecation Info API 以 'critical' / 'warning' 列出升级到下一个大版本时会引发问题的集群、节点、索引和 ML 设置。Kibana Upgrade Assistant 以可视化方式展示相同数据。

在 DBAtlas 中打开 →