ClickHouse/docs/en/sql-reference/functions/files.md

36 lines
999 B
Markdown
Raw Normal View History

---
2021-03-26 08:47:41 +00:00
toc_priority: 43
toc_title: Files
---
# Functions for Working with Files {#functions-for-working-with-files}
2021-03-28 18:26:51 +00:00
## file {#file}
Reads file as a String. The file content is not parsed, so any information is read as one string and placed into the specified column.
**Syntax**
``` sql
2021-03-26 08:22:43 +00:00
file(path)
```
**Arguments**
2021-03-28 18:26:51 +00:00
- `path` — The relative path to the file from [user_files_path](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-user_files_path). Path to file support following wildcards in read-only mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc', 'def'` — strings.
**Example**
2021-03-26 08:22:43 +00:00
Inserting data from files a.txt and b.txt into a table as different rows.
Query:
``` sql
2021-03-28 18:26:51 +00:00
INSERT INTO table SELECT file('a.txt'), file('b.txt');
```
**See Also**
2021-03-26 08:22:43 +00:00
- [user_files_path](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-user_files_path)
2021-03-26 09:25:33 +00:00
- [file](../table-functions/file.md)