Перейти к основному содержимому
Перейти к основному содержимому

Функция таблицы input

input(structure) - функция таблицы, которая позволяет эффективно преобразовывать и вставлять данные, отправленные на сервер с заданной структурой, в таблицу с другой структурой.

structure - структура данных, отправленных на сервер в следующем формате 'column1_name column1_type, column2_name column2_type, ...'. Например, 'id UInt32, name String'.

Эта функция может использоваться только в запросе INSERT SELECT и только один раз, но в остальном ведет себя как обычная функция таблицы (например, может использоваться в подзапросе и т.д.).

Данные могут быть отправлены любым способом, как для обычного запроса INSERT, и переданы в любом доступном формате, который необходимо указать в конце запроса (в отличие от обычного INSERT SELECT).

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

Примеры

  • Пусть таблица test имеет следующую структуру (a String, b String) и данные в data.csv имеют другую структуру (col1 String, col2 Date, col3 Int32). Запрос для вставки данных из data.csv в таблицу test с одновременным преобразованием выглядит следующим образом:
  • Если data.csv содержит данные той же структуры test_structure, что и таблица test, то эти два запроса равны: