DOCSUP-928: Doc groupArraySample function, updated and translated into Russian (#13979)

* Updated docs in English and docs in Russian.

* Updated docs in English and docs in Russian.

* Docs in Russian.

Co-authored-by: Olga Revyakina <revolg@yandex-team.ru>

docs/en/sql-reference/aggregate-functions/reference/grouparraysample.md

@@ -9,18 +9,14 @@ Creates an array of sample argument values. The size of the resulting array is l
 **Syntax**
 
 ``` sql
-groupArraySample(max_size)(x)
-```
-or
-``` sql
-groupArraySample(max_size, seed)(x)
+groupArraySample(max_size[, seed])(x)
 ```
 
 **Parameters**
 
--   `max_size` — Maximum size of the resulting array. Positive [UInt64](../../data-types/int-uint.md).
--   `seed` — Seed for the random number generator. Optional, can be omitted. Positive [UInt64](../../data-types/int-uint.md). Default value: `123456`.
--   `x` — Argument name. [String](../../data-types/string.md).
+-   `max_size` — Maximum size of the resulting array. [UInt64](../../data-types/int-uint.md).
+-   `seed` — Seed for the random number generator. Optional. [UInt64](../../data-types/int-uint.md). Default value: `123456`.
+-   `x` — Argument (column name or expression).
 
 **Returned values**
 
@@ -42,44 +38,44 @@ Consider table `colors`:
 └────┴────────┘
 ```
 
-Select `id`-s query:
+Query with column name as argument:
 
 ``` sql
-SELECT groupArraySample(3)(id) FROM colors;
-```
-
-Result:
-
-``` text
-┌─groupArraySample(3)(id)─┐
-│ [1,2,4]                 │
-└─────────────────────────┘
-```
-
-Select `color`-s query:
-
-``` sql
-SELECT groupArraySample(3)(color) FROM colors;
+SELECT groupArraySample(3)(color) as newcolors FROM colors;
 ```
 
 Result:
 
 ```text
-┌─groupArraySample(3)(color)─┐
+┌─newcolors──────────────────┐
 │ ['white','blue','green']   │
 └────────────────────────────┘
 ```
 
-Select `color`-s query with different seed:
+Query with column name and different seed:
 
 ``` sql
-SELECT groupArraySample(3, 987654321)(color) FROM colors;
+SELECT groupArraySample(3, 987654321)(color) as newcolors FROM colors;
 ```
 
 Result:
 
 ```text
-┌─groupArraySample(3, 987654321)(color)─┐
+┌─newcolors──────────────────┐
 │ ['red','orange','green']   │
-└───────────────────────────────────────┘
+└────────────────────────────┘
+```
+
+Query with expression as argument:
+
+``` sql
+SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM colors;
+```
+
+Result:
+
+```text
+┌─newcolors───────────────────────────────────┐
+│ ['light-blue','light-orange','light-green'] │
+└─────────────────────────────────────────────┘
 ```

docs/ru/sql-reference/aggregate-functions/reference/grouparraysample.md

@@ -0,0 +1,80 @@
+---
+toc_priority: 114
+---
+
+# groupArraySample {#grouparraysample}
+
+Создает массив из случайно выбранных значений аргумента. Количество элементов в массиве ограничено значением параметра `max_size`. Элементы добавляются в результирующий массив в случайном порядке.
+
+**Синтаксис**
+
+``` sql
+groupArraySample(max_size[, seed])(x)
+```
+
+**Параметры**
+
+-   `max_size` — максимальное количество элементов в возвращаемом массиве. [UInt64](../../data-types/int-uint.md).
+-   `seed` — состояние генератора случайных чисел. Необязательный параметр. [UInt64](../../data-types/int-uint.md). Значение по умолчанию: `123456`.
+-   `x` — аргумент (название колонки таблицы или выражение).
+
+**Возвращаемые значения**
+
+-   Массив случайно выбранных значений аргумента `x`.
+
+Тип: [Массив](../../data-types/array.md).
+
+**Примеры**
+
+Рассмотрим таблицу `colors`:
+
+``` text
+┌─id─┬─color──┐
+│  1 │ red    │
+│  2 │ blue   │
+│  3 │ green  │
+│  4 │ white  │
+│  5 │ orange │
+└────┴────────┘
+```
+
+Запрос с названием колонки таблицы в качестве аргумента:
+
+``` sql
+SELECT groupArraySample(3)(color) as newcolors FROM colors;
+```
+
+Результат:
+
+```text
+┌─newcolors──────────────────┐
+│ ['white','blue','green']   │
+└────────────────────────────┘
+```
+
+Запрос с названием колонки и другим состоянием генератора случайных чисел:
+
+``` sql
+SELECT groupArraySample(3, 987654321)(color) as newcolors FROM colors;
+```
+
+Результат:
+
+```text
+┌─newcolors─────────────────────────────┐
+│ ['red','orange','green']              │
+└───────────────────────────────────────┘
+```
+
+Запрос с выражением в качестве аргумента:
+
+``` sql
+SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM colors;
+```
+Результат:
+
+```text
+┌─newcolors───────────────────────────────────┐
+│ ['light-blue','light-orange','light-green'] │
+└─────────────────────────────────────────────┘
+```