DBAtlas · Atlas d'exploitation des bases de données

Vérification de compatibilité/préparation avant mise à niveau

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

Le mode 'analyze' d'AutoUpgrade produit un rapport préalable sans modifier les données ; il liste les avertissements à corriger et les éléments qui seront résolus automatiquement. Exécutez-le toujours avant la mise à niveau proprement dite.

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 vérifie que la mise à niveau est faisable sans modifier les données (signale les extensions manquantes, les types de données incompatibles, etc.). --check peut aussi s'exécuter pendant que l'ancien cluster tourne ; la mise à niveau effective se fait avec les deux clusters arrêtés.

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() de MySQL Shell signale les fonctionnalités supprimées, les conflits de mots réservés et les définitions incompatibles. À partir de 8.0, le serveur effectue lui-même la mise à niveau du dictionnaire au démarrage ; un mysql_upgrade séparé n'est plus nécessaire.

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) a remplacé l'ancien Upgrade Advisor ; il signale par base les fonctionnalités dépréciées, les changements incompatibles et les blocages. Exécutez-le avant la mise à niveau et traitez les constats.

MongoDB

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

Avant de mettre à niveau la version binaire, la FCV doit être égale à la version actuelle ; sinon la mise à niveau est bloquée. MongoDB n'a pas de « scanner de dépréciations » automatique ; les notes de compatibilité des versions sont examinées manuellement.

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.

Les mises à niveau Redis sont généralement compatibles ascendantes ; faute de scanner de préparation officiel, vérifiez manuellement dans les notes de version le format des fichiers RDB/AOF, les directives de configuration supprimées et les changements de commandes.

Elasticsearch

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

L'API Deprecation Info liste, en 'critical' / 'warning', les paramètres de cluster, de nœud, d'index et ML qui poseront problème lors du passage à la version majeure suivante. Kibana Upgrade Assistant présente les mêmes données visuellement.

Ouvrir dans DBAtlas →