دوال للتعامل مع القواميس

بالنسبة إلى القواميس التي أُنشئت باستخدام 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 tree:

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 tree:

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);

تمرير المفاتيح إلى دوال القاموس

تعتمد وسيطة المفتاح (id_expr) في دوال مثل dictGet وdictGetOrDefault وdictGetOrNull وdictHas على مفتاح القاموس:

بالنسبة إلى قاموس ذي مفتاح بسيط (UInt64)، مرّر قيمة المفتاح مباشرة:

SELECT dictGet('simple_key_dictionary', 'attr_name', toUInt64(1));

بالنسبة إلى قاموس ذي مفتاح مركب (معقّد) يتألف من أكثر من سمة واحدة، مرّر قيم المفتاح على شكل tuple:

SELECT dictGet('complex_key_dictionary', 'attr_name', ('value_for_field1', 42));

عندما يتألف المفتاح المركب من سمة واحدة، يمكن تمرير قيمة المفتاح مباشرةً، من دون تضمينها داخل tuple. الطريقتان التاليتان صحيحتان ومتكافئتان:

SELECT dictGet('complex_key_dictionary', 'attr_name', 'key');
SELECT dictGet('complex_key_dictionary', 'attr_name', tuple('key'));

ينطبق هذا أيضًا على قواميس ip_trie، التي يكون مفتاحها سمة واحدة. ويمكن تمرير عنوان IP المراد البحث عنه مباشرةً:

SELECT dictGet('ip_trie_dictionary', 'attr_name', toIPv4('202.79.32.10'));

dictGet

أُضيفت في: v18.16.0 تسترجع القيم من القاموس.

هذه الدالة غير حتمية: يمكن أن تُرجِع نتائج مختلفة للوسيطات نفسها.

الصيغة

dictGet('dict_name', attr_names, id_expr)

الوسيطات

dict_name — اسم القاموس. String
attr_names — اسم عمود القاموس، أو Tuple من أسماء الأعمدة. String أو Tuple(String)
id_expr — قيمة المفتاح. بالنسبة إلى قاموس ذي مفتاح بسيط، تعبير يُرجع قيمة UInt64. وبالنسبة إلى قاموس ذي مفتاح مركب، تعبير يُرجع Tuple من قيم المفاتيح. وإذا كان المفتاح المركب يتكون من سمة واحدة، فيمكن تمرير قيمتها مباشرةً، من دون تغليفها في tuple. UInt64 أو Tuple(T)

القيمة المعادة تعيد قيمة سمة القاموس المقابلة لـ id_expr إذا تم العثور على المفتاح. إذا لم يتم العثور على المفتاح، فتعيد محتوى العنصر <null_value> المحدد للسمة في تهيئة القاموس. أمثلة استرجاع سمة واحدة

Query

CREATE TABLE ext_dict_test_source (id UInt32, c1 UInt32, c2 String) ENGINE = Memory;
INSERT INTO ext_dict_test_source VALUES (1, 1, '1'), (2, 2, '2'), (3, 3, '3');
CREATE DICTIONARY ext_dict_test (id UInt32, c1 UInt32, c2 String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'ext_dict_test_source' DB currentDatabase())) LAYOUT(FLAT()) LIFETIME(MIN 0 MAX 0);
SELECT dictGet('ext_dict_test', 'c1', toUInt64(1)) AS val

Response

سمات متعددة

Query

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(TABLE 'dict_mult_source' DB currentDatabase())) LAYOUT(FLAT()) LIFETIME(MIN 0 MAX 0);
SELECT
    dictGet('ext_dict_mult', ('c1','c2'), number + 1) AS val,
    toTypeName(val) AS type
FROM system.numbers
LIMIT 3;

Response

┌─val─────┬─type───────────┐
├─c1─┬─c2─┼────────────────┤
│  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 تسترجع قيم السمات لجميع العُقد التي طابقت كل مفتاح في قاموس شجرة التعبير النمطي. وباستثناء أنها تُرجع قيمًا من النوع Array(T) بدلًا من T، تعمل هذه الدالة بصورة مماثلة لـ dictGet.

هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسيطات نفسها.

البنية

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

الوسيطات

dict_name — اسم القاموس. String
attr_names — اسم عمود القاموس، أو Tuple من أسماء الأعمدة. String أو Tuple(String)
id_expr — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
limit — اختياري. الحد الأقصى لطول كل مصفوفة قيم مُعادة. عند الاقتطاع، تُمنح العقد الفرعية أولوية على العقد الأصلية، وبخلاف ذلك يُراعى ترتيب القائمة المحدد لقاموس شجرة Regexp. إذا لم يُحدَّد، فسيكون طول المصفوفة غير محدود. UInt*

القيمة المُعادة تُرجع مصفوفة من قيم سمات القاموس التي تقابل id_expr لكل سمة محددة بواسطة attr_names. إذا لم يكن في القاموس مفتاح يقابل id_expr، فستُرجع مصفوفة فارغة.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

Array(T) أمثلة مثال على الاستخدام

Query

