> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Документация по табличным функциям

# Табличные функции

Табличные функции — это способы создания таблиц.

<div id="usage">
  ## Использование
</div>

Табличные функции можно использовать в секции [`FROM`](/docs/ru/reference/statements/select/from)
запроса `SELECT`. Например, с помощью табличной функции `file` можно выполнить `SELECT` данных из файла на локальном
компьютере.

```bash title="Query" theme={null}
echo "1, 2, 3" > example.csv
```

```text title="Response" theme={null}
./clickhouse client
:) SELECT * FROM file('example.csv')
┌─c1─┬─c2─┬─c3─┐
│  1 │  2 │  3 │
└────┴────┴────┘
```

Вы также можете использовать табличные функции для создания временной таблицы, доступной
только в рамках текущего запроса. Например:

```sql title="Query" theme={null}
SELECT * FROM generateSeries(1,5);
```

```response title="Response" theme={null}
┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘
```

Таблица удаляется после завершения запроса.

Табличные функции можно использовать для создания таблиц со следующим синтаксисом:

```sql title="Query" theme={null}
CREATE TABLE [IF NOT EXISTS] [db.]table_name AS table_function()
```

Например:

```sql title="Query" theme={null}
CREATE TABLE series AS generateSeries(1, 5);
SELECT * FROM series;
```

```response title="Response" theme={null}
┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘
```

Наконец, табличные функции можно использовать для `INSERT` в таблицу. Например,
мы можем снова использовать табличную функцию `file`, чтобы записать содержимое таблицы,
которую создали в предыдущем примере, в файл на диске:

```sql title="Query" theme={null}
INSERT INTO FUNCTION file('numbers.csv', 'CSV') SELECT * FROM series;
```

```bash title="Query" theme={null}
cat numbers.csv
1
2
3
4
5
```

<Note>
  Вы не сможете использовать табличные функции, если параметр [allow\_ddl](/docs/ru/reference/settings/session-settings#allow_ddl) отключён.
</Note>