# CASE

> CASE 语句允许在查询中执行条件逻辑，根据条件返回特定值。

# CASE

`CASE` 表达式按顺序计算各个条件，并返回第一个为真的条件所对应的结果。如果没有条件为真，则返回 `ELSE` 的结果；省略 `ELSE` 时返回 `NULL`。

## 语法

```sql
CASE
  WHEN condition1 THEN result1
  WHEN condition2 THEN result2
  ...
  ELSE result
END
```

- `condition1`，`condition2`，...：表达式的判断条件。
- `result1`，`result2`，...：满足相应条件时要返回的值。
- `result`：当没有条件满足时要返回的值（可选）。

## 示例

`CASE` 语句可以在各种子句中使用，例如 `SELECT`，`WHERE`，`ORDER BY` 和 `GROUP BY`。

### 在 `SELECT` 中使用 `CASE`

在 `SELECT` 子句中，你可以使用 `CASE` 语句根据条件创建新列。
请参阅查询数据指南中的[示例](/user-guide/query-data/sql.md#case-expression)。

你还可以将 `CASE` 与 `SUM` 等函数一起使用，以有条件地聚合数据。
例如，你可以计算状态码为 200 和 404 的日志总数：

```sql
SELECT
  SUM(CASE WHEN status_code = '200' THEN 1 ELSE 0 END) AS status_200_count,
  SUM(CASE WHEN status_code = '404' THEN 1 ELSE 0 END) AS status_404_count
FROM nginx_logs;
```

### 在 `WHERE` 中使用 `CASE`

在 `WHERE` 子句中，你可以根据条件过滤行。
例如，以下查询根据 `ts` 条件从 `monitor` 表中检索数据：

```sql
SELECT * 
FROM monitor 
WHERE host = CASE 
          WHEN ts > '2023-12-13 02:05:46' THEN '127.0.0.1' 
          ELSE '127.0.0.2' 
        END;
```

### 在 `GROUP BY` 中使用 `CASE`

`CASE` 语句可以在 `GROUP BY` 子句中使用，以根据特定条件对数据进行分类。
例如，以下查询按 `host` 列分组，并将 `cpu` 列分类为三类：'high'，'medium' 和 'low'：

```sql
SELECT
  host,
  COUNT(*) AS count,
  CASE
    WHEN cpu > 0.5 THEN 'high'
    WHEN cpu > 0.3 THEN 'medium'
    ELSE 'low'
  END AS cpu_status
FROM monitor
GROUP BY 
  host, cpu_status;
```

### 在 `ORDER BY` 中使用 `CASE`

以下查询在 `status_code` 不为 `NULL` 时按 `status_code` 排序，否则按 `http_method` 排序：

```sql
SELECT *
FROM nginx_logs
ORDER BY
  CASE
    WHEN status_code IS NOT NULL THEN status_code
    ELSE http_method
  END;
```