CREATE TABLE regexp_os (id UInt64, parent_id UInt64, regexp String, keys Array(String), values Array(String)) ENGINE = Memory;
INSERT INTO regexp_os VALUES
    (1, 0, 'Linux',      ['os_replacement'], ['Linux']),
    (2, 1, 'Android',    ['os_replacement'], ['Android']),
    (3, 2, 'Android 1',  ['os_replacement'], ['Android']),
    (4, 3, 'Android 12', ['os_replacement'], ['Android']);
CREATE DICTIONARY regexp_tree (regexp String, os_replacement String DEFAULT 'Other') PRIMARY KEY regexp SOURCE(CLICKHOUSE(TABLE 'regexp_os' DB currentDatabase())) LIFETIME(MIN 0 MAX 0) LAYOUT(REGEXP_TREE);
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

القيمة المُعادة تُرجِع الأبناء المباشرين للمفتاح. Array(UInt64) أمثلة الحصول على الأبناء المباشرين لقاموس

Query

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');
CREATE DICTIONARY hierarchical_dictionary (id UInt64, parent_id UInt64 HIERARCHICAL, name String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'hierarchy_source' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetChildren('hierarchical_dictionary', 2);

Response

┌─dictGetChildren('hierarchical_dictionary', 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 — قيمة المفتاح. تعبير يُرجِع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المُعادة تُرجِع قيمة سمة القاموس المقابلة لـ id_expr، وإلا فتُرجِع محتوى العنصر <null_value> المحدد لهذه السمة في تهيئة القاموس.

يُطلق ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Date_value Date) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '2020-01-01');
CREATE DICTIONARY all_types_dict (id UInt32, Date_value Date) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetDate('all_types_dict', 'Date_value', 1)

Response

┌─dictGetDate('all_types_dict', 'Date_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) التي تُعاد إذا لم يكن القاموس يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المُعادة تُرجع قيمة سمة القاموس المقابلة لـ id_expr، وإلا فتُرجع القيمة المُمرَّرة في المعامل default_value_expr.

يُطلق ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Date_value Date) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '2024-01-15');
CREATE DICTIONARY all_types_dict (id UInt32, Date_value Date) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetDate('all_types_dict', 'Date_value', 1);

-- for key which does not exist, returns the provided default value
SELECT dictGetDateOrDefault('all_types_dict', 'Date_value', 999, toDate('1970-01-01'));

Response

┌─dictGetDate('all_types_dict', 'Date_value', 1)─┐
│                                     2024-01-15 │
└────────────────────────────────────────────────┘
┌─dictGetDateOrDefault('all_types_dict', 'Date_value', 999, toDate('1970-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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)

القيمة المُعادة يعيد قيمة سمة القاموس المطابقة لـ id_expr، وإلا فإنه يعيد محتوى العنصر <null_value> المحدد لهذه السمة في إعدادات القاموس.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, DateTime_value DateTime) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '2024-01-15 10:30:00');
CREATE DICTIONARY all_types_dict (id UInt32, DateTime_value DateTime) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetDateTime('all_types_dict', 'DateTime_value', 1)

Response

┌─dictGetDateTime('all_types_dict', 'DateTime_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) المُعادة إذا لم يحتوِ القاموس على صف مفتاحه id_expr. Expression أو Tuple(T)

القيمة المعادة تعيد قيمة سمة القاموس المطابقة لـ id_expr، وإلا فتعيد القيمة المُمرَّرة في المعامل default_value_expr.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة، أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, DateTime_value DateTime) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '2024-01-15 10:30:00');
CREATE DICTIONARY all_types_dict (id UInt32, DateTime_value DateTime) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetDateTime('all_types_dict', 'DateTime_value', 1);

-- for key which does not exist, returns the provided default value
SELECT dictGetDateTimeOrDefault('all_types_dict', 'DateTime_value', 999, toDateTime('1970-01-01 00:00:00'));

Response

┌─dictGetDateTime('all_types_dict', 'DateTime_value', 1)─┐
│                                    2024-01-15 10:30:00 │
└────────────────────────────────────────────────────────┘
┌─dictGetDateTimeOrDefault('all_types_dict', 'DateTime_value', 999, toDateTime('1970-01-01 00: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

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');
CREATE DICTIONARY hierarchical_dictionary (id UInt64, parent_id UInt64 HIERARCHICAL, name String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'hierarchy_source' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- consider the following hierarchical dictionary:
-- 0 (Root)
-- └── 1 (Level 1 - Node 1)
--     ├── 2 (Level 2 - Node 2)
--     │   ├── 4 (Level 3 - Node 4)
--     │   └── 5 (Level 3 - Node 5)
--     └── 3 (Level 2 - Node 3)
--         └── 6 (Level 3 - Node 6)

SELECT dictGetDescendants('hierarchical_dictionary', 0, 2)

Response

┌─dictGetDescendants('hierarchical_dictionary', 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 — قيمة المفتاح. تعبير يعيد قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)

القيمة المعادة يعيد قيمة سمة القاموس المقابلة لـ id_expr، وإلا فيعيد محتوى العنصر <null_value> المحدد لهذه السمة في إعدادات القاموس.

يُصدر ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Float32_value Float32) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -123.123);
CREATE DICTIONARY all_types_dict (id UInt32, Float32_value Float32) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetFloat32('all_types_dict', 'Float32_value', 1)

Response

┌─dictGetFloat32('all_types_dict', 'Float32_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) المُعادة إذا كان القاموس لا يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المُعادة تعيد قيمة سمة القاموس المقابلة لـ id_expr، وإلا فتعيد القيمة المُمرَّرة في المعامل default_value_expr.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Float32_value Float32) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 123.45);
CREATE DICTIONARY all_types_dict (id UInt32, Float32_value Float32) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetFloat32('all_types_dict', 'Float32_value', 1);

-- for key which does not exist, returns the provided default value (-1.0)
SELECT dictGetFloat32OrDefault('all_types_dict', 'Float32_value', 999, -1.0);

Response

┌─dictGetFloat32('all_types_dict', 'Float32_value', 1)─┐
│                                               123.45 │
└──────────────────────────────────────────────────────┘
┌─dictGetFloat32OrDefault('all_types_dict', 'Float32_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المُعادة تُعيد قيمة سمة القاموس المطابقة لـ id_expr، وإلا فتُعيد محتوى العنصر <null_value> المحدد لهذه السمة في تهيئة القاموس.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Float64_value Float64) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -123.123);
CREATE DICTIONARY all_types_dict (id UInt32, Float64_value Float64) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetFloat64('all_types_dict', 'Float64_value', 1)

Response

┌─dictGetFloat64('all_types_dict', 'Float64_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) المُعادة إذا لم يحتوِ القاموس على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المُعادة يُرجع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فسيُرجع القيمة المُمرَّرة في المعامل default_value_expr.

يُطلق ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Float64_value Float64) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 987654.123456);
CREATE DICTIONARY all_types_dict (id UInt32, Float64_value Float64) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetFloat64('all_types_dict', 'Float64_value', 1);

-- for key which does not exist, returns the provided default value (nan)
SELECT dictGetFloat64OrDefault('all_types_dict', 'Float64_value', 999, nan);

Response

┌─dictGetFloat64('all_types_dict', 'Float64_value', 1)─┐
│                                        987654.123456 │
└──────────────────────────────────────────────────────┘
┌─dictGetFloat64OrDefault('all_types_dict', 'Float64_value', 999, nan)─┐
│                                                                  nan │
└──────────────────────────────────────────────────────────────────────┘

dictGetHierarchy

قُدِّم في: v1.1.0 ينشئ مصفوفة تحتوي على جميع أسلاف مفتاح في القاموس الهرمي.

هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة للوسيطات نفسها.

الصياغة

dictGetHierarchy(dict_name, key)

الوسيطات

dict_name — اسم القاموس. String
key — قيمة المفتاح. const String

القيمة المُعادة يعيد الأسلاف للمفتاح. Array(UInt64) أمثلة الحصول على التسلسل الهرمي لمفتاح

Query

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');
CREATE DICTIONARY hierarchical_dictionary (id UInt64, parent_id UInt64 HIERARCHICAL, name String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'hierarchy_source' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetHierarchy('hierarchical_dictionary', 5)

Response

┌─dictGetHierarchy('hierarchical_dictionary', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة من نوع Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)

القيمة المُعادة يُرجع قيمة سمة القاموس المقابلة لـ id_expr، وإلا فيُرجع محتوى العنصر <null_value> المحدد لهذه السمة في إعدادات القاموس.

يُطلق ClickHouse استثناءً إذا تعذر عليه تفسير قيمة السمة، أو إذا لم تتطابق القيمة مع نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, IPv4_value IPv4) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '192.168.0.1');
CREATE DICTIONARY all_types_dict (id UInt32, IPv4_value IPv4) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetIPv4('all_types_dict', 'IPv4_value', 1)

Response

┌─dictGetIPv4('all_types_dict', '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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة أو القيم التي تُرجع إذا لم يكن القاموس يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

يُطلِق ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال للاستخدام

Query

CREATE TABLE all_types_test (id UInt32, IPv4_value IPv4) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '192.168.0.1');
CREATE DICTIONARY all_types_dict (id UInt32, IPv4_value IPv4) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetIPv4('all_types_dict', 'IPv4_value', 1);

-- for key which does not exist, returns the provided default value
SELECT dictGetIPv4OrDefault('all_types_dict', 'IPv4_value', 999, toIPv4('0.0.0.0'));

Response

┌─dictGetIPv4('all_types_dict', 'IPv4_value', 1)─┐
│ 192.168.0.1                                    │
└────────────────────────────────────────────────┘
┌─dictGetIPv4OrDefault('all_types_dict', 'IPv4_value', 999, toIPv4('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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المُعادة تُرجع قيمة سمة القاموس المقابلة لـ id_expr، وإلا فتُرجع محتوى العنصر <null_value> المحدد للسمة في تهيئة القاموس.

يُصدر ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, IPv6_value IPv6) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '2001:db8:85a3::8a2e:370:7334');
CREATE DICTIONARY all_types_dict (id UInt32, IPv6_value IPv6) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetIPv6('all_types_dict', 'IPv6_value', 1)

Response

┌─dictGetIPv6('all_types_dict', '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 — قيمة المفتاح. تعبير يعيد قيمة من نوع مفتاح القاموس أو قيمة tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) التي تُعاد إذا لم يحتوِ القاموس على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المعادة تعيد قيمة سمة القاموس المطابقة لـ id_expr، وإلا فتعيد القيمة المُمرَّرة عبر المعامل default_value_expr.

يطلق ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تتطابق القيمة مع نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, IPv6_value IPv6) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '2001:db8:85a3::8a2e:370:7334');
CREATE DICTIONARY all_types_dict (id UInt32, IPv6_value IPv6) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetIPv6('all_types_dict', 'IPv6_value', 1);

