> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MySQL UNION

> UNION 如何把 2 个 MySQL 查询的行叠成 1 个结果，它与 UNION ALL 的区别，以及 2 个查询真正必须遵守的 1 条规则。

> [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md)
>
> All examples on this page work on VillageSQL. Install Now →

连接把表并排放置，让结果变宽。`UNION` 把结果上下叠放，让结果变长。当 2 个查询产生相同形状的行，而您想把它们放进 1 个列表时，就用它。

开始之前，请用 `mysql -u root -p sakila` 打开客户端。

## UNION 的工作原理

```sql theme={null}
SELECT COLUMN_LIST FROM FIRST_TABLE
UNION
SELECT COLUMN_LIST FROM SECOND_TABLE;
```

把每个 `COLUMN_LIST` 替换为您想要的列，`FIRST_TABLE` 和 `SECOND_TABLE` 替换为要读取的表。

2 个查询必须返回相同数量的列，服务器按位置而不是按名字匹配这些列。

`UNION` 去除重复行。`UNION ALL` 保留它们，而且更快，因为它不必比较任何东西。

## 示例

### UNION 去除重复

这里的两部分是同一个查询，所以第二部分的每一行都是第一部分某一行的重复。

```sql theme={null}
SELECT rating FROM film UNION SELECT rating FROM film;
```

```text theme={null}
+--------+
| rating |
+--------+
| PG     |
| G      |
| NC-17  |
| PG-13  |
| R      |
+--------+
5 rows in set (0.00 sec)
```

从 2,000 行得到 5 行。`UNION` 一次性对合并后的结果去重，所以一部分内部的重复与两部分之间的重复处理方式相同。答案与同一列上的 [SELECT DISTINCT](https://villagesql.com/docs/zh/tutorial/select-distinct.md) 一致。

### UNION ALL 保留它们

```sql theme={null}
SELECT rating FROM film UNION ALL SELECT rating FROM film;
```

```text theme={null}
+--------+
| rating |
+--------+
| PG     |
| G      |
| NC-17  |
...
+--------+
2000 rows in set (0.00 sec)
```

两部分的每一行。当您知道没有重复，或者重复正是目的时，就用 `UNION ALL`。

### 叠放来自不同表的行

这才是 `UNION` 真正的用途：2 个保存同类事物的表。一个字面值列说明每一行来自哪一部分。

```sql theme={null}
SELECT 'staff' AS source, first_name, last_name FROM staff
UNION ALL
SELECT 'actor', first_name, last_name FROM actor WHERE actor_id <= 3;
```

```text theme={null}
+--------+------------+-----------+
| source | first_name | last_name |
+--------+------------+-----------+
| staff  | Mike       | Hillyer   |
| staff  | Jon        | Stephens  |
| actor  | PENELOPE   | GUINESS   |
| actor  | NICK       | WAHLBERG  |
| actor  | ED         | CHASE     |
+--------+------------+-----------+
5 rows in set (0.00 sec)
```

第二个查询没有给它的字面值起别名。它不需要，因为列标题只来自第一个查询。

## UNION 不保证顺序

任何一部分都不保证整块连续到达，也不保证先到达。服务器按其计划产生行的顺序返回它们，所以 2 个相同查询的 `UNION ALL` 可能会交错。末尾的 `ORDER BY` 是唯一能固定顺序的方法，这与 [LIMIT](https://villagesql.com/docs/zh/tutorial/limit.md) 和 [GROUP BY](https://villagesql.com/docs/zh/tutorial/group-by.md) 的情况相同。

## 两部分的列数必须相同

```sql theme={null}
SELECT first_name FROM actor UNION SELECT first_name, last_name FROM actor;
```

```text theme={null}
ERROR 1222 (21000): The used SELECT statements have a different number of columns
```

列名不必匹配。只有数量是严格的，而且在任何东西运行之前就会检查。

## ORDER BY 作用于整个结果

末尾的 `ORDER BY` 对合并后的行排序，而不是对最后一个查询排序。请写第一部分的别名，那就是结果列的名字。

```sql theme={null}
SELECT first_name AS name FROM staff
UNION
SELECT last_name FROM staff
ORDER BY name;
```

```text theme={null}
+----------+
| name     |
+----------+
| Hillyer  |
| Jon      |
| Mike     |
| Stephens |
+----------+
4 rows in set (0.00 sec)
```

要单独对 1 部分排序或限制行数，请把那一部分用括号括起来，并把它的 `ORDER BY` 和 `LIMIT` 放在括号里面。

## 总结

* 用 `UNION` 把 2 个查询的行叠成 1 个结果。
* 预期 `UNION` 去除重复，`UNION ALL` 保留重复。
* 当您知道没有重复时，优先用 `UNION ALL`，因为它做的工作更少。
* 给两部分相同数量的列，否则得到 `ERROR 1222`。
* 预期列标题来自第一个查询，末尾的 `ORDER BY` 对整个结果排序。

## 另请参阅

* [SELECT DISTINCT](https://villagesql.com/docs/zh/tutorial/select-distinct.md) — 从 1 个查询中去除重复
* [连接的工作原理](https://villagesql.com/docs/zh/tutorial/joins.md) — 改为把表并排组合
* [子查询](https://villagesql.com/docs/zh/tutorial/subqueries.md) — 用作值而不是叠放的查询


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.