Skip to main content
Позволяет выполнять запросы к данным, хранящимся в базе данных SQLite.

Синтаксис

Аргументы

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

  • Объект table с теми же столбцами, что и в исходной таблице SQLite.

Передача запроса вместо имени таблицы

Вместо имени таблицы вторым аргументом можно указать SELECT-запрос, который передаётся в SQLite как есть. Структура результирующей таблицы автоматически определяется по результату запроса. Запрос можно записать либо как подзапрос, либо обернуть в функцию query:
Такая таблица доступна только для чтения: операция INSERT для неё недопустима. Тот же синтаксис поддерживается и движком таблицы SQLite.
Форма подзапроса (SELECT ...) разбирается ClickHouse и повторно сериализуется перед отправкой в SQLite. Поэтому она должна быть корректным ClickHouse SQL. Чтобы передать синтаксис, специфичный для SQLite, который ClickHouse не разбирает, используйте форму query('...'), текст которой отправляется в SQLite дословно.Любые внешние WHERE, LIMIT, агрегация и т. п. из окружающего запроса к ClickHouse не переносятся в переданный запрос — они применяются в ClickHouse после получения полного результата запроса. Чтобы ограничить данные, считываемые из SQLite, поместите фильтр внутрь переданного запроса. При external_table_strict_query = 1 внешний фильтр, который нельзя перенести, вызывает исключение вместо локального применения.

Пример

Query
Response
Последнее изменение 23 июля 2026 г.