-- for key which does not exist, returns the provided default value
SELECT dictGetIPv6OrDefault('all_types_dict', 'IPv6_value', 999, '::1'::IPv6);

Response

┌─dictGetIPv6('all_types_dict', 'IPv6_value', 1)─┐
│ 2001:db8:85a3::8a2e:370:7334                   │
└────────────────────────────────────────────────┘
┌─dictGetIPv6OrDefault('all_types_dict', 'IPv6_value', 999, CAST('::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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المعادة يعيد قيمة سمة القاموس المطابقة لـ id_expr، وإلا فيُعيد محتوى العنصر <null_value> المحدد لهذه السمة في تهيئة القاموس.

يطرح ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int16_value Int16) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -5000);
CREATE DICTIONARY all_types_dict (id UInt32, Int16_value Int16) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetInt16('all_types_dict', 'Int16_value', 1)

Response

┌─dictGetInt16('all_types_dict', 'Int16_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) المُعادة إذا كان القاموس لا يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المُعادة يعيد قيمة سمة القاموس المطابقة لـ id_expr، وإلا فيعيد القيمة المُمرَّرة في المعامل default_value_expr.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int16_value Int16) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -5000);
CREATE DICTIONARY all_types_dict (id UInt32, Int16_value Int16) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetInt16('all_types_dict', 'Int16_value', 1);

-- for key which does not exist, returns the provided default value (-1)
SELECT dictGetInt16OrDefault('all_types_dict', 'Int16_value', 999, -1);

Response

┌─dictGetInt16('all_types_dict', 'Int16_value', 1)─┐
│                                            -5000 │
└──────────────────────────────────────────────────┘
┌─dictGetInt16OrDefault('all_types_dict', 'Int16_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)

القيمة المُعادة تُرجع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فتُرجع محتوى العنصر <null_value> المحدَّد لهذه السمة في إعدادات القاموس.

يُطلق ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int32_value Int32) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -1000000);
CREATE DICTIONARY all_types_dict (id UInt32, Int32_value Int32) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetInt32('all_types_dict', 'Int32_value', 1)

Response

┌─dictGetInt32('all_types_dict', 'Int32_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) التي تُرجع إذا لم يحتوِ القاموس على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المُعادة تُرجع قيمة سمة القاموس المقابلة لـ id_expr، وإلا تُرجع القيمة الممرَّرة في المعامل default_value_expr.

يُصدر ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int32_value Int32) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -1000000);
CREATE DICTIONARY all_types_dict (id UInt32, Int32_value Int32) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetInt32('all_types_dict', 'Int32_value', 1);

-- for key which does not exist, returns the provided default value (-1)
SELECT dictGetInt32OrDefault('all_types_dict', 'Int32_value', 999, -1);

Response

┌─dictGetInt32('all_types_dict', 'Int32_value', 1)─┐
│                                         -1000000 │
└──────────────────────────────────────────────────┘
┌─dictGetInt32OrDefault('all_types_dict', 'Int32_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)

القيمة المُعادة تُرجع قيمة سمة القاموس المقابلة لـ id_expr، وإلا فتُرجع محتوى العنصر <null_value> المحدد لهذه السمة في إعدادات القاموس.

يُصدر ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int64_value Int64) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -9223372036854775807);
CREATE DICTIONARY all_types_dict (id UInt32, Int64_value Int64) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetInt64('all_types_dict', 'Int64_value', 1)

Response

┌─dictGetInt64('all_types_dict', 'Int64_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) التي تُعاد إذا لم يحتوي القاموس على صف يحمل المفتاح id_expr. Expression أو Tuple(T)

القيمة المعادة يعيد قيمة سمة القاموس المقابلة لـ id_expr، وإلا فسيعيد القيمة المُمرَّرة في المعامل default_value_expr.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int64_value Int64) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -9223372036854775808);
CREATE DICTIONARY all_types_dict (id UInt32, Int64_value Int64) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetInt64('all_types_dict', 'Int64_value', 1);

-- for key which does not exist, returns the provided default value (-1)
SELECT dictGetInt64OrDefault('all_types_dict', 'Int64_value', 999, -1);

Response

