PDB Hilfe

So installieren Sie CockroachDB unter Windows 11

📅
🕑 6 Minuten Lesezeit

Der Einstieg in verteilte SQL-Datenbanken unter Windows 11 kann anfangs etwas einschüchternd wirken. Vielleicht möchten Sie neue Ideen ausprobieren oder einfach nur lernen, wie die Profis Skalierung und Hochverfügbarkeit umsetzen. Was auch immer Ihr Grund ist, die Installation von CockroachDB ist eine gute Wahl – die Datenbank ist modern, cloudfähig und bei Entwicklern, die sich mit verteilten Systemen beschäftigen, sehr beliebt. Ziel ist es, die Datenbank reibungslos zum Laufen zu bringen, damit Sie direkt auf Ihrem lokalen Rechner mit SQL in einer verteilten Umgebung experimentieren können. Es klingt kompliziert, aber mit den richtigen Schritten ist es auch für Einsteiger machbar.

Diese Anleitung führt Sie durch alle Schritte – vom Herunterladen und den Systemvoraussetzungen bis hin zum Starten Ihres ersten Clusters. Bonus: Sie lernen die Funktionsweise des Web-Dashboards kennen, führen SQL-Befehle aus und erstellen Ihre erste Datenbank. Manchmal kann es vorkommen, dass Windows Probleme mit Umgebungsvariablen oder Netzwerkports verursacht – daher habe ich einige dieser häufigen Schwierigkeiten ebenfalls berücksichtigt. Am Ende verfügen Sie über einen lokalen CockroachDB-Cluster, der bereit ist, Ihre Lern- oder Testanforderungen zu erfüllen.

So installieren Sie CockroachDB unter Windows 11

Dateien herunterladen und vorbereiten

Laden Sie zunächst die neueste CockroachDB-Windows-ZIP-Datei von der offiziellen Website herunter. Normalerweise erkennt die Website Ihr Betriebssystem und zeigt Ihnen den passenden Download-Link an.Überprüfen Sie aber zur Sicherheit, ob Sie die Windows-Version herunterladen. Speichern Sie die Datei nach dem Download im Ordner „Downloads“ (oder auf dem Desktop, falls das einfacher ist).Sie müssen den Installer nicht ausführen – CockroachDB wird als ZIP-Archiv bereitgestellt, was praktisch ist, da es die Datei flexibel und ressourcenschonend hält.

Entpacken Sie die ZIP-Datei.

Klicken Sie mit der rechten Maustaste auf die ZIP-Datei, wählen Sie „ Alle extrahieren“ und anschließend einen einfachen Speicherort – ich verwende normalerweise C:\CockroachDB. So ist die Datei später leichter wiederzufinden. Suchen Sie nach dem Extrahieren im Ordner nach der Datei „ cockroach.exe. Dies ist die zentrale ausführbare Datei für die Interaktion mit der Datenbank“.Drag & Drop im Windows Explorer funktioniert zwar auch, aber stellen Sie sicher, dass alle Dateien korrekt entpackt wurden, bevor Sie mit dem nächsten Schritt fortfahren.

Verschieben Sie den Ordner an einen festen Speicherort

Es mag etwas ungewöhnlich klingen, aber es ist ratsam, den CockroachDB-Ordner an einem festen Ort außerhalb von Downloads oder Desktop zu speichern – beispielsweise unter C:\CockroachDB. So vermeiden Sie versehentliches Löschen und unnötige Ordnerstrukturen. Wenn Sie die Übersicht behalten möchten, kopieren Sie den Ordner einfach nach C: oder in den Ordner „Programme“ (führen Sie ihn dabei aber unbedingt als Administrator aus).Windows neigt dazu, Dateien im Download-Ordner manchmal zu vergessen, insbesondere nach Updates oder Aufräumarbeiten.

Fügen Sie CockroachDB zum Windows-Pfad hinzu

Dies ist der wichtigste Schritt: Ihr System muss den Befehl „cockroach“ in jedem Terminalfenster erkennen.Öffnen Sie das Startmenü, suchen Sie nach „Umgebungsvariablen“ und wählen Sie „Systemumgebungsvariablen bearbeiten“. Klicken Sie anschließend auf „Umgebungsvariablen“. Suchen Sie unter „Systemvariablen“ den Eintrag „ Path“ und klicken Sie auf „Bearbeiten“.

  • Klicken Sie auf Neu
  • Geben Sie den vollständigen Pfad zu dem Verzeichnis ein, in dem Sie CockroachDB extrahiert haben, z. B.C:\CockroachDB\cockroach-v25.1.0.windows-6.2-amd64

Gehen Sie genauso vor, als würden Sie einen neuen Ordner zu Ihrem System hinzufügen und anschließend alle Dialogfelder mit „OK“ bestätigen. So können Sie die Eingabeaufforderung oder das Windows Terminal überall öffnen und cockroachBefehle ausführen, ohne sich mit Ordnerstrukturen herumschlagen zu müssen. Manchmal benötigt Windows einen Neustart, um den neuen Pfad vollständig zu erkennen. Vergessen Sie diesen Schritt also nicht, falls Befehle nicht sofort erkannt werden.

Überprüfen Sie die Installation

Öffnen Sie das Windows-Terminal oder die Eingabeaufforderung und geben Sie Folgendes ein:

cockroach version

