mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-22 23:52:03 +00:00
Правки после консультации с разработчиком
This commit is contained in:
Mikhail
parent
d891a513db
commit
a97f859605
@ -3,6 +3,9 @@ toc_priority: 58
|
||||
toc_title: External Dictionaries
|
||||
---
|
||||
|
||||
!!! attention "Attention"
|
||||
For dictionaries, created with [DDL queries](../../sql-reference/statements/create/dictionary.md), the `dict_name` parameter must be fully specified, like `<database>.<dict_name>`. Otherwise, the current database is used.
|
||||
|
||||
# Functions for Working with External Dictionaries {#ext_dict_functions}
|
||||
|
||||
For information on connecting and configuring external dictionaries, see [External dictionaries](../../sql-reference/dictionaries/external-dictionaries/external-dicts.md).
|
||||
@ -23,10 +26,6 @@ dictGetOrDefault('dict_name', 'attr_name', id_expr, default_value_expr)
|
||||
- `id_expr` — Key value. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning a [UInt64](../../sql-reference/data-types/int-uint.md) or [Tuple](../../sql-reference/data-types/tuple.md)-type value depending on the dictionary configuration.
|
||||
- `default_value_expr` — Value returned if the dictionary doesn’t contain a row with the `id_expr` key. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning the value in the data type configured for the `attr_name` attribute.
|
||||
|
||||
|
||||
!!! attention "Attention"
|
||||
For `dict_name` argument, if database name is not specified for dictionaries created with DDL, current database is used.
|
||||
|
||||
**Returned value**
|
||||
|
||||
- If ClickHouse parses the attribute successfully in the [attribute’s data type](../../sql-reference/dictionaries/external-dictionaries/external-dicts-dict-structure.md#ext_dict_structure-attributes), functions return the value of the dictionary attribute that corresponds to `id_expr`.
|
||||
@ -114,9 +113,6 @@ dictHas('dict_name', id_expr)
|
||||
- `dict_name` — Name of the dictionary. [String literal](../../sql-reference/syntax.md#syntax-string-literal).
|
||||
- `id_expr` — Key value. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning a [UInt64](../../sql-reference/data-types/int-uint.md) or [Tuple](../../sql-reference/data-types/tuple.md)-type value depending on the dictionary configuration.
|
||||
|
||||
!!! attention "Attention"
|
||||
For `dict_name` argument, if database name is not specified for dictionaries created with DDL, current database is used.
|
||||
|
||||
**Returned value**
|
||||
|
||||
- 0, if there is no key.
|
||||
@ -139,9 +135,6 @@ dictGetHierarchy('dict_name', key)
|
||||
- `dict_name` — Name of the dictionary. [String literal](../../sql-reference/syntax.md#syntax-string-literal).
|
||||
- `key` — Key value. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning a [UInt64](../../sql-reference/data-types/int-uint.md)-type value.
|
||||
|
||||
!!! attention "Attention"
|
||||
`dict_name` parameter must be fully qualified for dictionaries created with DDL queries. Eg. `<database>.<dict_name>`.
|
||||
|
||||
**Returned value**
|
||||
|
||||
- Parents for the key.
|
||||
@ -162,9 +155,6 @@ dictIsIn('dict_name', child_id_expr, ancestor_id_expr)
|
||||
- `child_id_expr` — Key to be checked. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning a [UInt64](../../sql-reference/data-types/int-uint.md)-type value.
|
||||
- `ancestor_id_expr` — Alleged ancestor of the `child_id_expr` key. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning a [UInt64](../../sql-reference/data-types/int-uint.md)-type value.
|
||||
|
||||
!!! attention "Attention"
|
||||
`dict_name` parameter must be fully qualified for dictionaries created with DDL queries. Eg. `<database>.<dict_name>`.
|
||||
|
||||
**Returned value**
|
||||
|
||||
- 0, if `child_id_expr` is not a child of `ancestor_id_expr`.
|
||||
@ -202,9 +192,6 @@ dictGet[Type]OrDefault('dict_name', 'attr_name', id_expr, default_value_expr)
|
||||
- `id_expr` — Key value. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning a [UInt64](../../sql-reference/data-types/int-uint.md) or [Tuple](../../sql-reference/data-types/tuple.md)-type value depending on the dictionary configuration.
|
||||
- `default_value_expr` — Value returned if the dictionary doesn’t contain a row with the `id_expr` key. [Expression](../../sql-reference/syntax.md#syntax-expressions) returning the value in the data type configured for the `attr_name` attribute.
|
||||
|
||||
!!! attention "Attention"
|
||||
`dict_name` parameter must be fully qualified for dictionaries created with DDL queries. Eg. `<database>.<dict_name>`.
|
||||
|
||||
**Returned value**
|
||||
|
||||
- If ClickHouse parses the attribute successfully in the [attribute’s data type](../../sql-reference/dictionaries/external-dictionaries/external-dicts-dict-structure.md#ext_dict_structure-attributes), functions return the value of the dictionary attribute that corresponds to `id_expr`.
|
||||
|
||||
@ -3,6 +3,9 @@ toc_priority: 58
|
||||
toc_title: "Функции для работы с внешними словарями"
|
||||
---
|
||||
|
||||
!!! attention "Внимание"
|
||||
Для словарей, созданных с помощью [DDL-запросов](../../sql-reference/statements/create/dictionary.md), в параметре `dict_name` указывается полное имя словаря вместе с базой данных, например: `<database>.<dict_name>`. Если база данных не указана, используется текущая.
|
||||
|
||||
# Функции для работы с внешними словарями {#ext_dict_functions}
|
||||
|
||||
Информацию о подключении и настройке внешних словарей смотрите в разделе [Внешние словари](../../sql-reference/dictionaries/external-dictionaries/external-dicts.md).
|
||||
@ -23,9 +26,6 @@ dictGetOrDefault('dict_name', 'attr_name', id_expr, default_value_expr)
|
||||
- `id_expr` — значение ключа словаря. [Выражение](../syntax.md#syntax-expressions), возвращающее значение типа [UInt64](../../sql-reference/functions/ext-dict-functions.md) или [Tuple](../../sql-reference/functions/ext-dict-functions.md) в зависимости от конфигурации словаря.
|
||||
- `default_value_expr` — значение, возвращаемое в том случае, когда словарь не содержит строки с заданным ключом `id_expr`. [Выражение](../syntax.md#syntax-expressions) возвращающее значение с типом данных, сконфигурированным для атрибута `attr_name`.
|
||||
|
||||
!!! attention "Внимание"
|
||||
Если в параметре `dict_name` не указано имя базы данных перед именем созданного с помощью DDL-запросов словаря, тогда используется имя текущей базы данных.
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
- Значение атрибута, соответствующее ключу `id_expr`, если ClickHouse смог привести это значение к [заданному типу данных](../../sql-reference/functions/ext-dict-functions.md#ext_dict_structure-attributes).
|
||||
@ -113,9 +113,6 @@ dictHas('dict_name', id)
|
||||
- `dict_name` — имя словаря. [Строковый литерал](../syntax.md#syntax-string-literal).
|
||||
- `id_expr` — значение ключа словаря. [Выражение](../syntax.md#syntax-expressions), возвращающее значение типа [UInt64](../../sql-reference/functions/ext-dict-functions.md) или [Tuple](../../sql-reference/functions/ext-dict-functions.md) в зависимости от конфигурации словаря.
|
||||
|
||||
!!! attention "Внимание"
|
||||
Если в параметре `dict_name` не указано имя базы данных перед именем созданного с помощью DDL-запросов словаря, тогда используется имя текущей базы данных.
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
- 0, если ключа нет.
|
||||
@ -138,9 +135,6 @@ dictGetHierarchy('dict_name', key)
|
||||
- `dict_name` — имя словаря. [Строковый литерал](../syntax.md#syntax-string-literal).
|
||||
- `key` — значение ключа. [Выражение](../syntax.md#syntax-expressions), возвращающее значение типа [UInt64](../../sql-reference/functions/ext-dict-functions.md).
|
||||
|
||||
!!! attention "Внимание"
|
||||
В аргументе `dict_name` для словарей, созданных с помощью DDL-запросов, имя должно указываться целиком, включая базу данных. Формат: `<database>.<dict_name>`.
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
- Цепочка предков заданного ключа.
|
||||
@ -159,9 +153,6 @@ Type: [Array(UInt64)](../../sql-reference/functions/ext-dict-functions.md).
|
||||
- `child_id_expr` — ключ для проверки. [Выражение](../syntax.md#syntax-expressions), возвращающее значение типа [UInt64](../../sql-reference/functions/ext-dict-functions.md).
|
||||
- `ancestor_id_expr` — предполагаемый предок ключа `child_id_expr`. [Выражение](../syntax.md#syntax-expressions), возвращающее значение типа [UInt64](../../sql-reference/functions/ext-dict-functions.md).
|
||||
|
||||
!!! attention "Внимание"
|
||||
В аргументе `dict_name` для словарей, созданных с помощью DDL-запросов, имя должно указываться целиком, включая базу данных. Формат: `<database>.<dict_name>`.
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
- 0, если `child_id_expr` — не дочерний элемент `ancestor_id_expr`.
|
||||
@ -199,9 +190,6 @@ dictGet[Type]OrDefault('dict_name', 'attr_name', id_expr, default_value_expr)
|
||||
- `id_expr` — значение ключа словаря. [Выражение](../syntax.md#syntax-expressions), возвращающее значение типа [UInt64](../../sql-reference/functions/ext-dict-functions.md) или [Tuple](../../sql-reference/functions/ext-dict-functions.md) в зависимости от конфигурации словаря.
|
||||
- `default_value_expr` — значение, возвращаемое в том случае, когда словарь не содержит строки с заданным ключом `id_expr`. [Выражение](../syntax.md#syntax-expressions), возвращающее значение с типом данных, сконфигурированным для атрибута `attr_name`.
|
||||
|
||||
!!! attention "Внимание"
|
||||
В аргументе `dict_name` для словарей, созданных с помощью DDL-запросов, имя должно указываться целиком, включая базу данных. Формат: `<database>.<dict_name>`.
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
- Если ClickHouse успешно обработал атрибут в соответствии с [заданным типом данных](../../sql-reference/functions/ext-dict-functions.md#ext_dict_structure-attributes), то функции возвращают значение атрибута, соответствующее ключу `id_expr`.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user