┌─dictGetInt64('all_types_dict', 'Int64_value', 1)─┐
│                             -9223372036854775808 │
└──────────────────────────────────────────────────┘
┌─dictGetInt64OrDefault('all_types_dict', 'Int64_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int8_value Int8) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -100);
CREATE DICTIONARY all_types_dict (id UInt32, Int8_value Int8) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetInt8('all_types_dict', 'Int8_value', 1)

Response

┌─dictGetInt8('all_types_dict', 'Int8_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 — قيمة المفتاح. تعبير يعيد قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) المعادة إذا كان القاموس لا يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المعادة يعيد قيمة سمة القاموس المقابلة لـ id_expr، وإلا فيعيد القيمة المُمرَّرة في المعامل default_value_expr.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, Int8_value Int8) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, -100);
CREATE DICTIONARY all_types_dict (id UInt32, Int8_value Int8) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetInt8('all_types_dict', 'Int8_value', 1);

-- for key which does not exist, returns the provided default value (-1)
SELECT dictGetInt8OrDefault('all_types_dict', 'Int8_value', 999, -1);

Response

┌─dictGetInt8('all_types_dict', 'Int8_value', 1)─┐
│                                           -100 │
└────────────────────────────────────────────────┘
┌─dictGetInt8OrDefault('all_types_dict', 'Int8_value', 999, -1)─┐
│                                                            -1 │
└───────────────────────────────────────────────────────────────┘

dictGetKeys

تم طرحها في: v25.12.0 تعيد مفتاح/مفاتيح القاموس التي تكون سمتها مساوية للقيمة المحددة. وهذه هي معكوس الدالة dictGet لسمة واحدة. استخدم الإعداد max_reverse_dictionary_lookup_cache_size_bytes لتحديد حد أقصى لحجم ذاكرة التخزين المؤقت للبحث العكسي الخاصة بكل استعلام والمستخدَمة بواسطة dictGetKeys. تخزّن ذاكرة التخزين المؤقت Tuples المفاتيح المتسلسلة لكل قيمة سمة لتجنّب إعادة فحص القاموس ضمن الاستعلام نفسه. ولا تكون ذاكرة التخزين المؤقت دائمة عبر الاستعلامات. وعند بلوغ الحد الأقصى، تُطرَد الإدخالات وفق آلية LRU. ويكون ذلك أكثر فعالية مع القواميس الكبيرة عندما يكون للإدخال عدد قيم مميزة منخفض، وتكون مجموعة العمل ضمن حدود ذاكرة التخزين المؤقت. اضبطه على 0 لتعطيل التخزين المؤقت.

هذه الدالة غير حتمية: إذ يمكنها إرجاع نتائج مختلفة للمعاملات نفسها.

البنية

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

المعاملات

dict_name — اسم القاموس. String
attr_name — السمة المراد مطابقتها. String
value_expr — القيمة المراد مطابقتها مع السمة. Expression

القيمة المعادة بالنسبة إلى القواميس أحادية المفتاح: مصفوفة من المفاتيح التي تكون سمتها مساوية لـ value_expr. وبالنسبة إلى القواميس متعددة المفاتيح: مصفوفة من tuples للمفاتيح التي تكون سمتها مساوية لـ value_expr. إذا لم تكن هناك سمة في القاموس تقابل value_expr، فستُعاد مصفوفة فارغة. ويطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو تعذّر تحويل القيمة إلى نوع بيانات السمة. أمثلة مثال على الاستخدام

Query

CREATE TABLE task_priority_source (task_id UInt64, priority_level String) ENGINE = Memory;
INSERT INTO task_priority_source VALUES (1, 'low'), (2, 'high'), (3, 'medium'), (4, 'high');
CREATE DICTIONARY task_id_to_priority_dictionary (task_id UInt64, priority_level String) PRIMARY KEY task_id SOURCE(CLICKHOUSE(TABLE 'task_priority_source' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 0 MAX 0);
SELECT arraySort(dictGetKeys('task_id_to_priority_dictionary', 'priority_level', 'high')) AS ids;

Response

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

dictGetOrDefault

تم تقديمه في: v18.16.0 يسترجع قيماً من قاموس، مع إرجاع قيمة افتراضية إذا لم يتم العثور على المفتاح.

هذه الدالة غير حتمية: يمكن أن تُرجع نتائج مختلفة للمعاملات نفسها.

الصيغة

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

المعاملات

dict_name — اسم القاموس. String
attr_names — اسم عمود القاموس، أو Tuple من أسماء الأعمدة. String أو Tuple(String)
id_expr — قيمة المفتاح. بالنسبة إلى قاموس ذي مفتاح بسيط، تعبير يُرجع قيمة UInt64. وبالنسبة إلى قاموس ذي مفتاح مركب، تعبير يُرجع Tuple من قيم المفاتيح. إذا كان المفتاح المركب يتكون من سمة واحدة، فيمكن تمرير قيمتها مباشرةً، من دون تغليفها داخل tuple. UInt64 أو Tuple(T)
default_value — القيمة الافتراضية التي تُعاد إذا لم يُعثر على المفتاح. يجب أن يطابق النوع نوع بيانات السمة.

القيمة المُعادة تعيد قيمة سمة القاموس المطابقة لـ id_expr إذا وُجد المفتاح. إذا لم يُعثر على المفتاح، تُعيد قيمة default_value المقدَّمة. أمثلة الحصول على قيمة باستخدام قيمة افتراضية

Query

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(TABLE 'dict_mult_source' DB currentDatabase())) LAYOUT(FLAT()) LIFETIME(MIN 0 MAX 0);
SELECT dictGetOrDefault('ext_dict_mult', 'c1', toUInt64(999), 0) AS val

Response

dictGetOrNull

أُضيفت في: v21.4.0 تسترجع قيماً من قاموس، وتُرجِع NULL إذا لم يتم العثور على المفتاح.

هذه الدالة غير حتمية: قد تُرجِع نتائج مختلفة للوسائط نفسها.

الصيغة

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

الوسائط

dict_name — اسم القاموس. قيمة حرفية من نوع String. - attr_name — اسم العمود المطلوب استرجاعه. قيمة حرفية من نوع String. - id_expr — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس.

القيمة المُعادة تُرجع قيمة سمة القاموس المطابقة لـ id_expr إذا تم العثور على المفتاح. إذا لم يتم العثور على المفتاح، تُرجع NULL. أمثلة مثال باستخدام قاموس ذي مفتاح نطاقي

Query

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(TABLE 'range_key_dictionary_source_table' DB currentDatabase())) LIFETIME(MIN 1 MAX 1000) LAYOUT(RANGE_HASHED()) RANGE(MIN start_date MAX end_date);
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

dictGetRoot

قُدِّمت في: v26.7.0 تعيد أعلى سلف (الجذر) لمفتاح في قاموس هرمي. وهذا مكافئ عمليًا لأخذ آخر عنصر من المصفوفة التي تعيدها dictGetHierarchy، أي dictGetHierarchy(dict_name, key)[-1]. إذا كان المفتاح نفسه عقدة من المستوى الأعلى في التسلسل الهرمي، فسيُعاد المفتاح. وإذا لم يكن المفتاح موجودًا في القاموس، فستُعاد القيمة 0.

هذه الدالة غير حتمية: فقد تعيد نتائج مختلفة للوسيطات نفسها.

الصياغة

dictGetRoot(dict_name, key)

الوسائط

dict_name — اسم القاموس. String
key — قيمة المفتاح. UInt64

القيمة المُعادة تعيد أعلى سلف (الجذر) للمفتاح. UInt64 أمثلة الحصول على الجذر الخاص بمفتاح

Query

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');
CREATE DICTIONARY hierarchical_dictionary (id UInt64, parent_id UInt64 HIERARCHICAL, name String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'hierarchy_source' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetRoot('hierarchical_dictionary', 5)

Response

┌─dictGetRoot('hierarchical_dictionary', 5)─┐
│                                         1 │
└───────────────────────────────────────────┘

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)

يُطلق ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, String_value String) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 'test string');
CREATE DICTIONARY all_types_dict (id UInt32, String_value String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetString('all_types_dict', 'String_value', 1)

Response

┌─dictGetString('all_types_dict', 'String_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) المُعادة إذا لم يكن القاموس يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المعادة تُرجع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فتُرجع القيمة المُمرَّرة في المعامل default_value_expr.

يطرح ClickHouse استثناء إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تكن القيمة مطابقة لنوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, String_value String) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 'test string');
CREATE DICTIONARY all_types_dict (id UInt32, String_value String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetString('all_types_dict', 'String_value', 1);

-- for key which does not exist, returns the provided default value
SELECT dictGetStringOrDefault('all_types_dict', 'String_value', 999, 'default');

Response

┌─dictGetString('all_types_dict', 'String_value', 1)─┐
│ test string                                        │
└────────────────────────────────────────────────────┘
┌─dictGetStringOrDefault('all_types_dict', 'String_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)

القيمة المعادة يعيد قيمة سمة القاموس المقابلة لـ id_expr، وإلا فإنه يعيد محتوى العنصر <null_value> المحدد للسمة في إعدادات القاموس.

يُطلق ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt16_value UInt16) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 5000);
CREATE DICTIONARY all_types_dict (id UInt32, UInt16_value UInt16) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetUInt16('all_types_dict', 'UInt16_value', 1)

