ClickHouse 中的 LogsQL 方言

介绍如何启用实验性的 LogsQL 方言（VictoriaLogs 的查询语言）及其支持的功能

​

概述

ClickHouse 提供了一种实验性的 logsql 方言，可使用 VictoriaLogs LogsQL 语法查询日志表。 它会将 LogsQL 查询转换为 ClickHouse SELECT 查询。

在会话中启用该方言并配置源表：

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 过滤器、 stream 过滤器、文本和数值比较、时间范围，以及 fields、stats、sort、limit、format、extract 和 unpack_json 等管道操作。文本过滤器要求日志列为 String 类型；显式声明类型的字段可 用于数值比较和数值统计。

该方言目前处于实验阶段，并非对 VictoriaLogs 的逐字节实现。不支持的语法会被拒绝，并返回 NOT_IMPLEMENTED；此外，在 ClickHouse 类型、正则表达式、时区 或 SQL 聚合规则存在差异的情况下，查询 语义也可能有所不同。如果某个 LogsQL 语法结构不受支持，或需要与 VictoriaLogs 完全兼容，请改用常规的 ClickHouse SQL。