Создание SQL-запроса вручную
Скопировано

13 октября 2026

ID 228356

Создание SQL-запроса вручную

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

Чтобы сформировать SQL-запрос вручную:

  1. Перейдите в раздел События веб-интерфейса KUMA.

    Откроется форма с полем ввода.

  2. Введите SQL-запрос в поле ввода. Вам нужно использовать одинарные кавычки в запросах.

    При вводе имени функции в поле SQL-запроса отображается список функций, которые можно использовать. Для выбранной функции справа выводится подсказка с примером ее использования. Например, для функции concatWithSeparator отображается пример: concatWithSeparator('a', '1', '2', '3').

  3. Нажмите на кнопку Выполнить запрос.

    Вы также можете запустить выполнение запроса в фоновом режиме. Для этого нажмите на значок стрелки рядом с кнопкой Выполнить запрос и выберите Запустить в фоне. В этом случае происходит следующее:

    • Запрос будет добавлен в очередь на выполнение в фоновом режиме, и в разделе Диспетчер задач будет создана задача на выполнение этого запроса.
    • Фоновые запросы выполняются с низким приоритетом параллельно.
    • Запрос не может быть отправлен на выполнение в фоновом режиме, если он содержит более 10 000 событий.

В таблице отобразятся результаты поиска по сформированному SQL-запросу. Результат выполнения запроса в фоновом режиме можно просмотреть в разделе Диспетчер задач.

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

При необходимости вы можете отфильтровать события в таблице по периоду.

Поддерживаемые функции и операторы

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

При создании нормализатора для событий вы можете выбрать, сохранять ли значения полей исходного события. Данные сохраняются в поле события Extra. Поиск событий по этому полю осуществляется с помощью оператора LIKE.

Если вы создали SQL-запрос вручную в строке поиска и затем переключились на конструктор, параметры SQL-запроса не перенесутся в конструктор. В этом случае вам потребуется создать SQL-запрос в конструкторе заново. SQL-запрос, созданный в конструкторе, не перезаписывает SQL-запрос, введенный в строке поиска, пока вы не нажмете на кнопку Применить запрос в окне конструктора. Если вы создали SQL-запрос в конструкторе и затем переключились на поисковую строку, параметры запроса перенесутся автоматически.

Используемые в поисковых запросах псевдонимы не должны содержать пробелов.

Подробнее об SQL см. в справке ClickHouse. Также см. поддерживаемые функции ClickHouse.

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!