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

35 lines
1.6 KiB
Markdown
Raw Normal View History

2021-03-29 19:27:06 +00:00
---
sidebar_position: 43
sidebar_label: "Функции для работы с файлами"
2021-03-29 19:27:06 +00:00
---
# Функции для работы с файлами {#funktsii-dlia-raboty-s-failami}
## file {#file}
Читает файл как строку. Содержимое файла не разбирается (не парсится) и записывается в указанную колонку в виде единой строки.
2021-03-29 19:27:06 +00:00
**Синтаксис**
``` sql
2022-07-14 09:49:30 +00:00
file(path[, default])
2021-03-29 19:27:06 +00:00
```
**Аргументы**
- `path` — относительный путь до файла от [user_files_path](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-user_files_path). Путь к файлу может включать следующие символы подстановки и шаблоны: `*`, `?`, `{abc,def}` и `{N..M}`, где `N`, `M` — числа, `'abc', 'def'` — строки.
2022-07-14 09:49:30 +00:00
- `default` — Значение возвращаемое в случае, если указанный файл не существует. Поддерживаемые типы данных: [String](../../sql-reference/data-types/string.md) и [NULL](../../sql-reference/syntax.md#null-literal).
2021-03-29 19:27:06 +00:00
**Примеры**
Вставка данных из файлов a.txt и b.txt в таблицу в виде строк:
2021-03-29 19:27:06 +00:00
``` sql
INSERT INTO table SELECT file('a.txt'), file('b.txt');
```
**Смотрите также**
- [user_files_path](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-user_files_path)
- [file](../table-functions/file.md)