MySQL :: MySQL 8.4 参考手册 :: 22.4.4.2 选择表

版本 8.4

9.0
8.0

8.0 日本语

22.4.4.2 选择表

您可以使用 select() 方法查询并返回数据库中表中的记录。X DevAPI 提供了其他方法与 select() 方法一起使用，以过滤和排序返回的记录。

MySQL 提供以下运算符来指定搜索条件：OR (||)、AND (&&)、XOR、IS、NOT、BETWEEN、IN、LIKE、!=、<>、>、>=、<、<=、&、|、<<、>>、+、-、*、/、~ 和 %。

选择所有记录

要发出返回现有表中所有记录的查询，请使用 select() 方法，不指定搜索条件。以下示例从 world_x 数据库中的 city 表中选择所有记录。

注意

将空 select() 方法的使用限制在交互式语句中。在应用程序代码中始终使用显式列名选择。

mysql-py> db.city.select()
+------+------------+-------------+------------+-------------------------+
| ID   | Name       | CountryCode | District   | Info                    |
+------+------------+-------------+------------+-------------------------+
|    1 | Kabul      | AFG         | Kabol      |{"Population": 1780000}  |
|    2 | Qandahar   | AFG         | Qandahar   |{"Population": 237500}   |
|    3 | Herat      | AFG         | Herat      |{"Population": 186800}   |
...    ...          ...           ...          ...
| 4079 | Rafah      | PSE         | Rafah      |{"Population": 92020}    |
+------+------- ----+-------------+------------+-------------------------+
4082 rows in set (0.01 sec)

空集（没有匹配记录）返回以下信息

Empty set (0.00 sec)

过滤搜索

要发出返回一组表列的查询，请使用 select() 方法，并在方括号中指定要返回的列。此查询将返回 city 表中的 Name 和 CountryCode 列。

mysql-py> db.city.select(["Name", "CountryCode"])
+-------------------+-------------+
| Name              | CountryCode |
+-------------------+-------------+
| Kabul             | AFG         |
| Qandahar          | AFG         |
| Herat             | AFG         |
| Mazar-e-Sharif    | AFG         |
| Amsterdam         | NLD         |
...                 ...
| Rafah             | PSE         |
| Olympia           | USA         |
| Little Falls      | USA         |
| Happy Valley      | USA         |
+-------------------+-------------+
4082 rows in set (0.00 sec)

要发出返回与特定搜索条件匹配的行的查询，请使用 where() 方法包含这些条件。例如，以下示例将返回以字母 Z 开头的城市的名称和国家/地区代码。

mysql-py> db.city.select(["Name", "CountryCode"]).where("Name like 'Z%'")
+-------------------+-------------+
| Name              | CountryCode |
+-------------------+-------------+
| Zaanstad          | NLD         |
| Zoetermeer        | NLD         |
| Zwolle            | NLD         |
| Zenica            | BIH         |
| Zagazig           | EGY         |
| Zaragoza          | ESP         |
| Zamboanga         | PHL         |
| Zahedan           | IRN         |
| Zanjan            | IRN         |
| Zabol             | IRN         |
| Zama              | JPN         |
| Zhezqazghan       | KAZ         |
| Zhengzhou         | CHN         |
...                 ...
| Zeleznogorsk      | RUS         |
+-------------------+-------------+
59 rows in set (0.00 sec)

您可以使用 bind() 方法将值与搜索条件分开。例如，与其使用 “Name = 'Z%'” 作为条件，不如使用以冒号开头并以字母开头的命名占位符，如 name。然后，在 bind() 方法中包含占位符和值，如下所示

mysql-py> db.city.select(["Name", "CountryCode"]).where(
"Name like :name").bind("name", "Z%")

提示

在程序中，绑定使您能够在表达式中指定占位符，这些占位符将在执行之前填充值，并且可以从自动转义中获益，具体取决于情况。

始终使用绑定来清理输入。避免使用字符串连接在查询中引入值，这可能会产生无效输入，在某些情况下还会导致安全问题。

投影结果

要使用 AND 运算符发出查询，请在 where() 方法中的搜索条件之间添加运算符。

mysql-py> db.city.select(["Name", "CountryCode"]).where(
"Name like 'Z%' and CountryCode = 'CHN'")
+----------------+-------------+
| Name           | CountryCode |
+----------------+-------------+
| Zhengzhou      | CHN         |
| Zibo           | CHN         |
| Zhangjiakou    | CHN         |
| Zhuzhou        | CHN         |
| Zhangjiang     | CHN         |
| Zigong         | CHN         |
| Zaozhuang      | CHN         |
...              ...
| Zhangjiagang   | CHN         |
+----------------+-------------+
22 rows in set (0.01 sec)

要指定多个条件运算符，您可以将搜索条件括在括号中以更改运算符优先级。以下示例演示了 AND 和 OR 运算符的位置。

mysql-py> db.city.select(["Name", "CountryCode"]).where(
"Name like 'Z%' and (CountryCode = 'CHN' or CountryCode = 'RUS')")
+-------------------+-------------+
| Name              | CountryCode |
+-------------------+-------------+
| Zhengzhou         | CHN         |
| Zibo              | CHN         |
| Zhangjiakou       | CHN         |
| Zhuzhou           | CHN         |
...                 ...
| Zeleznogorsk      | RUS         |
+-------------------+-------------+
29 rows in set (0.01 sec)

限制、排序和偏移结果

您可以应用 limit()、order_by() 和 offset() 方法来管理 select() 方法返回的记录数量和顺序。

要指定结果集中的记录数量，请将带有值的 limit() 方法追加到 select() 方法。例如，以下查询将返回 country 表中的前五条记录。

mysql-py> db.country.select(["Code", "Name"]).limit(5)
+------+-------------+
| Code | Name        |
+------+-------------+
| ABW  | Aruba       |
| AFG  | Afghanistan |
| AGO  | Angola      |
| AIA  | Anguilla    |
| ALB  | Albania     |
+------+-------------+
5 rows in set (0.00 sec)

要指定结果的顺序，请将 order_by() 方法追加到 select() 方法。将要排序的一个或多个列的列表传递给 order_by() 方法，并根据需要选择降序 (desc) 或升序 (asc) 属性。升序是默认排序类型。

例如，以下查询按 Name 列对所有记录进行排序，然后以降序返回前三条记录。

mysql-py> db.country.select(["Code", "Name"]).order_by(["Name desc"]).limit(3)
+------+------------+
| Code | Name       |
+------+------------+
| ZWE  | Zimbabwe   |
| ZMB  | Zambia     |
| YUG  | Yugoslavia |
+------+------------+
3 rows in set (0.00 sec)

默认情况下，limit() 方法从表中的第一条记录开始。您可以使用 offset() 方法更改起始记录。例如，要忽略第一条记录并返回与条件匹配的接下来的三条记录，请将值 1 传递给 offset() 方法。

mysql-py> db.country.select(["Code", "Name"]).order_by(["Name desc"]).limit(3).offset(1)
+------+------------+
| Code | Name       |
+------+------------+
| ZMB  | Zambia     |
| YUG  | Yugoslavia |
| YEM  | Yemen      |
+------+------------+
3 rows in set (0.00 sec)