カテゴリ: 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
Flask
FlaskのAPIでドキュメントを作る方法!初心者でもわかるSwagger UIの使い方
New2
Flask
Flask‑Mailの使い方!アプリからメールを送信する基本方法を解説
New3
Python
PythonでSQLの結果をpandasのDataFrameに変換する方法を完全解説!初心者でもわかるデータ分析入門
New4
Flask
Flaskでセッション管理を始めよう!Cookieを活用した仕組みをわかりやすく解説
人気記事
No.1
Java&Spring記事人気No1
Python
Pythonで仮想環境(venv)を作る方法!初心者向けに環境構築をステップ解説
No.2
Java&Spring記事人気No2
Python
Pythonの文字列を1文字ずつ処理する方法!for文やlist化の活用例
No.3
Java&Spring記事人気No3
Python
Pythonで定数を定義する方法!変更されない変数の書き方と命名ルールを初心者向けに解説
No.4
Java&Spring記事人気No4
Python
Pythonのコメント活用術!初心者向けにTODO・FIXME・ドキュメンテーションコメントの書き方を完全解説
No.5
Java&Spring記事人気No5
Python
Pythonのbytes型とbytearray型とは?初心者向けにバイナリデータの扱い方を解説!
No.6
Java&Spring記事人気No6
Python
Pythonで空白や不要な文字を削除する方法!strip(), rstrip(), lstrip() の使い方を初心者向けに解説
No.7
Java&Spring記事人気No7
Python
Pythonとは何か?初心者向けにできること・特徴・インストール手順までやさしく解説
No.8
Java&Spring記事人気No8
Flask
Flaskでデータベースを使う基本!SQLAlchemyの導入方法をやさしく解説