Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

딕셔너리 속성

View as MarkdownEdit this pageReport an issueSet up docs MCP

structure 절은 쿼리에서 사용할 수 있는 딕셔너리 키와 필드를 설명합니다.

XML 설명:

<dictionary>
    <structure>
        <id>
            <name>Id</name>
        </id>

        <attribute>
            <!-- 속성 매개변수 -->
        </attribute>

        ...

    </structure>
</dictionary>

속성은 다음 요소로 설명됩니다:

  • <id> — 키 컬럼
  • <attribute> — 데이터 컬럼: 속성은 여러 개 있을 수 있습니다.

DDL 쿼리:

CREATE DICTIONARY dict_name (
    Id UInt64,
    -- 속성
)
PRIMARY KEY Id
...

속성은 쿼리 본문에 다음과 같이 설명됩니다:

  • PRIMARY KEY — 키 컬럼
  • AttrName AttrType — 데이터 컬럼. 속성은 여러 개일 수 있습니다.

키

ClickHouse는 다음과 같은 키 타입을 지원합니다:

  • 숫자 키. UInt64입니다. <id> 태그 또는 PRIMARY KEY 키워드로 정의합니다.
  • 복합 키. 서로 다른 타입의 값 집합입니다. <key> 태그 또는 PRIMARY KEY 키워드로 정의합니다.

XML 구조에는 <id> 또는 <key> 중 하나만 포함할 수 있습니다. DDL 쿼리에는 PRIMARY KEY를 하나만 포함해야 합니다.

숫자 키

유형: UInt64.

구성 예시:

<id>
    <name>Id</name>
</id>

구성 필드:

  • name – 키가 포함된 컬럼의 이름입니다.

DDL 쿼리의 경우:

CREATE DICTIONARY (
    Id UInt64,
    ...
)
PRIMARY KEY Id
...
  • PRIMARY KEY – 키를 포함하는 컬럼의 이름입니다.

복합 키

키는 어떤 타입의 필드로 구성된 tuple일 수 있습니다. 이 경우 레이아웃은 complex_key_hashed 또는 complex_key_cache여야 합니다.

키 구조는 <key> 요소에서 설정합니다. 키 필드는 딕셔너리 속성과 동일한 형식으로 지정합니다. 예시:

<structure>
    <key>
        <attribute>
            <name>field1</name>
            <type>String</type>
        </attribute>
        <attribute>
            <name>field2</name>
            <type>UInt32</type>
        </attribute>
        ...
    </key>
...

or

CREATE DICTIONARY (
    field1 String,
    field2 UInt32
    ...
)
PRIMARY KEY field1, field2
...

dictGet* 함수에 대한 쿼리에서는 키로 튜플을 전달합니다. 예시: dictGetString('dict_name', 'attr_name', tuple('string for field1', num_for_field2)).

복합 키가 단일 속성 하나로 이루어진 경우에는 tuple로 감싸지 않고 키 값을 직접 전달할 수 있습니다. 예를 들어 dictGetString('dict_name', 'attr_name', 'key')와 dictGetString('dict_name', 'attr_name', tuple('key'))는 모두 유효합니다.

속성

구성 예시:

<structure>
    ...
    <attribute>
        <name>Name</name>
        <type>ClickHouseDataType</type>
        <null_value></null_value>
        <expression>rand64()</expression>
        <hierarchical>true</hierarchical>
        <injective>true</injective>
        <is_object_id>true</is_object_id>
    </attribute>
</structure>

OR

CREATE DICTIONARY somename (
    Name ClickHouseDataType DEFAULT '' EXPRESSION rand64() HIERARCHICAL INJECTIVE IS_OBJECT_ID
)

구성 항목:

태그 설명 필수
name 컬럼 이름입니다. 예
type ClickHouse 데이터 타입: UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64, Float32, Float64, UUID, Decimal32, Decimal64, Decimal128, Decimal256,Date, Date32, DateTime, DateTime64, String, 배열.
ClickHouse는 딕셔너리의 값을 지정된 데이터 타입으로 변환하려고 시도합니다. 예를 들어 MySQL 원본 테이블에서 필드가 TEXT, VARCHAR, 또는 BLOB일 수 있지만, ClickHouse에서는 String으로 적재할 수 있습니다.
현재 널 허용은 Flat, Hashed, ComplexKeyHashed, Direct, ComplexKeyDirect, RangeHashed, Polygon, Cache, ComplexKeyCache, SSDCache, SSDComplexKeyCache 딕셔너리에서 지원됩니다. IPTrie 딕셔너리에서는 Nullable 타입을 지원하지 않습니다.		 예
null_value 존재하지 않는 요소의 기본값입니다.
예시에서는 빈 문자열입니다. NULL 값은 Nullable 타입에서만 사용할 수 있습니다(타입 설명이 있는 이전 줄 참조).		 예
expression ClickHouse가 값에 대해 실행하는 표현식입니다.
이 표현식은 원격 SQL 데이터베이스의 컬럼 이름일 수 있습니다. 따라서 이를 사용해 원격 컬럼의 별칭을 만들 수 있습니다.

기본값: 표현식 없음.		 아니요
hierarchical true이면 이 속성에는 현재 키의 상위 키 값이 포함됩니다. 계층형 딕셔너리를 참조하십시오.

기본값: false.		 아니요
injective id -> attribute 매핑이 단사인지 여부를 나타내는 플래그입니다.
true이면 ClickHouse는 단사 속성이 있는 딕셔너리에 대한 요청을 GROUP BY 절 뒤로 자동 배치할 수 있습니다. 일반적으로 이렇게 하면 이러한 요청 수를 크게 줄일 수 있습니다.

기본값: false.		 아니요
is_object_id 쿼리가 ObjectID를 사용해 MongoDB 문서에 대해 실행되는지 여부를 나타내는 플래그입니다.

기본값: false.
Navigation