Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Das Schema nach einem Upgrade prüfen

Wie Sie bestätigen, dass eine Exponential-Datenbank das Schema ihres Releases hat - die Prüfung der Datenbankkonsistenz unter Setup > Upgrade-Prüfung und die Arten von Befunden, die sie meldet, die Prüfung der…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/database-administrators/checking-the-schema-after-an-upgrade.md

On this page

This page is a translation. Read the English original

Das Schema nach einem Upgrade prüfen

Diese Seite richtet sich an Datenbankadministratoren, die eine Exponential-Datenbank nach einem Upgrade, einer Wiederherstellung oder einem Engine-Wechsel prüfen. Sie beantwortet: welche Werkzeuge die Datenbank mit dem Schema des Releases vergleichen, was jede Art von Befund bedeutet und auf welche Befunde Sie reagieren. Die Werkzeuge lesen nur: Keines davon ändert die Datenbank. Quelle: Die Upgrade-Prüfung und 11.7 Das Upgrade prüfen.

Inhalt

  1. Die Werkzeuge
  2. Die Prüfung der Datenbankkonsistenz
  3. Jede Art von Befund
  4. Auf MongoDB
  5. Aus der Shell: ezsqldiff.php
  6. Auf Oracle: schema-diff
  7. Checkliste

Die Werkzeuge

WerkzeugVergleichtEngines
Setup > Upgrade-Prüfung, "Überprüfe Datenbankkonsistenz"die Datenbank mit share/db_schema.dba und den Schemas aktiver ErweiterungenMySQL, MariaDB, PostgreSQL, SQLite, MongoDB (Collections) und jede Engine, deren Schema-Handler in dbschema.ini registriert ist
bin/php/ezsqldiff.phpzwei Schemas, Dateien oder Datenbankenmysql, postgresql
exp:checkdbfilesdie Update-Dateien auf der Festplatte mit dem Upgrade-Wegalle
ext:ezoracle:schema-diffdas Oracle-Schema mit share/db_schema.dbaOracle

Die Prüfung der Datenbankkonsistenz

Drücken Sie in der Administration unter Setup > Upgrade-Prüfung auf Überprüfe Datenbankkonsistenz. Sie liest share/db_schema.dba und die share/db_schema.dba jeder aktiven Erweiterung, die eine hat, liest das Schema der Datenbank und vergleicht beide mit dem Schema-Handler der Engine (dbschema.ini [SchemaSettings]). Sie liest außerdem die Schemadateien installierter, aber inaktiver Erweiterungen, nur um zu sagen, zu welcher von ihnen eine Tabelle gehört. Auf dem Demonstrationsserver (SQLite, 11 Schemadateien) dauert das etwa 0,1 Sekunden.

Die Seite zeigt Zahlen (Tabellen mit zu prüfendem SQL, fehlende Tabellen, Tabellen nicht im Schema, geänderte Tabellen, Tabellen inaktiver Erweiterungen, Engine-Hinweise), dann eine aufklappbare Karte je Tabelle mit den Unterschieden und dem SQL für diese Tabelle. Alle Anweisungen enthält das ganze SQL als einen Block. Die Seite führt nichts davon aus. Jeder Lauf wird als system.upgrade.run in den Audit-Trail geschrieben.

Jede Art von Befund

ArtBedeutungWas zu tun ist
Fehlende Tabellemit Exponential oder einer aktiven Erweiterung ausgeliefert, nicht in der Datenbank; die Funktion, die sie verwendet, scheitertihre CREATE-Anweisung nach einer Sicherung ausführen, oder die Update-Datei oder das Skript, das sie hätte anlegen sollen
Tabelle nicht im Schemain gar keinem Schema: meist eine Tabelle Ihrer eigenen Erweiterung ohne Schemadatei oder einer entfernten Erweiterunglassen Sie sie, sofern Sie nicht wissen, dass ihre Daten nicht mehr gebraucht werden; das DROP wird nur der Vollständigkeit halber gezeigt, markiert mit Entfernt etwas
Tabelle einer nicht aktiven Extensionvom Schema einer installierten, inaktiven Erweiterung genannt (zum Beispiel ezfind_elevate_configuration von ezfind)die Erweiterung aktivieren oder die Tabelle lassen; dafür wird kein SQL geschrieben
Geänderte TabelleFelder oder Indizes weichen von der mitgelieferten Definition ablesen Sie jede Anweisung; führen Sie die aus, denen Sie zustimmen, nach einer Sicherung; mit Entfernt etwas markierte Anweisungen können Ihre Daten entfernen
Engine-Hinweiseder Schema-Handler schreibt für den Unterschied kein SQL (auf SQLite sind zum Beispiel text und longtext dasselbe)nichts

Die Regel: Fehlende Tabellen sind meist echte Probleme; zusätzliche und geänderte Tabellen sind meist Ihre eigene Arbeit. Führen Sie Alle Anweisungen nie als Ganzes aus.

Auf MongoDB

Die Prüfung vergleicht Collections: fehlende Collections nach Funktion gruppiert, Collections, die nicht im Schema stehen, und den mongosh-Befehl, der die fehlenden anlegt. Führen Sie danach bin/mongodb/create_indexes.js aus (MongoDB: Grenzen und Betrieb).

Aus der Shell: ezsqldiff.php

php bin/php/ezsqldiff.php --type=mysql --user=USER --password='<password>' share/db_schema.dba DATABASE --allow-root-user
echo $?

Das Referenzschema kommt zuerst. Die Ausgabe ist das SQL, das Ihre Datenbank in die Referenz verwandeln würde: Eine Zeile CREATE TABLE oder ADD nennt etwas, das ein Update-Schritt hätte anlegen sollen; eine Zeile DROP TABLE eine Tabelle, die nur Ihre Datenbank hat (die Tabellen Ihrer eigenen Erweiterungen erscheinen so). Lesen Sie sie, führen Sie sie nicht aus. Exit-Code 0, wenn die Schemas übereinstimmen, 1, wenn sie sich unterscheiden; --check-only gibt nichts aus und setzt nur den Exit-Code, nützlich in einem Deploy-Skript (Schemawerkzeuge).

Verwandte Prüfungen in der Shell:

php bin/php/console exp:checkdbfiles --no-verify-branches     # update files complete: no output
php bin/php/console exp:system:info --allow-root-user         # exits 1 when a health check fails

Auf Oracle: schema-diff

php bin/php/console ext:ezoracle:schema-diff --allow-root-user

Es vergleicht die Datenbank mit share/db_schema.dba (--file=<dba> für eine andere Datei) und gibt das Upgrade-SQL aus; danach kompiliert ext:ezoracle:recompile ungültige Objekte neu (Wartungsbefehle und Cronjobs für Oracle).

Checkliste

  • To do: Die Versionszeile passt zum Code.
  • To do: Die Konsistenzprüfung listet keine fehlende Tabelle.
  • To do: Geänderte und zusätzliche Tabellen sind erklärt (eigene Erweiterungen, entfernte Erweiterungen).
  • To do: exp:checkdbfiles gibt nichts aus.
  • To do: Keine Anweisung wurde ohne Sicherung und Grund ausgeführt.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x