ClickHouse/docs/en/table_functions/file.md

<a name="table_functions-file"></a>

# file

`file(path, format, structure)` - returns a table created from a path file with a format type, with columns specified in structure.

path - a relative path to a file from [user_files_path](../operations/server_settings/settings.md#user_files_path).

format - file [format](../formats/index.md#formats).

structure -  table structure in 'UserID UInt64, URL String' format. Determines column names and types.

**Example**

```sql
-- getting the first 10 lines of a table that contains 3 columns of UInt32 type from a CSV file
SELECT * FROM file('test.csv', 'CSV', 'column1 UInt32, column2 UInt32, column3 UInt32') LIMIT 10
```
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			`<a name="table_functions-file"></a>`

			`# file`

			`file(path, format, structure)` - returns a table created from a path file with a format type, with columns specified in structure.

			`path - a relative path to a file from [user_files_path](../operations/server_settings/settings.md#user_files_path).`

Few documentation infrastructure improvements (#2613) * Remove Berlin meetup link * Do not block browser while single page docs content loads * Restore sidebar scroll tracking feature * Temporary hide footer in single page docs mode so it does not jump around * Swap sidebars in single page docs mode * fix lost anchor in link * Explicitly fail if there are errors during docs build 2018-07-09 12:00:38 +00:00			`format - file [format](../formats/index.md#formats).`
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
			`structure - table structure in 'UserID UInt64, URL String' format. Determines column names and types.`

			`Example`

			```sql
			`-- getting the first 10 lines of a table that contains 3 columns of UInt32 type from a CSV file`
			`SELECT * FROM file('test.csv', 'CSV', 'column1 UInt32, column2 UInt32, column3 UInt32') LIMIT 10`
			```