シードデータにおけるオートインクリメントIDの処理

オートインクリメントカラムの処理

オートインクリメントカラムはデータベースエンジンによって管理され、通常INSERT文から省略すべきです。シードジェネレーターはこれらを検出して自動的に除外します。

検出パターン

ジェネレーターはいくつかのSQLパターンを通じてオートインクリメントカラムを認識します：

パターン	ダイアレクト	例
SERIAL	PostgreSQL	id SERIAL PRIMARY KEY
BIGSERIAL	PostgreSQL	id BIGSERIAL PRIMARY KEY
SMALLSERIAL	PostgreSQL	id SMALLSERIAL PRIMARY KEY
AUTO_INCREMENT	MySQL	id INT AUTO_INCREMENT PRIMARY KEY
AUTOINCREMENT	SQLite	id INTEGER PRIMARY KEY AUTOINCREMENT
IDENTITY	SQL Server	id INT IDENTITY(1,1)

SQL INSERTの動作

オートインクリメントカラムが検出されると、INSERTカラムリストから除外されます：

-- idはSERIALなので省略：
INSERT INTO "users" ("username", "email", "is_active") VALUES ('james42', 'james.smith@gmail.com', TRUE);

データベースが内部シーケンスを使用してID値を自動的に割り当てます。

JSONとCSVの動作

JSONとCSV出力形式では、オートインクリメントカラムは連番値（1, 2, 3, ...）で含まれます。JSONフィクスチャやCSVインポートでは明示的なIDが必要なことが多いためです：

{ "id": 1, "username": "james42", "email": "james.smith@gmail.com" }

明示的なIDが必要な場合

テストシナリオによっては、予測可能な外部キー参照を作成するためにSQL INSERT文に明示的なIDが必要です。その場合、カラムをSERIALからINTEGER PRIMARY KEYに変更すると、ジェネレーターは連番値で含めます。

PostgreSQLシーケンスの考慮事項

PostgreSQLで明示的なIDを持つ行を挿入した後、シーケンスをリセットすることを忘れないでください：

SELECT setval('users_id_seq', (SELECT MAX(id) FROM users));

これにより、アプリケーションが後でシーケンスを使用して行を挿入する際の重複キーエラーを防ぎます。