From 39d4316a69b8c8f2da7e5495588228f9b612fb1a Mon Sep 17 00:00:00 2001 From: FeehanG <51821376+FeehanG@users.noreply.github.com> Date: Tue, 24 Dec 2019 17:35:17 +0300 Subject: [PATCH 1/4] Update array_functions.md (#75) --- docs/en/query_language/functions/array_functions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/en/query_language/functions/array_functions.md b/docs/en/query_language/functions/array_functions.md index ab194deff15..f4c2908d74a 100644 --- a/docs/en/query_language/functions/array_functions.md +++ b/docs/en/query_language/functions/array_functions.md @@ -794,13 +794,13 @@ Synonym for ["arrayReverse"](#array_functions-arrayreverse) ## arrayFlatten {#arrayflatten} -Converts array of arrays to a flat array. +Converts an array of arrays to a flat array. Function: -- Applies for any depth of nested arrays, but all the elements should lay at the same level. +- Applies to any depth of nested arrays, but all the elements must be on the same level. - For example, the `[[[1]], [[2], [3]]]` array can be flattened, but the `[[1], [[2], [3]]]` array can't be flattened. + For example, array `[[[1]], [[2], [3]]]` can be flattened, but array `[[1], [[2], [3]]]` can't. - Does not change arrays that are already flat. From 2d04d39d6b84b15de6d77d7c91cb702555606887 Mon Sep 17 00:00:00 2001 From: Sergei Shtykov Date: Tue, 24 Dec 2019 18:10:21 +0300 Subject: [PATCH 2/4] DOCAPI-6182: EN review. RU translation. --- .../functions/array_functions.md | 54 +++++++++++++------ 1 file changed, 38 insertions(+), 16 deletions(-) diff --git a/docs/ru/query_language/functions/array_functions.md b/docs/ru/query_language/functions/array_functions.md index f12395ca64d..fded68dfc75 100644 --- a/docs/ru/query_language/functions/array_functions.md +++ b/docs/ru/query_language/functions/array_functions.md @@ -778,22 +778,6 @@ SELECT arrayReduce('uniqUpTo(3)', [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]) └─────────────────────────────────────────────────────────────┘ ``` -## arrayFlatten(arr) {#array_functions-arrayflatten} - -Функция `arrayFlatten` (или `flatten`) соеденит вложенные массивы и вернет массив из их элементов. - -Пример: - -```sql -SELECT arrayFlatten([[1, 2, 3], [4, 5]]) -``` - -```text -┌─arrayFlatten([[1, 2, 3], [4, 5]])─┐ -│ [1,2,3,4,5] │ -└───────────────────────────────────┘ -``` - ## arrayReverse(arr) {#array_functions-arrayreverse} Возвращает массив того же размера, что и исходный массив, содержащий элементы в обратном порядке. @@ -814,6 +798,44 @@ SELECT arrayReverse([1, 2, 3]) Синоним для ["arrayReverse"](#array_functions-arrayreverse) +## arrayFlatten {#arrayflatten} + +Преобразует массив массивов в плоский массив. + +Функция: + +- Оперирует с массивами любой вложенности, однако все элементы всех массивов должны находиться на одном уровне. + + Например, массив `[[[1]], [[2], [3]]]` функция сделает плоским, а массив `[[1], [[2], [3]]]` нет. + +- Не изменяет массив, если он уже плоский. + +Результирующий массив содержит все элементы исходных массивов. + +**Синтаксис** + +```sql +flatten(array_of_arrays) +``` + +Синоним: `flatten`. + + +**Параметры** + +- `array_of_arrays` — [Массивов](../../data_types/array.md) массивов. Например, `[[1,2,3], [4,5]]`. + +**Примеры** + +```sql +SELECT flatten([[[1]], [[2], [3]]]) +``` +```text +┌─flatten(array(array([1]), array([2], [3])))─┐ +│ [1,2,3] │ +└─────────────────────────────────────────────┘ +``` + ## arrayCompact {#arraycompact} Удаляет дубликаты из массива. Порядок результирующих значений определяется порядком в исходном массиве. From bf0fd8aa7d28a9f56b0e11d52291e09bca35025c Mon Sep 17 00:00:00 2001 From: alexey-milovidov Date: Thu, 26 Dec 2019 20:17:25 +0300 Subject: [PATCH 3/4] Update array_functions.md --- docs/en/query_language/functions/array_functions.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/docs/en/query_language/functions/array_functions.md b/docs/en/query_language/functions/array_functions.md index 32423103ae3..6d5d9ccd6bf 100644 --- a/docs/en/query_language/functions/array_functions.md +++ b/docs/en/query_language/functions/array_functions.md @@ -798,10 +798,7 @@ Converts an array of arrays to a flat array. Function: -- Applies to any depth of nested arrays, but all the elements must be on the same level. - - For example, array `[[[1]], [[2], [3]]]` can be flattened, but array `[[1], [[2], [3]]]` can't. - +- Applies to any depth of nested arrays. - Does not change arrays that are already flat. The flattened array contains all the elements from all source arrays. From 621e0e635fa21e3fd344116439f7b9056ec29b30 Mon Sep 17 00:00:00 2001 From: alexey-milovidov Date: Thu, 26 Dec 2019 20:17:55 +0300 Subject: [PATCH 4/4] Update array_functions.md --- docs/ru/query_language/functions/array_functions.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/docs/ru/query_language/functions/array_functions.md b/docs/ru/query_language/functions/array_functions.md index 6bbfbd1f225..d8eaae99c64 100644 --- a/docs/ru/query_language/functions/array_functions.md +++ b/docs/ru/query_language/functions/array_functions.md @@ -804,10 +804,7 @@ SELECT arrayReverse([1, 2, 3]) Функция: -- Оперирует с массивами любой вложенности, однако все элементы всех массивов должны находиться на одном уровне. - - Например, массив `[[[1]], [[2], [3]]]` функция сделает плоским, а массив `[[1], [[2], [3]]]` нет. - +- Оперирует с массивами любой вложенности. - Не изменяет массив, если он уже плоский. Результирующий массив содержит все элементы исходных массивов.