Die Verwaltung und Abfrage von Datenbanken ist ein essenzieller Bestandteil jedes modernen ERP-Systems. Mit mxDatabaseQuery.exe stellt MicrotronX ein vielseitiges und leistungsfähiges Kommandozeilen-Tool bereit, das die direkte Interaktion mit der ERP-Datenbank über SQL-Abfragen ermöglicht. In diesem Blog-Beitrag erfährst du, welche Möglichkeiten das Tool bietet und wie es effektiv eingesetzt werden kann.
Sicherheitshinweis
Das Tool sollte nur durch Administratoren und berechtigte Benutzer ausgeführt werden. Seit dem letzten Update erfordert die Nutzung zwingend die Angabe der Parameter /username= und /password=, um unbefugte Zugriffe zu verhindern.
Funktionen von mxDatabaseQuery.exe
Das mxDatabaseQuery.exe-Tool erlaubt es, SQL-Abfragen direkt gegen die MicrotronX ERP-Datenbank auszuführen und die Ergebnisse in verschiedenen Formaten zu exportieren. Es bietet unter anderem folgende Features:
- Verbindung zur Datenbank über vordefinierte Konfigurationen oder manuelle Parameter
- Ausführung von SQL-Abfragen direkt aus der Kommandozeile
- Nutzung von SQL-Skriptdateien zur Abfrageautomatisierung
- Ausgabe der Ergebnisse in den Formaten CSV, XML oder JSON
- Möglichkeit zur Definition von Spaltentrennern in CSV-Dateien
- Unterstützt Detailabfragen zur Generierung von hierarchischen Datenstrukturen
Verfügbare Parameter
Das Tool bietet eine Vielzahl von Parametern zur Konfiguration und Abfrageausführung:
/config = {Name der Konfiguration aus mxssetup oder * für manuelle Einrichtung}
/host = {Hostname des Servers}
/port = {Port; Standard: 12010}
/signature = {Verbindungssignatur, die auf dem Server definiert ist}
/encpw = {Verschlüsselungspasswort; falls erforderlich}
/dbname = {Datenbankname}
/inputsqlquery = {SQL-Abfrage direkt als Parameter}
/inputsqlfile = {Pfad zur Datei mit der SQL-Abfrage}
/outputsqlfile = {Pfad für die Ausgabedatei}
/outputfiletype = {Format der Ausgabedatei: csv (Standard), xml, json}
/outputcolumndelimiter = {Spaltentrenner für CSV; Standard: |}
/username = {Benutzername}
/password = {Passwort}
Beispielhafte Anwendung
1. SQL-Abfrage direkt ausführen
mxDatabaseQuery.exe /dbname="erpconfig" /inputsqlquery="SELECT * FROM auftraege WHERE status='offen'" /outputsqlfile=auftraege.csv /outputfiletype=csv /username=admin /password=securepass
Diese Abfrage listet alle offenen Aufträge und speichert sie als CSV-Datei.
2. SQL-Skript aus Datei ausführen
mxDatabaseQuery.exe /dbname="erpconfig" /inputsqlfile=test.sql /outputsqlfile=testsqloutput.json /outputfiletype=json /username=admin /password=securepass
3. Beispielinhalt einer SQL-Datei (test.sql)
SELECT * FROM haupttabelle RANGE 1 TO 10;
-->detailquery:kontakte::SELECT * FROM detailkontakte WHERE masterid=$$id$$;
-->detailquery:branchen::SELECT * FROM detailbranchen WHERE masterid=$$id$$;
Hierbei ersetzt das Tool automatisch die Platzhalter $$id$$ mit den entsprechenden IDs aus der Haupttabelle und erzeugt eine verschachtelte JSON- oder XML-Struktur mit den Detaildaten zu Kontakten und Branchen.
Fazit
Das mxDatabaseQuery.exe-Tool ist ein unverzichtbares Werkzeug für Systemadministratoren und Entwickler, die regelmäßig mit der MicrotronX ERP-Datenbank arbeiten. Dank der vielseitigen Parameter und der Möglichkeit zur Ausgabe in verschiedenen Formaten lassen sich Datenabfragen einfach automatisieren und weiterverarbeiten.