Drücken Sie die Eingabetaste und warten Sie. Bei korrekter Einrichtung sollten Versionsinformationen angezeigt werden. Prima! Falls eine Meldung wie „Cockroach wird nicht erkannt“ erscheint, überprüfen Sie die PATH-Konfiguration erneut – möglicherweise fehlt ein Ordner oder Sie müssen Ihren Computer neu starten.

Starten Sie einen lokalen CockroachDB-Knoten

Jetzt ist es an der Zeit, den Schlüssel umzudrehen und das Ding zu starten. Führen Sie im Terminal folgenden Befehl aus:

cockroach start-single-node --insecure

Dadurch wird ein Einzelknoten-Cluster initialisiert (ideal für lokale Tests).Möglicherweise sehen Sie einige Protokollmeldungen – das ist normal. Sobald der Server stabil läuft und eine URL wie http://localhost:8080 angezeigt wird, ist er betriebsbereit und die Weboberfläche erreichbar. Lassen Sie dieses Fenster geöffnet, da der Server darauf angewiesen ist.

Stellen Sie eine Verbindung zur SQL-Shell her.

Öffnen Sie ein weiteres Terminalfenster und führen Sie folgenden Befehl aus:

cockroach sql --insecure

Sie befinden sich nun in der interaktiven Shell. Die Eingabeaufforderung sollte wie folgt aussehen root@localhost:26257/defaultdb>:.Probieren Sie einige Befehle aus —

  • SHOW DATABASES;
  • CREATE DATABASE mytest;
  • USE mytest;
  • CREATE TABLE users (id INT PRIMARY KEY, name STRING);
  • INSERT INTO users VALUES (1, 'Liam');
  • SELECT * FROM users;

Wenn alles einwandfrei angezeigt wird, herzlichen Glückwunsch – die Datenbank steht Ihnen nun offen.

Zugriff auf das Web-Dashboard

Öffnen Sie Ihren Browser und rufen Sie http://localhost:8080 auf. Dort finden Sie detaillierte Statistiken, Knoteninformationen und die Abfrageleistung – hilfreich, wenn Sie das Verhalten von CockroachDB verstehen oder Ihren kleinen Cluster überwachen möchten. Obwohl es sich um eine lokale Anwendung handelt, bietet dieses Dashboard einen Einblick in die Funktionsweise eines realen verteilten Systems.

Server stoppen

Schließen Sie nach Abschluss der Arbeit nicht einfach alle Fenster. Gehen Sie zurück zu Ihrem Serverterminal und drücken Sie die entsprechende Taste Ctrl + C. CockroachDB wird ordnungsgemäß beendet. Warten Sie, bis der Vorgang abgeschlossen ist, und schließen Sie dann Ihre Fenster. Dies verhindert Datenbeschädigung und das Verbleiben von Prozessen.

Was schiefgehen kann (und wie man es behebt)

Kakerlaken-Befehl nicht gefunden

Wenn Ihr Terminal die Fehlermeldung „cockroach“ anzeigt, liegt das fast immer an einem Problem mit der PATH-Umgebungsvariablen.Überprüfen Sie, ob der zuvor hinzugefügte Ordnerpfad korrekt ist. Manchmal behebt ein Neustart das Problem, manchmal müssen Sie die Umgebungsvariablen neu konfigurieren.

Blockiert Windows Defender es?

Das kann vorkommen, insbesondere beim ersten Start. Falls Windows Sicherheitswarnungen anzeigt, erteilen Sie einfach die Berechtigung für die Datei cockroach.exe oder fügen Sie eine Ausnahme hinzu. Es ist zwar lästig, aber Windows ist hier übervorsichtig.

Hafenkonflikte

CockroachDB verwendet standardmäßig Port 26257 und 8080 für das Dashboard. Falls diese Ports bereits von einer anderen Anwendung belegt sind, startet der Server nicht.Überprüfen Sie dies mit netstat--listen-addr oder Ihrem Task-Manager und beenden Sie entweder die betreffende Anwendung oder geben Sie mithilfe von Parametern wie `–port` oder `–port` andere Ports an --http-addr.

Häufig gestellte Fragen

Ist CockroachDB kostenlos für Windows 11?

Ja. Die Community-Version ist kostenlos und eignet sich perfekt zum Testen, Lernen oder für kleinere Projekte.

Kann ich CockroachDB offline betreiben?

Absolut. Nach dem Herunterladen und Installieren ist keine Internetverbindung mehr nötig – alles läuft lokal.

Ist es anfängerfreundlich?

Absolut. Verteilte Datenbanken klingen zwar komplex, aber dank der CLI und der Web-Oberfläche von CockroachDB ist der Einstieg überraschend einfach. Man sollte sich lediglich auf einige neue Konzepte zu Skalierung und Fehlertoleranz einstellen.

Ähnlich wie PostgreSQL?

Ja, es unterstützt PostgreSQL-kompatible SQL-Syntax. Wenn Sie also PostgreSQL gewohnt sind, sollte der Übergang reibungsloser verlaufen.

Docker erforderlich?

Nein, überhaupt nicht. Sie können es direkt ohne Docker installieren – folgen Sie einfach den oben genannten Schritten.

Ist es mit Programmiersprachen kompatibel?

Absolut. Es bietet Treiber und Clients für Sprachen wie Python, Java, Node.js, Go, PHP – was auch immer Sie ausprobieren möchten.

Hoffentlich hilft das jemandem bei der Ersteinrichtung, ohne dass man sich die Haare raufen muss. Im Idealfall läuft alles wie am Schnürchen. Ich drücke die Daumen!