PDB ヘルプ

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

📅
🕑 1 分で読む

Windows 11 に Cassandra をインストールするのは、特に Java と環境変数に大きく依存しているため、準備不足だと少し面倒な作業になることがあります。すべてインストールした後でも、コマンドラインが Cassandra コマンドを認識しなかったり、CQLSH が接続できなかったりすることがあります。私も経験済みです。すべてセットアップしたのに、これらの癖をいくつか理解するまで何も動作しませんでした。これらの手順が、Java が検出されない、Cassandra が正しく起動しないなど、よくある問題を回避するのに役立つことを願っています。設定が完了すれば、開発やテストのために Windows 上で Cassandra を実行するのは実際にはかなりスムーズですが、もちろん、Windows では Linux に比べて少し複雑に感じられるだけです。

Windows 11でCassandraのインストールに関する問題を解決する方法

Javaが正しくインストールされ、認識されていることを確認してください。

よくある問題の一つに、Javaが正しく検出されないためにCassandraが起動しないというものがあります。CassandraはJavaを必要とし、JAVA_HOMEなどの環境変数に依存しています。JavaをインストールしたにもかかわらずコマンドプロンプトがJavaを見つけられない場合、Cassandraは起動せず、CQLSHでエラーが発生します。この問題を解決するには、JavaがシステムPATHに含まれていること、およびJAVA_HOMEが正しいフォルダを指していることを再確認してください。

  • スタートメニューを開き、「システムの詳細設定の表示」を検索するか、このPCを右クリックして「プロパティ」>「システムの詳細設定」を選択します。
  • 「環境変数」をクリックしてください。
  • システム変数で、 JAVA_HOMEを探すか作成します。
  • その値をJavaのインストールパスに設定します。例: C:\Program Files\Java\jdk-21。
  • %JAVA_HOME%\bin を Path 変数に追加します。編集 をクリックし、次に 新規 をクリックして、それを貼り付けます。

これは、WindowsがCassandraにJavaの場所を伝えるのに役立ちます。環境によっては、JAVA_HOMEを設定するだけでは不十分で、Pathにも追加する必要があります。

CASSANDRA_HOMEとPATHを適切に設定する

次に、WindowsにCassandraの場所を伝える必要があります。手順は同じで、環境変数を使用します。

  • Cassandraフォルダを指すCASSANDRA_HOME変数を作成します。例: C:\Cassandra\apache-cassandra-5.0。
  • システムのパスに%CASSANDRA_HOME%\binを追加することを忘れないでください。そうすれば、どこからでもコマンドを実行できます。これは非常に時間の節約になります。

これらの設定後、コマンドプロンプトまたはPowerShellを再起動して、環境変数が再読み込みされていることを確認してください。 と で確認してくださいecho %JAVA_HOME%。echo %CASSANDRA_HOME%正しいパスが表示されていれば、問題ありません。

CQLSH用のPythonをインストールする

これは多くの人がつまずく点です。特に、CassandraのコマンドラインインターフェースであるCQLSHはPythonを必要とすることが多いためです。Pythonがないと、「Pythonが見つかりません」というエラーが表示されたり、起動すらできない場合があります。python.orgからPythonをダウンロードし、インストーラーを実行して、「PythonをPATHに追加する」にチェックが入っていることを確認してください。

コマンドラインを開いて、と入力してくださいpython --version。バージョン番号が表示されるはずです。表示されない場合は、再インストールを試してください。インストール後にPATHが正しく更新されない場合があります。

Cassandraを正しく起動する

すべての環境変数が設定され、JavaとPythonが適切な場所に配置されたら、コマンドプロンプトを管理者として開きます。binディレクトリに移動します。例:

cd C:\Cassandra\apache-cassandra-5.0\bin

そして走る：

cassandra

これによりサーバーが起動します。完全にロードされるまで1～2分かかる場合があり、ログがスクロール表示されますが、これは正常です。しばらく経っても何も起こらない場合は、\logsフォルダ内のログを確認して手がかりを探してください。Windowsファイアウォールがポート（9042、7000、7199）をブロックしていないことを確認してください。アクセス許可のプロンプトが表示された場合は、アクセスを許可してください。

CQLSHの起動と接続

サーバーが起動したら、新しいコマンドプロンプトを開き、再度 に移動して\bin、 と入力しますcqlsh。すべてが正しく設定されていれば、次のようなプロンプトが表示されます。

Connected to Test Cluster at 127.0.0.1:9042

これは、Cassandraが稼働状態にあることを意味します。これで、ドキュメントにあるように、キースペースやテーブルの作成を開始できます。例:

CREATE KEYSPACE testdb WITH replication = { 'class': 'SimpleStrategy', 'replication_factor': 1 };

その後：

USE testdb;

通常、接続エラーが発生する場合は、環境設定を見直したり、ポートの競合やファイアウォールの問題がないか確認してください。環境変数を設定した後、マシンを再起動するだけで問題が解決する場合もあります。

現場からの追加ヒント：

  • コマンドプロンプトを管理者として実行してください。Cassandraはポートを割り当てるために、より高い権限を必要とする場合があります。
  • 次のようなシンプルなパスを使用してくださいC:\Cassandra。ネストされたフォルダーなど、複雑すぎるパスを使用すると、Windows はパスの問題を報告します。
  • Cassandra の起動時に Java のバージョンに関するエラーや見つからないエラーが発生する場合は、 JAVA_HOMEのパスを再確認してください。
  • CQLSHが起動しない場合は、Pythonがインストールされていることを確認し、PATH環境変数に追加してください。

正直なところ、環境によっては初回起動時に完璧に動作しない場合もあります。再起動したり、環境変数を再確認したりする必要があるかもしれません。Windowsはとかく物事を複雑にしがちですが、一度設定が完了すれば、Cassandraは非常にスムーズに動作します。

まとめ

  • Javaがインストールされていること、およびJAVA_HOMEが正しく設定されていることを確認してください。
  • JavaとCassandraのバイナリをシステムパスに追加してください。
  • CASSANDRA_HOMEが展開したフォルダを指していることを確認してください。
  • CQLSHを問題なく使用したい場合は、Pythonをインストールしてください。
  • Cassandraをコマンドラインから管理者権限で実行してください。
  • 新しいプロンプトからCQLSHを起動して、ローカルクラスターに接続してください。

まとめ

Windows 11でCassandraを動作させるのは、まるで堂々巡りのように感じるかもしれませんが、環境変数が修正され、サーバーが起動すれば、状況は一変します。以下の手順に従い、ログファイルに注意を払い、起動中は辛抱強く待ちましょう。Cassandraは通常Linux環境に適しているため、WindowsマシンでCassandraが動作するのを見るのは非常にやりがいがあります。この情報が、誰かが頭を抱えたり、何時間もトラブルシューティングに費やしたりするのを防げることを願っています。環境パスには注意してください。Windowsは環境パスに関して非常にうるさいのです。