FastAPI × SQLite で作る、
いちばん小さなバックエンド

FastAPI — Python の Web フレームワーク。関数の上に @app.get("/…") と一行書くだけで、その URL が API になる。 型ヒントを書けば入力チェックと API ドキュメントが自動生成される。速く、学びやすく、いま最も勢いがある。

SQLite — サーバ不要のデータベース。Python に最初から同梱されていて、インストールも起動もいらない。 データは app.db という1個のファイルに溜まる。プログラムを止めても消えない＝これが「永続化」。

# 仮想環境を作って有効化（推奨）
python3 -m venv venv
source venv/bin/activate   # Windows は venv\Scripts\activate

# FastAPI 本体と、開発サーバ uvicorn を入れる
pip install "fastapi[standard]"

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "こんにちは、バックエンド"}

@app.get("/hello/{name}")
def hello(name: str):
    return {"hello": name}

fastapi dev main.py

import sqlite3
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()

def db():
    # 1ファイル app.db に繋ぐ。無ければ自動で作られる
    con = sqlite3.connect("app.db")
    con.row_factory = sqlite3.Row   # 列名でアクセスできる
    return con

# 起動時に一度だけ：テーブルが無ければ作る
with db() as con:
    con.execute("""CREATE TABLE IF NOT EXISTS items(
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        title TEXT NOT NULL,
        done  INTEGER DEFAULT 0)""")

# POST で受け取る JSON の形。型に反したら FastAPI が自動で 422 を返す
class ItemIn(BaseModel):
    title: str
    done: bool = False

# CREATE
@app.post("/items")
def create(item: ItemIn):
    with db() as con:
        cur = con.execute(
            "INSERT INTO items(title, done) VALUES(?, ?)",
            (item.title, int(item.done)))
        return {"id": cur.lastrowid, "title": item.title, "done": item.done}

# READ（一覧）
@app.get("/items")
def list_items():
    with db() as con:
        rows = con.execute("SELECT * FROM items").fetchall()
        return [dict(r) for r in rows]

# UPDATE
@app.put("/items/{item_id}")
def update(item_id: int, item: ItemIn):
    with db() as con:
        cur = con.execute(
            "UPDATE items SET title=?, done=? WHERE id=?",
            (item.title, int(item.done), item_id))
        if cur.rowcount == 0:
            raise HTTPException(404, "見つかりません")
    return {"id": item_id, "title": item.title, "done": item.done}

# DELETE
@app.delete("/items/{item_id}")
def delete(item_id: int):
    with db() as con:
        con.execute("DELETE FROM items WHERE id=?", (item_id,))
    return {"deleted": item_id}

① データが消える？ → 消えていない。 SQLite は app.db ファイルに書く。サーバを再起動しても残る。 逆に「消したい」ときはこのファイルを消すだけ。.gitignore に app.db を入れて、DBファイルはコミットしないのが定石。

② ブラウザから叩けない（CORS）。 別ドメインのフロントから呼ぶと弾かれることがある。 その時は CORSMiddleware を1ブロック足す。まずは /docs から試せば CORS は関係ないので、切り分けが楽。

③ 本番で SQLite のまま？ → 個人・小規模なら十分。 同時書き込みが激しくなったら PostgreSQL 等へ。 sqlite3 を SQLAlchemy（ORM）に替えておくと、その乗り換えが設定1行で済む。次の学習の入口はここ。