MariaDB-Kurs / Unter Windows installieren und Server sowie Verbindung prüfen

Unter Windows können Sie MariaDB Server mit einem MSI-Paket installieren und als Dienst ausführen. Notieren Sie Dienstname, Port und Administratorkennwort und prüfen Sie anschließend die Clientverbindung sowie eine SQL-Abfrage, bevor Sie mit den Datenbankübungen beginnen.

Den Computer vor der Installation prüfen

Diese Anleitung beschreibt eine neue lokale Lerninstallation unter Windows 11 mit 64 Bit. Die Installation des MSI-Pakets und Änderungen an Diensten können Administratorrechte erfordern. Wenn MariaDB oder MySQL bereits vorhanden ist, unterscheiden Sie ein Upgrade der bestehenden Instanz von einer unabhängigen neuen Instanz. Die Einführung in MariaDB sowie Server und Client hilft bei der Auswahl der Komponenten.

Fragen Sie zunächst Dienste und lauschende Ports in PowerShell ab. Der Anzeigename eines Dienstes kann von seiner Eigenschaft Name abweichen. Ein unbekannter Name bedeutet nicht, dass seine Daten entbehrlich sind.

Get-Service | Where-Object { $_.Name -match 'MariaDB|MySQL' }
Get-NetTCPConnection -State Listen -LocalPort 3306 -ErrorAction SilentlyContinue

Auf einem Computer ohne vorhandenen Server ist eine leere Ausgabe normal. Wenn Sie einen Server finden, klären Sie dessen Zweck, bevor Sie ihn stoppen oder sein Datenverzeichnis wiederverwenden. Eine separate Instanz benötigt einen anderen Dienstnamen und bei belegtem Port einen anderen Port. Passen Sie sämtliche Verbindungsbefehle an den tatsächlich gewählten Port an.

MSI herunterladen und Komponenten auswählen

  1. Wählen Sie auf der offiziellen MariaDB-Downloadseite eine gepflegte stabile Version und deren Windows-x64-MSI-Paket. Vorabversionen sind nicht die Grundlage dieser Einrichtung für Einsteiger.
  2. Starten Sie das MSI-Paket, lesen Sie die Lizenz und gehen Sie bei Zustimmung zu den Bedingungen zu Custom Setup weiter. Stellen Sie sicher, dass Server, Client und die Komponente Database instance zur Einrichtung der Instanz ausgewählt sind.
  3. Notieren Sie Installationspfad und Datenverzeichnis. Die Beispiele verwenden C:\Program Files\MariaDB 12.3\; ersetzen Sie den Pfad durch Ihren tatsächlichen Pfad. Ein grafisches Werkzeug wie HeidiSQL ist für diese Kommandozeilenübungen optional.

Beschriftungen und Bildschirmaufbau können sich zwischen Versionen ändern. Die offizielle Anleitung zur MSI-Installation unter Windows erklärt die Instanzoptionen. Wählen Sie nicht allein deshalb ein Upgrade einer vorhandenen Instanz, weil der Assistent es anbietet.

Dienst, Administrator und Verbindung einrichten

Einstellung Auswahl für eine lokale Lerninstanz
root-Kennwort Ein starkes Kennwort wählen und sicher aufbewahren; root ist der Datenbankadministrator.
Entfernter root-Zugriff Für diese lokale Übung deaktiviert lassen.
Anonymes Konto Deaktiviert lassen.
Windows-Dienst Als Dienst installieren und tatsächlichen Namen notieren.
TCP-Port 3306 verwenden, wenn frei, andernfalls einen anderen Port notieren.
Zeichensatz Die UTF-8-Option des Installers ersetzt keine ausdrücklichen utf8mb4-Einstellungen der Datenbanken.

Das MariaDB-Administratorkennwort ist nicht Ihr Windows-Anmeldekennwort. Nach der Serverprüfung erstellen Sie ein separates Konto für SQL-Übungen. Lokaler Zugriff über 127.0.0.1 erfordert keine Freigabe des Ports für externe Netzwerke. Schließen Sie die Installation ab und notieren Sie Fehler, statt einen erfolgreichen Serverstart vorauszusetzen.

Dienst starten und Administratorverbindung prüfen

Wenn der Dienst MariaDB heißt, verwenden Sie diese PowerShell-Befehle. Ersetzen Sie den Namen, falls Sie einen anderen gewählt haben. Zum Starten kann eine als Administrator geöffnete PowerShell erforderlich sein.

Get-Service -Name MariaDB
Start-Service -Name MariaDB
Get-Service -Name MariaDB

Der abschließende Status soll Running lauten. Die Verknüpfung MariaDB Command Prompt kann das Clientverzeichnis bereits im Suchpfad enthalten. In einer normalen PowerShell vermeidet ein ausdrücklicher Programmpfad diese Abhängigkeit:

