ClickHouse/docs/ru/query_language/table_functions/file.md


# file

Создаёт таблицу из файла.

```
file(path, format, structure)
```

**Входные параметры**

- `path` — относительный путь до файла от [user_files_path](../../operations/server_settings/settings.md#server_settings-user_files_path).
- `format` — [формат](../../interfaces/formats.md#formats) файла.
- `structure` — структура таблицы. Формат `'colunmn1_name column1_ype, column2_name column2_type, ...'`.

**Возвращаемое значение**

Таблица с указанной структурой, предназначенная для чтения или записи данных в указанном файле.

**Пример**

Настройка `user_files_path` и содержимое файла `test.csv`:

```bash
$ grep user_files_path /etc/clickhouse-server/config.xml
    <user_files_path>/var/lib/clickhouse/user_files/</user_files_path>

$ cat /var/lib/clickhouse/user_files/test.csv
    1,2,3
    3,2,1
    78,43,45
```

Таблица из `test.csv` и выборка первых двух строк из неё:

``` sql
SELECT *
FROM file('test.csv', 'CSV', 'column1 UInt32, column2 UInt32, column3 UInt32')
LIMIT 2
```
```
┌─column1─┬─column2─┬─column3─┐
│       1 │       2 │       3 │
│       3 │       2 │       1 │
└─────────┴─────────┴─────────┘
```

[Оригинальная статья](https://clickhouse.yandex/docs/ru/query_language/table_functions/file/) <!--hide-->
-												file() function's description (#2361)

* Create file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update settings.md

* Create file.md

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update settings.md

* Update settings.md

* Update mkdocs_en.yml

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update mkdocs_en.yml

* Update file.md

* Update file.md

											
										
										
											2018-05-14 19:58:49 +00:00
 								# file
-												Update file.md
											
										
										
											2018-08-22 06:20:05 +00:00
+								Создаёт таблицу из файла.
-												file() function's description (#2361)

* Create file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update settings.md

* Create file.md

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update settings.md

* Update settings.md

* Update mkdocs_en.yml

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update mkdocs_en.yml

* Update file.md

* Update file.md

											
										
										
											2018-05-14 19:58:49 +00:00
-												Update of file() table function description.

											
										
										
											2018-08-15 10:58:37 +00:00
+								```
 								file(path, format, structure)
 								```
 								**Входные параметры**
-												file() function's description (#2361)

* Create file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update settings.md

* Create file.md

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update settings.md

* Update settings.md

* Update mkdocs_en.yml

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update mkdocs_en.yml

* Update file.md

* Update file.md

											
										
										
											2018-05-14 19:58:49 +00:00
-												Doc fixes: remove all anchors <a> (#3897)

* Doc fixes: rm anchors <a>

* Doc fixes: rm anchors <a>

* Doc fixes: fix links

* Doc fixes: fix the links

											
										
										
											2018-12-21 19:23:55 +00:00
+								- `path` — относительный путь до файла от [user_files_path](../../operations/server_settings/settings.md#server_settings-user_files_path).
-												Update file.md
											
										
										
											2018-08-22 06:22:06 +00:00
+								- `format` — [формат](../../interfaces/formats.md#formats) файла.
 								- `structure` — структура таблицы. Формат `'colunmn1_name column1_ype, column2_name column2_type, ...'`.
-												file() function's description (#2361)

* Create file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update settings.md

* Create file.md

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update settings.md

* Update settings.md

* Update mkdocs_en.yml

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update mkdocs_en.yml

* Update file.md

* Update file.md

											
										
										
											2018-05-14 19:58:49 +00:00
-												Update of file() table function description.

											
										
										
											2018-08-15 10:58:37 +00:00
+								**Возвращаемое значение**
-												Update file.md
											
										
										
											2018-08-22 06:23:28 +00:00
+								Таблица с указанной структурой, предназначенная для чтения или записи данных в указанном файле.
-												file() function's description (#2361)

* Create file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update settings.md

* Create file.md

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update settings.md

* Update settings.md

* Update mkdocs_en.yml

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update mkdocs_en.yml

* Update file.md

* Update file.md

											
										
										
											2018-05-14 19:58:49 +00:00
 								**Пример**
-												Correction and clarification of descriptions of file() and round().

											
										
										
											2018-08-16 08:25:35 +00:00
+								Настройка `user_files_path` и содержимое файла `test.csv`:
-												Update of file() table function description.

											
										
										
											2018-08-15 10:58:37 +00:00
 								```bash
 								$ grep user_files_path /etc/clickhouse-server/config.xml
 								    <user_files_path>/var/lib/clickhouse/user_files/</user_files_path>
 								$ cat /var/lib/clickhouse/user_files/test.csv
 ,2,3
 ,2,1
 ,43,45
 								```
-												Correction and clarification of descriptions of file() and round().

											
										
										
											2018-08-16 08:25:35 +00:00
+								Таблица из `test.csv` и выборка первых двух строк из неё:
-												Update of file() table function description.

											
										
										
											2018-08-15 10:58:37 +00:00
-												WIP on docs/website (#3383)

* CLICKHOUSE-4063: less manual html @ index.md

* CLICKHOUSE-4063: recommend markdown="1" in README.md

* CLICKHOUSE-4003: manually purge custom.css for now

* CLICKHOUSE-4064: expand <details> before any print (including to pdf)

* CLICKHOUSE-3927: rearrange interfaces/formats.md a bit

* CLICKHOUSE-3306: add few http headers

* Remove copy-paste introduced in #3392

* Hopefully better chinese fonts #3392

* get rid of tabs @ custom.css

* Apply comments and patch from #3384

* Add jdbc.md to ToC and some translation, though it still looks badly incomplete

* minor punctuation

* Add some backlinks to official website from mirrors that just blindly take markdown sources

* Do not make fonts extra light

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's//g' {}

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's/ sql/g' {}

* Remove outdated stuff from roadmap.md

* Not so light font on front page too

* Refactor Chinese formats.md to match recent changes in other languages

											
										
										
											2018-10-16 10:47:17 +00:00
+								``` sql
-												Update of file() table function description.

											
										
										
											2018-08-15 10:58:37 +00:00
+								SELECT *
 								FROM file('test.csv', 'CSV', 'column1 UInt32, column2 UInt32, column3 UInt32')
 								LIMIT 2
 								```
 								```
 								┌─column1─┬─column2─┬─column3─┐
 								│       1 │       2 │       3 │
 								│       3 │       2 │       1 │
 								└─────────┴─────────┴─────────┘
-												file() function's description (#2361)

* Create file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update file.md

* Update settings.md

* Update file.md

* Update settings.md

* Update settings.md

* Update settings.md

* Create file.md

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update settings.md

* Update settings.md

* Update mkdocs_en.yml

* Update mkdocs_ru.yml

* Update mkdocs_en.yml

* Update mkdocs_en.yml

* Update file.md

* Update file.md

											
										
										
											2018-05-14 19:58:49 +00:00
+								```
-												WIP on docs/website (#3383)

* CLICKHOUSE-4063: less manual html @ index.md

* CLICKHOUSE-4063: recommend markdown="1" in README.md

* CLICKHOUSE-4003: manually purge custom.css for now

* CLICKHOUSE-4064: expand <details> before any print (including to pdf)

* CLICKHOUSE-3927: rearrange interfaces/formats.md a bit

* CLICKHOUSE-3306: add few http headers

* Remove copy-paste introduced in #3392

* Hopefully better chinese fonts #3392

* get rid of tabs @ custom.css

* Apply comments and patch from #3384

* Add jdbc.md to ToC and some translation, though it still looks badly incomplete

* minor punctuation

* Add some backlinks to official website from mirrors that just blindly take markdown sources

* Do not make fonts extra light

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's//g' {}

* find . -name '*.md' -type f | xargs -I{} perl -pi -e 's/ sql/g' {}

* Remove outdated stuff from roadmap.md

* Not so light font on front page too

* Refactor Chinese formats.md to match recent changes in other languages

											
										
										
											2018-10-16 10:47:17 +00:00
 								[Оригинальная статья](https://clickhouse.yandex/docs/ru/query_language/table_functions/file/) <!--hide-->