> ## 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 소개

> 환영합니다! VillageSQL은 MySQL을 위한 혁신 플랫폼이며, 에이전틱 AI 시대의 MySQL을 위한 새로운 길입니다. VillageSQL 문서는 VillageSQL Server 배포, 확장 기능 설치, 확장 기능 빌드에 대한 안내와 MySQL 학습 가이드를 제공합니다.

## VillageSQL Server란 무엇인가요?

VillageSQL Server는 에이전틱 AI 시대를 위한 확장 기능을 갖춘 MySQL의 드롭인 대체품입니다. 확장 프레임워크를 통해 누구나 허락을 구하지 않고, 서버 코드를 변경하지 않고도 사용자 정의 데이터 유형과 사용자 정의 함수를 서버에 추가할 수 있습니다.

## 시작하기

> [!TIP]
>
> **코딩 에이전트에게 VillageSQL 설치를 맡기세요.** 다음 내용을 코딩 에이전트의 채팅에 붙여넣으세요:
>
> ```text wrap theme={null}
> Set me up for VillageSQL. Fetch https://villagesql.com/llms.txt and follow its setup steps.
> ```
>
> 에이전트는 VillageSQL 에이전트 스킬을 설치하고, 서버를 설치한 다음, 서버가 동작하는지 확인하기 위해 확장 기능을 하나 로드합니다.

> [card] [빠른 시작](https://villagesql.com/docs/ko/quickstart.md)
>
> VillageSQL을 설치하고 첫 번째 데이터베이스를 실행해 보세요.

> [card] [GitHub의 VillageSQL](https://github.com/villagesql/villagesql-server)
>
> 소스 코드를 확인하고 프로젝트에 기여하세요.

## MySQL용 확장 기능

확장 기능은 실행 중인 VillageSQL 서버에 기능을 추가합니다. 확장 기능이 추가할 수 있는 것:

* **사용자 정의 데이터 유형:** `UUID`, `COMPLEX`, `INET` 같은 InnoDB 열용 새 유형으로, 내장 유형처럼 사용합니다.
* **사용자 정의 함수:** C++ 또는 Rust로 작성하여 SQL에서 호출하는 함수입니다.

확장 기능은 SQL로 추가하고 제거합니다: `INSTALL EXTENSION`과 `UNINSTALL EXTENSION`.

설치할 수 있는 확장 기능은 [확장 기능 카탈로그](https://villagesql.com/docs/ko/extensions/catalog)를 참조하세요.

### 확장 기능 빌드하기

[확장 기능 템플릿](https://github.com/villagesql/vsql-extension-template)으로 시작하고 [C++ 가이드](https://villagesql.com/docs/en/guides/cpp-extensions.md) 또는 [Rust 가이드](https://villagesql.com/docs/en/guides/rust-extensions.md)를 따르세요. AI의 도움을 받는 안내형 워크플로를 원한다면 [Extension Builder](https://villagesql.com/agent-skills)를 사용해 보세요.

## 왜 VillageSQL인가요?

> [card] 드롭인 호환성
>
> VillageSQL은 MySQL 프로토콜을 사용하므로 기존 MySQL 클라이언트와 드라이버가 그대로 연결됩니다.

> [card] 확장 가능한 코어
>
> `INSTALL EXTENSION`으로 실행 중인 서버에 기능을 추가합니다. 서버를 재시작할 필요가 없습니다.

> [card] 열린 생태계
>
> 누구나 확장 기능을 만들 수 있습니다. 카탈로그에는 커뮤니티가 만든 확장 기능과 VillageSQL이 만든 확장 기능이 나란히 나열됩니다.

> [card] 익숙한 도구
>
> `mysqld`와 `mysql` 클라이언트처럼 이미 알고 있는 MySQL 도구와 구성 파일을 사용하세요.

## 커뮤니티

최신 소식을 확인하고 대화에 참여하세요.

> [card] [최신 소식](https://villagesql.com/blog)
>
> 블로그에서 최신 소식을 확인하세요.

> [card] [Discord](https://discord.gg/KSr6whd3Fr)
>
> Discord에서 커뮤니티와 대화하세요.

> [card] [이슈](https://github.com/villagesql/villagesql-server/issues)
>
> 버그를 신고하거나 새 기능을 요청하세요.

> [card] [토론](https://github.com/villagesql/villagesql-server/discussions)
>
> GitHub Discussions에서 토론에 참여하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.