// PostgreSQL エラーリファレンス

PostgreSQL 23502: NULL 値が NOT NULL 制約に違反しています

INSERT または UPDATE で NOT NULL 列が空のままになりました。多くの場合、その列が省略され、デフォルト値もないことが原因です。

SQLSTATE
23502
名前
not_null_violation
カテゴリ
整合性制約違反
エラーメッセージ
null value in column "email" of relation "users" violates not-null constraint
DETAIL:  Failing row contains (7, Ada, null).

意味

A NOT NULL 列にはすべての行で値が必要です。23502は、新しい行または更新後の行に次があったことを意味します NULL その列はそこにありません。明示的に指定されなかったか、列が抜け落ちたためです。 INSERT 既定値は NULL.

その DETAIL 行には失敗した行全体が表示されます。PostgreSQL 13 以降はメッセージにテーブル名が含まれます。それより古いバージョンでは次のみが表示されます null value in column "email" violates not-null constraint.

よくある原因

  • その INSERT 列を指定しておらず、その列には次がありません DEFAULT.
  • アプリケーションが次を送信しました NULL、たとえば未設定のフィールドや失敗した検索など。
  • INSERT ... SELECT または UPDATE 行を返さなかったサブクエリで、次が生成されます NULL.
  • 次で追加された列 NOT NULL 既存のコードが認識していないもの。

修正方法

  1. 値を指定するか、その列に既定値を設定してください。

    INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]');
    ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
  2. 使用 COALESCE ルックアップまたは式が次を返す可能性がある場合 NULL.

    UPDATE orders o
    SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
  3. 列に NULL を許可する場合は、制約を削除します。

    ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;

安全に再現する

CREATE TEMP TABLE u (id int, email text NOT NULL);
INSERT INTO u (id) VALUES (1);  -- ERROR: null value in column "email" of relation "u" violates not-null constraint

関連エラー

その他の整合性制約違反のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。