From b46e31d198834f22cd4f95907c80585b01ea7fb1 Mon Sep 17 00:00:00 2001 From: BayoNet Date: Tue, 24 Sep 2019 02:32:02 +0300 Subject: [PATCH] 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 --- .../query_language/table_functions/index.md | 6 ++-- docs/ru/query_language/select.md | 19 +++++++----- .../query_language/table_functions/index.md | 29 +++++++++++++++++-- 3 files changed, 40 insertions(+), 14 deletions(-) diff --git a/docs/en/query_language/table_functions/index.md b/docs/en/query_language/table_functions/index.md index dc2665ce7a..0e27ba7b49 100644 --- a/docs/en/query_language/table_functions/index.md +++ b/docs/en/query_language/table_functions/index.md @@ -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. diff --git a/docs/ru/query_language/select.md b/docs/ru/query_language/select.md index ca7df78735..002f144397 100644 --- a/docs/ru/query_language/select.md +++ b/docs/ru/query_language/select.md @@ -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} diff --git a/docs/ru/query_language/table_functions/index.md b/docs/ru/query_language/table_functions/index.md index 704c9fa712..2883ae7c03 100644 --- a/docs/ru/query_language/table_functions/index.md +++ b/docs/ru/query_language/table_functions/index.md @@ -1,7 +1,30 @@ # Табличные функции -Табличные функции могут указываться в секции FROM вместо имени БД и таблицы. -Табличные функции можно использовать только если не выставлена настройка readonly. -Табличные функции не имеют отношения к другим функциям. +Табличные функции — это метод создания таблиц. + +Табличные функции можно использовать в: + +* Секции [FROM](../select.md#select-from) запроса `SELECT`. + + Это способ создания временной таблицы, которая доступна только в текущем запросе. + +* Запросе [CREATE TABLE AS ](../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/) -- GitLab