中級者向け No.03

SQLiteデータベースブラウザ

SQLiteデータベースを開いてテーブル一覧・カラム情報・レコードを表示し、任意のSQL文を実行できるGUIブラウザ。tkinter と sqlite3 だけで実現する本格的なDBツールです。

🎯 難易度: ★★☆ 普通 📦 ライブラリ: tkinter, sqlite3, os（すべて標準ライブラリ） ⏱️ 制作時間: 60〜120分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

このアプリは Python 標準ライブラリの tkinter と sqlite3 だけを使って実装した SQLiteデータベースブラウザです。既存の .db / .sqlite ファイルを開くか、新規ファイルを作成して接続し、テーブル一覧・カラム情報の確認や任意の SQL 文の実行を行えます。

画面は 3 つのエリアに分かれています。上段の左ペインにはデータベース内のテーブル一覧が表示され、テーブルを選択すると右ペインにカラム情報（カラム名・型・NOT NULL制約・主キー）が自動表示されます。中段はSQL 入力エリアで、テキストボックスに SQL 文を書いて「実行」ボタンまたは F5 キーで実行します。下段の結果グリッド（ttk.Treeview）には SELECT 結果が表示され、INSERT / UPDATE / DELETE などの更新系クエリは実行完了後に影響行数を表示します。

使用ライブラリはすべて標準ライブラリです（tkinter, sqlite3, os）。外部パッケージのインストールは不要で、Python をインストールすればすぐに動かせます。難易度は ★★☆ 普通 で、PanedWindow・Treeview・filedialog など実務的なウィジェットの使い方を学べます。

ソースコードは完全な動作状態で提供しています。コピーしてそのまま実行し、動作を確認したらコードを読んで仕組みを理解しましょう。カスタマイズセクションにはテーブル編集機能やエクスポート機能など発展的なアイデアを掲載しています。

SQLiteデータベースブラウザ実行画面（Windows） — 実行画面（Windows）

SQLiteデータベースブラウザ実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

既存の SQLite ファイル（.db / .sqlite / .sqlite3）を開いて接続
新規 SQLite データベースファイルの作成・接続
テーブル一覧の表示（Listbox で選択可能）
選択テーブルのカラム情報を自動表示（カラム名・型・NOT NULL・主キー）
テーブル選択時に SELECT 文を自動セットして即実行
テキストエリアで任意の SQL 文を入力・実行（SELECT / INSERT / UPDATE / DELETE / CREATE TABLE など）
F5 キーによるキーボードショートカット実行
クエリ結果を Treeview で行・列表示（水平・垂直スクロール対応）
更新系クエリ実行後のテーブル一覧自動更新
ステータスバーに取得行数・影響行数を表示
SQL エラーをダイアログで分かりやすく通知

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

使用するライブラリはすべて Python 標準ライブラリです。pip install は不要です。

tkinter — GUI ウィジェット（標準ライブラリ）
sqlite3 — SQLite データベース操作（標準ライブラリ）
os — ファイルパス操作（標準ライブラリ）

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

✅ 追加インストール不要（標準ライブラリのみ使用）

app003.py

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import sqlite3
import os


