Windows 11にCockroachDBをインストールする方法

Windows 11 で分散 SQL データベースを使い始めるのは、最初は少し難しく感じるかもしれません。新しいアイデアを試しているのかもしれませんし、大手企業がどのようにスケーリングと高可用性を実現しているかを学びたいだけかもしれません。理由は何であれ、CockroachDBをインストールするのは賢明な選択です。最新のクラウド対応で、分散システムを試している開発者の間で非常に人気があります。ここでは、CockroachDB をスムーズに起動して、ローカルマシン上で分散環境で SQL の実験を開始できるようにすることが目標です。複雑に聞こえるかもしれませんが、正直なところ、正しい手順を踏めば、初心者でも十分に可能です。

このガイドでは、ダウンロード、システム要件から最初のクラスターの起動まで、すべてを順を追って説明します。さらに、Webダッシュボードの使い方、SQLコマンドの実行方法、最初のデータベースの作成方法もご紹介します。Windowsでは環境変数やネットワークポートで問題が発生することがあるため、よくあるトラブルについても解説しています。このガイドを読み終える頃には、学習やテストに必要なローカルのCockroachDBクラスターが構築されているはずです。

Windows 11にCockroachDBをインストールする方法

ファイルをダウンロードして準備する

まず、公式サイトから最新のCockroachDB Windows版ZIPファイルをダウンロードしてください。通常、ウェブサイトはOSを自動的に検出し、適切なダウンロードリンクを表示しますが、Windows版をダウンロードしていることを確認してください。ダウンロード後、ダウンロードフォルダ（またはデスクトップ）に保存してください。インストーラーを実行する必要はありません。CockroachDBはZIPアーカイブとして提供されるため、柔軟性と軽量性を保つことができます。

ZIPファイルを解凍してください。

ZIPファイルを右クリックし、「すべて展開」を選択して、分かりやすい場所を選択します。私は通常、C:\CockroachDBを選択します。こうすることで、後で簡単に見つけることができます。展開後、フォルダ内を調べて、cockroach.exeデータベースとやり取りするためのコア実行ファイルを探します。正直なところ、Windowsエクスプローラーのドラッグアンドドロップで問題なく動作しますが、次のステップに進む前に、すべてが正しく解凍されていることを確認してください。

フォルダを恒久的な場所に移動する

ちょっと変かもしれませんが、CockroachDBフォルダはダウンロードフォルダやデスクトップ以外の場所（例えばC:\CockroachDBなど）に保存しておくのがおすすめです。こうすることで、誤って削除したり、フォルダが散らかったりするのを防ぐことができます。整理整頓したい場合は、CドライブやProgram Filesフォルダにコピー＆ペーストするだけでも構いません（ただし、その場合は管理者として実行してください）。Windowsは、特にアップデートやクリーンアップの後などに、ダウンロードフォルダ内のファイルを忘れてしまうことがあるからです。

CockroachDBをWindowsのPATHに追加する

これが最も重要な部分です。どのターミナルウィンドウからでも「cockroach」コマンドをシステムが認識するようにします。スタートメニューを開き、「環境変数」を検索して、「システム環境変数の編集」を選択します。次に、「環境変数」をクリックします。 「システム変数」の下にある「Path」という名前の変数を見つけて、「編集」をクリックします。

「新規」をクリック
CockroachDB を解凍した場所への完全なパスを入力してください。例:C:\CockroachDB\cockroach-v25.1.0.windows-6.2-amd64

システムに新しいフォルダを追加するのと同じように操作し、表示されるダイアログで「OK」をクリックしてください。こうすることで、コマンドプロンプトやWindowsターミナルをどこからでも開いて、cockroachフォルダを気にすることなくコマンドを実行できます。新しいPATHを完全に認識させるにはWindowsの再起動が必要な場合があるので、コマンドがすぐに認識されない場合は再起動を忘れないでください。

インストールを確認する

Windowsターミナルまたはコマンドプロンプトを開き、以下を入力します。

cockroach version

