fetchone()メソッドとは？PythonとMySQLでの使い方をわかりやすく解説

fetchone()メソッドとは

fetchone()メソッドは、テーブルから最初の1行だけを取得したい場合に使用するメソッドです。このメソッドは、MySQLテーブルから取得した結果セットの中の先頭行のみを返します。

fetchone()メソッドの仕組み

fetchone()は、カーソルオブジェクトに直接渡すクエリではありません。まず「SELECT *」というクエリを実行してテーブル内のすべての行を取得し、その後、返された結果セットに対してfetchone()メソッドを実行します。すると、結果セットの中から最初の1行だけが取り出されます。

PythonでMySQLから最初の行を取得する手順

• mysql.connectorモジュールをインポートする
• connect()メソッドを使ってデータベースへの接続を確立する
• cursor()メソッドを使ってカーソルオブジェクトを作成する
• 「SELECT *」文を使ってクエリを作成する
• execute()メソッドを使ってSQLクエリを実行する
• 「SELECT *」クエリが返した結果に対してfetchone()メソッドを実行する
• 接続を閉じる（close()）

ここでは、「MyTable」という名前の次のようなテーブルから、最初の1行だけを取得することを考えます。

+----------+---------+-----------+------------+
|    Name  |  Class  |    City   |   Marks    |
+----------+---------+-----------+------------+
|    Karan |    4    | Amritsar  |     95     |
|    Sahil |    6    | Amritsar  |     93     |
|    Kriti |    3    | Batala    |     88     |
|   Khushi |    9    | Delhi     |     90     |
|    Kirat |    5    | Delhi     |     85     |
+----------+---------+-----------+------------+

サンプルコード

import mysql.connector

db = mysql.connector.connect(host="your host", user="your username", password="your password", database="database_name")
cursor = db.cursor()

query = "SELECT * FROM MyTable"
cursor.execute(query)

# カーソルオブジェクトにはクエリの結果（すべての行）が格納されている
# fetchone()メソッドで最初の1行を取得する
first_row = cursor.fetchone()
print(first_row)

上記のコードを実行すると、テーブルから最初の1行を取得して表示します。

実行結果

('Karan', 4, 'Amritsar', 95)

なお、すべての行を一度に取得したい場合はfetchall()メソッドを、指定した件数だけ取得したい場合はfetchmany(n)メソッドを使うと便利です。用途に応じてこれらのメソッドを使い分けることで、効率的にデータを扱うことができます。