[Python] SQLite3でテーブルからデータを取得する方法
PythonでSQLite3を使用してテーブルからデータを取得するには、まずsqlite3モジュールをインポートし、データベースに接続します。
次に、カーソルオブジェクトを作成し、SELECT文を実行します。
結果はfetchall()やfetchone()で取得可能です。
例として、cursor.execute("SELECT * FROM table_name")を使用し、rows = cursor.fetchall()で全データを取得します。
最後に接続を閉じます。
SQLite3を使う準備
SQLite3は、Pythonに標準で搭載されている軽量なデータベースです。
SQLite3を使用するための準備として、以下の手順を行います。
SQLite3のインポート
まず、SQLite3を使用するために、Pythonのプログラム内でインポートします。
以下のコードを記述してください。
import sqlite3データベースの作成または接続
次に、SQLite3データベースに接続します。
データベースが存在しない場合は、新たに作成されます。
以下のコードを使用します。
# データベースに接続(存在しない場合は新規作成)
connection = sqlite3.connect('example.db')カーソルの作成
データベースに対してSQL文を実行するためには、カーソルを作成する必要があります。
カーソルは、データベースとのやり取りを行うためのオブジェクトです。
# カーソルの作成
cursor = connection.cursor()テーブルの作成(オプション)
データを格納するためのテーブルを作成することもできます。
以下のコードは、簡単なテーブルを作成する例です。
# テーブルの作成
cursor.execute('''
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
age INTEGER
)
''')変更の保存と接続の終了
データベースに対する変更を保存するためには、commit()メソッドを使用します。
最後に、接続を終了するためにclose()メソッドを呼び出します。
# 変更を保存
connection.commit()
# 接続を終了
connection.close()これでSQLite3を使う準備が整いました。
次のステップでは、テーブルからデータを取得する方法について解説します。
テーブルからデータを取得する基本的な手順
SQLite3を使用してテーブルからデータを取得するための基本的な手順を以下に示します。
これらの手順を実行することで、データベース内の情報を簡単に取得できます。
データベースへの接続
まず、データベースに接続します。
前のセクションで作成したexample.dbに接続するコードは以下の通りです。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()データの取得
次に、SQLのSELECT文を使用してデータを取得します。
以下のコードは、usersテーブルから全てのデータを取得する例です。
# データの取得
cursor.execute('SELECT * FROM users')
rows = cursor.fetchall() # すべての行を取得取得したデータの表示
取得したデータを表示するためには、ループを使用して各行を出力します。
以下のコードは、取得したデータを表示する例です。
# 取得したデータの表示
for row in rows:
print(row)接続の終了
データの取得が完了したら、接続を終了します。
以下のコードを追加します。
# 接続を終了
connection.close()サンプルコード全体
これまでの手順をまとめたサンプルコードは以下の通りです。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# データの取得
cursor.execute('SELECT * FROM users')
rows = cursor.fetchall() # すべての行を取得
# 取得したデータの表示
for row in rows:
print(row)
# 接続を終了
connection.close()もしusersテーブルに以下のデータが格納されている場合、出力結果は次のようになります。
(1, '山田太郎', 30)
(2, '鈴木花子', 25)この手順を通じて、SQLite3を使用してテーブルからデータを取得する基本的な方法を理解できたと思います。
次のセクションでは、条件付きでデータを取得する方法について解説します。
条件付きでデータを取得する方法
SQLite3を使用して、特定の条件に基づいてデータを取得することができます。
これにより、必要な情報だけを効率的に取得することが可能です。
以下に、条件付きでデータを取得する手順を示します。
データベースへの接続
まず、データベースに接続します。
前のセクションで作成したexample.dbに接続するコードは以下の通りです。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()条件付きのデータ取得
SQLのSELECT文にWHERE句を追加することで、特定の条件に合致するデータを取得できます。
以下のコードは、ageが30以上のユーザーを取得する例です。
# 条件付きのデータ取得
cursor.execute('SELECT * FROM users WHERE age >= 30')
rows = cursor.fetchall() # すべての行を取得取得したデータの表示
取得したデータを表示するためには、ループを使用して各行を出力します。
以下のコードは、取得したデータを表示する例です。
# 取得したデータの表示
for row in rows:
print(row)接続の終了
データの取得が完了したら、接続を終了します。
以下のコードを追加します。
# 接続を終了
connection.close()サンプルコード全体
これまでの手順をまとめたサンプルコードは以下の通りです。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# 条件付きのデータ取得
cursor.execute('SELECT * FROM users WHERE age >= 30')
rows = cursor.fetchall() # すべての行を取得
# 取得したデータの表示
for row in rows:
print(row)
# 接続を終了
connection.close()もしusersテーブルに以下のデータが格納されている場合、出力結果は次のようになります。
(1, '山田太郎', 30)この手順を通じて、SQLite3を使用して条件付きでデータを取得する方法を理解できたと思います。
次のセクションでは、データの整形と活用について解説します。
データの整形と活用
SQLite3を使用して取得したデータは、そのままでは使いにくい場合があります。
データを整形し、必要な形式に変換することで、より効果的に活用できます。
以下に、データの整形と活用の方法を示します。
データの整形
取得したデータを整形するためには、リストや辞書に変換することが一般的です。
以下のコードは、取得したデータを辞書形式に整形する例です。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# データの取得
cursor.execute('SELECT * FROM users')
rows = cursor.fetchall() # すべての行を取得
# データを辞書形式に整形
users = []
for row in rows:
user = {
'id': row[0],
'name': row[1],
'age': row[2]
}
users.append(user)
# 整形したデータの表示
for user in users:
print(user)
# 接続を終了
connection.close()整形したデータの活用
整形したデータは、さまざまな方法で活用できます。
例えば、特定の条件に基づいてフィルタリングしたり、データを集計したりすることが可能です。
以下のコードは、年齢が30以上のユーザーのみをフィルタリングする例です。
# 年齢が30以上のユーザーをフィルタリング
filtered_users = [user for user in users if user['age'] >= 30]
# フィルタリングしたデータの表示
for user in filtered_users:
print(user)データの集計
整形したデータを使って集計を行うこともできます。
例えば、ユーザーの平均年齢を計算することができます。
以下のコードは、平均年齢を計算する例です。
# 平均年齢の計算
average_age = sum(user['age'] for user in users) / len(users) if users else 0
print(f'平均年齢: {average_age:.2f}歳')サンプルコード全体
これまでの手順をまとめたサンプルコードは以下の通りです。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# データの取得
cursor.execute('SELECT * FROM users')
rows = cursor.fetchall() # すべての行を取得
# データを辞書形式に整形
users = []
for row in rows:
user = {
'id': row[0],
'name': row[1],
'age': row[2]
}
users.append(user)
# 年齢が30以上のユーザーをフィルタリング
filtered_users = [user for user in users if user['age'] >= 30]
# フィルタリングしたデータの表示
for user in filtered_users:
print(user)
# 平均年齢の計算
average_age = sum(user['age'] for user in users) / len(users) if users else 0
print(f'平均年齢: {average_age:.2f}歳')
# 接続を終了
connection.close()もしusersテーブルに以下のデータが格納されている場合、出力結果は次のようになります。
{'id': 1, 'name': '山田太郎', 'age': 30}
平均年齢: 27.50歳この手順を通じて、SQLite3を使用して取得したデータを整形し、活用する方法を理解できたと思います。
次のセクションでは、エラー処理と接続の終了について解説します。
エラー処理と接続の終了
SQLite3を使用する際には、エラーが発生する可能性があります。
適切なエラー処理を行うことで、プログラムの安定性を向上させることができます。
また、データベース接続を適切に終了することも重要です。
以下に、エラー処理と接続の終了について説明します。
エラー処理の基本
SQLite3では、tryとexceptブロックを使用してエラー処理を行います。
これにより、エラーが発生した場合でもプログラムがクラッシュせず、適切なメッセージを表示することができます。
以下のコードは、データベース接続時のエラー処理の例です。
import sqlite3
try:
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# データの取得
cursor.execute('SELECT * FROM users')
rows = cursor.fetchall() # すべての行を取得
# データの表示
for row in rows:
print(row)
except sqlite3.Error as e:
print(f'エラーが発生しました: {e}')
finally:
# 接続を終了
if connection:
connection.close()
print('接続が終了しました。')エラーの種類
SQLite3で発生する可能性のあるエラーには、以下のようなものがあります。
| エラーの種類 | 説明 |
|---|---|
OperationalError | データベースの操作に関するエラー |
IntegrityError | データの整合性に関するエラー |
ProgrammingError | SQL文の構文エラー |
DatabaseError | データベースに関する一般的なエラー |
接続の終了
データベース接続を終了する際には、close()メソッドを使用します。
接続を終了することで、リソースを解放し、他のプロセスがデータベースにアクセスできるようになります。
接続を終了する際は、finallyブロック内で行うことが推奨されます。
これにより、エラーが発生しても必ず接続が終了します。
サンプルコード全体
これまでの手順をまとめたサンプルコードは以下の通りです。
import sqlite3
try:
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# データの取得
cursor.execute('SELECT * FROM users')
rows = cursor.fetchall() # すべての行を取得
# データの表示
for row in rows:
print(row)
except sqlite3.Error as e:
print(f'エラーが発生しました: {e}')
finally:
# 接続を終了
if connection:
connection.close()
print('接続が終了しました。')正常にデータが取得できた場合、出力結果は次のようになります。
(1, '山田太郎', 30)
(2, '鈴木花子', 25)
接続が終了しました。エラーが発生した場合は、エラーメッセージが表示され、接続が終了します。
この手順を通じて、SQLite3を使用する際のエラー処理と接続の終了方法を理解できたと思います。
次のセクションでは、応用として複数テーブルからのデータ取得について解説します。
応用：複数テーブルからのデータ取得
SQLite3を使用して複数のテーブルからデータを取得することは、データベースのリレーショナルな特性を活かすために非常に重要です。
ここでは、複数のテーブルを結合してデータを取得する方法について説明します。
テーブルの準備
まず、複数のテーブルを用意します。
以下の例では、usersテーブルに加えて、ordersテーブルを作成します。
ordersテーブルは、ユーザーが行った注文を記録します。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# usersテーブルの作成
cursor.execute('''
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
age INTEGER
)
''')
# ordersテーブルの作成
cursor.execute('''
CREATE TABLE IF NOT EXISTS orders (
id INTEGER PRIMARY KEY,
user_id INTEGER,
product TEXT NOT NULL,
FOREIGN KEY (user_id) REFERENCES users (id)
)
''')
# サンプルデータの挿入
cursor.execute("INSERT INTO users (name, age) VALUES ('山田太郎', 30)")
cursor.execute("INSERT INTO users (name, age) VALUES ('鈴木花子', 25)")
cursor.execute("INSERT INTO orders (user_id, product) VALUES (1, '商品A')")
cursor.execute("INSERT INTO orders (user_id, product) VALUES (1, '商品B')")
cursor.execute("INSERT INTO orders (user_id, product) VALUES (2, '商品C')")
# 変更を保存
connection.commit()複数テーブルからのデータ取得
複数のテーブルからデータを取得するためには、JOIN句を使用します。
以下のコードは、usersテーブルとordersテーブルを結合して、ユーザー名とその注文を取得する例です。
# 複数テーブルからのデータ取得
cursor.execute('''
SELECT users.name, orders.product
FROM users
JOIN orders ON users.id = orders.user_id
''')
rows = cursor.fetchall() # すべての行を取得
# 取得したデータの表示
for row in rows:
print(f'ユーザー: {row[0]}, 注文: {row[1]}')接続の終了
データの取得が完了したら、接続を終了します。
以下のコードを追加します。
# 接続を終了
connection.close()サンプルコード全体
これまでの手順をまとめたサンプルコードは以下の通りです。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# usersテーブルの作成
cursor.execute('''
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
age INTEGER
)
''')
# ordersテーブルの作成
cursor.execute('''
CREATE TABLE IF NOT EXISTS orders (
id INTEGER PRIMARY KEY,
user_id INTEGER,
product TEXT NOT NULL,
FOREIGN KEY (user_id) REFERENCES users (id)
)
''')
# サンプルデータの挿入
cursor.execute("INSERT INTO users (name, age) VALUES ('山田太郎', 30)")
cursor.execute("INSERT INTO users (name, age) VALUES ('鈴木花子', 25)")
cursor.execute("INSERT INTO orders (user_id, product) VALUES (1, '商品A')")
cursor.execute("INSERT INTO orders (user_id, product) VALUES (1, '商品B')")
cursor.execute("INSERT INTO orders (user_id, product) VALUES (2, '商品C')")
# 変更を保存
connection.commit()
# 複数テーブルからのデータ取得
cursor.execute('''
SELECT users.name, orders.product
FROM users
JOIN orders ON users.id = orders.user_id
''')
rows = cursor.fetchall() # すべての行を取得
# 取得したデータの表示
for row in rows:
print(f'ユーザー: {row[0]}, 注文: {row[1]}')
# 接続を終了
connection.close()ユーザー: 山田太郎, 注文: 商品A
ユーザー: 山田太郎, 注文: 商品B
ユーザー: 鈴木花子, 注文: 商品Cこの手順を通じて、SQLite3を使用して複数のテーブルからデータを取得する方法を理解できたと思います。
これにより、リレーショナルデータベースの利点を活かしたデータ操作が可能になります。
実践例：簡単なデータ取得スクリプトの作成
ここでは、SQLite3を使用して簡単なデータ取得スクリプトを作成します。
このスクリプトでは、ユーザー情報をデータベースから取得し、特定の条件に基づいてフィルタリングした結果を表示します。
データベースの準備
まず、データベースとテーブルを作成し、サンプルデータを挿入します。
以下のコードを使用して、usersテーブルを作成し、いくつかのユーザー情報を追加します。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# usersテーブルの作成
cursor.execute('''
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
age INTEGER
)
''')
# サンプルデータの挿入
cursor.execute("INSERT INTO users (name, age) VALUES ('山田太郎', 30)")
cursor.execute("INSERT INTO users (name, age) VALUES ('鈴木花子', 25)")
cursor.execute("INSERT INTO users (name, age) VALUES ('佐藤次郎', 35)")
cursor.execute("INSERT INTO users (name, age) VALUES ('田中三郎', 28)")
# 変更を保存
connection.commit()データ取得スクリプトの作成
次に、ユーザーの年齢が30歳以上の情報を取得し、表示するスクリプトを作成します。
以下のコードを使用します。
# 年齢が30歳以上のユーザーを取得
cursor.execute('SELECT * FROM users WHERE age >= 30')
rows = cursor.fetchall() # すべての行を取得
# 取得したデータの表示
print("年齢が30歳以上のユーザー:")
for row in rows:
print(f'ID: {row[0]}, 名前: {row[1]}, 年齢: {row[2]}')接続の終了
データの取得が完了したら、接続を終了します。
以下のコードを追加します。
# 接続を終了
connection.close()サンプルコード全体
これまでの手順をまとめたサンプルコードは以下の通りです。
import sqlite3
# データベースに接続
connection = sqlite3.connect('example.db')
cursor = connection.cursor()
# usersテーブルの作成
cursor.execute('''
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
age INTEGER
)
''')
# サンプルデータの挿入
cursor.execute("INSERT INTO users (name, age) VALUES ('山田太郎', 30)")
cursor.execute("INSERT INTO users (name, age) VALUES ('鈴木花子', 25)")
cursor.execute("INSERT INTO users (name, age) VALUES ('佐藤次郎', 35)")
cursor.execute("INSERT INTO users (name, age) VALUES ('田中三郎', 28)")
# 変更を保存
connection.commit()
# 年齢が30歳以上のユーザーを取得
cursor.execute('SELECT * FROM users WHERE age >= 30')
rows = cursor.fetchall() # すべての行を取得
# 取得したデータの表示
print("年齢が30歳以上のユーザー:")
for row in rows:
print(f'ID: {row[0]}, 名前: {row[1]}, 年齢: {row[2]}')
# 接続を終了
connection.close()年齢が30歳以上のユーザー:
ID: 1, 名前: 山田太郎, 年齢: 30
ID: 3, 名前: 佐藤次郎, 年齢: 35この実践例を通じて、SQLite3を使用して簡単なデータ取得スクリプトを作成する方法を理解できたと思います。
このスクリプトは、データベースから特定の条件に基づいて情報を取得し、表示する基本的な機能を持っています。
これを基に、さらに複雑なデータ操作を行うことができます。
まとめ
この記事では、SQLite3を使用してデータベースからデータを取得する方法について、基本的な手順から応用的なテクニックまで幅広く解説しました。
特に、テーブルからのデータ取得や条件付きのデータ取得、複数テーブルからのデータ取得など、実践的なスクリプトを通じて具体的な操作方法を紹介しました。
これを機に、SQLite3を活用して自分自身のプロジェクトにデータベース機能を組み込むことに挑戦してみてはいかがでしょうか。
![[Python] SQLite3のexecute関数の戻り値について解説](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46970.png?resize=390%2C220&ssl=1)
![[Python] SQLite3で自動コミットを設定する方法を解説](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46969.png?resize=390%2C220&ssl=1)
![[Python] cx_oracleの使い方 – Oracle Databaseへの接続](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46967.png?resize=390%2C220&ssl=1)
![[Python] SQLite3の使い方 – SQLiteデータベースの基本操作を解説](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46975.png?resize=390%2C220&ssl=1)
![[Python] SQLite3でテーブルの一覧を取得する方法](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46974.png?resize=390%2C220&ssl=1)
![[Python] SQLite3でwith文を使って安全に接続・カーソルを管理する](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46971.png?resize=390%2C220&ssl=1)
![[Python] pyodbcの使い方 – SQLサーバーに接続する](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46968.png?resize=390%2C220&ssl=1)
![[Python] SQLite3でデータベースを新規作成する方法を解説](https://i0.wp.com/af-e.net/wp-content/uploads/2024/10/thumbnail-46972.png?resize=390%2C220&ssl=1)