SQL Schema生成時のNullable JSONフィールドの処理

Nullable vs NOT NULLカラム

JSONでは、フィールドはnullであるか、オブジェクトから完全に欠落しているか、値を持つことができます。SQLでは、すべてのカラムはNULL（欠損データを許可）またはNOT NULL（値を必須）のいずれかです。この区別を正しく行うことはデータの整合性にとって重要です。

JSON例

{
  "id": 1,
  "name": "Alice",
  "email": "alice@example.com",
  "phone": null,
  "bio": null,
  "avatar_url": "https://cdn.example.com/alice.jpg"
}

生成されるSQL

CREATE TABLE users (
  id INTEGER NOT NULL,
  name VARCHAR(255) NOT NULL,
  email VARCHAR(255) NOT NULL,
  phone VARCHAR(20) NULL,
  bio TEXT NULL,
  avatar_url VARCHAR(2048) NULL
);

コンバーターの判断方法

1. 値がnull — カラムはNULL（nullable）としてマークされます。
2. 値が存在し非null — カラムはデフォルトでNOT NULLとしてマークされます。
3. 複数サンプル — 一部のレコードでnullで他で非nullの場合、カラムはNULLとしてマークされます。

NOT NULLが重要な理由

NOT NULL制約には複数の利点があります：

• データの整合性 — 不完全なレコードの意図しない挿入を防ぎます。
• クエリの簡潔さ — すべてのクエリでCOALESCE()やIS NOT NULLチェックが不要になります。
• インデックス効率 — 一部のデータベースはNOT NULLカラムをインデックスでより効率的に処理します。
• ORM互換性 — nullの許容が明示的な場合、ORMはよりクリーンなコードを生成できます。

Nullableカラムのデフォルト値

NULLを許可する代わりに、デフォルト値がより適切かを検討してください：

phone VARCHAR(20) NULL,               -- 本当にオプショナル
bio TEXT NOT NULL DEFAULT '',           -- NULLの代わりに空文字列
avatar_url VARCHAR(2048) NULL,          -- NULLは「デフォルトアバターを使用」を意味
is_active BOOLEAN NOT NULL DEFAULT TRUE -- 常に状態を持つ

NULLの罠

NULLの比較には注意が必要です。SQLでは、NULL = NULLはNULL（TRUEではない）であり、NULL <> 'value'もNULLです。nullチェックにはIS NULLとIS NOT NULLを使用し、フォールバック値にはCOALESCE()を検討してください。

複数サンプル分析

ツールに複数のJSONレコードを貼り付けると、コンバーターはすべてのレコードを比較してnull許容を判断します。一部のレコードに存在するが他に欠落しているフィールドは、データベースカラムがすべての行に対応する必要があるため、nullableとして扱われます。