> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Диалект LogsQL в ClickHouse

> Как включить экспериментальный диалект LogsQL (язык запросов VictoriaLogs) и что он поддерживает

<h2 id="overview">
  Обзор
</h2>

ClickHouse предоставляет экспериментальный диалект `logsql` для выполнения запросов к таблицам логов с использованием синтаксиса
[VictoriaLogs LogsQL](https://docs.victoriametrics.com/victorialogs/logsql/).
Он преобразует запрос LogsQL в `SELECT`-запрос ClickHouse.

Включите его для сеанса и настройте исходную таблицу:

```sql theme={null}
SET enable_logsql_dialect = 1;
SET logsql_database = 'default';
SET logsql_table = 'logs';
SET logsql_time_column = '_time';
SET logsql_message_column = '_msg';
SET dialect = 'logsql';
```

Настроенная таблица должна содержать столбцы времени и сообщения. Поддерживаются фильтры LogsQL,
фильтры потоков, текстовые и числовые сравнения, временные диапазоны, а также операции конвейера,
такие как `fields`, `stats`, `sort`, `limit`, `format`, `extract` и `unpack_json`.
Текстовые фильтры рассчитаны на столбцы журнала типа `String`; типизированные поля можно
использовать в числовых сравнениях и при вычислении числовой статистики.

Этот диалект является экспериментальным и не воспроизводит VictoriaLogs побайтово.
Неподдерживаемый синтаксис отклоняется с ошибкой `NOT_IMPLEMENTED`; кроме того, семантика запросов
может отличаться там, где различаются типы ClickHouse, регулярные выражения, часовые
пояса или правила агрегации SQL. Если конструкция LogsQL не поддерживается или требуется
точная совместимость с VictoriaLogs, используйте обычный ClickHouse SQL.