mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-22 23:52:03 +00:00
DOCAPI-7719: Columns matcher docs (#6831)
* Typo fix. * DOCAPI-7719: Docs * DOCAPI-7719: Text. * DOCAPI-7719: Text. * DOCAPI-7719: Update. * DOCAPI-7719: Update.
This commit is contained in:
parent
60d74a5e55
commit
c3c3f3829e
@ -66,7 +66,7 @@ mysql> select * from test;
|
|||||||
1 row in set (0,00 sec)
|
1 row in set (0,00 sec)
|
||||||
```
|
```
|
||||||
|
|
||||||
Table in ClickHouse, retrieving data from the MySQL table:
|
Table in ClickHouse, retrieving data from the MySQL table created above:
|
||||||
|
|
||||||
```sql
|
```sql
|
||||||
CREATE TABLE mysql_table
|
CREATE TABLE mysql_table
|
||||||
@ -77,7 +77,7 @@ CREATE TABLE mysql_table
|
|||||||
ENGINE = MySQL('localhost:3306', 'test', 'test', 'bayonet', '123')
|
ENGINE = MySQL('localhost:3306', 'test', 'test', 'bayonet', '123')
|
||||||
```
|
```
|
||||||
```sql
|
```sql
|
||||||
SELECT * FROM mysql_table6
|
SELECT * FROM mysql_table
|
||||||
```
|
```
|
||||||
```text
|
```text
|
||||||
┌─float_nullable─┬─int_id─┐
|
┌─float_nullable─┬─int_id─┐
|
||||||
|
@ -962,12 +962,64 @@ Running a query may use more memory than 'max_bytes_before_external_sort'. For t
|
|||||||
|
|
||||||
External sorting works much less effectively than sorting in RAM.
|
External sorting works much less effectively than sorting in RAM.
|
||||||
|
|
||||||
### SELECT Clause
|
### SELECT Clause {#select-select}
|
||||||
|
|
||||||
|
[Expressions](syntax.md#syntax-expressions) that specified in the `SELECT` clause are analyzed after the calculations for all the clauses listed above are completed. More specifically, expressions are analyzed that are above the aggregate functions, if there are any aggregate functions. The aggregate functions and everything below them are calculated during aggregation (`GROUP BY`). These expressions work as if they are applied to separate rows in the result.
|
||||||
|
|
||||||
|
If you want to get all columns in the result, use the asterisk (`*`) symbol. For example, `SELECT * FROM ...`.
|
||||||
|
|
||||||
|
To match some columns in the result by a [re2](https://en.wikipedia.org/wiki/RE2_(software)) regular expression, you can use the `COLUMNS` expression.
|
||||||
|
|
||||||
|
```sql
|
||||||
|
COLUMNS('regexp')
|
||||||
|
```
|
||||||
|
|
||||||
|
For example, consider the table:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
CREATE TABLE default.col_names (aa Int8, ab Int8, bc Int8) ENGINE = TinyLog
|
||||||
|
```
|
||||||
|
|
||||||
|
The following query selects data from all the columns containing the `a` symbol in their name.
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT COLUMNS('a') FROM col_names
|
||||||
|
```
|
||||||
|
```text
|
||||||
|
┌─aa─┬─ab─┐
|
||||||
|
│ 1 │ 1 │
|
||||||
|
└────┴────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
You can use multiple `COLUMNS` expressions in a query, also you can apply functions to it.
|
||||||
|
|
||||||
|
For example:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT COLUMNS('a'), COLUMNS('c'), toTypeName(COLUMNS('c')) FROM col_names
|
||||||
|
```
|
||||||
|
```text
|
||||||
|
┌─aa─┬─ab─┬─bc─┬─toTypeName(bc)─┐
|
||||||
|
│ 1 │ 1 │ 1 │ Int8 │
|
||||||
|
└────┴────┴────┴────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
Be careful when using functions because the `COLUMN` expression returns variable number of columns, and, if a function doesn't support this number of arguments, ClickHouse throws an exception.
|
||||||
|
|
||||||
|
For example:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT COLUMNS('a') + COLUMNS('c') FROM col_names
|
||||||
|
```
|
||||||
|
```text
|
||||||
|
Received exception from server (version 19.14.1):
|
||||||
|
Code: 42. DB::Exception: Received from localhost:9000. DB::Exception: Number of arguments for function plus doesn't match: passed 3, should be 2.
|
||||||
|
```
|
||||||
|
|
||||||
|
In this example, `COLUMNS('a')` returns two columns `aa`, `ab`, and `COLUMNS('c')` returns the `bc` column. The `+` operator can't apply to 3 arguments, so ClickHouse throws an exception with the message about it.
|
||||||
|
|
||||||
|
Columns that matched by the `COLUMNS` expression can be in different types. If `COLUMNS` doesn't match any columns and it is the single expression in `SELECT`, ClickHouse throws an exception.
|
||||||
|
|
||||||
The expressions specified in the SELECT clause are analyzed after the calculations for all the clauses listed above are completed.
|
|
||||||
More specifically, expressions are analyzed that are above the aggregate functions, if there are any aggregate functions.
|
|
||||||
The aggregate functions and everything below them are calculated during aggregation (GROUP BY).
|
|
||||||
These expressions work as if they are applied to separate rows in the result.
|
|
||||||
|
|
||||||
### DISTINCT Clause {#select-distinct}
|
### DISTINCT Clause {#select-distinct}
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user