mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-10 10:30:51 +00:00
2e1f6bc56d
* replace exit with assert in test_single_page * improve save_raw_single_page docs option * More grammar fixes * "Built from" link in new tab * fix mistype * Example of include in docs * add anchor to meeting form * Draft of translation helper * WIP on translation helper * Replace some fa docs content with machine translation * add normalize-en-markdown.sh * normalize some en markdown * normalize some en markdown * admonition support * normalize * normalize * normalize * support wide tables * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * lightly edited machine translation of introdpection.md * lightly edited machhine translation of lazy.md * WIP on translation utils * Normalize ru docs * Normalize other languages * some fixes * WIP on normalize/translate tools * add requirements.txt * [experimental] add es docs language as machine translated draft * remove duplicate script * Back to wider tab-stop (narrow renders not so well)
80 lines
4.6 KiB
Markdown
80 lines
4.6 KiB
Markdown
# File(Format) {#table-engines-file}
|
||
|
||
Управляет данными в одном файле на диске в указанном формате.
|
||
|
||
Примеры применения:
|
||
|
||
- Выгрузка данных из ClickHouse в файл.
|
||
- Преобразование данных из одного формата в другой.
|
||
- Обновление данных в ClickHouse редактированием файла на диске.
|
||
|
||
## Использование движка в сервере ClickHouse {#ispolzovanie-dvizhka-v-servere-clickhouse}
|
||
|
||
``` sql
|
||
File(Format)
|
||
```
|
||
|
||
`Format` должен быть таким, который ClickHouse может использовать и в запросах `INSERT` и в запросах `SELECT`. Полный список поддерживаемых форматов смотрите в разделе [Форматы](../../interfaces/formats.md#formats).
|
||
|
||
Сервер ClickHouse не позволяет указать путь к файлу, с которым будет работать `File`. Используется путь к хранилищу, определенный параметром [path](../server_settings/settings.md) в конфигурации сервера.
|
||
|
||
При создании таблицы с помощью `File(Format)` сервер ClickHouse создает в хранилище каталог с именем таблицы, а после добавления в таблицу данных помещает туда файл `data.Format`.
|
||
|
||
Можно вручную создать в хранилище каталог таблицы, поместить туда файл, затем на сервере ClickHouse добавить ([ATTACH](../../query_language/misc.md)) информацию о таблице, соответствующей имени каталога и прочитать из файла данные.
|
||
|
||
!!! warning "Warning"
|
||
Будьте аккуратны с этой функциональностью, поскольку сервер ClickHouse не отслеживает внешние изменения данных. Если в файл будет производиться запись одновременно со стороны сервера ClickHouse и с внешней стороны, то результат непредсказуем.
|
||
|
||
**Пример:**
|
||
|
||
**1.** Создадим на сервере таблицу `file_engine_table`:
|
||
|
||
``` sql
|
||
CREATE TABLE file_engine_table (name String, value UInt32) ENGINE=File(TabSeparated)
|
||
```
|
||
|
||
В конфигурации по умолчанию сервер ClickHouse создаст каталог `/var/lib/clickhouse/data/default/file_engine_table`.
|
||
|
||
**2.** Вручную создадим файл `/var/lib/clickhouse/data/default/file_engine_table/data.TabSeparated` с содержимым:
|
||
|
||
``` bash
|
||
$cat data.TabSeparated
|
||
one 1
|
||
two 2
|
||
```
|
||
|
||
**3.** Запросим данные:
|
||
|
||
``` sql
|
||
SELECT * FROM file_engine_table
|
||
```
|
||
|
||
``` text
|
||
┌─name─┬─value─┐
|
||
│ one │ 1 │
|
||
│ two │ 2 │
|
||
└──────┴───────┘
|
||
```
|
||
|
||
## Использование движка в clickhouse-local {#ispolzovanie-dvizhka-v-clickhouse-local}
|
||
|
||
В [clickhouse-local](../utils/clickhouse-local.md) движок в качестве параметра принимает не только формат, но и путь к файлу. В том числе можно указать стандартные потоки ввода/вывода цифровым или буквенным обозначением `0` или `stdin`, `1` или `stdout`.
|
||
|
||
**Пример:**
|
||
|
||
``` bash
|
||
$ echo -e "1,2\n3,4" | clickhouse-local -q "CREATE TABLE table (a Int64, b Int64) ENGINE = File(CSV, stdin); SELECT a, b FROM table; DROP TABLE table"
|
||
```
|
||
|
||
## Детали реализации {#detali-realizatsii}
|
||
|
||
- Поддерживается одновременное выполнение множества запросов `SELECT`, запросы `INSERT` могут выполняться только последовательно.
|
||
- Поддерживается создание ещё не существующего файла при запросе `INSERT`.
|
||
- Для существующих файлов `INSERT` записывает в конец файла.
|
||
- Не поддерживается:
|
||
- использование операций `ALTER` и `SELECT...SAMPLE`;
|
||
- индексы;
|
||
- репликация.
|
||
|
||
[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/table_engines/file/) <!--hide-->
|