딕셔너리 작업용 함수

딕셔너리 작업용 함수 문서

DDL queries로 생성한 딕셔너리의 경우, dict_name 매개변수는 <database>.<dict_name>처럼 전체 이름을 지정해야 합니다. 그렇지 않으면 현재 데이터베이스가 사용됩니다.

딕셔너리 연결 및 구성에 관한 정보는 딕셔너리를 참조하십시오.

​

예시 딕셔너리

이 섹션의 예시에서는 다음 딕셔너리를 사용합니다. 아래에 설명된 함수의 예시를 실행하려면 ClickHouse에서 이 딕셔너리를 생성하십시오.

dictGet\<T\> 및 dictGet\<T\>OrDefault 함수용 예시 딕셔너리

-- 필요한 모든 데이터 타입이 포함된 테이블 생성
CREATE TABLE all_types_test (
    `id` UInt32,
    
    -- String 타입
    `String_value` String,
    
    -- 부호 없는 정수 타입
    `UInt8_value` UInt8,
    `UInt16_value` UInt16,
    `UInt32_value` UInt32,
    `UInt64_value` UInt64,
    
    -- 부호 있는 정수 타입
    `Int8_value` Int8,
    `Int16_value` Int16,
    `Int32_value` Int32,
    `Int64_value` Int64,
    
    -- 부동 소수점 타입
    `Float32_value` Float32,
    `Float64_value` Float64,
    
    -- 날짜/시간 타입
    `Date_value` Date,
    `DateTime_value` DateTime,
    
    -- 네트워크 타입
    `IPv4_value` IPv4,
    `IPv6_value` IPv6,
    
    -- UUID 타입
    `UUID_value` UUID
) ENGINE = MergeTree() 
ORDER BY id;

-- 테스트 데이터 삽입
INSERT INTO all_types_test VALUES
(
    1,                              -- id
    'ClickHouse',                   -- String
    100,                            -- UInt8
    5000,                           -- UInt16
    1000000,                        -- UInt32
    9223372036854775807,            -- UInt64
    -100,                           -- Int8
    -5000,                          -- Int16
    -1000000,                       -- Int32
    -9223372036854775808,           -- Int64
    123.45,                         -- Float32
    987654.123456,                  -- Float64
    '2024-01-15',                   -- Date
    '2024-01-15 10:30:00',          -- DateTime
    '192.168.1.1',                  -- IPv4
    '2001:db8::1',                  -- IPv6
    '550e8400-e29b-41d4-a716-446655440000' -- UUID
)

-- 딕셔너리 생성
CREATE DICTIONARY all_types_dict
(
    id UInt32,
    String_value String,
    UInt8_value UInt8,
    UInt16_value UInt16,
    UInt32_value UInt32,
    UInt64_value UInt64,
    Int8_value Int8,
    Int16_value Int16,
    Int32_value Int32,
    Int64_value Int64,
    Float32_value Float32,
    Float64_value Float64,
    Date_value Date,
    DateTime_value DateTime,
    IPv4_value IPv4,
    IPv6_value IPv6,
    UUID_value UUID
)
PRIMARY KEY id
SOURCE(CLICKHOUSE(HOST 'localhost' PORT 9000 USER 'default' TABLE 'all_types_test' DB 'default'))
LAYOUT(HASHED())
LIFETIME(MIN 300 MAX 600);

dictGetAll용 예시 딕셔너리

regexp 트리 딕셔너리에 사용할 데이터를 저장할 테이블을 생성합니다:

CREATE TABLE regexp_os(
    id UInt64,
    parent_id UInt64,
    regexp String,
    keys Array(String),
    values Array(String)
)
ENGINE = Memory;

테이블에 데이터를 삽입합니다:

INSERT INTO regexp_os 
SELECT *
FROM s3(
    'https://datasets-documentation.s3.eu-west-3.amazonaws.com/' ||
    'user_agent_regex/regexp_os.csv'
);

regexp 트리 딕셔너리를 생성합니다:

CREATE DICTIONARY regexp_tree
(
    regexp String,
    os_replacement String DEFAULT 'Other',
    os_v1_replacement String DEFAULT '0',
    os_v2_replacement String DEFAULT '0',
    os_v3_replacement String DEFAULT '0',
    os_v4_replacement String DEFAULT '0'
)
PRIMARY KEY regexp
SOURCE(CLICKHOUSE(TABLE 'regexp_os'))
LIFETIME(MIN 0 MAX 0)
LAYOUT(REGEXP_TREE);

예시: 범위 키 딕셔너리

입력 테이블을 생성합니다:

CREATE TABLE range_key_dictionary_source_table
(
    key UInt64,
    start_date Date,
    end_date Date,
    value String,
    value_nullable Nullable(String)
)
ENGINE = TinyLog();

입력 테이블에 데이터를 삽입합니다:

