> ## 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.

# MySQL용 vsql_nanoid 확장 기능

> vsql_nanoid 커뮤니티 확장 기능은 MySQL에서 URL에 안전한 짧은 무작위 식별자를 생성하며, 기본 21자에 길이와 알파벳을 구성할 수 있습니다.

Nano ID는 UUID가 36자인 데 비해 21자이며, 이스케이프 없이 URL에 안전하게 쓸 수
있는 알파벳으로 만들어집니다. `vsql_nanoid`는 이를 SQL에서 생성하므로, 외부에
공개되는 식별자를 애플리케이션이 아니라 삽입 시점에 만들 수 있습니다.

| | |
| - | - |
| **관리자** | [Anurag Ojha](https://github.com/intojhanurag) |
| **소스 및 문서** | [intojhanurag/vsql-nanoid](https://github.com/intojhanurag/vsql-nanoid) |
| **라이선스** | GPL-2.0 |

> [!NOTE]
>
> 이 확장 기능은 제3자가 작성하고 관리합니다. VillageSQL은 이를 빌드, 테스트,
> 배포하지 않으며, 아래 설명은 관리자의 자체 문서를 따릅니다. 이 확장 기능에
> 의존하기 전에 해당 문서를 읽으세요.

## 설치

저장소에서 VillageSQL 빌드 트리(`VillageSQL_BUILD_DIR`)를 기준으로 빌드하고, `.veb` 파일을 서버의 `veb_dir`에 복사한 다음 설치합니다. 난수 소스로
OpenSSL이 필요합니다.

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

## 추가되는 기능

| 함수 | 반환값 | 설명 |
| - | - | - |
| `nanoid()` | text | 기본 알파벳 `A-Za-z0-9_-`로 만든 21자 식별자 |
| `nanoid_with(size)` | text | 같은 식별자를 원하는 길이로 생성 |
| `nanoid_with(size, alphabet)` | text | 같은 식별자를 원하는 알파벳으로 생성 |

## 참고 항목

* [MySQL의 UUID](https://villagesql.com/docs/en/guides/uuids.md) — 불투명 식별자를 생성하는 또 다른 방법
* [기본 키 전략](https://villagesql.com/docs/en/guides/primary-key-strategies.md) — 무작위 키가 InnoDB 인덱스에서 치르는 비용
* [사용 가능한 확장 기능](https://villagesql.com/docs/ko/extensions/catalog) — 전체 카탈로그
* [intojhanurag/vsql-nanoid](https://github.com/intojhanurag/vsql-nanoid) — 소스, 예제, 알려진 제한 사항


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