> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

> VillageSQL Server をセットアップして使い始めましょう。

VillageSQL Server インスタンスを起動し、接続して、拡張機能システムを試してみましょう。

## ステップ 1: VillageSQL のインストール

### オプション A: Docker (推奨)

ホスト側にインストールすることなく、コンテナで VillageSQL を実行します。

```bash theme={null}
docker run -d --name vsql -e MYSQL_ALLOW_EMPTY_PASSWORD=yes -p 3306:3306 villagesql/server:stable
```

### オプション B: シェルスクリプト

公式のインストールスクリプトを使用して、マシンに VillageSQL を直接インストールします。これにより、サーバーバイナリがダウンロードされ、プラットフォーム用に構成されます。

```bash theme={null}
curl -fsSL https://install.villagesql.com | bash
```

スクリプトを実行する前に確認するには: `curl -fsSL https://install.villagesql.com | less`

### オプション C: ソースコードからのビルド

開発またはカスタムビルドの場合は、[ソースコードからのクローンとビルドガイド](/docs/ja/mysql-8.4/0.0.5/source)に従って、最新のコードからコンパイルします。

## ステップ 2: サーバーへの接続

サーバーが起動したら、任意の標準の MySQL クライアントを使用して接続します。

```bash theme={null}
mysql -h 127.0.0.1 -P 3306 -u root -p
```

## ステップ 3: 最初の拡張機能のインストール

VillageSQL には、すぐにインストールできるサンプル拡張機能が付属しています。

`vsql_complex` 拡張機能をインストールして、複素数のサポートを追加します。

```sql theme={null}
INSTALL EXTENSION vsql_complex;
```

インストールを確認します。

```sql theme={null}
SELECT * FROM INFORMATION_SCHEMA.EXTENSIONS;
```

`vsql_complex` がリストされているはずです。

詳細については、[拡張機能のインストール](/docs/ja/mysql-8.4/0.0.5/install) を参照してください。

## ステップ 4: 拡張データ型の使用

拡張機能がアクティブになったので、テーブルで `COMPLEX` データ型をネイティブ型と同様に使用できます。

```sql theme={null}
-- Create a database and use it
CREATE DATABASE demo;
USE demo;

-- Create a table using the new COMPLEX type
CREATE TABLE electronic_components (
    id INT PRIMARY KEY,
    name VARCHAR(50),
    impedance COMPLEX
);

-- Insert complex number values (using string literals)
INSERT INTO electronic_components VALUES
    (1, 'Resistor', '(100,0)'),
    (2, 'Inductor', '(0,50)'),
    (3, 'Capacitor', '(25,-75)');

-- Query the data
SELECT * FROM electronic_components;

-- Use extension functions
SELECT
    name,
    impedance,
    complex_abs(impedance) AS magnitude,
    complex_real(impedance) AS resistance,
    complex_imag(impedance) AS reactance
FROM electronic_components;
```

拡張機能をアンインストールするには:

```sql theme={null}
UNINSTALL EXTENSION vsql_complex;
```

## 次のステップ

VillageSQL を起動し、拡張機能システムを検証したので、さらに詳しく調べてみましょう。

<CardGroup cols={2}>
  <Card title="拡張機能の管理" icon="puzzle-piece" href="/docs/ja/mysql-8.4/0.0.5/managing">
    他の拡張機能をインストールおよび管理する方法を学びます。
  </Card>

  <Card title="拡張機能の作成" icon="code" href="/docs/ja/mysql-8.4/0.0.5/create">
    VillageSQL 用に独自の拡張機能を作成する方法を学びます。
  </Card>

  <Card title="アップグレードガイド" icon="arrow-up" href="/docs/guides/upgrade">
    以前のバージョンからのアップグレード、または MySQL からの移行。
  </Card>
</CardGroup>

## トラブルシューティング

### サーバーが起動しない

一般的な問題:

* ポート 3306 がすでに使用されている: 別のポートを使用するようにサーバーを構成してください。
* 権限: ファイルが読み取り/実行可能であることを確認します。