ClickHouse/docs/en/sql-reference/functions/files.md
Slach a9580644eb add ** wildcard to docs, which available from 22.11
Signed-off-by: Slach <bloodjazman@gmail.com>
2023-08-09 16:30:33 +04:00

31 lines
987 B
Markdown

---
slug: /en/sql-reference/functions/files
sidebar_position: 75
sidebar_label: Files
---
## file
Reads a file as string and loads the data into the specified column. The file content is not interpreted.
Also see table function [file](../table-functions/file.md).
**Syntax**
``` sql
file(path[, default])
```
**Arguments**
- `path` — The path of the file relative to [user_files_path](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-user_files_path). Supports wildcards `*`, `**`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` are numbers and `'abc', 'def'` are strings.
- `default` — The value returned if the file does not exist or cannot be accessed. Supported data types: [String](../../sql-reference/data-types/string.md) and [NULL](../../sql-reference/syntax.md#null-literal).
**Example**
Inserting data from files a.txt and b.txt into a table as strings:
``` sql
INSERT INTO table SELECT file('a.txt'), file('b.txt');
```