DOCAPI-7743: EN review, RU translation for CREATE TABLE AS table_function() docs (#7056)

* Typo fix.

* Links fix.

* Fixed links in docs.

* More fixes.

* Update index.md (#57)

* DOCAPI-7743: RU translation.

* Update select.md

* Update index.md
This commit is contained in:
BayoNet 2019-09-24 02:32:02 +03:00 committed by alexey-milovidov
parent 37481d8019
commit b46e31d198
3 changed files with 40 additions and 14 deletions

View File

@ -1,6 +1,6 @@
# Table Functions
Table function is a method of constructing a table.
Table functions are methods for constructing tables.
You can use table functions in:
@ -10,7 +10,7 @@ You can use table functions in:
* [FROM](../select.md#select-from) clause of the `SELECT` query.
The method of creating a temporary table, that is available only in current query. The table is deleted after the query finishes.
The method for creating a temporary table that is available only in the current query. The table is deleted when the query finishes.
!!! warning "Warning"
You can't use table functions if the [allow_ddl](../../operations/settings/permissions_for_queries.md#settings_allow_ddl) setting is disabled.
@ -19,7 +19,7 @@ Function | Description
---------|------------
[file](file.md) | Creates a [File](../../operations/table_engines/file.md)-engine table.
[merge](merge.md) | Creates a [Merge](../../operations/table_engines/merge.md)-engine table.
[numbers](numbers.md) | Creates a table with the single column filled with integer numbers.
[numbers](numbers.md) | Creates a table with a single column filled with integer numbers.
[remote](remote.md) | Allows you to access remote servers without creating a [Distributed](../../operations/table_engines/distributed.md)-engine table.
[url](url.md) | Creates a [Url](../../operations/table_engines/url.md)-engine table.
[mysql](mysql.md) | Creates a [MySQL](../../operations/table_engines/mysql.md)-engine table.

View File

@ -95,20 +95,23 @@ FROM
### Секция FROM
Если секция FROM отсутствует, то данные будут читаться из таблицы `system.one`.
Таблица system.one содержит ровно одну строку (то есть, эта таблица выполняет такую же роль, как таблица DUAL, которую можно найти в других СУБД).
Таблица `system.one` содержит ровно одну строку (то есть, эта таблица выполняет такую же роль, как таблица DUAL, которую можно найти в других СУБД).
В секции FROM указывается таблица, из которой будут читаться данные, либо подзапрос, либо табличная функция; дополнительно могут присутствовать ARRAY JOIN и обычный JOIN (смотрите ниже).
Cекция `FROM` определяет источник данных:
Вместо таблицы, может быть указан подзапрос SELECT в скобках.
В этом случае, конвейер обработки подзапроса будет встроен в конвейер обработки внешнего запроса.
В отличие от стандартного SQL, после подзапроса не нужно указывать его синоним. Для совместимости, присутствует возможность написать AS name после подзапроса, но указанное имя нигде не используется.
- Таблица
- Подзапрос
- [Табличная функция](table_functions/index.md)
Вместо таблицы, может быть указана табличная функция. Подробнее смотрите раздел "Табличные функции".
Также могут присутствовать `ARRAY JOIN` и обычный `JOIN` (смотрите ниже).
Вместо таблицы, может быть указан подзапрос `SELECT` в скобках.
В отличие от стандартного SQL, после подзапроса не обязательно указывать его синоним.
Для выполнения запроса, из соответствующей таблицы, вынимаются все столбцы, перечисленные в запросе. Из подзапросов выкидываются столбцы, не нужные для внешнего запроса.
Если в запросе не перечислено ни одного столбца (например, SELECT count() FROM t), то из таблицы всё равно вынимается один какой-нибудь столбец (предпочитается самый маленький), для того, чтобы можно было хотя бы посчитать количество строк.
Если в запросе не перечислено ни одного столбца (например, `SELECT count() FROM t`), то из таблицы всё равно вынимается один какой-нибудь столбец (предпочитается самый маленький), для того, чтобы можно было посчитать количество строк.
Модификатор FINAL может быть использован при SELECT-е из таблиц типа ReplacingMergeTree, SummingMergeTree, AggregatingMergeTree, CollapsingMergeTree, VersionedCollapsingMergeTree. При указании FINAL, данные будут выбираться полностью "домерженными". Стоит учитывать, что использование FINAL приводит к выбору кроме указанных в SELECT-е столбцов также столбцов, относящихся к первичному ключу. Также, запрос будет выполняться в один поток, и при выполнении запроса будет выполняться слияние данных. Это приводит к тому, что при использовании FINAL, запрос выполняется медленнее. В большинстве случаев, следует избегать использования FINAL.
Модификатор `FINAL` может быть использован в запросе `SELECT` из таблиц семейства [MergeTree](../operations/table_engines/mergetree.md). При указании `FINAL`, данные будут выбираться полностью "домерженными". Стоит учитывать, что использование `FINAL` приводит к выбору кроме указанных в `SELECT` столбцов также столбцов, относящихся к первичному ключу. Также, запрос будет выполняться в один поток, и при выполнении запроса будет выполняться слияние данных. Это приводит к тому, что при использовании `FINAL`, запрос выполняется медленнее. В большинстве случаев, следует избегать использования `FINAL`.
### Секция SAMPLE {#select-sample-clause}

View File

@ -1,7 +1,30 @@
# Табличные функции
Табличные функции могут указываться в секции FROM вместо имени БД и таблицы.
Табличные функции можно использовать только если не выставлена настройка readonly.
Табличные функции не имеют отношения к другим функциям.
Табличные функции — это метод создания таблиц.
Табличные функции можно использовать в:
* Секции [FROM](../select.md#select-from) запроса `SELECT`.
Это способ создания временной таблицы, которая доступна только в текущем запросе.
* Запросе [CREATE TABLE AS <table_function()>](../create.md#create-table-query).
Это один из методов создания таблицы.
!!! warning "Предупреждение"
Если настройка [allow_ddl](../../operations/settings/permissions_for_queries.md#settings_allow_ddl) выключена, то использовать табличные функции невозможно.
Функция | Описание
---------|------------
[file](file.md) | Создаёт таблицу с движком [File](../../operations/table_engines/file.md).
[merge](merge.md) | Создаёт таблицу с движком [Merge](../../operations/table_engines/merge.md).
[numbers](numbers.md) | Создаёт таблицу с единственным столбцом, заполненным целыми числами.
[remote](remote.md) | Предоставляет доступ к удалённым серверам, не создавая таблицу с движком [Distributed](../../operations/table_engines/distributed.md).
[url](url.md) | Создаёт таблицу с движком [Url](../../operations/table_engines/url.md).
[mysql](mysql.md) | Создаёт таблицу с движком [MySQL](../../operations/table_engines/mysql.md).
[jdbc](jdbc.md) | Создаёт таблицу с дижком [JDBC](../../operations/table_engines/jdbc.md).
[odbc](odbc.md) | Создаёт таблицу с движком [ODBC](../../operations/table_engines/odbc.md).
[hdfs](hdfs.md) | Создаёт таблицу с движком [HDFS](../../operations/table_engines/hdfs.md).
[Оригинальная статья](https://clickhouse.yandex/docs/ru/query_language/table_functions/) <!--hide-->