Response

┌─dictGetUInt16('all_types_dict', 'UInt16_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 — قيمة المفتاح. تعبير يعيد قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)
default_value_expr — القيمة أو القيم المُعادة إذا كان القاموس لا يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt16_value UInt16) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 5000);
CREATE DICTIONARY all_types_dict (id UInt32, UInt16_value UInt16) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetUInt16('all_types_dict', 'UInt16_value', 1);

-- for key which does not exist, returns the provided default value (0)
SELECT dictGetUInt16OrDefault('all_types_dict', 'UInt16_value', 999, 0);

Response

┌─dictGetUInt16('all_types_dict', 'UInt16_value', 1)─┐
│                                               5000 │
└────────────────────────────────────────────────────┘
┌─dictGetUInt16OrDefault('all_types_dict', 'UInt16_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المُعادة تُرجِع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فتُرجِع محتوى العنصر <null_value> المحدد لهذه السمة في تهيئة القاموس.

يُصدر ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt32_value UInt32) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 1000000);
CREATE DICTIONARY all_types_dict (id UInt32, UInt32_value UInt32) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetUInt32('all_types_dict', 'UInt32_value', 1)

Response

┌─dictGetUInt32('all_types_dict', 'UInt32_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة من نوع Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة أو القيم المُعادة إذا لم يكن القاموس يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المُعادة يعيد قيمة سمة القاموس المقابلة لـ id_expr، وإلا فيُعيد القيمة المُمرَّرة في المعامل default_value_expr.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تتطابق القيمة مع نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt32_value UInt32) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 1000000);
CREATE DICTIONARY all_types_dict (id UInt32, UInt32_value UInt32) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetUInt32('all_types_dict', 'UInt32_value', 1);

-- for key which does not exist, returns the provided default value (0)
SELECT dictGetUInt32OrDefault('all_types_dict', 'UInt32_value', 999, 0);

Response

┌─dictGetUInt32('all_types_dict', 'UInt32_value', 1)─┐
│                                            1000000 │
└────────────────────────────────────────────────────┘
┌─dictGetUInt32OrDefault('all_types_dict', 'UInt32_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المُعادة تُرجع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فتُرجع محتوى العنصر <null_value> المحدد لهذه السمة في تهيئة القاموس.

يطرح ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt64_value UInt64) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 9223372036854775807);
CREATE DICTIONARY all_types_dict (id UInt32, UInt64_value UInt64) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetUInt64('all_types_dict', 'UInt64_value', 1)

