Перейти к основному содержанию
Табличная функция Values позволяет создавать временное хранилище, заполняющее столбцы значениями. Она полезна для быстрого тестирования или генерации примерных данных.
Values — регистронезависимая функция. То есть допустимы оба варианта: VALUES и values.

Синтаксис

Базовый синтаксис табличной функции VALUES выглядит так:
Обычно используется так:

Аргументы

  • column1_name Type1, ... (необязательно). String задаёт имена столбцов и типы. Если этот аргумент опущен, столбцы будут называться c1, c2 и т. д.
  • (value1_row1, value2_row1). Tuple содержит значения любого типа.
Tuple, разделённые запятыми, также можно заменить отдельными значениями. В этом случае каждое значение рассматривается как новая строка. Подробности см. в разделе примеры.

Возвращаемое значение

  • Возвращает временную таблицу с переданными значениями.

Примеры

Query
Response
VALUES также можно использовать с отдельными значениями, а не с кортежами. Например:
Query
Response
Или без указания спецификации строки ('column1_name Type1, column2_name Type2, ...' в синтаксисе) — в этом случае столбцы будут названы автоматически. Например:
Query
Response
Query
Response

Стандартная SQL-конструкция VALUES

Начиная с версии 26.3, ClickHouse также поддерживает стандартную SQL-конструкцию VALUES как табличное выражение в FROM, как в PostgreSQL, MySQL, DuckDB и SQL Server. Этот синтаксис внутренне преобразуется с использованием описанной выше табличной функции values.
Query
Response
Его можно использовать в CTE:
Query
И в JOIN:
Query
Псевдонимы столбцов после AS t(col1, col2, ...) соответствуют стандартному синтаксису SQL для именования столбцов производных таблиц. Если они опущены, столбцы получают имена c1, c2 и т. д.

См. также

Последнее изменение 10 июня 2026 г.