mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-24 16:42:05 +00:00
DOCSUP-4280: Update the SELECT query (#17231)
* Add description for column modifiers * Update index.md * Update docs/en/sql-reference/statements/select/index.md * Update docs/en/sql-reference/statements/select/index.md Co-authored-by: BayoNet <da-daos@yandex.ru>
This commit is contained in:
parent
7af89cba8a
commit
e76f7c316b
@ -159,4 +159,111 @@ If the query omits the `DISTINCT`, `GROUP BY` and `ORDER BY` clauses and the `IN
|
|||||||
|
|
||||||
For more information, see the section “Settings”. It is possible to use external sorting (saving temporary tables to a disk) and external aggregation.
|
For more information, see the section “Settings”. It is possible to use external sorting (saving temporary tables to a disk) and external aggregation.
|
||||||
|
|
||||||
{## [Original article](https://clickhouse.tech/docs/en/sql-reference/statements/select/) ##}
|
## SELECT modifiers {#select-modifiers}
|
||||||
|
|
||||||
|
You can use the following modifiers in `SELECT` queries.
|
||||||
|
|
||||||
|
### APPLY {#apply-modifier}
|
||||||
|
|
||||||
|
Allows you to invoke some function for each row returned by an outer table expression of a query.
|
||||||
|
|
||||||
|
**Syntax:**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT <expr> APPLY( <func> ) FROM [db.]table_name
|
||||||
|
```
|
||||||
|
|
||||||
|
**Example:**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
CREATE TABLE columns_transformers (i Int64, j Int16, k Int64) ENGINE = MergeTree ORDER by (i);
|
||||||
|
INSERT INTO columns_transformers VALUES (100, 10, 324), (120, 8, 23);
|
||||||
|
SELECT * APPLY(sum) FROM columns_transformers;
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─sum(i)─┬─sum(j)─┬─sum(k)─┐
|
||||||
|
│ 220 │ 18 │ 347 │
|
||||||
|
└────────┴────────┴────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### EXCEPT {#except-modifier}
|
||||||
|
|
||||||
|
Specifies the names of one or more columns to exclude from the result. All matching column names are omitted from the output.
|
||||||
|
|
||||||
|
**Syntax:**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT <expr> EXCEPT ( col_name1 [, col_name2, col_name3, ...] ) FROM [db.]table_name
|
||||||
|
```
|
||||||
|
|
||||||
|
**Example:**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT * EXCEPT (i) from columns_transformers;
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──j─┬───k─┐
|
||||||
|
│ 10 │ 324 │
|
||||||
|
│ 8 │ 23 │
|
||||||
|
└────┴─────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### REPLACE {#replace-modifier}
|
||||||
|
|
||||||
|
Specifies one or more [expression aliases](../../../sql-reference/syntax.md#syntax-expression_aliases). Each alias must match a column name from the `SELECT *` statement. In the output column list, the column that matches the alias is replaced by the expression in that `REPLACE`.
|
||||||
|
|
||||||
|
This modifier does not change the names or order of columns. However, it can change the value and the value type.
|
||||||
|
|
||||||
|
**Syntax:**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT <expr> REPLACE( <expr> AS col_name) from [db.]table_name
|
||||||
|
```
|
||||||
|
|
||||||
|
**Example:**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT * REPLACE(i + 1 AS i) from columns_transformers;
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
┌───i─┬──j─┬───k─┐
|
||||||
|
│ 101 │ 10 │ 324 │
|
||||||
|
│ 121 │ 8 │ 23 │
|
||||||
|
└─────┴────┴─────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### Modifier Combinations {#modifier-combinations}
|
||||||
|
|
||||||
|
You can use each modifier separately or combine them.
|
||||||
|
|
||||||
|
**Examples:**
|
||||||
|
|
||||||
|
Using the same modifier multiple times.
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT COLUMNS('[jk]') APPLY(toString) APPLY(length) APPLY(max) from columns_transformers;
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─max(length(toString(j)))─┬─max(length(toString(k)))─┐
|
||||||
|
│ 2 │ 3 │
|
||||||
|
└──────────────────────────┴──────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
Using multiple modifiers in a single query.
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT * REPLACE(i + 1 AS i) EXCEPT (j) APPLY(sum) from columns_transformers;
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─sum(plus(i, 1))─┬─sum(k)─┐
|
||||||
|
│ 222 │ 347 │
|
||||||
|
└─────────────────┴────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
[Original article](https://clickhouse.tech/docs/en/sql-reference/statements/select/)
|
||||||
|
<!--hide-->
|
||||||
|
Loading…
Reference in New Issue
Block a user