CREATE DICTIONARY ... LAYOUT Hierarchical

CREATE DICTIONARY ... LAYOUT Hierarchical

ClickHouse는 숫자 키를 가진 계층형 딕셔너리를 지원해요.

출처: 문서

본문

Hierarchical dictionaries

ClickHouse는 숫자 키를 가진 계층형 딕셔너리를 지원해요.

다음의 계층 구조를 봐 보세요.

0 (Common parent)
│
├── 1 (United States of America)
│   │
│   └── 2 (California)
│       │
│       └── 3 (San Francisco)
│
└── 4 (Great Britain)
    │
    └── 5 (London)

이 계층은 다음과 같은 딕셔너리 테이블로 표현할 수 있어요.

region_id parent_region region_name
1 0 United States of America
2 1 California
3 2 San Francisco
4 0 Great Britain
5 4 London

이 테이블은 요소의 가장 가까운 부모의 키를 담는 parent_region 컬럼을 포함해요.

ClickHouse는 외부 딕셔너리 속성의 계층(hierarchical) 속성을 지원해요. 이 속성은 위에서 설명한 것과 유사한 계층형 딕셔너리를 구성할 수 있게 해줍니다.

dictGetHierarchy 함수는 요소의 부모 체인을 얻을 수 있게 해줘요. dictGetRoot 함수는 요소의 최상위 조상(루트)만 반환합니다.

우리 예시에서 딕셔너리의 구조는 다음과 같을 수 있어요.

  • DDL
  • Configuration file
CREATE DICTIONARY regions_dict
(
    region_id UInt64,
    parent_region UInt64 DEFAULT 0 HIERARCHICAL,
    region_name String DEFAULT ''
)
PRIMARY KEY region_id
SOURCE(...)
LAYOUT(HASHED())
LIFETIME(3600);
<dictionary>
    <structure>
        <id>
            <name>region_id</name>
        </id>

        <attribute>
            <name>parent_region</name>
            <type>UInt64</type>
            <null_value>0</null_value>
            <hierarchical>true</hierarchical>
        </attribute>

        <attribute>
            <name>region_name</name>
            <type>String</type>
            <null_value></null_value>
        </attribute>

    </structure>
</dictionary>

더 알아보기 (Learn more)