> ## 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_address_standardizer 확장 기능

> vsql_address_standardizer 커뮤니티 확장 기능은 MySQL에서 자유 형식의 미국 우편 주소를 건물 번호, 거리, 호수, 도시, 주, ZIP으로 파싱합니다.

미국 우편 주소는 자유 형식 텍스트 한 줄로 들어오지만, 거의 모든 용도에서 그
구성 요소가 필요합니다: 건물 번호, 거리, 호수, 도시, 주, ZIP입니다.
`vsql_address_standardizer`는 그 줄을 SQL에서 분리하고 찾은 내용을
정규화하므로, `north`는 `N`이 되고 `new york`은 `NY`가 됩니다. PostgreSQL의
`address_standardizer` contrib 모듈에서 영감을 받았습니다.

| | |
| - | - |
| **관리자** | [Japheth Obala](https://github.com/jobala) |
| **소스 및 문서** | [jobala/vsql-address-standardizer](https://github.com/jobala/vsql-address-standardizer) |
| **라이선스** | GPL-2.0 |

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

## 설치

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

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

## 추가되는 기능

| 함수 | 반환값 | 설명 |
| - | - | - |
| `address_standardize(address)` | text | 주소 전체를 정규화하여 한 줄로 다시 쓴 결과 |
| `address_parse_json(address)` | text | 구성 요소를 JSON 객체로 반환. `house_number`, `street_name`, `street_suffix`, `city`, `state`, `zip`은 항상 포함되고, `pre_directional`, `post_directional`, `unit_designator`, `unit_identifier`는 주소에 있을 때 포함 |
| `address_field(address, name)` | text | 이름으로 지정한 구성 요소 하나 |

미국 주소만 처리합니다.

## 참고 항목

* [사용 가능한 확장 기능](https://villagesql.com/docs/ko/extensions/catalog) — 전체 카탈로그
* [jobala/vsql-address-standardizer](https://github.com/jobala/vsql-address-standardizer) — 소스, 예제, 알려진 제한 사항


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