Response

┌─dictGetUInt64('all_types_dict', 'UInt64_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب إعدادات القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) التي تُرجع إذا لم يكن القاموس يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

يُصدر ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt64_value UInt64) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 9223372036854775807);
CREATE DICTIONARY all_types_dict (id UInt32, UInt64_value UInt64) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetUInt64('all_types_dict', 'UInt64_value', 1);

-- for key which does not exist, returns the provideddefault value (0)
SELECT dictGetUInt64OrDefault('all_types_dict', 'UInt64_value', 999, 0);

Response

┌─dictGetUInt64('all_types_dict', 'UInt64_value', 1)─┐
│                                9223372036854775807 │
└────────────────────────────────────────────────────┘
┌─dictGetUInt64OrDefault('all_types_dict', 'UInt64_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المعادة يُرجع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فيُرجع محتوى العنصر <null_value> المحدد لهذه السمة في تهيئة القاموس.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt8_value UInt8) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 100);
CREATE DICTIONARY all_types_dict (id UInt32, UInt8_value UInt8) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetUInt8('all_types_dict', 'UInt8_value', 1)

Response

┌─dictGetUInt8('all_types_dict', 'UInt8_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)
default_value_expr — القيمة (أو القيم) المُعادة إذا لم يكن القاموس يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المعادة يُرجع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فيُرجع القيمة المُمرَّرة في الوسيط default_value_expr.

يُطلق ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UInt8_value UInt8) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, 100);
CREATE DICTIONARY all_types_dict (id UInt32, UInt8_value UInt8) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetUInt8('all_types_dict', 'UInt8_value', 1);

-- for key which does not exist, returns the provided default value (0)
SELECT dictGetUInt8OrDefault('all_types_dict', 'UInt8_value', 999, 0);

Response

┌─dictGetUInt8('all_types_dict', 'UInt8_value', 1)─┐
│                                              100 │
└──────────────────────────────────────────────────┘
┌─dictGetUInt8OrDefault('all_types_dict', 'UInt8_value', 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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة Tuple (بحسب تهيئة القاموس). Expression أو Tuple(T)

القيمة المُعادة يُرجع قيمة سمة القاموس المطابقة لـ id_expr، وإلا فيُرجع محتوى العنصر <null_value> المحدد لهذه السمة في تهيئة القاموس.

يطرح ClickHouse استثناءً إذا تعذر عليه تحليل قيمة السمة أو إذا لم تطابق القيمة نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UUID_value UUID) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '123e4567-e89b-12d3-a456-426614174000');
CREATE DICTIONARY all_types_dict (id UInt32, UUID_value UUID) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
SELECT dictGetUUID('all_types_dict', 'UUID_value', 1)

Response