Enterキーを押してしばらくお待ちください。設定が正しければ、バージョン情報が表示されます。素晴らしい！「cockroach」が認識されないなどのメッセージが表示された場合は、PATHの設定手順を再度確認してください。フォルダが抜けているか、マシンを再起動する必要があるかもしれません。

ローカルのCockroachDBノードを起動する

さあ、キーを回してエンジンをかけましょう。ターミナルから、以下のコマンドを実行してください。

cockroach start-single-node --insecure

これにより、シングルノードクラスタが初期化されます（ローカルテストに最適です）。ログが大量にスクロール表示されることがありますが、これは正常です。安定してhttp://localhost:8080のような URL が表示されたら、サーバーが起動し、Web UI にアクセスできるようになります。サーバーはこのウィンドウに依存しているため、ウィンドウを開いたままにしておいてください。

SQLシェルに接続します

別のターミナルウィンドウを開いて、以下を実行します。

cockroach sql --insecure

これで対話型シェルに入りました。プロンプトは次のようになりますroot@localhost:26257/defaultdb>。いくつかのコマンドを試してみてください。

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;

すべて問題なく表示されれば、おめでとうございます。これでデータベースはあなたの思いのままです。

ウェブダッシュボードにアクセス

ブラウザを開いて、http://localhost:8080にアクセスしてください。ここでは、詳細な統計情報、ノード情報、クエリパフォーマンスを確認できます。これは、CockroachDB の動作を理解したい場合や、小規模なクラスタを監視したい場合に役立ちます。ローカル環境ではありますが、このダッシュボードは実際の分散システムがどのようなものかを知る手がかりとなります。

サーバーを停止しています

完了したら、むやみにすべてを閉じないでください。サーバーのターミナルに戻り、キーを押してくださいCtrl + C。CockroachDBは安全にシャットダウンします。完了するまで待ってから、ウィンドウを閉じてください。これにより、データの破損やプロセスが残ってしまうのを防ぐことができます。

何が問題になる可能性があるか（そしてその対処法）

ゴキブリコマンドが見つかりません

ターミナルに「cockroach」が認識されないというエラーが表示される場合、ほとんどの場合、PATH の問題です。以前追加したフォルダパスが正しいかどうかを再度確認してください。再起動で解決する場合もあれば、環境変数の設定を見直す必要がある場合もあります。

Windows Defenderがブロックしている？

これは特に初回起動時に発生する可能性があります。Windowsセキュリティからポップアップが表示された場合は、cockroach.exeファイルへのアクセスを許可するか、例外設定を追加してください。煩わしいですが、これはWindowsが過剰に警戒しているためです。

港湾紛争

CockroachDB はデフォルトでポート 26257 を使用し、ダッシュボードには 8080 を使用します。他のアプリケーションがこれらのポートを使用している場合、サーバーは起動しません。netstatまたはタスクマネージャーで確認し、競合するアプリケーションを停止するか、またはなどのフラグを使用して別のポートを指定して--listen-addrください--http-addr。

よくある質問

CockroachDBはWindows 11で無料で利用できますか？

はい。コミュニティ版は無料で、テスト、学習、小規模プロジェクトに最適です。

CockroachDBはオフラインで実行できますか？

もちろんです。ダウンロードしてインストールすれば、インターネット接続は不要です。すべてローカルで動作します。

初心者向けですか？

確かに。分散データベースは複雑そうに聞こえますが、CockroachDBのCLIとWeb UIは、初心者でも驚くほど簡単に扱えます。ただし、スケーリングとフォールトトレランスに関する新しい概念を理解する準備をしておいてください。

PostgreSQLに似ていますか？

はい、PostgreSQL互換のSQL構文をサポートしているので、PostgreSQLに慣れている方なら、移行はよりスムーズになるでしょう。

Dockerが必要ですか？

いいえ、全く問題ありません。Dockerを使わずに直接インストールできます。上記の手順に従ってください。

プログラミング言語に対応していますか？

もちろんです。Python、Java、Node.js、Go、PHPなど、試してみたい言語に対応したドライバとクライアントが用意されています。

これで、誰かが頭を抱えることなく初期設定を終えられることを願っています。調子が良ければ、すべてがスムーズに進むはずです。これが役に立つことを祈っています！