3. SQL 基础回顾：查询与聚合

在将 SQL 与 Grafana 结合进行趋势分析之前，必须牢固掌握 SQL 查询的核心语法。本章将系统回顾 SELECT、WHERE、ORDER BY、LIMIT 以及常用聚合函数，这些是构建任何时间序列查询的基石。

3.1 SELECT 语句与字段投影

SELECT 语句用于从数据库表中检索数据。其基本语法决定了返回哪些列（字段）以及如何对它们进行变换。

SELECT column1, column2, ...
FROM table_name;

3.2 WHERE 条件过滤

WHERE 子句用于在数据返回前过滤行记录。它支持比较运算符（=, >, <）、逻辑运算符（AND, OR, NOT）以及范围匹配（IN, BETWEEN, LIKE）。

3.3 ORDER BY 排序与 LIMIT 分页

ORDER BY 用于对结果集按一列或多列进行排序，默认升序（ASC），可指定 DESC 降序。LIMIT 用于限制返回的行数，常与 ORDER BY 配合实现“Top-N”查询。

SELECT timestamp, host, cpu_usage
FROM system_metrics
WHERE timestamp > now() - INTERVAL '1 hour'
ORDER BY cpu_usage DESC
LIMIT 5;

分页模式： 在需要分页展示时，某些数据库（如 PostgreSQL、MySQL）支持 LIMIT 配合 OFFSET 语法。

-- 获取第 2 页数据，每页 10 条
SELECT * FROM events
ORDER BY event_time DESC
LIMIT 10 OFFSET 10;

3.4 常用聚合函数

聚合函数用于对一组值执行计算并返回单个汇总值。它们通常与 GROUP BY 子句结合使用，是趋势分析的核心工具。

3.5 综合查询示例

以下示例展示了如何将上述知识点组合成一个完整的趋势分析查询。该查询按小时统计每个服务的平均响应时间和请求总数。

SELECT
    DATE_TRUNC('hour', request_time) AS hour_bucket,
    service_name,
    COUNT(*) AS total_requests,
    AVG(response_time_ms) AS avg_response_time,
    MAX(response_time_ms) AS max_response_time
FROM api_requests
WHERE request_time >= now() - INTERVAL '7 days'
  AND status_code != 500
GROUP BY hour_bucket, service_name
ORDER BY hour_bucket DESC, avg_response_time DESC
LIMIT 100;

3.6 常见错误与避坑指南