┌─dictGetUUID('all_types_dict', 'UUID_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 — قيمة المفتاح. تعبير يُرجع قيمة من نوع مفتاح القاموس أو قيمة tuple (بحسب إعداد القاموس). Expression أو Tuple(T)
default_value_expr — القيمة أو القيم التي تُرجع إذا لم يكن القاموس يحتوي على صف بالمفتاح id_expr. Expression أو Tuple(T)

القيمة المعادة تُرجع قيمة سمة القاموس المقابلة لـ id_expr، وإلا فتُرجع القيمة المُمرَّرة في الوسيط default_value_expr.

يطرح ClickHouse استثناءً إذا تعذّر عليه تحليل قيمة السمة أو إذا كانت القيمة لا تطابق نوع بيانات السمة.

أمثلة مثال على الاستخدام

Query

CREATE TABLE all_types_test (id UInt32, UUID_value UUID) ENGINE = MergeTree() ORDER BY id;
INSERT INTO all_types_test VALUES (1, '550e8400-e29b-41d4-a716-446655440000');
CREATE DICTIONARY all_types_dict (id UInt32, UUID_value UUID) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'all_types_test' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- for key which exists
SELECT dictGetUUID('all_types_dict', 'UUID_value', 1);

-- for key which does not exist, returns the provided default value
SELECT dictGetUUIDOrDefault('all_types_dict', 'UUID_value', 999, '00000000-0000-0000-0000-000000000000'::UUID);

Response

┌─dictGetUUID('all_types_dict', 'UUID_value', 1)─┐
│ 550e8400-e29b-41d4-a716-446655440000           │
└────────────────────────────────────────────────┘
┌─dictGetUUIDOrDefault('all_types_dict', 'UUID_value', 999, CAST('00000000-0000-0000-0000-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

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');
CREATE DICTIONARY hierarchical_dictionary (id UInt64, parent_id UInt64 HIERARCHICAL, name String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'hierarchy_source' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- consider the following hierarchical dictionary:
-- 0 (Root)
-- └── 1 (Level 1 - Node 1)
--     ├── 2 (Level 2 - Node 2)
--     │   ├── 4 (Level 3 - Node 4)
--     │   └── 5 (Level 3 - Node 5)
--     └── 3 (Level 2 - Node 3)
--         └── 6 (Level 3 - Node 6)

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

Response

┌─dictHas('hierarchical_dictionary', 2)─┐
│                                     1 │
└───────────────────────────────────────┘
┌─dictHas('hierarchical_dictionary', 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

القيمة المعادة تُرجع 0 إذا لم يكن child_id_expr تابعًا لـ ancestor_id_expr، وتُرجع 1 إذا كان child_id_expr تابعًا لـ ancestor_id_expr أو إذا كان child_id_expr هو نفسه ancestor_id_expr. UInt8 أمثلة التحقق من العلاقة الهرمية

Query

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');
CREATE DICTIONARY hierarchical_dictionary (id UInt64, parent_id UInt64 HIERARCHICAL, name String) PRIMARY KEY id SOURCE(CLICKHOUSE(TABLE 'hierarchy_source' DB currentDatabase())) LAYOUT(HASHED()) LIFETIME(MIN 300 MAX 600);
-- valid hierarchy
SELECT dictIsIn('hierarchical_dictionary', 6, 3);

-- invalid hierarchy
SELECT dictIsIn('hierarchical_dictionary', 3, 5);

Response

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

​قواميس الأمثلة

​تمرير المفاتيح إلى دوال القاموس

​dictGet

​dictGetAll

​dictGetChildren

​dictGetDate

​dictGetDateOrDefault

​dictGetDateTime

​dictGetDateTimeOrDefault

​dictGetDescendants

​dictGetFloat32

​dictGetFloat32OrDefault

​dictGetFloat64

​dictGetFloat64OrDefault

​dictGetHierarchy

​dictGetIPv4

​dictGetIPv4OrDefault

​dictGetIPv6

​dictGetIPv6OrDefault

​dictGetInt16

​dictGetInt16OrDefault

​dictGetInt32

​dictGetInt32OrDefault

​dictGetInt64

​dictGetInt64OrDefault

​dictGetInt8

​dictGetInt8OrDefault

​dictGetKeys

​dictGetOrDefault

​dictGetOrNull

​dictGetRoot

​dictGetString

​dictGetStringOrDefault

​dictGetUInt16

​dictGetUInt16OrDefault

​dictGetUInt32

​dictGetUInt32OrDefault

​dictGetUInt64

​dictGetUInt64OrDefault

​dictGetUInt8

​dictGetUInt8OrDefault

​dictGetUUID

​dictGetUUIDOrDefault

​dictHas

​dictIsIn

قواميس الأمثلة

تمرير المفاتيح إلى دوال القاموس

dictGet

dictGetAll

dictGetChildren

dictGetDate

dictGetDateOrDefault

dictGetDateTime

dictGetDateTimeOrDefault

dictGetDescendants

dictGetFloat32

dictGetFloat32OrDefault

dictGetFloat64

dictGetFloat64OrDefault

dictGetHierarchy

dictGetIPv4

dictGetIPv4OrDefault

dictGetIPv6

dictGetIPv6OrDefault

dictGetInt16

dictGetInt16OrDefault

dictGetInt32

dictGetInt32OrDefault

dictGetInt64

dictGetInt64OrDefault

dictGetInt8

dictGetInt8OrDefault

dictGetKeys

dictGetOrDefault

dictGetOrNull

dictGetRoot

dictGetString

dictGetStringOrDefault

dictGetUInt16

dictGetUInt16OrDefault

dictGetUInt32

dictGetUInt32OrDefault

dictGetUInt64

dictGetUInt64OrDefault

dictGetUInt8

dictGetUInt8OrDefault

dictGetUUID

dictGetUUIDOrDefault

dictHas

dictIsIn