mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-22 16:30:49 +00:00
2d2bc052e1
* Typo fix. * Links fix. * Fixed links in docs. * More fixes. * docs/en: cleaning some files * docs/en: cleaning data_types * docs/en: cleaning database_engines * docs/en: cleaning development * docs/en: cleaning getting_started * docs/en: cleaning interfaces * docs/en: cleaning operations * docs/en: cleaning query_lamguage * docs/en: cleaning en * docs/ru: cleaning data_types * docs/ru: cleaning index * docs/ru: cleaning database_engines * docs/ru: cleaning development * docs/ru: cleaning general * docs/ru: cleaning getting_started * docs/ru: cleaning interfaces * docs/ru: cleaning operations * docs/ru: cleaning query_language * docs: cleaning interfaces/http * Update docs/en/data_types/array.md decorated ``` Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/getting_started/example_datasets/nyc_taxi.md fixed typo Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/getting_started/example_datasets/ontime.md fixed typo Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/interfaces/formats.md fixed error Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/table_engines/custom_partitioning_key.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/utils/clickhouse-local.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/dicts/external_dicts_dict_sources.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/utils/clickhouse-local.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/json_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/json_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/other_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/other_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/date_time_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/table_engines/jdbc.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * docs: fixed error * docs: fixed error
100 lines
6.8 KiB
Markdown
100 lines
6.8 KiB
Markdown
# Nested(Name1 Type1, Name2 Type2, ...)
|
||
|
||
Вложенная структура данных - это как будто вложенная таблица. Параметры вложенной структуры данных - имена и типы столбцов, указываются так же, как у запроса CREATE. Каждой строке таблицы может соответствовать произвольное количество строк вложенной структуры данных.
|
||
|
||
Пример:
|
||
|
||
```sql
|
||
CREATE TABLE test.visits
|
||
(
|
||
CounterID UInt32,
|
||
StartDate Date,
|
||
Sign Int8,
|
||
IsNew UInt8,
|
||
VisitID UInt64,
|
||
UserID UInt64,
|
||
...
|
||
Goals Nested
|
||
(
|
||
ID UInt32,
|
||
Serial UInt32,
|
||
EventTime DateTime,
|
||
Price Int64,
|
||
OrderID String,
|
||
CurrencyID UInt32
|
||
),
|
||
...
|
||
) ENGINE = CollapsingMergeTree(StartDate, intHash32(UserID), (CounterID, StartDate, intHash32(UserID), VisitID), 8192, Sign)
|
||
```
|
||
|
||
В этом примере объявлена вложенная структура данных `Goals`, содержащая данные о достижении целей. Каждой строке таблицы visits может соответствовать от нуля до произвольного количества достижений целей.
|
||
|
||
Поддерживается только один уровень вложенности. Столбцы вложенных структур, содержащие массивы, эквивалентны многомерным массивам, поэтому их поддержка ограничена (не поддерживается хранение таких столбцов в таблицах с движком семейства MergeTree).
|
||
|
||
В большинстве случаев, при работе с вложенной структурой данных, указываются отдельные её столбцы. Для этого, имена столбцов указываются через точку. Эти столбцы представляют собой массивы соответствующих типов. Все столбцы-массивы одной вложенной структуры данных имеют одинаковые длины.
|
||
|
||
Пример:
|
||
|
||
```sql
|
||
SELECT
|
||
Goals.ID,
|
||
Goals.EventTime
|
||
FROM test.visits
|
||
WHERE CounterID = 101500 AND length(Goals.ID) < 5
|
||
LIMIT 10
|
||
```
|
||
|
||
```text
|
||
┌─Goals.ID───────────────────────┬─Goals.EventTime───────────────────────────────────────────────────────────────────────────┐
|
||
│ [1073752,591325,591325] │ ['2014-03-17 16:38:10','2014-03-17 16:38:48','2014-03-17 16:42:27'] │
|
||
│ [1073752] │ ['2014-03-17 00:28:25'] │
|
||
│ [1073752] │ ['2014-03-17 10:46:20'] │
|
||
│ [1073752,591325,591325,591325] │ ['2014-03-17 13:59:20','2014-03-17 22:17:55','2014-03-17 22:18:07','2014-03-17 22:18:51'] │
|
||
│ [] │ [] │
|
||
│ [1073752,591325,591325] │ ['2014-03-17 11:37:06','2014-03-17 14:07:47','2014-03-17 14:36:21'] │
|
||
│ [] │ [] │
|
||
│ [] │ [] │
|
||
│ [591325,1073752] │ ['2014-03-17 00:46:05','2014-03-17 00:46:05'] │
|
||
│ [1073752,591325,591325,591325] │ ['2014-03-17 13:28:33','2014-03-17 13:30:26','2014-03-17 18:51:21','2014-03-17 18:51:45'] │
|
||
└────────────────────────────────┴───────────────────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
Проще всего понимать вложенную структуру данных, как набор из нескольких столбцов-массивов одинаковых длин.
|
||
|
||
Единственное место, где в запросе SELECT можно указать имя целой вложенной структуры данных, а не отдельных столбцов - секция ARRAY JOIN. Подробнее см. раздел "Секция ARRAY JOIN". Пример:
|
||
|
||
```sql
|
||
SELECT
|
||
Goal.ID,
|
||
Goal.EventTime
|
||
FROM test.visits
|
||
ARRAY JOIN Goals AS Goal
|
||
WHERE CounterID = 101500 AND length(Goals.ID) < 5
|
||
LIMIT 10
|
||
```
|
||
|
||
```text
|
||
┌─Goal.ID─┬──────Goal.EventTime─┐
|
||
│ 1073752 │ 2014-03-17 16:38:10 │
|
||
│ 591325 │ 2014-03-17 16:38:48 │
|
||
│ 591325 │ 2014-03-17 16:42:27 │
|
||
│ 1073752 │ 2014-03-17 00:28:25 │
|
||
│ 1073752 │ 2014-03-17 10:46:20 │
|
||
│ 1073752 │ 2014-03-17 13:59:20 │
|
||
│ 591325 │ 2014-03-17 22:17:55 │
|
||
│ 591325 │ 2014-03-17 22:18:07 │
|
||
│ 591325 │ 2014-03-17 22:18:51 │
|
||
│ 1073752 │ 2014-03-17 11:37:06 │
|
||
└─────────┴─────────────────────┘
|
||
```
|
||
|
||
Вы не можете сделать SELECT целой вложенной структуры данных. Можно лишь явно перечислить отдельные столбцы - её составляющие.
|
||
|
||
При запросе INSERT, вы должны передать все составляющие столбцы-массивы вложенной структуры данных по-отдельности (как если бы это были отдельные столбцы-массивы). При вставке проверяется, что они имеют одинаковые длины.
|
||
|
||
При запросе DESCRIBE, столбцы вложенной структуры данных перечисляются так же по отдельности.
|
||
|
||
Работоспособность запроса ALTER для элементов вложенных структур данных, является сильно ограниченной.
|
||
|
||
[Оригинальная статья](https://clickhouse.yandex/docs/ru/data_types/nested_data_structures/nested/) <!--hide-->
|