DBAtlas · Atlas für Datenbankbetrieb

Kompatibilitäts-/Bereitschaftsprüfung vor dem Upgrade

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

Der Modus 'analyze' von AutoUpgrade erstellt einen Pre-Upgrade-Bericht, ohne Daten zu ändern; er listet Warnungen, die behoben werden müssen, und Punkte, die automatisch gelöst werden. Führe ihn immer vor dem eigentlichen Upgrade aus.

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 prüft, ob das Upgrade durchführbar ist, ohne Daten zu ändern (meldet fehlende Extensions, inkompatible Datentypen usw.). --check kann auch bei laufendem altem Cluster ausgeführt werden; das eigentliche Upgrade erfolgt bei gestoppten Clustern.

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

util.checkForServerUpgrade() der MySQL Shell meldet entfernte Features, Konflikte mit reservierten Wörtern und inkompatible Definitionen. Ab 8.0 führt der Server das Dictionary-Upgrade beim Start selbst durch; ein separates mysql_upgrade ist nicht mehr nötig.

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) hat den alten Upgrade Advisor abgelöst; er meldet pro Datenbank veraltete Features, Breaking Changes und Blocker. Führe ihn vor dem Upgrade aus und behebe die Befunde.

MongoDB

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

Vor dem Upgrade der Binärversion muss die FCV der aktuellen Version entsprechen, sonst wird das Upgrade blockiert. MongoDB hat keinen automatischen 'Deprecation-Scanner'; die Kompatibilitätshinweise der Release Notes werden manuell geprüft.

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-Upgrades sind in der Regel vorwärtskompatibel; da es keinen offiziellen Bereitschaftsscanner gibt, prüfe RDB-/AOF-Dateiformat, entfernte Konfigurationsdirektiven und Befehlsänderungen manuell anhand der Release Notes.

Elasticsearch

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

Die Deprecation Info API listet Cluster-, Knoten-, Index- und ML-Einstellungen, die beim Wechsel auf die nächste Major-Version Probleme verursachen, als 'critical' / 'warning'. Der Kibana Upgrade Assistant visualisiert dieselben Daten.

In DBAtlas öffnen →