INSERT INTO range_key_dictionary_source_table VALUES(1, toDate('2019-05-20'), toDate('2019-05-20'), 'First', 'First');
INSERT INTO range_key_dictionary_source_table VALUES(2, toDate('2019-05-20'), toDate('2019-05-20'), 'Second', NULL);
INSERT INTO range_key_dictionary_source_table VALUES(3, toDate('2019-05-20'), toDate('2019-05-20'), 'Third', 'Third');

딕셔너리를 생성합니다:

CREATE DICTIONARY range_key_dictionary
(
    key UInt64,
    start_date Date,
    end_date Date,
    value String,
    value_nullable Nullable(String)
)
PRIMARY KEY key
SOURCE(CLICKHOUSE(HOST 'localhost' PORT tcpPort() TABLE 'range_key_dictionary_source_table'))
LIFETIME(MIN 1 MAX 1000)
LAYOUT(RANGE_HASHED())
RANGE(MIN start_date MAX end_date);

예시: 복합 키 딕셔너리

소스 테이블을 생성합니다:

CREATE TABLE dict_mult_source
(
id UInt32,
c1 UInt32,
c2 String
) ENGINE = Memory;

소스 테이블에 데이터를 삽입합니다:

INSERT INTO dict_mult_source VALUES
(1, 1, '1'),
(2, 2, '2'),
(3, 3, '3');

딕셔너리를 생성합니다:

CREATE DICTIONARY ext_dict_mult
(
    id UInt32,
    c1 UInt32,
    c2 String
)
PRIMARY KEY id
SOURCE(CLICKHOUSE(HOST 'localhost' PORT 9000 USER 'default' TABLE 'dict_mult_source' DB 'default'))
LAYOUT(FLAT())
LIFETIME(MIN 0 MAX 0);

예시: 계층형 딕셔너리

소스 테이블을 생성합니다:

CREATE TABLE hierarchy_source
(
  id UInt64,
  parent_id UInt64,
  name String
) ENGINE = Memory;

소스 테이블에 데이터를 삽입합니다:

INSERT INTO hierarchy_source VALUES
(0, 0, 'Root'),
(1, 0, 'Level 1 - Node 1'),
(2, 1, 'Level 2 - Node 2'),
(3, 1, 'Level 2 - Node 3'),
(4, 2, 'Level 3 - Node 4'),
(5, 2, 'Level 3 - Node 5'),
(6, 3, 'Level 3 - Node 6');

-- 0 (루트)
-- └── 1 (수준 1 - 노드 1)
--     ├── 2 (수준 2 - 노드 2)
--     │   ├── 4 (수준 3 - 노드 4)
--     │   └── 5 (수준 3 - 노드 5)
--     └── 3 (수준 2 - 노드 3)
--         └── 6 (수준 3 - 노드 6)

딕셔너리를 생성합니다:

CREATE DICTIONARY hierarchical_dictionary
(
    id UInt64,
    parent_id UInt64 HIERARCHICAL,
    name String
)
PRIMARY KEY id
SOURCE(CLICKHOUSE(HOST 'localhost' PORT 9000 USER 'default' TABLE 'hierarchy_source' DB 'default'))
LAYOUT(HASHED())
LIFETIME(MIN 300 MAX 600);

​

dictGet

v18.16.0에 도입됨

딕셔너리에서 값을 가져옵니다.

구문

dictGet('dict_name', attr_names, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_names — 딕셔너리 컬럼 이름 또는 컬럼 이름의 튜플입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. UInt64/Tuple(T)를 반환하는 표현식입니다. UInt64 또는 Tuple(T)

반환 값

키를 찾으면 id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 키를 찾지 못하면 딕셔너리 구성에서 해당 속성에 대해 지정한 <null_value> 요소의 내용을 반환합니다.

예시

단일 속성 조회

Query

SELECT dictGet('ext_dict_test', 'c1', toUInt64(1)) AS val

Response

1

여러 속성

Query

SELECT
    dictGet('ext_dict_mult', ('c1','c2'), number + 1) AS val,
    toTypeName(val) AS type
FROM system.numbers
LIMIT 3;

Response

┌─val─────┬─type───────────┐
│ (1,'1') │ Tuple(        ↴│
│         │↳    c1 UInt32,↴│
│         │↳    c2 String) │
│ (2,'2') │ Tuple(        ↴│
│         │↳    c1 UInt32,↴│
│         │↳    c2 String) │
│ (3,'3') │ Tuple(        ↴│
│         │↳    c1 UInt32,↴│
│         │↳    c2 String) │
└─────────┴────────────────┘

​

dictGetAll

v23.5.0에서 도입됨

정규 표현식 트리 딕셔너리에서 각 키와 일치하는 모든 노드의 속성 값을 가져옵니다.

이 함수는 T 대신 Array(T) 유형의 값을 반환한다는 점만 제외하면 dictGet과 유사하게 동작합니다.

구문

dictGetAll(dict_name, attr_names, id_expr[, limit])

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_names — 딕셔너리 컬럼의 이름 또는 컬럼 이름 튜플입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라집니다). Expression 또는 Tuple(T)
• limit — 선택 사항입니다. 반환되는 각 값 배열의 최대 길이입니다. 값을 잘라낼 때는 상위 노드보다 하위 노드가 우선하며, 그 외의 경우에는 regexp 트리 딕셔너리에 정의된 목록 순서를 따릅니다. 지정하지 않으면 배열 길이에 제한이 없습니다. UInt*