class App03:
    """SQLiteデータベースブラウザ"""

    def __init__(self, root):
        self.root = root
        self.root.title("SQLiteデータベースブラウザ")
        self.root.geometry("900x673")
        self.root.minsize(900, 673)
        self.root.configure(bg="#f8f9fc")
        self.conn = None
        self.db_path = None
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=10)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="🗄️ SQLiteデータベースブラウザ",
                 font=("Noto Sans JP", 15, "bold"),
                 bg="#3776ab", fg="white").pack(side=tk.LEFT, padx=12)
        ttk.Button(title_frame, text="📂 DBを開く",
                   command=self._open_db).pack(side=tk.RIGHT, padx=12)
        ttk.Button(title_frame, text="✨ 新規DB",
                   command=self._new_db).pack(side=tk.RIGHT, padx=4)

        # 上段: テーブル一覧 + カラム情報
        top = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        top.pack(fill=tk.BOTH, expand=False, padx=4, pady=4)

        # テーブル一覧
        tbl_frame = ttk.LabelFrame(top, text="テーブル一覧", padding=4)
        self.tbl_list = tk.Listbox(tbl_frame, font=("Courier New", 11),
                                    width=20, exportselection=False)
        self.tbl_list.pack(fill=tk.BOTH, expand=True)
        self.tbl_list.bind("<<ListboxSelect>>", self._on_table_select)
        top.add(tbl_frame, weight=1)

        # カラム情報
        col_frame = ttk.LabelFrame(top, text="カラム情報", padding=4)
        cols = ("cid", "name", "type", "notnull", "pk")
        self.col_tree = ttk.Treeview(col_frame, columns=cols,
                                      show="headings", height=6)
        for c, h, w in [("cid", "#", 30), ("name", "名前", 120),
                         ("type", "型", 80), ("notnull", "NOT NULL", 70),
                         ("pk", "PK", 40)]:
            self.col_tree.heading(c, text=h)
            self.col_tree.column(c, width=w, minwidth=30)
        self.col_tree.pack(fill=tk.BOTH, expand=True)
        top.add(col_frame, weight=2)

        # SQL入力エリア
        sql_frame = ttk.LabelFrame(self.root, text="SQL実行", padding=6)
        sql_frame.pack(fill=tk.X, padx=4, pady=(0, 4))
        self.sql_text = tk.Text(sql_frame, height=3, font=("Courier New", 11),
                                bg="white")
        self.sql_text.pack(fill=tk.X, expand=True, side=tk.LEFT)
        self.sql_text.insert("1.0", "SELECT * FROM sqlite_master WHERE type='table';")
        btn_frame = tk.Frame(sql_frame, bg=ttk.Style().lookup("TLabelframe", "background"))
        btn_frame.pack(side=tk.RIGHT, padx=6)
        ttk.Button(btn_frame, text="▶ 実行\n(F5)",
                   command=self._run_sql).pack(pady=2)
        ttk.Button(btn_frame, text="クリア",
                   command=lambda: self.sql_text.delete("1.0", tk.END)).pack()
        self.root.bind("<F5>", lambda e: self._run_sql())

        # 結果グリッド
        result_frame = ttk.LabelFrame(self.root, text="結果", padding=4)
        result_frame.pack(fill=tk.BOTH, expand=True, padx=4, pady=(0, 4))
        self.result_tree = ttk.Treeview(result_frame, show="headings")
        h_sb = ttk.Scrollbar(result_frame, orient=tk.HORIZONTAL,
                             command=self.result_tree.xview)
        v_sb = ttk.Scrollbar(result_frame, orient=tk.VERTICAL,
                             command=self.result_tree.yview)
        self.result_tree.configure(xscrollcommand=h_sb.set,
                                   yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.result_tree.pack(fill=tk.BOTH, expand=True)

        self.status_var = tk.StringVar(value="DBファイルを開いてください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#dde", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open_db(self):
        path = filedialog.askopenfilename(
            title="SQLiteファイルを選択",
            filetypes=[("SQLiteファイル", "*.db *.sqlite *.sqlite3"),
                       ("すべて", "*.*")])
        if path:
            self._connect(path)

    def _new_db(self):
        path = filedialog.asksaveasfilename(
            title="新規DBファイル",
            defaultextension=".db",
            filetypes=[("SQLiteファイル", "*.db"), ("すべて", "*.*")])
        if path:
            self._connect(path)

    def _connect(self, path):
        if self.conn:
            self.conn.close()
        try:
            self.conn = sqlite3.connect(path)
            self.db_path = path
            self.root.title(f"SQLiteブラウザ — {os.path.basename(path)}")
            self.status_var.set(f"接続済み: {path}")
            self._load_tables()
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _load_tables(self):
        if not self.conn:
            return
        self.tbl_list.delete(0, tk.END)
        cur = self.conn.execute(
            "SELECT name FROM sqlite_master WHERE type='table' ORDER BY name")
        for row in cur.fetchall():
            self.tbl_list.insert(tk.END, row[0])

    def _on_table_select(self, event):
        sel = self.tbl_list.curselection()
        if not sel:
            return
        table = self.tbl_list.get(sel[0])
        # カラム情報
        self.col_tree.delete(*self.col_tree.get_children())
        for row in self.conn.execute(f"PRAGMA table_info({table})"):
            self.col_tree.insert("", "end", values=row[:5])
        # SQLにSELECTをセット
        self.sql_text.delete("1.0", tk.END)
        self.sql_text.insert("1.0", f"SELECT * FROM {table} LIMIT 100;")
        self._run_sql()

    def _run_sql(self):
        if not self.conn:
            messagebox.showwarning("警告", "DBを開いてください")
            return
        sql = self.sql_text.get("1.0", tk.END).strip()
        if not sql:
            return
        try:
            cur = self.conn.execute(sql)
            self.conn.commit()
            # 結果をTreeviewに表示
            self.result_tree.delete(*self.result_tree.get_children())
            if cur.description:
                cols = [d[0] for d in cur.description]
                self.result_tree.configure(columns=cols)
                for c in cols:
                    self.result_tree.heading(c, text=c)
                    self.result_tree.column(c, width=max(80, len(c)*10), minwidth=40)
                rows = cur.fetchall()
                for row in rows:
                    self.result_tree.insert("", "end",
                                            values=[str(v) if v is not None else "NULL"
                                                    for v in row])
                self.status_var.set(f"{len(rows)} 行取得")
            else:
                self.result_tree.configure(columns=("result",))
                self.result_tree.heading("result", text="結果")
                self.result_tree.insert("", "end", values=("OK",))
                self.status_var.set(f"実行完了 ({cur.rowcount} 行影響)")
                self._load_tables()
        except Exception as e:
            messagebox.showerror("SQLエラー", str(e))


if __name__ == "__main__":
    root = tk.Tk()
    app = App03(root)
    root.mainloop()

この完成コードは minsize(900, 673) で最小サイズを固定しているので、これより小さくは縮められません。

5. コード解説

SQLiteデータベースブラウザのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

クラス設計とコンストラクタ（init）

App03 クラスにアプリの全機能をまとめています。__init__ でウィンドウサイズ・背景色の設定と、接続状態を保持するインスタンス変数（self.conn、self.db_path）の初期化を行い、最後に _build_ui() を呼んで UI を構築します。self.conn は SQLite 接続オブジェクトで、未接続時は None になります。