mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-27 18:12:02 +00:00
33 lines
1.0 KiB
Markdown
33 lines
1.0 KiB
Markdown
---
|
|
slug: /en/sql-reference/functions/files
|
|
sidebar_position: 75
|
|
sidebar_label: Files
|
|
---
|
|
|
|
## file
|
|
|
|
Reads file as string and loads the data into the specified column. The actual 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 the following wildcards: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` are numbers and `'abc', 'def'` are strings.
|
|
- `default` — The value that will be returned in the case 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:
|
|
|
|
Query:
|
|
|
|
``` sql
|
|
INSERT INTO table SELECT file('a.txt'), file('b.txt');
|
|
```
|