메인 콘텐츠로 건너뛰기
이 페이지는 ClickHouse Cloud에는 적용되지 않습니다. 여기에서 설명하는 기능은 ClickHouse Cloud 서비스에서 지원되지 않습니다. 자세한 내용은 ClickHouse의 Cloud Compatibility 가이드를 참조하십시오.
ClickHouse에는 지오베이스 작업을 위한 내장 기능이 있습니다. 이 기능으로 다음을 수행할 수 있습니다:
  • 지역 ID를 사용해 원하는 언어로 지역 이름을 가져옵니다.
  • 지역 ID를 사용해 도시, 권역, 연방 지구, 국가 또는 대륙의 ID를 가져옵니다.
  • 어떤 지역이 다른 지역에 속하는지 확인합니다.
  • 상위 지역 체인을 가져옵니다.
모든 함수는 “translocality”, 즉 지역 소속에 대한 서로 다른 관점을 동시에 사용할 수 있는 기능을 지원합니다. 자세한 내용은 “웹 분석 딕셔너리 작업용 함수” 섹션을 참조하십시오. 내부 딕셔너리는 기본 패키지에서 비활성화되어 있습니다. 이를 활성화하려면 서버 설정 파일에서 path_to_regions_hierarchy_filepath_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 식별자 및 검색 엔진 작업용 함수도 있지만, 사용하지 않는 것이 좋습니다.
마지막 수정일 2026년 6월 10일