PythonでSQL文を扱う際のfetchall関数の使い方について現役エンジニアが解説【初心者向け】

PythonでSQL文を扱う際のfetchall関数の使い方について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。

PythonでSQL文を扱う際のfetchall関数を利用すると、取得したいデータをリスト形式に変換してくれます。

実務でも、PythonでSQL文を扱う際のfetchall関数を利用して、データをリスト形式で一気に取得するので、ぜひ学習してみてください。

目次

• SQLとは
• fetchall関数について
• fetchall関数の使い方
• 実際に書いてみよう
• まとめ
• Pythonを学習中の方へ

そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

今回は、Pythonに関する内容だね！

どういう内容でしょうか？

PythonでSQL文を扱う際のfetchall関数の使い方について詳しく説明していくね！

お願いします！

SQLとは

SQLとはStructured Query Languageの略で、データベースにデータの操作や定義を行うためのコンピュータ言語のことです。

データベースの操作を行うためにプログラム言語と一緒に使うことがありますが、SQLそのものはプログラム言語ではありません。

SQLを使ってデータベースを操作するときに使われる命令文のことを、Queryといいます。

SQLは使用するデータベースによっては細かい書き方の違いはありますが、一度覚えてしまえばだいたいどのデータベースも操作できます。

SQLで操作できるデータベースはリレーショナル・データベース(RDB)と呼ばれています。

RDBの例としては、MySQL、PostgreSQL、MariaDB、SQLiteなどがあります。

fetchall関数について

fetchall関数とは、PythonのSQLライブラリを使うときに使われる関数です。

PythonでQueryを実行するときには、execute関数を使って行います。

execute関数を使ってQueryを実行すると、取得できるレコードは1行ずつです。

レコードを複数行取得するためには、execute関数を使ったfor文で以下のように行う必要があります。

for doc in curs.execute('select * from table'):
    print(doc)

execute関数を使ったfor文を利用して、複数行のレコードを毎回取得することは効率的とは言えません。

そこで使われるのがfetchall関数です。

fetchall関数を使えば、execute関数を使ってfor文で取得していた処理を、リスト形式に変換してくれるので処理が簡単になります。

[PR] Pythonで挫折しない学習方法を動画で公開中

fetchall関数の使い方

ここでは、具体的にfetchall関数の使い方を紹介します。

今回は標準ライブラリで使えるsqlite3を使っていきたいと思います。

sqlite3を接続するときには、以下のように書きます。

conn = sqlite3.connect('example.db')
curs = conn.cursor()

あとはexecute関数でQueryを使って、fetchall関数でリスト化するだけです。

fetchall関数を使えば、execute関数を使ったfor文の処理が次の書き方に変わります。

curs.execute('select * from table')
docs = curs.fetchall()
for doc in docs:
    print(doc)

行数は増えましたが、複数行のデータがリスト形式になるので処理としてはきれいになります。

コラム

コスパとタイパ、両方結果的に良くなる良くなる学び方とは？

「スクールは高いし時間も縛られて効率が悪い」と考える方は多いと思います。
もちろん、時間も費用もかかることは間違いありません。
ただ 結果的に無駄な学びにお金も時間もかける方がリスクが高いという考えもあります。

コスパ・タイパ最適化の参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

• ・困ったときに、質問や相談できる相手がいるため挫折しなかった
• ・プロとして必要なスキルのみを深く学べたので無駄がなかった
• ・副業案件の提供と納品までのサポートがあったので目的を達成できた

安価・短期間で広く浅く学んでも意味がありません。 本当に自分の目的が達成できるか、それが重要です。
自分にどのスキルや学び方が合っているか、どんな学習方法かなど、お気軽に 無料相談 に参加してみませんか？

カウンセラー・現役のプロへ、何でも気軽に無料相談可能。 30分か60分お好きな時間が選べて、かつ3回まで すべて無料で ご利用できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら相談した方限定の割引・参加特典付き！ 無料相談はこちら

実際に書いてみよう

それでは、実際にfetchall関数でのデータ取得をサンプルコードを使って試してみましょう。

サンプルコード

import sqlite3

conn = sqlite3.connect('./example.db')
curs = conn.cursor()

# テーブルを作成
curs.execute("CREATE TABLE IF NOT EXISTS members (id INTEGER PRIMARY KEY, name TEXT)")

# レコードを登録
persons = [(1, 'Steave'), (2, 'Eric'), (3, 'Mike')]
curs.executemany("INSERT INTO members VALUES (?, ?)", persons)

curs.execute('select * from members')
docs = curs.fetchall()
for doc in docs:
    print(doc)

実行結果

(1, 'Steave')
(2, 'Eric')
(3, 'Mike')

解説

import sqlite3では、sqliteを利用するためのモジュールをインポートしています。

conn = sqlite3.connect(‘./example.db’)では、example.dbというデータベースに接続しています。

curs.execute(“CREATE TABLE IF NOT EXISTS members (id INTEGER PRIMARY KEY, name TEXT)”)では、members テーブルを作成しています。

persons = [(1, ‘Steave’), (2, ‘Eric’), (3, ‘Mike’)]では、レコードを登録する準備をするために、データを変数personsに代入しています。

curs.executemany(“INSERT INTO members VALUES (?, ?)”, persons)では、membersテーブルに変数personのデータを挿入しています。

curs.execute(‘select * from members’)では、membersテーブルを表示しています。

docs = curs.fetchall()では、fetchall関数を利用し、データをリストの状態で変数docsに代入しています。

for doc in docs:では、docsというリストから一つだけ変数docに取り出す処理を行っています。

for文で指定するため、docsというリストの中にデータが無くなるまで変数docに取り出す作業が続けられます。

print(doc)では、変数docを表示しています。

まとめ

今回は、SQLを扱うときに使うfetchall関数について紹介しました。

PythonでQueryを実行するときには、execute関数を使って行うことが多いです。

fetchall関数を使えば、execute関数を使ってfor文で取得していた処理をリスト形式に変換してくれるので処理が簡単でした。

リスト形式については、簡単なサンプル付き！Pythonでlistを使う方法も参考にしてみてください。

SQLを扱うPythonのライブラリにはだいたい入っている関数なので、役割を知っておくと開発がスムーズになります。

今回の記事でSQLiteライブラリをインポートしましたが、Pythonでimportを使う方法を参考にしてみてください。

内容が分かりやすくて良かったです！

ゆかりちゃんも分からないことがあったら質問してね！

分かりました。ありがとうございます！

Pythonを学習中の方へ

これで解説は終了です、お疲れさまでした。

• つまずかず「効率的に」学びたい
• 副業や転職後の「現場で使える」知識やスキルを身につけたい

プログラミングを学習していて、このように思ったことはありませんか？

テックアカデミーのPythonコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。

合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、人工知能（AI）や機械学習の基礎を学べます。

まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。

時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！

プログラミングを独学で学習していて、このように感じた経験はないでしょうか？

• ・調べてもほしい情報が見つからない
• ・独学のスキルが実際の業務で通用するのか不安
• ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 学習に不安を抱えている方へ、マンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう カウンセラーやエンジニア・デザイナー があなたの相談に真摯に向き合います。

「自分に合っているか診断してほしい」
「漠然としているが話を聞いてみたい」
こんなささいな悩みでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。（1週間限定）

今なら参加者限定の割引特典付き！ 無料相談を予約する