sqlite-utils 4.0 リリース：データベーススキーママイグレーションを新機能として追加

sqlite-utils 4.0 が正式にリリースされました。これはプロジェクト124番目のリリースであり、2020年11月の3.0以来初のメジャーバージョンアップです。小さな破壊的変更（アップグレードガイドに記載）に加えて、データベースマイグレーション、ネストされたトランザクション（新しい db.atomic() メソッド経由）、複合外部キーサポートの3つの主要機能が導入されました。

データベーススキーママイグレーション

スキーママイグレーションは、SQLiteデータベースに適用する一連の変更と、適用済みマイグレーションを追跡するメカニズムを定義します。マイグレーションファイルはPythonで記述され、sqlite-utilsライブラリの table.transform() メソッドを使用します。このメソッドは、新しい一時テーブルを作成し、データをコピーし、古いテーブルを削除して一時テーブルをリネームする、SQLiteドキュメント推奨のパターンを実装しています。

以下は、creatures テーブルを作成し、列を追加し、列の型を変更するマイグレーションファイルの例です：

from sqlite_utils import Migrations

migrations = Migrations("creatures")

@migrations()
def create_table(db):
    db["creatures"].create(
        {"id": int, "name": str, "species": str},
        pk="id",
    )

@migrations()
def add_weight(db):
    db["creatures"].add_column("weight", float)

@migrations()
def change_column_types(db):
    db["creatures"].transform(types={"species": int, "weight": str})

uvx sqlite-utils migrate data.db migrations.py を実行すると、データベースに _sqlite_migrations テーブルが作成され、各マイグレーションの適用状況が記録されます。--list オプションで適用済みおよび未適用のマイグレーション一覧を表示できます。

ネストされたトランザクション

sqlite-utils は長年にわたりトランザクション処理に混乱がありました。4.0では db.atomic() コンテキストマネージャを導入し、SQLiteのセーブポイント機構を利用してネスト可能なトランザクションを実現しています。これにより、マイグレーションシステムの安全性と推論のしやすさが大幅に向上しました。

複合外部キー

複合外部キーの作成、変換、イントロスペクションがサポートされました。この機能は、コードエージェントによるレビューで「後から追加すると破壊的変更になる」と指摘されたことから実装が決まりました。API設計には Claude Fable 5 が協力し、ライブラリ全体の一貫性を保つものになりました。

その他の重要な変更

• Upsert は INSERT ... ON CONFLICT ... DO UPDATE SET 構文を使用し、主キーを自動検出して必須の主キー値が欠けているレコードを拒否します。
• db.query() は即座に実行され、行を返さない文を拒否します。書き込みやDDLには db.execute() を使用します。
• CSV/TSV インポートはデフォルトで列の型を自動検出（テキスト、整数、実数）し、既存テーブルへの挿入ではそのテーブルの列型を保持します。
• table.extract() と extracts= は、すべての値がNULLの場合にルックアップテーブルのレコードを作成しなくなりました。

AIの貢献

アップグレードガイドとリリースノートは、Claude Fable 5、Claude Opus 4.8、GPT-5.5 によって作成されました。著者は、この種の文書は正確で詳細であればよく、意見を表明する必要がないため、AIに任せるのに適していると述べています。

Claude Fable 5 はテストで12のスクリプトを作成し、4つのリリースブロッカーと10の追加バグを発見しました。例えば、失敗した db.execute() 書き込みが暗黙的なトランザクションを開いたままにする、先頭のセミコロンによるクエリパーサー回避、複合外部キーのカラム順序の問題などです。これらの発見により、4.0の品質は大幅に向上しました。

総じて、sqlite-utils 4.0 は、マイグレーションシステム、トランザクションの改善、AI支援によるテストにより、SQLiteツールエコシステムに信頼性の高い基盤を提供します。