Some clarifications to File engine docs. (#5667)

* Some clarifications to File engine docs.

* Mention URL, HDFS and dictionaries

* Fix capitalization.
This commit is contained in:
akuzm 2019-07-10 10:04:11 +03:00 committed by Ivan Blinkov
parent 2753588f6a
commit e84b7be6af
2 changed files with 14 additions and 6 deletions

View File

@ -1,10 +1,14 @@
# Formats for input and output data {#formats}
ClickHouse can accept (`INSERT`) and return (`SELECT`) data in various formats.
ClickHouse can accept and return data in various formats. A format supported
for input can be used to parse the data provided to `INSERT`s, to perform
`SELECT`s from a file-backed table such as File, URL or HDFS, or to read an
external dictionary. A format supported for output can be used to arrange the
results of a `SELECT`, and to perform `INSERT`s into a file-backed table.
The table below lists supported formats and how they can be used in `INSERT` and `SELECT` queries.
The supported formats are:
| Format | INSERT | SELECT |
| Format | Input | Output |
| ------- | -------- | -------- |
| [TabSeparated](#tabseparated) | ✔ | ✔ |
| [TabSeparatedRaw](#tabseparatedraw) | ✗ | ✔ |

View File

@ -1,6 +1,7 @@
# File(InputFormat) {#table_engines-file}
# File {#table_engines-file}
The data source is a file that stores data in one of the supported input formats (TabSeparated, Native, etc.).
The File table engine keeps the data in a file in one of the supported [file
formats](../../interfaces/formats.md#formats) (TabSeparated, Native, etc.).
Usage examples:
@ -14,7 +15,10 @@ Usage examples:
File(Format)
```
`Format` should be supported for either `INSERT` and `SELECT`. For the full list of supported formats see [Formats](../../interfaces/formats.md#formats).
The `Format` parameter specifies one of the available file formats. To perform
`SELECT` queries, the format must be supported for input, and to perform
`INSERT` queries -- for output. The available formats are listed in the
[Formats](../../interfaces/formats.md#formats) section.
ClickHouse does not allow to specify filesystem path for`File`. It will use folder defined by [path](../server_settings/settings.md) setting in server configuration.