반환 값

attr_names에 지정된 각 속성에 대해 id_expr에 해당하는 딕셔너리 속성 값 배열을 반환합니다. 딕셔너리에 id_expr에 해당하는 키가 없으면 빈 배열을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

Array(T)

예시

사용 예시

Query

SELECT
    'Mozilla/5.0 (Linux; Android 12; SM-G998B) Mobile Safari/537.36' AS user_agent,

    -- This will match ALL applicable patterns
    dictGetAll('regexp_tree', 'os_replacement', 'Mozilla/5.0 (Linux; Android 12; SM-G998B) Mobile Safari/537.36') AS all_matches,

    -- This returns only the first match
    dictGet('regexp_tree', 'os_replacement', 'Mozilla/5.0 (Linux; Android 12; SM-G998B) Mobile Safari/537.36') AS first_match;

Response

┌─user_agent─────────────────────────────────────────────────────┬─all_matches─────────────────────────────┬─first_match─┐
│ Mozilla/5.0 (Linux; Android 12; SM-G998B) Mobile Safari/537.36 │ ['Android','Android','Android','Linux'] │ Android     │
└────────────────────────────────────────────────────────────────┴─────────────────────────────────────────┴─────────────┘

​

dictGetChildren

도입 버전: v21.4.0

직계 하위 항목을 인덱스 배열로 반환합니다. dictGetHierarchy의 역변환입니다.

구문

dictGetChildren(dict_name, key)

인수

• dict_name — 딕셔너리 이름입니다. String
• key — 확인할 키입니다. const String

반환 값

해당 키의 1단계 하위 항목을 반환합니다. Array(UInt64)

예시

딕셔너리의 1단계 하위 항목 가져오기

Query

SELECT dictGetChildren('hierarchical_dictionary', 2);

Response

┌─dictGetChild⋯ionary', 2)─┐
│ [4,5]                    │
└──────────────────────────┘

​

dictGetDate

도입 버전: v1.1.0

딕셔너리 구성과 무관하게 딕셔너리 속성 값을 Date 데이터 타입으로 변환합니다.

구문

