From cc2a287a8960b1baa5cdf54178d194c2e41c669b Mon Sep 17 00:00:00 2001 From: sevirov <72220289+sevirov@users.noreply.github.com> Date: Sat, 28 Nov 2020 14:38:57 +0300 Subject: [PATCH] DOCSUP-3922: Document the tuple functions (#17505) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Update in-functions.md and tuple-functions.md Изменил регистр в названиях разделов. * Update tuple-functions.md and in-functions.md Убрал описание операторов из in-functions.md. Co-authored-by: Dmitriy --- .../sql-reference/functions/in-functions.md | 20 ------------------- .../functions/tuple-functions.md | 18 +++++++---------- .../sql-reference/functions/in-functions.md | 20 ------------------- .../functions/tuple-functions.md | 18 +++++++---------- 4 files changed, 14 insertions(+), 62 deletions(-) diff --git a/docs/en/sql-reference/functions/in-functions.md b/docs/en/sql-reference/functions/in-functions.md index e7ee28861b7..dd3c1900fdc 100644 --- a/docs/en/sql-reference/functions/in-functions.md +++ b/docs/en/sql-reference/functions/in-functions.md @@ -9,24 +9,4 @@ toc_title: IN Operator See the section [IN operators](../../sql-reference/operators/in.md#select-in-operators). -## tuple(x, y, …), operator (x, y, …) {#tuplex-y-operator-x-y} - -A function that allows grouping multiple columns. -For columns with the types T1, T2, …, it returns a Tuple(T1, T2, …) type tuple containing these columns. There is no cost to execute the function. -Tuples are normally used as intermediate values for an argument of IN operators, or for creating a list of formal parameters of lambda functions. Tuples can’t be written to a table. - -**See Also** - -- [Tuple](../../sql-reference/functions/tuple-functions.md#tuple) - -## tupleElement(tuple, n), operator x.N {#tupleelementtuple-n-operator-x-n} - -A function that allows getting a column from a tuple. -‘N’ is the column index, starting from 1. N must be a constant. ‘N’ must be a constant. ‘N’ must be a strict postive integer no greater than the size of the tuple. -There is no cost to execute the function. - -**See Also** - -- [TupleElement](../../sql-reference/functions/tuple-functions.md#tupleelement) - [Original article](https://clickhouse.tech/docs/en/query_language/functions/in_functions/) diff --git a/docs/en/sql-reference/functions/tuple-functions.md b/docs/en/sql-reference/functions/tuple-functions.md index 020516f5727..dcbcd3e374b 100644 --- a/docs/en/sql-reference/functions/tuple-functions.md +++ b/docs/en/sql-reference/functions/tuple-functions.md @@ -5,39 +5,35 @@ toc_title: Tuples # Functions for Working with Tuples {#tuple-functions} -## Tuple {#tuple} +## tuple {#tuple} A function that allows grouping multiple columns. For columns with the types T1, T2, …, it returns a Tuple(T1, T2, …) type tuple containing these columns. There is no cost to execute the function. Tuples are normally used as intermediate values for an argument of IN operators, or for creating a list of formal parameters of lambda functions. Tuples can’t be written to a table. +The function implements the operator `(x, y, …)`. + **Syntax** ``` sql tuple(x, y, …) ``` -**See Also** - -- [Operator (x, y, …)](../../sql-reference/functions/in-functions.md#tuplex-y-operator-x-y) - -## TupleElement {#tupleelement} +## tupleElement {#tupleelement} A function that allows getting a column from a tuple. ‘N’ is the column index, starting from 1. N must be a constant. ‘N’ must be a constant. ‘N’ must be a strict postive integer no greater than the size of the tuple. There is no cost to execute the function. +The function implements the operator `x.N`. + **Syntax** ``` sql tupleElement(tuple, n) ``` -**See Also** - -- [Operator x.N](../../sql-reference/functions/in-functions.md#tupleelementtuple-n-operator-x-n) - -## Untuple {#untuple} +## untuple {#untuple} Performs syntactic substitution of [tuple](../../sql-reference/data-types/tuple.md#tuplet1-t2) elements in the call location. diff --git a/docs/ru/sql-reference/functions/in-functions.md b/docs/ru/sql-reference/functions/in-functions.md index 3280a625d75..b732f67303b 100644 --- a/docs/ru/sql-reference/functions/in-functions.md +++ b/docs/ru/sql-reference/functions/in-functions.md @@ -9,24 +9,4 @@ toc_title: "\u0424\u0443\u043d\u043a\u0446\u0438\u0438\u0020\u0434\u043b\u044f\u Смотрите раздел [Операторы IN](../operators/in.md#select-in-operators). -## tuple(x, y, …), оператор (x, y, …) {#tuplex-y-operator-x-y} - -Функция, позволяющая сгруппировать несколько столбцов. -Для столбцов, имеющих типы T1, T2, … возвращает кортеж типа Tuple(T1, T2, …), содержащий эти столбцы. Выполнение функции ничего не стоит. -Кортежи обычно используются как промежуточное значение в качестве аргумента операторов IN, или для создания списка формальных параметров лямбда-функций. Кортежи не могут быть записаны в таблицу. - -**Смотрите также** - -- [Tuple](../../sql-reference/functions/tuple-functions.md#tuple) - -## tupleElement(tuple, n), оператор x.N {#tupleelementtuple-n-operator-x-n} - -Функция, позволяющая достать столбец из кортежа. -N - индекс столбца начиная с 1. N должно быть константой. N должно быть целым строго положительным числом не большим размера кортежа. -Выполнение функции ничего не стоит. - -**Смотрите также** - -- [TupleElement](../../sql-reference/functions/tuple-functions.md#tupleelement) - [Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/functions/in_functions/) diff --git a/docs/ru/sql-reference/functions/tuple-functions.md b/docs/ru/sql-reference/functions/tuple-functions.md index 386aaa32ecc..f88886ec6f1 100644 --- a/docs/ru/sql-reference/functions/tuple-functions.md +++ b/docs/ru/sql-reference/functions/tuple-functions.md @@ -5,39 +5,35 @@ toc_title: Функции для работы с кортежами # Функции для работы с кортежами {#tuple-functions} -## Tuple {#tuple} +## tuple {#tuple} Функция, позволяющая сгруппировать несколько столбцов. Для столбцов, имеющих типы T1, T2, … возвращает кортеж типа Tuple(T1, T2, …), содержащий эти столбцы. Выполнение функции ничего не стоит. Кортежи обычно используются как промежуточное значение в качестве аргумента операторов IN, или для создания списка формальных параметров лямбда-функций. Кортежи не могут быть записаны в таблицу. +С помощью функции реализуется оператор `(x, y, …)`. + **Синтаксис** ``` sql tuple(x, y, …) ``` -**Смотрите также** - -- [Оператор (x, y, …)](../../sql-reference/functions/in-functions.md#tuplex-y-operator-x-y) - -## TupleElement {#tupleelement} +## tupleElement {#tupleelement} Функция, позволяющая достать столбец из кортежа. N - индекс столбца начиная с 1. N должно быть константой. N должно быть целым строго положительным числом не большим размера кортежа. Выполнение функции ничего не стоит. +С помощью функции реализуется оператор `x.N`. + **Синтаксис** ``` sql tupleElement(tuple, n) ``` -**Смотрите также** - -- [Оператор x.N](../../sql-reference/functions/in-functions.md#tupleelementtuple-n-operator-x-n) - -## Untuple {#untuple} +## untuple {#untuple} Выполняет синтаксическую подстановку элементов [кортежа](../../sql-reference/data-types/tuple.md#tuplet1-t2) в место вызова.