SQLite Utils 4.1 のリリース

Release: sqlite-utils 4.1

数日前にリリースされた4.0以来の最初のドットリリースで、いくつかのマイナーな新機能が追加されました。

• sqlite-utils insert および sqlite-utils upsert コマンドは、--code オプションを受け付けるようになりました。これにより、ファイルからインポートする代わりに、挿入対象となる行を定義する rows() 関数または行のイテレータを含む Python コードブロック（または .py ファイルへのパス）を提供できるようになりました (#684)。

sqlite-utils にはすでに、CLI オプションとして Python コードブロックを渡す機能があり、例えば sqlite-utils convert コマンドでは以下のように使用できます:

sqlite-utils convert content.db articles headline '

def convert(value):

return value.upper()'

このパターンを拡張して、新しい行を直接生成できるようにしたのが今回の機能です:

sqlite-utils insert data.db creatures --code '

def rows():

yield {"id": 1, "name": "Cleo"}

yield {"id": 2, "name": "Suna"}

' --pk id

• sqlite-utils insert および sqlite-utils upsert コマンドは、--type column-name type オプションも受け付けるようになりました。これにより、テーブル作成時に自動的に選択される型を上書きできます。これは、ZIP コードのように整数に見えるが、先頭のゼロを保持するために TEXT として保存すべき CSV や TSV の列に対して有用です (#131)。

長年待ち望まれていた機能リクエストが、実は シンプルな実装 であることが判明しました。

• インデックス名を指定してインデックスを削除するための新しい table.drop_index(name) メソッドと、sqlite-utils drop-index コマンドが追加されました。両方とも ignore=True または --ignore を受け付けるため、存在しないインデックスを無視できます（#626）。

• sqlite-utils query は、クエリ部分に - を指定することで標準入力から SQL クエリを読み取れるようになりました。例えば、echo "select * from dogs" | sqlite-utils query dogs.db - のように使用します（#765）。

さらに小さな機能 2 つを追加しました。Codex にすべての未解決の課題をレビューさせ、最も簡単なものを目立たせました！

• sqlite-utils upsert は、既存テーブルの主キーを自動的に推論できるようになりました。そのため、主キーが既に定義されているテーブルに対してアップサートする際、--pk オプションを省略できます。

これも Codex の提案によるものです。Python ライブラリの改善として 4.0 リリースで提供された機能から、明らかに CLI で不足していた機能を追加しました。

• table.transform() と table.transform_sql() は、テーブルの SQLite ストリクトモードを変更するために strict=True または strict=False を受け付けるようになりました。このオプションを省略すると、既存のモードが維持されます（#787）。

• sqlite-utils transform コマンドも、テーブルのストリクトモードを変更するために --strict と --no-strict を受け付けるようになりました（#787）。

これら 2 つは、Evan Hahn による SQLite では STRICT テーブルを優先する という記事に触発されたものです。この記事は本日、Hacker News で話題になりました。Evan は次のように指摘しています：

残念ながら、テーブルを厳格モードに変更する ALTER 文には方法がないと考えています。非厳格なテーブルからデータを抽出し、厳格なテーブルにコピーする必要があります。

これはまさに sqlite-utils の transform メカニズム が行うことであり、私はこれを拡張して、テーブルを厳格モードと非厳格モードの間で切り替える機能を追加しました。

これらの新しい厳格テーブル機能を実装するために使用した GPT-5.6 Sol xhigh Codex のトランスクリプト はこちらです。私が実行した最も有用なプロンプトの一つはこれでした:

use uv run python -c and manually exercise the new .transform(strict=) option, see if you can find any edge-cases or bugs

これは、モデルに対して既に作成済みの自動テストの外側で手動テストを実行するよう指示するものでした。これにより、2 つの軽微な問題が発見され、その後修正されました。

Tags: projects, python, sqlite, sqlite-utils, annotated-release-notes, ai-assisted-programming