eval

SET allow_experimental_eval_table_function = 1;

​

Синтаксис

eval(expression)
eval(SELECT ...)

​

Аргументы

• expression — Константное выражение, возвращающее строку запроса. Допускаются параметры запроса и скалярные подзапросы.
• SELECT ... — Запрос SELECT, возвращающий строку запроса. Эта форма представляет собой синтаксический сахар для скалярного подзапроса: eval(SELECT ...) эквивалентно eval((SELECT ...)), поэтому запрос должен возвращать ровно одну строку и один столбец.

• String
• Nullable(String)
• LowCardinality(String)
• LowCardinality(Nullable(String))

​

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

​

Примеры

SELECT * FROM eval('SEL' || 'ECT 1 AS x');

┌─x─┐
│ 1 │
└───┘

SET param_q = 'SELECT 2 AS y';
SELECT * FROM eval({q:String});

┌─y─┐
│ 2 │
└───┘

SELECT * FROM eval(SELECT 'SELECT 3 AS z');

┌─z─┐
│ 3 │
└───┘

SELECT x + 1 FROM eval('SELECT 4 AS x');

┌─plus(x, 1)─┐
│          5 │
└────────────┘

​

Ограничения

• Сгенерированный запрос должен представлять собой один SELECT-запрос без предложений вывода, таких как INTO OUTFILE или FORMAT. eval не выполняет несколько операторов.
• Сгенерированный запрос должен быть самодостаточным: он обрабатывается в собственной области видимости и не может ссылаться на псевдонимы WITH или столбцы внешнего запроса.
• Сгенерированный запрос не может повторно использовать табличную функцию eval.
• eval нельзя использовать в качестве аргумента другой табличной функции, например remote('host', eval(...)). Чтобы выполнить сгенерированный запрос на удалённом сервере, оберните его в view: remote('host', view(SELECT * FROM eval(...))).
• Аргумент вычисляется один раз при анализе запроса, а не отдельно для каждой строки или блока.
• Во внешнем журнале запросов записывается исходный запрос, содержащий eval; сгенерированный SELECT-запрос не записывается как отдельный пользовательский запрос.

​

См. также

• табличная функция view
• настройка allow_experimental_eval_table_function