> ## 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/ko/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/ko/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/ko/mysql-8.4/0.0.5/managing">
    다른 확장을 설치하고 관리하는 방법을 배웁니다.
  </Card>

  <Card title="확장 만들기" icon="code" href="/docs/ko/mysql-8.4/0.0.5/create">
    VillageSQL용 자체 확장을 구축하는 방법을 배웁니다.
  </Card>

  <Card title="업그레이드 가이드" icon="arrow-up" href="/docs/guides/upgrade">
    이전 버전에서 업그레이드하거나 MySQL에서 마이그레이션하는 방법.
  </Card>
</CardGroup>

## 문제 해결

### 서버 시작 안됨

흔한 문제:

* 포트 3306이 이미 사용 중: 서버를 다른 포트로 구성하세요
* 권한: 파일이 읽기/실행 가능하도록 확인하세요