dictGetDate(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당 값이 없으면 딕셔너리 구성에서 해당 속성에 대해 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetDate('all_types_dict', 'Date_value', 1)

Response

┌─dictGetDate(⋯_value', 1)─┐
│               2020-01-01 │
└──────────────────────────┘

​

dictGetDateOrDefault

지원 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Date 데이터 타입으로 변환합니다. 키를 찾을 수 없는 경우에는 지정한 기본값을 반환합니다.

구문

dictGetDateOrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 ClickHouse는 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetDate('all_types_dict', 'Date_value', 1);

-- 존재하지 않는 키의 경우, 제공된 기본값을 반환
SELECT dictGetDateOrDefault('all_types_dict', 'Date_value', 999, toDate('1970-01-01'));

Response

┌─dictGetDate(⋯_value', 1)─┐
│               2024-01-15 │
└──────────────────────────┘
┌─dictGetDateO⋯70-01-01'))─┐
│               1970-01-01 │
└──────────────────────────┘

​

dictGetDateTime

도입 버전: v1.1.0

딕셔너리 구성과 무관하게 딕셔너리 속성 값을 DateTime 데이터 타입으로 변환합니다.

구문

dictGetDateTime(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식이며, 이는 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당 값이 없으면 딕셔너리 구성에서 그 속성에 대해 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetDateTime('all_types_dict', 'DateTime_value', 1)

Response

┌─dictGetDateT⋯_value', 1)─┐
│      2024-01-15 10:30:00 │
└──────────────────────────┘

​

dictGetDateTimeOrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 DateTime 데이터 타입으로 변환하거나, 키를 찾지 못한 경우 지정된 기본값을 반환합니다.

구문

dictGetDateTimeOrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라짐). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 해당 값이 없으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 해당 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetDateTime('all_types_dict', 'DateTime_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값을 반환
SELECT dictGetDateTimeOrDefault('all_types_dict', 'DateTime_value', 999, toDateTime('1970-01-01 00:00:00'));

Response

┌─dictGetDateT⋯_value', 1)─┐
│      2024-01-15 10:30:00 │
└──────────────────────────┘
┌─dictGetDateT⋯0:00:00'))──┐
│      1970-01-01 00:00:00 │
└──────────────────────────┘

​

dictGetDescendants

도입 버전: v21.4.0

dictGetChildren 함수를 재귀적으로 level번 적용한 경우와 같이, 모든 하위 항목을 반환합니다.

구문

dictGetDescendants(dict_name, key, level)

인수

• dict_name — 딕셔너리 이름입니다. String
• key — 확인할 키입니다. const String
• level — 계층 수준입니다. level = 0이면 최하위까지 모든 하위 항목을 반환합니다. UInt8

반환 값

해당 키의 하위 항목을 반환합니다. Array(UInt64)

예시

딕셔너리의 직계 하위 항목 가져오기

Query

-- 다음 계층형 딕셔너리를 고려하십시오:
-- 0 (루트)
-- └── 1 (수준 1 - 노드 1)
--     ├── 2 (수준 2 - 노드 2)
--     │   ├── 4 (수준 3 - 노드 4)
--     │   └── 5 (수준 3 - 노드 5)
--     └── 3 (수준 2 - 노드 3)
--         └── 6 (수준 3 - 노드 6)

SELECT dictGetDescendants('hierarchical_dictionary', 0, 2)

Response

┌─dictGetDesce⋯ary', 0, 2)─┐
│ [3,2]                    │
└──────────────────────────┘

​

dictGetFloat32

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Float32 데이터 타입으로 변환합니다.

구문

dictGetFloat32(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식이며(딕셔너리 구성에 따라 다름), Expression 또는 Tuple(T)입니다.

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당하는 값이 없으면 딕셔너리 구성에서 해당 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetFloat32('all_types_dict', 'Float32_value', 1)

Response

┌─dictGetFloat⋯_value', 1)─┐
│               -123.123   │
└──────────────────────────┘

​

dictGetFloat32OrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Float32 데이터 타입으로 변환하며, 키를 찾지 못한 경우에는 지정된 기본값을 반환합니다.

구문

dictGetFloat32OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 때 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetFloat32('all_types_dict', 'Float32_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(-1.0)을 반환
SELECT dictGetFloat32OrDefault('all_types_dict', 'Float32_value', 999, -1.0);

Response

┌─dictGetFloat⋯_value', 1)─┐
│                   123.45 │
└──────────────────────────┘
┌─dictGetFloat⋯e', 999, -1)─┐
│                       -1  │
└───────────────────────────┘

​

dictGetFloat64

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Float64 데이터 타입으로 변환합니다.

구문

dictGetFloat64(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 그렇지 않으면 딕셔너리 구성에서 해당 속성에 대해 지정된 <null_value> 요소의 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetFloat64('all_types_dict', 'Float64_value', 1)

Response

┌─dictGetFloat⋯_value', 1)─┐
│                 -123.123 │
└──────────────────────────┘

​

dictGetFloat64OrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Float64 데이터 타입으로 변환하며, 키를 찾을 수 없으면 제공된 기본값을 반환합니다.

구문

dictGetFloat64OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라집니다). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetFloat64('all_types_dict', 'Float64_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(nan)을 반환
SELECT dictGetFloat64OrDefault('all_types_dict', 'Float64_value', 999, nan);

Response

┌─dictGetFloat⋯_value', 1)─┐
│            987654.123456 │
└──────────────────────────┘
┌─dictGetFloat⋯, 999, nan)─┐
│                      nan │
└──────────────────────────┘

​

dictGetHierarchy

도입 버전: v1.1.0

계층형 딕셔너리(hierarchical dictionary)에서 지정한 키의 모든 부모를 포함하는 배열을 생성합니다.

구문

dictGetHierarchy(dict_name, key)

인수

• dict_name — 딕셔너리 이름입니다. String
• key — 키 값입니다. const String

반환 값

해당 키의 상위 항목을 반환합니다. Array(UInt64)

예시

키의 계층 구조 가져오기

Query

SELECT dictGetHierarchy('hierarchical_dictionary', 5)

Response

┌─dictGetHiera⋯ionary', 5)─┐
│ [5,2,1]                  │
└──────────────────────────┘

​

dictGetIPv4

도입 버전: v1.1.0

딕셔너리 구성과 무관하게 딕셔너리 속성 값을 IPv4 데이터 타입으로 변환합니다.

구문

dictGetIPv4(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라짐). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 그렇지 않으면 딕셔너리 구성에서 해당 속성에 대해 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetIPv4('all_types_dict', 'IPv4_value', 1)

Response

┌─dictGetIPv4('all_⋯ 'IPv4_value', 1)─┐
│ 192.168.0.1                         │
└─────────────────────────────────────┘

​

dictGetIPv4OrDefault

도입 버전: v23.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 IPv4 데이터 타입으로 변환하며, 키를 찾을 수 없으면 지정된 기본값을 반환합니다.

구문

dictGetIPv4OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라집니다). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetIPv4('all_types_dict', 'IPv4_value', 1);

-- 존재하지 않는 키의 경우, 제공된 기본값을 반환
SELECT dictGetIPv4OrDefault('all_types_dict', 'IPv4_value', 999, toIPv4('0.0.0.0'));

Response

┌─dictGetIPv4('all_⋯ 'IPv4_value', 1)─┐
│ 192.168.0.1                         │
└─────────────────────────────────────┘
┌─dictGetIPv4OrDefa⋯0.0.0.0'))─┐
│ 0.0.0.0                      │
└──────────────────────────────┘

​

dictGetIPv6

도입 버전: v23.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 IPv6 데이터 타입으로 변환합니다.

구문

dictGetIPv6(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라짐). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당 값이 없으면 딕셔너리 구성에서 그 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetIPv6('all_types_dict', 'IPv6_value', 1)

Response

┌─dictGetIPv6('all_⋯ 'IPv6_value', 1)─┐
│ 2001:db8:85a3::8a2e:370:7334        │
└─────────────────────────────────────┘

​

dictGetIPv6OrDefault

도입 버전: v23.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 IPv6 데이터 타입으로 변환하며, 키를 찾지 못하면 제공된 기본값을 반환합니다.

구문

dictGetIPv6OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하며, 해당 값이 없으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetIPv6('all_types_dict', 'IPv6_value', 1);

-- 존재하지 않는 키의 경우, 제공된 기본값을 반환
SELECT dictGetIPv6OrDefault('all_types_dict', 'IPv6_value', 999, '::1'::IPv6);

Response

┌─dictGetIPv6('all_⋯ 'IPv6_value', 1)─┐
│ 2001:db8:85a3::8a2e:370:7334        │
└─────────────────────────────────────┘
┌─dictGetIPv6OrDefa⋯:1'::IPv6)─┐
│ ::1                          │
└──────────────────────────────┘

​

dictGetInt16

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Int16 데이터 타입으로 변환합니다.

구문

dictGetInt16(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하며, 그렇지 않으면 딕셔너리 구성에서 해당 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetInt16('all_types_dict', 'Int16_value', 1)

Response

┌─dictGetInt16⋯_value', 1)─┐
│                    -5000 │
└──────────────────────────┘

​

dictGetInt16OrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Int16 데이터 타입으로 변환하며, 키를 찾지 못한 경우에는 지정된 기본값을 반환합니다.

구문

dictGetInt16OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라집니다). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하며, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetInt16('all_types_dict', 'Int16_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(-1)을 반환
SELECT dictGetInt16OrDefault('all_types_dict', 'Int16_value', 999, -1);

Response

┌─dictGetInt16⋯_value', 1)─┐
│                    -5000 │
└──────────────────────────┘
┌─dictGetInt16⋯', 999, -1)─┐
│                       -1 │
└──────────────────────────┘

​

dictGetInt32

도입 버전: v1.1.0

딕셔너리 구성에 관계없이 딕셔너리 속성 값을 Int32 데이터 타입으로 변환합니다.

구문

dictGetInt32(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당 값이 없으면 딕셔너리 구성에서 그 속성에 대해 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetInt32('all_types_dict', 'Int32_value', 1)

Response

┌─dictGetInt32⋯_value', 1)─┐
│                -1000000  │
└──────────────────────────┘

​

dictGetInt32OrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Int32 데이터 타입으로 변환하며, 키를 찾지 못하면 지정된 기본값을 반환합니다.

구문

dictGetInt32OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 때 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetInt32('all_types_dict', 'Int32_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(-1)을 반환
SELECT dictGetInt32OrDefault('all_types_dict', 'Int32_value', 999, -1);

Response

┌─dictGetInt32⋯_value', 1)─┐
│                -1000000  │
└──────────────────────────┘
┌─dictGetInt32⋯', 999, -1)─┐
│                       -1 │
└──────────────────────────┘

​

dictGetInt64

도입 버전: v1.1.0

딕셔너리 구성과 무관하게 딕셔너리 속성 값을 Int64 데이터 타입으로 변환합니다.

구문

dictGetInt64(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당 값이 없으면 딕셔너리 구성에서 해당 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetInt64('all_types_dict', 'Int64_value', 1)

Response

┌─dictGetInt64⋯_value', 1)───┐
│       -9223372036854775807 │
└────────────────────────────┘

​

dictGetInt64OrDefault

도입된 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Int64 데이터 타입으로 변환하며, 키를 찾지 못하면 제공된 기본값을 반환합니다.

구문

dictGetInt64OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리의 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하며, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetInt64('all_types_dict', 'Int64_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(-1)을 반환
SELECT dictGetInt64OrDefault('all_types_dict', 'Int64_value', 999, -1);

Response

┌─dictGetInt64⋯_value', 1)─┐
│     -9223372036854775808 │
└──────────────────────────┘
┌─dictGetInt64⋯', 999, -1)─┐
│                       -1 │
└──────────────────────────┘

​

dictGetInt8

도입된 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 Int8 데이터 타입으로 변환합니다.

구문

dictGetInt8(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 그렇지 않으면 딕셔너리 구성에서 해당 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetInt8('all_types_dict', 'Int8_value', 1)

Response

┌─dictGetInt8(⋯_value', 1)─┐
│                     -100 │
└──────────────────────────┘

​

dictGetInt8OrDefault

도입 버전: v1.1.0

딕셔너리 구성과 무관하게 딕셔너리 속성 값을 Int8 데이터 타입으로 변환하며, 키를 찾지 못한 경우에는 지정한 기본값을 반환합니다.

구문

dictGetInt8OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 때 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetInt8('all_types_dict', 'Int8_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(-1)을 반환
SELECT dictGetInt8OrDefault('all_types_dict', 'Int8_value', 999, -1);

Response

┌─dictGetInt8(⋯_value', 1)─┐
│                     -100 │
└──────────────────────────┘
┌─dictGetInt8O⋯', 999, -1)─┐
│                       -1 │
└──────────────────────────┘

​

dictGetKeys

도입 버전: v25.12.0

속성 값이 지정된 값과 일치하는 딕셔너리 키를 반환합니다. 이는 단일 속성에 대한 dictGet 함수의 역연산입니다.

dictGetKeys에서 사용하는 쿼리별 역방향 조회 캐시의 크기를 제한하려면 max_reverse_dictionary_lookup_cache_size_bytes 설정을 사용합니다. 이 캐시는 동일한 쿼리 내에서 딕셔너리를 다시 스캔하지 않도록 각 속성 값에 대한 직렬화된 키 튜플을 저장합니다. 이 캐시는 쿼리 간에 유지되지 않습니다. 한도에 도달하면 항목이 LRU 방식으로 제거됩니다. 입력의 카디널리티가 낮고 작업 집합이 캐시에 들어갈 수 있는 대규모 딕셔너리에서 가장 효과적입니다. 캐싱을 비활성화하려면 0으로 설정합니다.

구문

dictGetKeys('dict_name', 'attr_name', value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 일치 여부를 확인할 속성입니다. String
• value_expr — 속성과 비교할 값입니다. Expression

반환 값

단일 키 딕셔너리의 경우 속성이 value_expr와 같은 키의 배열입니다. 다중 키 딕셔너리의 경우 속성이 value_expr와 같은 키 튜플의 배열입니다. 딕셔너리에 value_expr에 해당하는 속성이 없으면 빈 배열이 반환됩니다. ClickHouse는 속성 값을 파싱할 수 없거나 해당 값을 속성 데이터 타입으로 변환할 수 없으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetKeys('task_id_to_priority_dictionary', 'priority_level', 'high') AS ids;

Response

┌─ids───┐
│ [4,2] │
└───────┘

​

dictGetOrDefault

도입 버전: v18.16.0

딕셔너리에서 값을 조회하며, 키를 찾지 못하면 기본값을 반환합니다.

구문

dictGetOrDefault('dict_name', attr_names, id_expr, default_value)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_names — 딕셔너리의 컬럼 이름 또는 컬럼 이름의 튜플입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. UInt64/Tuple(T)를 반환하는 표현식입니다. UInt64 또는 Tuple(T)
• default_value — 키를 찾지 못했을 때 반환할 기본값입니다. 타입은 속성의 데이터 타입과 일치해야 합니다.

반환 값

키를 찾으면 id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 키를 찾지 못하면 제공된 default_value를 반환합니다.

예시

기본값을 사용해 값 가져오기

Query

SELECT dictGetOrDefault('ext_dict_mult', 'c1', toUInt64(999), 0) AS val

Response

0

​

dictGetOrNull

도입 버전: v21.4.0

딕셔너리에서 값을 조회하며, 키를 찾지 못하면 NULL을 반환합니다.

구문

dictGetOrNull('dict_name', 'attr_name', id_expr)

인수

• dict_name — 딕셔너리 이름입니다. 문자열 리터럴입니다. - attr_name — 조회할 컬럼 이름입니다. 문자열 리터럴입니다. - id_expr — 키 값입니다. 딕셔너리 키 유형의 값을 반환하는 표현식입니다.

반환 값

키를 찾으면 id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 키를 찾지 못하면 NULL을 반환합니다.

예시

범위 키 딕셔너리를 사용하는 예시

Query

SELECT
    (number, toDate('2019-05-20')),
    dictGetOrNull('range_key_dictionary', 'value', number, toDate('2019-05-20')),
FROM system.numbers LIMIT 5 FORMAT TabSeparated;

Response

(0,'2019-05-20')  \N
(1,'2019-05-20')  First
(2,'2019-05-20')  Second
(3,'2019-05-20')  Third
(4,'2019-05-20')  \N

​

dictGetString

도입 버전: v1.1.0

딕셔너리의 구성과 관계없이 딕셔너리 속성 값을 String 데이터 타입으로 변환합니다.

구문

dictGetString(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 Tuple 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당 값이 없으면 딕셔너리 구성에서 그 속성에 대해 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetString('all_types_dict', 'String_value', 1)

Response

┌─dictGetString(⋯_value', 1)─┐
│ test string                │
└────────────────────────────┘

​

dictGetStringOrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 String 데이터 타입으로 변환합니다. 키를 찾을 수 없으면 지정된 기본값을 반환합니다.

구문

dictGetStringOrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하며, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetString('all_types_dict', 'String_value', 1);

-- 존재하지 않는 키의 경우, 제공된 기본값을 반환
SELECT dictGetStringOrDefault('all_types_dict', 'String_value', 999, 'default');

Response

┌─dictGetString(⋯_value', 1)─┐
│ test string                │
└────────────────────────────┘
┌─dictGetStringO⋯ 999, 'default')─┐
│ default                         │
└─────────────────────────────────┘

​

dictGetUInt16

v1.1.0에 도입됨

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 UInt16 데이터 타입으로 변환합니다.

구문

dictGetUInt16(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당하는 값이 없으면 딕셔너리 구성에서 해당 속성에 대해 지정한 <null_value> 요소의 내용을 반환합니다.

속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 ClickHouse는 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetUInt16('all_types_dict', 'UInt16_value', 1)

Response

┌─dictGetUInt1⋯_value', 1)─┐
│                     5000 │
└──────────────────────────┘

​

dictGetUInt16OrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 UInt16 데이터 타입으로 변환하며, 키를 찾을 수 없으면 지정한 기본값을 반환합니다.

구문

dictGetUInt16OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라짐). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당 값이 없으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 키가 존재하는 경우
SELECT dictGetUInt16('all_types_dict', 'UInt16_value', 1);

-- 키가 존재하지 않는 경우, 지정된 기본값(0)을 반환
SELECT dictGetUInt16OrDefault('all_types_dict', 'UInt16_value', 999, 0);

Response

┌─dictGetUInt1⋯_value', 1)─┐
│                     5000 │
└──────────────────────────┘
┌─dictGetUInt1⋯e', 999, 0)─┐
│                        0 │
└──────────────────────────┘

​

dictGetUInt32

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 UInt32 데이터 타입으로 변환합니다.

구문

dictGetUInt32(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당하는 값이 없으면 딕셔너리 구성에서 해당 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetUInt32('all_types_dict', 'UInt32_value', 1)

Response

┌─dictGetUInt3⋯_value', 1)─┐
│                  1000000 │
└──────────────────────────┘

​

dictGetUInt32OrDefault

도입된 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 UInt32 데이터 타입으로 변환하며, 키를 찾지 못한 경우에는 지정한 기본값을 반환합니다.

구문

dictGetUInt32OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리의 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하며, 해당 값이 없으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 키가 존재하는 경우
SELECT dictGetUInt32('all_types_dict', 'UInt32_value', 1);

-- 키가 존재하지 않는 경우, 지정된 기본값(0)을 반환
SELECT dictGetUInt32OrDefault('all_types_dict', 'UInt32_value', 999, 0);

Response

┌─dictGetUInt3⋯_value', 1)─┐
│                  1000000 │
└──────────────────────────┘
┌─dictGetUInt3⋯e', 999, 0)─┐
│                        0 │
└──────────────────────────┘

​

dictGetUInt64

v1.1.0에 도입됨

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 UInt64 데이터 타입으로 변환합니다.

구문

dictGetUInt64(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라집니다). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성의 값을 반환합니다. 그렇지 않으면 딕셔너리 구성에서 해당 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetUInt64('all_types_dict', 'UInt64_value', 1)

Response

┌─dictGetUInt6⋯_value', 1)─┐
│      9223372036854775807 │
└──────────────────────────┘

​

dictGetUInt64OrDefault

도입 버전: v1.1.0

딕셔너리 구성에 관계없이 딕셔너리 속성 값을 UInt64 데이터 타입으로 변환하며, 키를 찾지 못한 경우 제공된 기본값을 반환합니다.

구문

dictGetUInt64OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetUInt64('all_types_dict', 'UInt64_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(0)을 반환
SELECT dictGetUInt64OrDefault('all_types_dict', 'UInt64_value', 999, 0);

Response

┌─dictGetUInt6⋯_value', 1)─┐
│      9223372036854775807 │
└──────────────────────────┘
┌─dictGetUInt6⋯e', 999, 0)─┐
│                        0 │
└──────────────────────────┘

​

dictGetUInt8

도입 버전: v1.1.0

딕셔너리 구성과 상관없이 딕셔너리 속성 값을 UInt8 데이터 타입으로 변환합니다.

구문

dictGetUInt8(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리의 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식이며, 딕셔너리 구성에 따라 달라집니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당하는 값이 없으면 딕셔너리 구성에서 해당 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetUInt8('all_types_dict', 'UInt8_value', 1)

Response

┌─dictGetUInt8⋯_value', 1)─┐
│                      100 │
└──────────────────────────┘

​

dictGetUInt8OrDefault

도입 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 UInt8 데이터 타입으로 변환하며, 키를 찾지 못하면 지정된 기본값을 반환합니다.

구문

dictGetUInt8OrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 다름). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

속성 값을 파싱할 수 없거나 값이 속성 데이터 타입과 일치하지 않으면 ClickHouse는 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetUInt8('all_types_dict', 'UInt8_value', 1);

-- 존재하지 않는 키의 경우, 지정된 기본값(0)을 반환
SELECT dictGetUInt8OrDefault('all_types_dict', 'UInt8_value', 999, 0);

Response

┌─dictGetUInt8⋯_value', 1)─┐
│                      100 │
└──────────────────────────┘
┌─dictGetUInt8⋯e', 999, 0)─┐
│                        0 │
└──────────────────────────┘

​

dictGetUUID

도입된 버전: v1.1.0

딕셔너리 속성 값을 딕셔너리 구성과 상관없이 UUID 데이터 타입으로 변환합니다.

구문

dictGetUUID(dict_name, attr_name, id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼의 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입의 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라짐). Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환합니다. 해당하는 값이 없으면 딕셔너리 구성에서 그 속성에 지정된 <null_value> 요소의 내용을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 값이 속성의 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

SELECT dictGetUUID('all_types_dict', 'UUID_value', 1)

Response

┌─dictGetUUID(⋯_value', 1)─────────────┐
│ 123e4567-e89b-12d3-a456-426614174000 │
└──────────────────────────────────────┘

​

dictGetUUIDOrDefault

지원 시작 버전: v1.1.0

딕셔너리 구성과 관계없이 딕셔너리 속성 값을 UUID 데이터 타입으로 변환하며, 키를 찾을 수 없으면 지정된 기본값을 반환합니다.

구문

dictGetUUIDOrDefault(dict_name, attr_name, id_expr, default_value_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• attr_name — 딕셔너리 컬럼 이름입니다. String 또는 Tuple(String)
• id_expr — 키 값입니다. 딕셔너리 키 타입 값 또는 튜플 값을 반환하는 표현식입니다(딕셔너리 구성에 따라 달라짐). Expression 또는 Tuple(T)
• default_value_expr — 딕셔너리에 id_expr 키를 가진 행이 없을 경우 반환되는 값입니다. Expression 또는 Tuple(T)

반환 값

id_expr에 해당하는 딕셔너리 속성 값을 반환하고, 그렇지 않으면 default_value_expr 매개변수로 전달된 값을 반환합니다.

ClickHouse는 속성 값을 파싱할 수 없거나 해당 값이 속성 데이터 타입과 일치하지 않으면 예외를 발생시킵니다.

예시

사용 예시

Query

-- 존재하는 키의 경우
SELECT dictGetUUID('all_types_dict', 'UUID_value', 1);

-- 존재하지 않는 키의 경우, 제공된 기본값을 반환
SELECT dictGetUUIDOrDefault('all_types_dict', 'UUID_value', 999, '00000000-0000-0000-0000-000000000000'::UUID);

Response

┌─dictGetUUID('all_t⋯ 'UUID_value', 1)─┐
│ 550e8400-e29b-41d4-a716-446655440000 │
└──────────────────────────────────────┘
┌─dictGetUUIDOrDefa⋯000000000000'::UUID)─┐
│ 00000000-0000-0000-0000-000000000000   │
└────────────────────────────────────────┘

​

dictHas

도입 버전: v1.1.0

딕셔너리에 키가 있는지 확인합니다.

구문

dictHas('dict_name', id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• id_expr — 키 값 const String

반환 값

키가 존재하면 1을 반환하고, 그렇지 않으면 0을 반환합니다. UInt8

예시

딕셔너리에 키가 존재하는지 확인

Query

-- 다음 계층적 딕셔너리를 고려하십시오:
-- 0 (루트)
-- └── 1 (수준 1 - 노드 1)
--     ├── 2 (수준 2 - 노드 2)
--     │   ├── 4 (수준 3 - 노드 4)
--     │   └── 5 (수준 3 - 노드 5)
--     └── 3 (수준 2 - 노드 3)
--         └── 6 (수준 3 - 노드 6)

SELECT dictHas('hierarchical_dictionary', 2);
SELECT dictHas('hierarchical_dictionary', 7);

Response

┌─dictHas('hie⋯ionary', 2)─┐
│                        1 │
└──────────────────────────┘
┌─dictHas('hie⋯ionary', 7)─┐
│                        0 │
└──────────────────────────┘

​

dictIsIn

도입 버전: v1.1.0

딕셔너리에서 계층 체인 전체를 따라 키의 상위 항목을 확인합니다.

구문

dictIsIn(dict_name, child_id_expr, ancestor_id_expr)

인수

• dict_name — 딕셔너리 이름입니다. String
• child_id_expr — 확인할 키입니다. String
• ancestor_id_expr — child_id_expr 키의 상위 조상으로 간주되는 키입니다. const String

반환 값

child_id_expr가 ancestor_id_expr의 자식이 아니면 0을 반환하고, child_id_expr가 ancestor_id_expr의 자식이거나 child_id_expr가 ancestor_id_expr와 같으면 1을 반환합니다. UInt8

예시

계층 관계 확인

Query

-- 유효한 계층 구조
SELECT dictIsIn('hierarchical_dictionary', 6, 3)

-- 유효하지 않은 계층 구조
SELECT dictIsIn('hierarchical_dictionary', 3, 5)

Response

┌─dictIsIn('hi⋯ary', 6, 3)─┐
│                        1 │
└──────────────────────────┘
┌─dictIsIn('hi⋯ary', 3, 5)─┐
│                        0 │
└──────────────────────────┘