MySQL :: MySQL 8.0 リファレンスマニュアル

9.1 English
9.0 English
8.4 English
8.0 English

MySQL 8.0 リファレンスマニュアル / ... / テーブルの選択

このページは機械翻訳したものです。

20.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() メソッドの値を追加します。たとえば、次のクエリーでは、国テーブルの最初の 5 つのレコードが返されます。

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() メソッドに追加します。必要に応じて、降順 (desc) または昇順 (asc) 属性でソートするカラムのリストを order_by() メソッドに渡します。昇順がデフォルトのオーダータイプです。

たとえば、次のクエリーでは、すべてのレコードが名前カラムでソートされ、最初の 3 つのレコードが降順で返されます。

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() メソッドを使用して、開始レコードを変更できます。たとえば、最初のレコードを無視し、条件に一致する次の 3 つのレコードを返すには、offset() メソッドに値 1 を渡します。

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)

20.4.4.2 テーブルの選択

すべてのレコードの選択

フィルタ検索

プロジェクト結果

制限、順序およびオフセットの結果

関連情報