CockroachDBをWindows 10にクリーンインストールする手順を以下に示します。この手順に従うことで、エラーを回避し、スムーズにインストールできるはずです。
---
### **前提条件**
1. **Windows 10**が最新の状態であることを確認してください。
2. **管理者権限**を持つアカウントでログインしていることを確認してください。
3. **インターネット接続**が安定していることを確認してください。
---
### **手順 1: CockroachDBのバイナリをダウンロード**
1. ブラウザで [CockroachDBの公式ダウンロードページ](https://www.cockroachlabs.com/docs/stable/install-cockroachdb-windows.html) にアクセスします。
2. Windows用のバイナリ(`.zip`ファイル)をダウンロードします。
- 例: `cockroach-v23.1.11.windows-6.2-amd64.zip`
---
### **手順 2: バイナリを解凍**
1. ダウンロードした`.zip`ファイルを右クリックし、「すべて展開」を選択します。
2. 解凍先のフォルダを指定します(例: `C:\cockroach`)。
3. 解凍されたフォルダ内に`cockroach.exe`が含まれていることを確認します。
---
### **手順 3: 環境変数にパスを追加**
1. **スタートメニュー**から「環境変数を編集」を検索し、開きます。
2. 「システムのプロパティ」ウィンドウで、「環境変数」ボタンをクリックします。
3. 「システム環境変数」セクションで、`Path`を選択し、「編集」をクリックします。
4. 「新規」をクリックし、CockroachDBのバイナリが含まれるフォルダのパスを追加します(例: `C:\cockroach`)。
5. 「OK」をクリックして変更を保存します。
---
### **手順 4: CockroachDBの動作確認**
1. **コマンドプロンプト**または**PowerShell**を開きます。
2. 以下のコマンドを実行して、CockroachDBが正しくインストールされたことを確認します。
```bash
cockroach version
```
- インストールされたバージョンが表示されれば成功です。
---
### **手順 5: ローカルクラスターの起動**
1. 以下のコマンドを実行して、ローカルでシングルノードのCockroachDBクラスターを起動します。
```bash
cockroach start-single-node --insecure --listen-addr=localhost
```
- `--insecure`: セキュリティを無効化(開発環境用)。
- `--listen-addr=localhost`: ローカルホストでのみリッスン。
2. 別のコマンドプロンプトまたはPowerShellを開き、以下のコマンドでクラスターに接続します。
```bash
cockroach sql --insecure --host=localhost
```
- SQLシェルが起動し、データベース操作が可能になります。
---
### **手順 6: データベースの作成と操作**
1. SQLシェルで以下のコマンドを実行し、新しいデータベースを作成します。
```sql
CREATE DATABASE testdb;
```
2. データベースを選択します。
```sql
USE testdb;
```
3. テーブルを作成し、データを挿入します。
```sql
CREATE TABLE users (id INT PRIMARY KEY, name STRING);
INSERT INTO users VALUES (1, 'Alice'), (2, 'Bob');
SELECT * FROM users;
```
---
### **トラブルシューティング**
- **エラー: `cockroach`コマンドが認識されない**
- 環境変数の設定が正しく行われていない可能性があります。手順3を再確認してください。
- **ポートの競合**
- デフォルトのポート(26257など)が他のアプリケーションで使用されている場合、`--listen-addr`や`--http-addr`オプションで別のポートを指定してください。
---
### **アンインストール方法**
1. CockroachDBのバイナリを含むフォルダを削除します(例: `C:\cockroach`)。
2. 環境変数からパスを削除します(手順3を逆に実行)。
---
この手順に従えば、Windows 10にCockroachDBをクリーンインストールし、ローカルで動作させることができます。開発やテスト環境での利用に適していますが、本番環境ではセキュリティ設定やクラスター構成を適切に行う必要があります。