> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ClickHouse에 내장된 지오베이스 딕셔너리

# 내장 (지오베이스) 딕셔너리

export const CloudNotSupportedBadge = () => {
  return <div className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            ClickHouse Cloud에서 지원되지 않음
        </div>;
};

<CloudNotSupportedBadge />

<Note>
  이 페이지는 [ClickHouse Cloud](https://clickhouse.com/cloud)에는 적용되지 않습니다. 여기에서 설명하는 기능은 ClickHouse Cloud 서비스에서 지원되지 않습니다.
  자세한 내용은 ClickHouse의 [Cloud Compatibility](/docs/ko/products/cloud/guides/cloud-compatibility) 가이드를 참조하십시오.
</Note>

ClickHouse에는 지오베이스 작업을 위한 내장 기능이 있습니다.

이 기능으로 다음을 수행할 수 있습니다:

* 지역 ID를 사용해 원하는 언어로 지역 이름을 가져옵니다.
* 지역 ID를 사용해 도시, 권역, 연방 지구, 국가 또는 대륙의 ID를 가져옵니다.
* 어떤 지역이 다른 지역에 속하는지 확인합니다.
* 상위 지역 체인을 가져옵니다.

모든 함수는 "translocality", 즉 지역 소속에 대한 서로 다른 관점을 동시에 사용할 수 있는 기능을 지원합니다. 자세한 내용은 "웹 분석 딕셔너리 작업용 함수" 섹션을 참조하십시오.

내부 딕셔너리는 기본 패키지에서 비활성화되어 있습니다.
이를 활성화하려면 서버 설정 파일에서 `path_to_regions_hierarchy_file` 및 `path_to_regions_names_files` 매개변수의 주석 처리를 해제하십시오.

지오베이스는 텍스트 파일에서 로드됩니다.

`regions_hierarchy*.txt` 파일은 `path_to_regions_hierarchy_file` 디렉터리에 배치하십시오. 이 구성 매개변수에는 `regions_hierarchy.txt` 파일(기본 지역 계층 구조)의 경로가 들어 있어야 하며, 다른 파일(`regions_hierarchy_ua.txt`)도 같은 디렉터리에 있어야 합니다.

`regions_names_*.txt` 파일은 `path_to_regions_names_files` 디렉터리에 넣으십시오.

이 파일은 직접 만들 수도 있습니다. 파일 포맷은 다음과 같습니다:

`regions_hierarchy*.txt`: TabSeparated(헤더 없음), 컬럼:

* 지역 ID (`UInt32`)
* 상위 지역 ID (`UInt32`)
* 지역 유형 (`UInt8`): 1 - 대륙, 3 - 국가, 4 - 연방 지구, 5 - 지역, 6 - 도시; 그 밖의 유형에는 값이 없습니다
* 인구(`UInt32`) — 선택적 컬럼

`regions_names_*.txt`: TabSeparated(헤더 없음), 컬럼:

* 지역 ID (`UInt32`)
* 지역 이름 (`String`) — 이스케이프된 경우를 포함해 탭이나 줄바꿈 문자를 포함할 수 없습니다.

RAM에 저장할 때는 평면 배열이 사용됩니다. 따라서 ID는 100만을 넘지 않아야 합니다.

서버를 재시작하지 않고도 딕셔너리를 업데이트할 수 있습니다. 하지만 사용 가능한 딕셔너리 집합은 업데이트되지 않습니다.
업데이트할 때는 파일 수정 시간을 확인합니다. 파일이 변경되면 딕셔너리가 업데이트됩니다.
변경 여부를 확인하는 인터벌은 `builtin_dictionaries_reload_interval` 매개변수로 구성합니다.
딕셔너리 업데이트(최초 사용 시 로드 제외)는 쿼리를 차단하지 않습니다. 업데이트 중에는 쿼리가 이전 버전의 딕셔너리를 사용합니다. 업데이트 중 오류가 발생하면 해당 오류가 서버 로그에 기록되고, 쿼리는 계속 이전 버전의 딕셔너리를 사용합니다.

지오베이스와 함께 딕셔너리도 주기적으로 업데이트하는 것을 권장합니다. 업데이트할 때는 새 파일을 생성해 별도의 위치에 기록하십시오. 모든 준비가 끝나면 서버가 사용하는 파일 이름으로 변경하십시오.

OS 식별자 및 검색 엔진 작업용 함수도 있지만, 사용하지 않는 것이 좋습니다.