カテゴリ: Python 更新日: 2026/03/07

PythonでSQLの結果をpandasのDataFrameに変換する方法を完全解説!初心者でもわかるデータ分析入門

PythonでSQLの結果をpandasのDataFrameに変換する方法
PythonでSQLの結果をpandasのDataFrameに変換する方法

先生と生徒の会話形式で理解しよう

生徒

「Pythonでデータベースからデータを取り出したあと、表みたいに見やすく扱う方法はありますか?」

先生

「ありますよ。SQLの実行結果をpandasのDataFrameに変換すると、表計算ソフトのように扱えます。」

生徒

「pandasやDataFrameって、何をするものなんですか?」

先生

「データを表の形で整理して、並び替えや確認がしやすくなる便利な道具だと思ってください。」

1. pandasとDataFrameとは何か

1. pandasとDataFrameとは何か
1. pandasとDataFrameとは何か

pandasは、Pythonでデータを扱うためのライブラリです。ライブラリとは、便利な機能をまとめた道具箱のようなものです。DataFrameはpandasの中心的なデータ構造で、行と列を持つ表の形をしています。紙の表やエクセルのシートを思い浮かべると理解しやすいです。

2. SQLの結果をDataFrameに変換するメリット

2. SQLの結果をDataFrameに変換するメリット
2. SQLの結果をDataFrameに変換するメリット

SQLで取得したデータは、そのままだとプログラム初心者には扱いづらい形になりがちです。DataFrameに変換すると、データの中身を一覧で確認でき、列ごとに意味を理解しやすくなります。データベース操作とデータ分析をつなぐ役割を果たします。

3. SQLiteとpandasを使う基本準備

3. SQLiteとpandasを使う基本準備
3. SQLiteとpandasを使う基本準備

ここでは、Pythonに最初から入っているsqlite3と、追加で使うpandasを利用します。SQLiteは軽量なデータベースで、ファイル一つで管理できます。まずはデータベースに接続し、SQLを実行する準備をします。


import sqlite3
import pandas as pd

conn = sqlite3.connect("sample.db")

4. read_sql_queryで簡単にDataFrameへ変換

4. read_sql_queryで簡単にDataFrameへ変換
4. read_sql_queryで簡単にDataFrameへ変換

pandasには、SQLの結果をそのままDataFrameに変換できる便利な関数があります。read_sql_queryを使うと、SQL文と接続情報を渡すだけで表が完成します。難しい処理を書かなくて済むのが特徴です。


sql = "SELECT id, name FROM users"
df = pd.read_sql_query(sql, conn)
print(df)

   id   name
0   1   田中
1   2   佐藤

5. read_sql_tableを使ったテーブル指定の方法

5. read_sql_tableを使ったテーブル指定の方法
5. read_sql_tableを使ったテーブル指定の方法

SQL文を書くのが不安な場合は、テーブル名を直接指定する方法もあります。read_sql_tableは、テーブル全体をDataFrameとして読み込みます。列名も自動で設定されるため、初心者でも安心です。


df = pd.read_sql_table("users", conn)
print(df.head())

6. DataFrameで中身を確認する基本操作

6. DataFrameで中身を確認する基本操作
6. DataFrameで中身を確認する基本操作

DataFrameに変換したあとは、内容を確認することが大切です。先頭だけを見る、列名を確認するなど、表として眺める感覚で操作できます。これにより、SQLの結果が正しいかすぐに判断できます。


print(df.columns)
print(df.head())

7. よくあるつまずきポイントと注意点

7. よくあるつまずきポイントと注意点
7. よくあるつまずきポイントと注意点

データベース接続を閉じ忘れると、ファイルが使えなくなることがあります。処理が終わったら接続を終了しましょう。また、pandasがインストールされていないとエラーが出ます。エラーは失敗ではなく、原因を教えてくれるサインだと考えると安心です。


conn.close()
カテゴリの一覧へ
新着記事
New1
Python
Pythonの文字列から一部を抽出する方法!スライスを使った基本的な切り出し方
New2
Flask
Flaskアプリのセキュリティ対策まとめ!初心者向けに基本をやさしく解説
New3
Flask
FlaskでCookieを安全に使う方法!HttpOnly・Secureフラグの使い方を徹底解説
New4
Flask
Flaskで外部APIと連携する方法!requestsライブラリの使い方を初心者向けに解説
人気記事
No.1
Java&Spring記事人気No1
Python
Pythonの文字列を1文字ずつ処理する方法!for文やlist化の活用例
No.2
Java&Spring記事人気No2
Python
Pythonでトランザクション処理を実装する方法を完全解説!commit・rollbackで安全なSQL操作
No.3
Java&Spring記事人気No3
Python
Pythonで仮想環境(venv)を作る方法!初心者向けに環境構築をステップ解説
No.4
Java&Spring記事人気No4
Flask
Flaskとは何か?初心者向けにできること・特徴・インストール手順までやさしく解説
No.5
Java&Spring記事人気No5
Flask
Flask‑RESTfulでREST APIを構築する手順まとめ!初心者向けにやさしく解説
No.6
Java&Spring記事人気No6
Python
Pythonの文字列から一部を抽出する方法!スライスを使った基本的な切り出し方
No.7
Java&Spring記事人気No7
Flask
FlaskのSQLAlchemyでフィルタリング検索!filter, filter_byの使い方完全ガイド
No.8
Java&Spring記事人気No8
Flask
Flaskで開発中にデータベースを初期化する方法!初心者でもわかる便利なTips