> ## 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 -e MYSQL_ALLOW_EMPTY_PASSWORD=yes -p 3306:3306 villagesql/server:stable
```

### 选项 B：Shell 脚本

使用官方安装脚本直接在您的机器上安装 VillageSQL。它会下载并配置适用于您平台的服务器二进制文件。

```bash theme={null}
curl https://villagesql.com/shell | sh
```

在运行脚本之前检查脚本：`curl https://villagesql.com/shell | less`

### 选项 C：从源代码构建

对于开发或自定义构建，请按照[从源代码克隆和构建指南](/docs/zh/mysql-8.4/0.0.4/source)进行操作，以从最新代码进行编译。

## 步骤 2：连接到服务器

服务器运行后，使用任何标准的 MySQL 客户端进行连接：

```bash theme={null}
mysql -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/zh/mysql-8.4/0.0.4/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/zh/mysql-8.4/0.0.4/managing">
    了解如何安装和管理其他扩展。
  </Card>

  <Card title="创建扩展" icon="code" href="/docs/zh/mysql-8.4/0.0.4/create">
    了解如何为 VillageSQL 构建您自己的扩展。
  </Card>

  <Card title="升级指南" icon="arrow-up" href="/docs/guides/upgrade">
    从先前版本升级或从 MySQL 迁移。
  </Card>
</CardGroup>

## 故障排除

### 服务器无法启动

常见问题：

* 端口 3306 已经被占用：配置您的服务器以使用不同的端口
* 权限：确保文件可读/可执行