日志服务Copliot支持使用自然语言生成SQL语句,对日志内容或SQL语句进行解释,优化SQL语句以提高查询效率。
前提条件
已创建索引。如果您要分析日志,则需创建字段索引并开启统计。
为确保Copilot能准确理解和生成SQL,建议索引设计和字段名称满足以下条件:
-
定义清晰、语义明确的索引列名。
例如
GET /HTTP/1.1索引名称定义为request_method。 -
如无法修改列名,可使用别名补充说明。
例如某个索引字段名称为
test,但实际上该字段主要记录的是请求的状态,在索引别名输入status补充说明。 -
避免使用意义相近或模糊不清的字段名。
例如某个索引记录的是文件的名称,建议索引字段名为
file_name,避免使用file或其他名称。
使用限制
目前Copilot只适用SQL语句,不能适用SPL语句。
功能概览
-
生成SQL语句:您使用日常语言表达查询需求,Copilot会自动将这些描述转换为准确的SQL查询语句,从而显著降低使用技术工具的难度。在日志服务查询分析页面中,打开 Copilot 面板,可使用日志查询语句助手,包含 SQL生成、SQL解释、SQL诊断 三个功能标签页。选择 SQL生成 标签页后,在输入框中描述要执行的查询需求即可自动生成对应 SQL 语句。
-
解释SQL语句:解析SQL语句并分解其结构和功能,帮助用户更深入地理解查询逻辑,从而提高SQL技能。解释 SQL 语句:在 Copilot 的日志查询语句助手区域选择SQL解释页签,输入待分析的查询语句,Copilot 将对复杂 SQL 进行自然语言解读,帮助理解查询逻辑。
-
优化SQL语句:通过智能分析SQL性能与结构,以识别潜在优化点并提供具体改进建议,提高查询效率。在 Copilot 的日志查询语句助手区域选择SQL诊断页签,输入待优化的 SQL 语句,Copilot 将分析语句性能与结构并提供具体改进建议。
操作步骤
登录日志服务控制台,在目标Project的LogStore的查询分析页面单击
,进入Copilot界面。按需要选择SQL生成,解释或诊断。
生成SQL语句使用示例
为提高Copilot识别准确率,建议使用明确的表述方式,如:"查询..."、"分析..."、"编写一个 SQL..."等。
-
对某个字段进行统计:分析不同
host的请求总量,总量字段是body_bytes_sent。Copilot 生成的查询语句为
* | SELECT host, SUM(body_bytes_sent) AS total_bytes_sent FROM log GROUP BY host ORDER BY total_bytes_sent DESC,通过 SUM 函数计算每个 host 的总请求量,使用 GROUP BY host 分组并按降序排序。单击复制或使用并查询可直接使用该语句。 -
对特定
host进一步分析,计算百分位的数量:分析下service.cn-shanghai.log.aliyun-inc.com这个P95百分位数据量是多少。因百分位数非标准SQL函数,需要Copilot识别并使用相应函数。Copilot 生成的 SQL 查询语句为:
* | SELECT approx_percentile(body_bytes_sent, 0.95) AS p95_bytes_sent FROM log WHERE host = 'service.cn-shanghai.log.aliyun-inc.com',通过approx_percentile函数估算 P95 百分位值,并以 WHERE 子句过滤指定主机。生成结果可单击复制或使用并查询直接执行。 -
不同
host的流量存在差别,计算请求量最大和最小的主机之间的差别:查询最大的host和最小的host,他们的请求量相差多少。这个问题复杂在于要在一个SQL里面分别计算最大和最小流量的
host,同时要进行比对。说明对于多条件复杂SQL,Copilot可能出现语法错误或无数据等问题。建议采用分步咨询方式,逐步完善SQL。例如该示例先统计出请求量最大主机和最小主机的数量,再次计算两者的差值。
-
输入查询需求。
例如输入
帮我计算最大的 host 和最小的 host,他们的请求量相差多少,Copilot 返回解释说明并生成使用公共表表达式(CTE)的 SPL 查询语句,通过host_totals、max_host、min_host子查询分别计算每个主机的总请求量、找到最大和最小主机并计算差值。生成结果下方提供复制和使用并查询操作按钮。 -
使用后结果展示了差值,但是没有展示
host的最大值和最小值。查询结果中字段difference的值为
455115968,仅展示差值,未展示各host的最大值与最小值。 -
继续输入需求:上述SQL,需要展示最大和最小流量的
host。Copilot 回复了一段基于 WITH 子句的 SQL 查询,定义了
host_totals、max_host、min_host三个 CTE,最终 SELECT 输出最大和最小主机名称、各自请求总量及差异值。可单击复制或使用并查询使用该 SQL。 -
使用后Copilot正确地分析了我们的需求。
Copilot 生成的 SQL 语句使用 CTE(
WITH host_totals AS (...))统计各 host 的发送字节数,并查询发送字节数最多的 max_host、最少的 min_host 及二者差值 diff。在日志服务查询分析界面执行该语句后,结果表格正确返回了对应的三列数据。
-
解释SQL语句使用示例
为提高Copilot识别准确率,建议使用明确的表述方式,如:"分析下..."、"解释下..."等。
-
解释复杂SQL
输入复杂SQL,Copilot会告知SQL语句的含义,以及每一个字段的含义。
Copilot 除了解释 SQL 含义外,还会提供优化后的 SQL 语句,底部可通过复制或使用并查询链接直接应用结果。
-
查询SQL函数
日志服务包含了许多SQL函数,Copilot可以根据描述给出函数的解释和样例。
例如,用户询问时序预测相关函数时,Copilot 会给出
ts_predict函数的用法说明及对应的 SQL 查询示例。 -
查询字段信息
日志服务可以解释原始日志中的字段含义,帮助您理解日志内容。在智能助手中提问"请解释原始日志中各个字段的含义是什么",智能助手返回各字段含义:
__time__表示日志记录的时间戳,__tag__:pod_name(_pod_name_)表示Pod名称,__tag__:container_name(_container_name_)表示容器名称,_image_name_表示镜像名称,_namespace_表示命名空间,_source_表示数据源,__tag__:pod_uid(_pod_uid_)表示Pod唯一标识符,__tag__:container_ip(_container_ip_)表示容器IP地址,__tag__:__hostname__表示主机名。
优化SQL语句使用示例
通过智能分析SQL性能与结构,以识别潜在优化点并提供具体改进建议,旨在确保查询能够高效执行。
例如,用户输入查询语句* | select a count(a) group by a,Copilot识别出缺少FROM子句、COUNT(a)未设置别名等问题,并给出修正后的查询语句:* | SELECT a, COUNT(a) AS count_a FROM table_name GROUP BY a。修正结果支持通过复制或使用并查询直接应用。