& "C:\Program Files\MariaDB 12.3\bin\mariadb.exe" --protocol=tcp --host=127.0.0.1 --port=3306 --user=root --password --default-character-set=utf8mb4

Der PowerShell-Operator & startet die ausführbare Datei mit dem in Anführungszeichen gesetzten Pfad. Verwenden Sie tatsächlichen Pfad und Port. Die Option --password ohne Wert fragt das Kennwort interaktiv ab, statt es in den Befehl zu schreiben. Führen Sie nach der Verbindung im Client Folgendes aus:

SELECT VERSION() AS server_version;
SELECT 1 + 1 AS result;

Der Server soll seine Version und das Rechenergebnis 2 zurückgeben. Einen Client ohne erfolgreiche Verbindung öffnen zu können, beweist keinen funktionierenden Server. Bei mehreren lokalen Servern prüfen Sie zunächst den Instanzport, bevor Sie die zurückgegebene Version zuordnen.

Ein Konto für die Übungsdatenbank erstellen

Verwenden Sie root zur Einrichtung und danach course_user zum Lernen. Prüfen Sie zuerst, ob dieser Name bereits existiert:

SELECT User, Host FROM mysql.user WHERE User = 'course_user';

Wenn ein Konto vorhanden ist, prüfen Sie Host und Zweck, bevor Sie es löschen oder neu erstellen. Ersetzen Sie für ein neues Kurskonto den folgenden Kennwortplatzhalter durch ein eigenes starkes Kennwort und führen Sie die Anweisungen als Administrator aus:

CREATE USER 'course_user'@'127.0.0.1'
  IDENTIFIED BY 'CHANGE_THIS_TO_YOUR_OWN_PASSWORD';

GRANT ALL PRIVILEGES ON shopcourse.*
  TO 'course_user'@'127.0.0.1';

SHOW GRANTS FOR 'course_user'@'127.0.0.1';

Der vollständige Kontoname umfasst Benutzer und Host. Diese Beispiele verwenden bewusst TCP mit 127.0.0.1 und erteilen Rechte für dieses Hostkonto. Der Bereich shopcourse.* erlaubt die Arbeit in der Übungsdatenbank einschließlich ihrer Erstellung, ohne globale Rechte oder die Berechtigung, anderen Benutzern Rechte zu erteilen. Dieser Bereich darf bereits vor der Erstellung der Datenbank freigegeben werden.

Eine produktive Anwendung benötigt normalerweise enger gefasste Rechte entsprechend ihrer Aufgabe. Die offiziellen Referenzen zu CREATE USER und GRANT erklären die Regeln.

Verlassen Sie den Client mit \q und verbinden Sie sich erneut vom Terminal aus. Der folgende Befehl setzt mariadb im Suchpfad voraus; verwenden Sie andernfalls wie zuvor den vollständigen Pfad mit dem Operator &.

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
SELECT CURRENT_USER() AS privilege_account;

Führen Sie das letzte SELECT in der neuen Verbindung aus. Das für Rechte verwendete Konto soll course_user@127.0.0.1 sein. --abort-source-on-error bereitet den Client darauf vor, die Verarbeitung einer SOURCE-Datei bei einem Fehler abzubrechen; die Option ändert keine Kontorechte. CREATE USER und GRANT wirken in diesem Verfahren ohne manuelles FLUSH PRIVILEGES.

Häufige Probleme eingrenzen

  • Dienst startet nicht: Prüfen Sie Name, Portkonflikt und Fehlerprotokoll dieser Instanz. Bewahren Sie das Datenverzeichnis auf.
  • Clientbefehl wird nicht gefunden: Verwenden Sie den tatsächlichen vollständigen Pfad oder den MariaDB Command Prompt der Installation.
  • Verbindung scheitert: Prüfen Sie, ob der gewünschte Dienst läuft und Host und Port zu ihm passen.
  • Access denied erscheint: Prüfen Sie Kennwort und Host des MariaDB-Kontos. Ein Authentifizierungsfehler ist etwas anderes als ein gestoppter Server.

Sichern Sie vor Änderungen an my.ini der Lerninstanz die Originaldatei und notieren Sie ihren Speicherort. Ändern Sie eine Option, starten Sie diese Instanz neu und prüfen Sie das Ergebnis. Stellen Sie die Sicherung wieder her, wenn die Änderung den Start verhindert. Einen Dienst zu stoppen, Software zu deinstallieren und Datenbankdateien zu löschen sind unterschiedliche Aktionen: Datenlöschung ist keine gewöhnliche Lösung für Anmeldefehler.