>> Inhaltsverzeichnis >> Erweiterungen

Plugin: DB-Administration

Allgemeines

Dieses Plugin erlaubt es Ihnen, die Verbindungseinstellungen zu Ihrer Datenbank zu editieren. Weiterhin können Sie Tabellen installieren, erforderliche Daten übertragen und Backups erstellen.

Verbindung zur Datenbank herstellen

Formular
Abbildung: Einstellungen der Verbindung zur Datenbank

Wählen Sie für die Option "Datenbank benutzen" den Wert "ja", um die eine Datenbankverbindung mit den angegebenen Verbindungsdaten zu verwenden. Die Installation der Datenbank läuft automatisch ab. Sie müssen somit nur im Fehlerfall von Hand eingreifen.

Beim Aktivieren der Datenbank werden automatisch folgende Aktionen durchgeführt:
  1. Test der Verbindungsparameter
  2. Verbindung zur Datenbank öffnen
  3. alle erforderlichen Tabellen installieren
  4. alle Daten aus dem Dateisystem zur Datenbank übertragen

Sollte an einem dieser Punkte ein Fehler auftreten, so wird die Verbindung NICHT aktiviert und es wird eine Fehlermeldung angezeigt. Eine genaue Erläuterung des Fehlers finden Sie im Fehlerprotokoll. Beachten Sie bitte, dass dazu die Protokollierung aktiviert sein muss (siehe Kapitel "Logging und Fehlermeldungen").

Anleitung für den Fehlerfall

Sie können im Fehlerfall die einzelnen Schritte, welche beim Aktivieren der Datenbankverbindung normalerweise automatisch durchgeführt werden, auch manuell durchführen. Gehen Sie dazu wie folgt vor.

  1. Prüfen Sie Ihre Verbindungseinstellungen auf Fehler. Falls diese korrekt sind, fahren Sie fort.
  2. Geben Sie die Verbindungsparameter zur Datenbank ein und speichern Sie Ihre Änderungen. Lassen Sie dabei aber den Wert der Option "Datenbank benutzen" unverändert auf "nein".
  3. Wählen Sie die Option "Datenbanken installieren". Versuchen Sie diese Aktion auszuführen, indem Sie auf "Abschicken" klicken (siehe Abbildung). Falls dies erfolgreich ist, fahren Sie mit dem nächsten Schritt fort.
    Sollte ein Fehler auftreten, prüfen Sie bitte mit einem anderen Programm, ob die Tabellen bereits existieren. Falls dies der Fall ist, löschen Sie die Tabellen und versuchen Sie es erneut.
    Falls die Tabellen nicht existieren, versuchen Sie die Tabellen mit einem anderen Programm zu installieren. Die Quellen dazu finden Sie im Kapitel "Anleitung für Fortgeschrittene" / "Konfiguration". Falls dies erfolgreich ist, prüfen Sie bitte erneut Ihre Verbindungseinstellungen.
  4. Wählen Sie die Option "Datenbanken synchronisieren". Versuchen Sie zunächst nur die Datenbank "user" zu synchronisieren. Deaktivieren Sie dazu alle anderen Optionen. Versuchen Sie danach die übrigen Datenbanken zu synchronisieren (siehe Abbildung). Sollte sich dabei ein Fehler ergeben, könnte die Ursache ein Datenfehler sein. Sie können sich dann entscheiden, ob sie auf die betroffenen Daten verzichten können. Sollte dies nicht möglich sein, so haben Sie die Möglichkeit die Daten entweder manuell in die Zieldatenbank zu kopieren, oder in der Quelldatenbank zu korrigieren.
    Sie finden die Quelldaten in Textdateien im Verzeichnis "config/db/name", wobei "name" für den Namen der Datenbank steht. Diese Maßnahme wird nur erfahrenen Nutzern empfohlen.
  5. Sollten die oben aufgeführten Schritte erfolgreich gewesen sein, so wählen Sie die Option "Verbindung zur Datenbank herstellen". Achten Sie darauf, dass Sie im Administrationsmenü den Expertenmodus aktiviert haben. Wählen für die Option "Datenbank benutzen" den Wert "ja". Deaktivieren Sie die Optionen "Tabellen automatisch anlegen" und "Datensätze kopieren". Diese Optionen sind nur im Expertenmodus sichtbar. Klicken Sie dann auf "Abschicken" (siehe Abbildung).

Bitte beachten Sie auch die Kompatibilitätshinweise!

Datenbanken installieren

• Hinweis: Dieser Schritt wird normalerweise automatisch ausgeführt, wenn eine Datenbankverbindung aktiviert wird. Das hier dargestellte Formular dient der manuellen Behandlung im Fehlerfall.

Formular
Abbildung: Formular zum installieren der Tabellen

Es wird versucht, die zu den ausgewählten Datenbanken gehörenden Tabellen auf dem Datenbankserver zu erzeugen. Zu diesem Zweck werden gespeicherte SQL Dateien importiert, passend zum Typ der Datenbank. Voraussetzung ist, dass die Verbindung zur Datenbank vorher korrekt konfiguriert worden ist. Sie sollten die Datenbankverbindung jedoch nicht aktivieren bevor sie die erforderlichen Tabellen erzeugt haben.

In seltenen Fällen kann dieser Prozess fehlschlagen. Z.Bsp. wenn: keine Verbindung zum Datenbankserver möglich ist, für das gewählte DBMS kein SQL erzeugt werden kann, das erzeugte SQL fehlerhaft ist, eine andere Tabelle mit der gleichen Bezeichnung bereits existiert, oder der Nutzer nicht ausreichende Rechte zum Erzeugen der Tabellen besitzt. In diesen Fällen muss die Installation von Hand durchgeführt werden.

Die erforderlichen SQL-Dateien für das manuelle Erzeugen der Tabellen finden Sie im Kapitel "Anleitung für Fortgeschrittene" / "Konfiguration".

Datenbanken synchronisieren

• Hinweis: Dieser Schritt wird normalerweise automatisch ausgeführt, wenn eine Datenbankverbindung aktiviert wird. Das hier dargestellte Formular dient der manuellen Behandlung im Fehlerfall.

Formular
Abbildung: Formular zum Kopieren der Inhalte der Tabellen zur Datenbank

Die Einträge in den Textdateien und der Datenbank werden miteinander abgeglichen. Bei diesem Vorgang werden KEINE Einträge gelöscht oder geändert, sondern lediglich neue hinzugefügt. Bei sehr großen Datenmengen kann es zu einem Timeout kommen. In diesem Fall wiederholen Sie die Prozedur mehrfach, bis alle Daten übertragen sind.

Backup erstellen

• Hinweis: Diese Option funktioniert nur wenn eine Datenbankverbindung aktiv ist.

Formular
Abbildung: Formular um ein Backup der Datenbank zu erstellen

Benutzen Sie diese Option um eine Sicherungskopie Ihrer Datenbank zu erstellen.

SQL-Syntax
der SQL-Dialekt, in welchem die Ausgabe gespeichert werden soll
Struktur exportieren
gibt an, ob die Tabellenstrukturen gespeichert werden sollen ("create table ...")
Daten exportieren
gibt an, ob die in den Tabellen enthaltenen Datensätze gespeichert werden sollen
als GZip komprimieren
da Backups sehr groß sein können, haben Sie die Möglichkeit mit dieser Option die Datei vor dem Herunterladen im GZip-Format zu komprimieren. Dadurch wird die Datei kleiner.

Autor: Thomas Meyer, www.yanaframework.net