PythonでSQLデータベースのスキーマ情報を取得する方法を完全解説！PRAGMA・INFORMATION_SCHEMA入門

$PythonでSQLデータベースのスキーマ情報を取得する方法（PRAGMA・INFORMATION\_SCHEMA）$

PythonでSQLデータベースのスキーマ情報を取得する方法（PRAGMA・INFORMATION\_SCHEMA）

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

生徒

「Pythonでデータベースを使っていると、テーブルの中身だけじゃなくて、列の構造も知りたくなるんですが、どうやって調べるんですか？」

先生

「それなら、スキーマ情報を取得すると分かります。スキーマは、テーブルの設計図のようなものです。」

生徒

「設計図ですか？名前や型が書いてある感じですか？」

先生

「その通りです。PythonとSQLを使えば、PRAGMAやINFORMATION_SCHEMAで簡単に確認できますよ。」

1. スキーマ情報とは何か

スキーマ情報とは、データベースの構造に関する情報です。テーブル名、列名、データの種類、制約などが含まれます。これは、家でいうと間取り図のようなもので、どこに何があるのかを把握するために欠かせません。データを安全に扱うためには、まず構造を知ることが大切です。

2. なぜスキーマ情報を取得するのか

スキーマ情報を確認すると、データベースの中身を壊さずに扱えます。列の型を知らずにデータを入れると、エラーが出たり、思わぬ不具合が起きたりします。初心者ほど、最初にスキーマを確認する習慣をつけることで、安心してPythonのSQLデータベース操作ができるようになります。

3. SQLiteで使えるPRAGMAとは

PRAGMAは、SQLite専用の命令で、データベースの内部情報を取得するために使います。難しい言葉に見えますが、「設定や構造を教えてもらうための命令」と考えると分かりやすいです。PythonからSQLを実行することで、テーブルの列構成を確認できます。


import sqlite3

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

cursor.execute("PRAGMA table_info(users)")
rows = cursor.fetchall()

for row in rows:
    print(row)


(0, 'id', 'INTEGER', 0, None, 1)
(1, 'name', 'TEXT', 0, None, 0)

4. PRAGMAの結果の見方を理解しよう

PRAGMA table_infoの結果には、列番号、列名、データ型、必須かどうかなどが並びます。例えばTEXTは文字、INTEGERは数値を意味します。数字や英単語が並んでいますが、列の説明書だと思って一つずつ確認すると理解しやすくなります。

5. INFORMATION_SCHEMAとは何か

INFORMATION_SCHEMAは、多くのSQLデータベースで共通して使える仕組みです。MySQLやPostgreSQLなどで利用でき、データベース全体の構造を表として取得できます。特定のテーブルだけでなく、データベース全体を調べたいときに便利です。


import mysql.connector

conn = mysql.connector.connect(
    host="localhost",
    user="user",
    password="password",
    database="sample_db"
)

cursor = conn.cursor()
cursor.execute("""
SELECT column_name, data_type
FROM information_schema.columns
WHERE table_name = 'users'
""")

for row in cursor:
    print(row)