【完全ガイド】ORA-01407: cannot update … to NULL の原因と解決方法｜相関サブクエリ・NVL 外側 vs 内側 徹底解説

Oracle 開発者がUPDATE 文実装時に頻繁に遭遇するエラー:

UPDATE orders o SET o.amount = (
  SELECT b.qty * b.item_price
  FROM items b
  WHERE o.item_id = b.item_id
);
*
ERROR at line 1:
ORA-01407: cannot update ("APP"."ORDERS"."AMOUNT") to NULL

**「NOT NULL 列を NULL に更新できない」**というシンプルなメッセージ。Oracle 開発者の実務で最頻出の UPDATE 系エラーです:

• 相関サブクエリが空を返した瞬間に発生
• 既存の値が不用意に破壊される問題
• バッチ処理の中断
• 意外なほど NVL の使い方でハマる
• ORA-01400 (INSERT) の姉妹エラー

このエラーの本質は、Oracle 公式ドキュメントが明確に述べています:

Cause: An attempt was made to update a table column 
       "USER"."TABLE"."COLUMN" with a NULL value.

例:
connect scott/tiger
CREATE TABLE a (a1 NUMBER NOT NULL);
INSERT INTO a VALUES (1);
UPDATE a SET a1 = NULL;
-- ORA-01407 cannot update ("SCOTT"."A"."A1") to NULL

ORA-01407 vs ORA-01400 の完全比較

姉妹エラーとの厳密な区別:

ORA-01400: cannot insert NULL into ("SCHEMA"."TABLE"."COL")
  → INSERT 時、NOT NULL 列に NULL

ORA-01407: cannot update ("SCHEMA"."TABLE"."COL") to NULL
  → UPDATE 時、NOT NULL 列を NULL に

両方: DML で NOT NULL 制約違反
違い: INSERT vs UPDATE

最頻出パターン：相関サブクエリで一致なし

現場で 8 割以上のケースがこれです:

UPDATE orders o SET o.amount = (
  SELECT b.qty * b.item_price
  FROM items b
  WHERE o.item_id = b.item_id   -- 対応する item がない行
);
-- 対応 item なし → サブクエリ NULL → ORA-01407

危険な副作用: 既に amount に値があった行も NULL 更新試行（そして失敗）。

NVL の外側 vs 内側の重大な罠

日本語圏で最も混乱するポイント:

-- ❌ 誤り：NVL がサブクエリ内側
UPDATE t1 SET val = (
  SELECT NVL(t2.val, 'default') FROM t2 WHERE t2.id = t1.id
);
-- 対応行なし → SELECT 自体が NULL 返す
-- NVL は内側で動作、外の NULL は防げない
-- → ORA-01407

-- ✅ 正しい：NVL がサブクエリ外側
UPDATE t1 SET val = NVL(
  (SELECT t2.val FROM t2 WHERE t2.id = t1.id),
  'default'
);
-- SELECT が NULL でも、外の NVL で default に置換
-- → 成功

現場で最も典型的なパターン:

• 相関サブクエリで対応行なし（最頻出）
• 直接 NULL 代入（コーディングミス）
• NVL の配置ミス（内側 vs 外側）
• 全行 UPDATE の副作用
• MERGE 文の WHEN MATCHED THEN UPDATE
• トリガーで NULL 代入
• 関数の戻り値が NULL
• JOIN 結果が NULL
• Bind 変数が NULL
• 型変換失敗（TO_NUMBER の NULL）

多くの日本語記事が「NVL を使え」で終わりますが、実務では:

• NVL の外側配置の重要性
• WHERE EXISTS による更新対象絞り込み
• COALESCE vs NVL の使い分け
• MERGE 文の**WHEN MATCHED THEN UPDATE** 条件
• ROW-EXCLUSIVE LOCK の副作用
• DEFAULT 値の NOT NULL 列への設定
• 制約 NOT NULL の一時無効化（DBA 権限）
• NULLIF による特殊値変換
• DBMS_ERRLOG によるエラーログテーブル
• Rails / Java / Python アプリでのNULL 対策

さらに、Oracle 実務で頻繁に使われるWHERE EXISTS パターン:

UPDATE orders o SET o.amount = (
  SELECT b.qty * b.item_price FROM items b WHERE o.item_id = b.item_id
)
WHERE EXISTS (
  SELECT 1 FROM items b WHERE o.item_id = b.item_id
);
-- 対応 item がある行のみ UPDATE、他は変更なし

本記事では、ORA-01407: cannot update ... to NULL の完全な原因と解決方法を、リファレンスとして実用的に整理します。10大発生パターン、NVL 配置の罠、6つの解決策、Rails/Java/Python 対応、実践シナリオ、FAQまで完全網羅。この1本で ORA-01407 を根本から解決できるようになります。

結論：NVL 外側配置 or WHERE EXISTS

時間がない方向けに、最速の対処を先に示します。

エラーメッセージの読み方

ORA-01407: cannot update ("SCHEMA"."TABLE"."COLUMN") to NULL
                            ↑
                    問題の列名（NOT NULL）

= UPDATE で NOT NULL 列を NULL にしようとした
  多くはサブクエリが NULL を返した

最速の診断

-- STEP 1: NOT NULL 列確認
SELECT column_name, nullable, data_default
FROM user_tab_columns
WHERE table_name = 'ORDERS'
  AND nullable = 'N';

-- STEP 2: サブクエリの結果確認
SELECT b.qty * b.item_price FROM items b WHERE b.item_id = 999;
-- 0 行なら NULL 発生

-- STEP 3: UPDATE 対象行の特定
SELECT COUNT(*) FROM orders o WHERE NOT EXISTS (
  SELECT 1 FROM items b WHERE o.item_id = b.item_id
);
-- 該当行数

最速の対処パターン

-- パターンA: NVL 外側配置
UPDATE orders o SET o.amount = NVL(
  (SELECT b.qty * b.item_price FROM items b WHERE o.item_id = b.item_id),
  0  -- または元の値: o.amount
);

-- パターンB: WHERE EXISTS
UPDATE orders o SET o.amount = (
  SELECT b.qty * b.item_price FROM items b WHERE o.item_id = b.item_id
)
WHERE EXISTS (SELECT 1 FROM items b WHERE o.item_id = b.item_id);

-- パターンC: MERGE 文
MERGE INTO orders o
USING items b ON (o.item_id = b.item_id)
WHEN MATCHED THEN UPDATE SET o.amount = b.qty * b.item_price;

6つの解決策

ORA-01407 vs ORA-01400

詳細は以下で解説します。

Oracle NOT NULL 制約の仕組み

NOT NULL の定義方法

列定義時:

CREATE TABLE orders (
  id NUMBER NOT NULL,
  amount NUMBER NOT NULL
);

ALTER で追加:

ALTER TABLE orders MODIFY (amount NUMBER NOT NULL);

CHECK 制約として:

CREATE TABLE orders (
  id NUMBER,
  CONSTRAINT chk_id CHECK (id IS NOT NULL)
);

NOT NULL 制約の確認

-- 直接 NOT NULL
SELECT column_name, nullable, data_default
FROM user_tab_columns
WHERE table_name = 'ORDERS' AND nullable = 'N';

-- CHECK 制約経由
SELECT constraint_name, search_condition
FROM user_constraints
WHERE table_name = 'ORDERS' AND constraint_type = 'C';

UPDATE の内部動作

UPDATE t SET col = expr WHERE ...;
   ↓
1. WHERE 該当行を特定
2. 各行に対して expr を評価
3. 結果が NULL & col が NOT NULL → ORA-01407
4. 全行成功なら COMMIT 可能
5. 1 行失敗で全体 ROLLBACK

重要: 1 行失敗で全体ロールバック、部分成功なし。

【原因①】相関サブクエリで一致なし（最頻出）

症状（実例）

-- LAWSON ERP 実例
UPDATE LAWSON.ITEMLOC LOC 
SET LOC.AVERAGE_COST = (
  SELECT PF.BASE_COST / IM.ALT_UOM_CONV_01
  FROM LAWSON.ITEMLOC LC
  INNER JOIN LAWSON.POVAGRMTLN PF ON PF.ITEM = LC.ITEM
  INNER JOIN LAWSON.ITEMMAST IM ON IM.ITEM = LC.ITEM
  WHERE PF.HOLD_FLAG='N'
    AND ...
);
-- 対応 item がない行 → NULL → ORA-01407

根本原因

UPDATE 全行対象
   ↓
1 部の行にはサブクエリ結果あり
   ↓
別の行にはサブクエリ結果なし → NULL
   ↓
NOT NULL 列 → ORA-01407 → 全体ロールバック

解決A: NVL 外側配置（既存値保持）

UPDATE LAWSON.ITEMLOC LOC 
SET LOC.AVERAGE_COST = NVL(
  (SELECT PF.BASE_COST / IM.ALT_UOM_CONV_01
   FROM LAWSON.ITEMLOC LC
   INNER JOIN LAWSON.POVAGRMTLN PF ON PF.ITEM = LC.ITEM
   INNER JOIN LAWSON.ITEMMAST IM ON IM.ITEM = LC.ITEM
   WHERE PF.HOLD_FLAG='N' AND LC.ROWID = LOC.ROWID),
  LOC.AVERAGE_COST   -- 既存値をキープ（推奨）
);

解決B: WHERE EXISTS（対象絞り込み）

UPDATE LAWSON.ITEMLOC LOC 
SET LOC.AVERAGE_COST = (
  SELECT PF.BASE_COST / IM.ALT_UOM_CONV_01
  FROM LAWSON.POVAGRMTLN PF, LAWSON.ITEMMAST IM
  WHERE PF.ITEM = LOC.ITEM AND IM.ITEM = LOC.ITEM
    AND PF.HOLD_FLAG='N'
)
WHERE EXISTS (
  SELECT 1 FROM LAWSON.POVAGRMTLN PF, LAWSON.ITEMMAST IM
  WHERE PF.ITEM = LOC.ITEM AND IM.ITEM = LOC.ITEM
    AND PF.HOLD_FLAG='N'
);

解決C: MERGE 文（Oracle 推奨）

MERGE INTO LAWSON.ITEMLOC LOC
USING (
  SELECT LC.ROWID AS rid, PF.BASE_COST / IM.ALT_UOM_CONV_01 AS new_cost
  FROM LAWSON.ITEMLOC LC
  INNER JOIN LAWSON.POVAGRMTLN PF ON PF.ITEM = LC.ITEM
  INNER JOIN LAWSON.ITEMMAST IM ON IM.ITEM = LC.ITEM
  WHERE PF.HOLD_FLAG='N'
) src
ON (LOC.ROWID = src.rid)
WHEN MATCHED THEN UPDATE SET LOC.AVERAGE_COST = src.new_cost;

INSERT 関連は ORA-01400: cannot insert NULL の記事も参照してください。

【原因②】直接 NULL 代入

症状

UPDATE emp SET salary = NULL WHERE dept_id = 10;
-- ORA-01407 (salary が NOT NULL)

解決

A. デフォルト値使用:

UPDATE emp SET salary = 0 WHERE dept_id = 10;

B. 制約変更（要件検討）:

ALTER TABLE emp MODIFY (salary NUMBER);   -- NOT NULL 削除

【原因③】NVL の内側配置ミス

症状（超典型的ミス）

UPDATE table_1 t1 SET val = (
  SELECT NVL(t2.val, 'Was NULL') 
  FROM table_2 t2 
  WHERE t2.id = t1.id
);
-- 対応行なし → SELECT 自体が 0 行
-- NVL は「行はあるが値が NULL」に効く
-- 「行がない」には効かない
-- → ORA-01407

解決

NVL を外側に:

UPDATE table_1 t1 SET val = NVL(
  (SELECT t2.val FROM table_2 t2 WHERE t2.id = t1.id),
  'Was NULL'
);
-- SELECT が 0 行 → NULL
-- 外側 NVL で 'Was NULL' に置換
-- 成功

【原因④】全行 UPDATE の副作用

シナリオ

-- WHERE 句なし
UPDATE emp SET salary = (SELECT AVG(salary) FROM emp WHERE emp_id = ??);
-- 意図しない全行更新

解決

WHERE 句必須:

UPDATE emp e SET salary = (
  SELECT AVG(salary) FROM emp e2 WHERE e2.dept_id = e.dept_id
)
WHERE dept_id IS NOT NULL;

【原因⑤】MERGE 文

シナリオ

MERGE INTO orders o
USING new_data n ON (o.id = n.id)
WHEN MATCHED THEN UPDATE SET o.amount = n.amount;   -- n.amount が NULL の行あり
-- ORA-01407

解決

WHEN MATCHED with WHERE:

MERGE INTO orders o
USING new_data n ON (o.id = n.id)
WHEN MATCHED THEN UPDATE SET o.amount = n.amount
  WHERE n.amount IS NOT NULL;   -- NULL は更新しない

【原因⑥】トリガーで NULL 代入

シナリオ

CREATE OR REPLACE TRIGGER emp_trg
  BEFORE UPDATE ON emp
  FOR EACH ROW
BEGIN
  IF :NEW.status = 'ACTIVE' THEN
    :NEW.deleted_at := NULL;   -- deleted_at が NOT NULL
  END IF;
END;
/
-- UPDATE で ORA-01407 + ORA-04088

解決

トリガー修正 or 制約変更:

BEGIN
  IF :NEW.status = 'ACTIVE' THEN
    :NEW.deleted_at := TO_DATE('9999-12-31', 'YYYY-MM-DD');
  END IF;
END;

トリガー関連は ORA-04088: error during execution of trigger の記事も参照してください。

【原因⑦】関数の戻り値が NULL

シナリオ

CREATE FUNCTION get_default(id NUMBER) RETURN NUMBER AS
BEGIN
  IF id > 100 THEN
    RETURN NULL;
  END IF;
  RETURN 0;
END;
/

UPDATE orders SET amount = get_default(id);
-- id > 100 の行で NULL → ORA-01407

解決

関数を修正 or NVL でラップ:

UPDATE orders SET amount = NVL(get_default(id), 0);

【原因⑧】JOIN 結果が NULL

シナリオ

-- LEFT JOIN で右側が NULL の行
UPDATE orders o SET o.category = (
  SELECT c.name FROM categories c 
  WHERE c.id = o.cat_id   -- cat_id が NULL の行 or 対応なし
);

解決

UPDATE orders o SET o.category = NVL(
  (SELECT c.name FROM categories c WHERE c.id = o.cat_id),
  'UNCATEGORIZED'
);

【原因⑨】Bind 変数が NULL

シナリオ（Rails / Java 等）

# Rails
Order.where(id: 1).update_all(amount: nil)
# または
order.update!(amount: nil)
# ORA-01407

解決

アプリ側で NULL チェック:

amount = calculate_amount || 0   # NULL 時デフォルト
order.update!(amount: amount)

【原因⑩】型変換失敗

シナリオ

UPDATE emp SET salary = TO_NUMBER(comment);
-- comment が数値でない → TO_NUMBER 失敗 or NULL
-- ORA-01722 or ORA-01407

解決

A. VALIDATE_CONVERSION（12.2+）:

UPDATE emp SET salary = CASE
  WHEN VALIDATE_CONVERSION(comment AS NUMBER) = 1 
    THEN TO_NUMBER(comment)
  ELSE 0
END;

B. EXCEPTION 処理（PL/SQL 使用時）。

型変換関連は ORA-01722: invalid number の記事も参照してください。

診断ツール完全リファレンス

USER_TAB_COLUMNS

-- NOT NULL 列一覧
SELECT column_name, data_type, nullable, data_default
FROM user_tab_columns
WHERE table_name = 'ORDERS' AND nullable = 'N';

USER_CONSTRAINTS

-- CHECK 制約（NOT NULL 含む）
SELECT constraint_name, constraint_type, search_condition
FROM user_constraints
WHERE table_name = 'ORDERS';

対象行の事前確認

-- UPDATE で問題になる行の特定
SELECT COUNT(*) FROM orders o
WHERE NOT EXISTS (
  SELECT 1 FROM items b WHERE o.item_id = b.item_id
);

DBMS_ERRLOG（エラーログ）

-- エラーログテーブル作成
BEGIN
  DBMS_ERRLOG.CREATE_ERROR_LOG(
    dml_table_name => 'ORDERS',
    err_log_table_name => 'ORDERS_ERR'
  );
END;
/

-- LOG ERRORS 使用
UPDATE orders SET amount = ...
LOG ERRORS INTO orders_err ('UPDATE_001') REJECT LIMIT UNLIMITED;

-- エラー内容確認
SELECT ora_err_number$, ora_err_mesg$, id, amount
FROM orders_err;

V$SQL

-- 実行済み UPDATE 文の追跡
SELECT sql_id, sql_text, executions
FROM v$sql
WHERE upper(sql_text) LIKE 'UPDATE%ORDERS%'
ORDER BY last_active_time DESC;

6つの解決策 完全リファレンス

解決策① NVL 外側配置（既存値保持）

-- ✅ NVL は外側
UPDATE t1 SET col = NVL(
  (SELECT val FROM t2 WHERE t2.id = t1.id),
  t1.col   -- 既存値をキープ（データ保護）
);

-- 別のデフォルト
UPDATE t1 SET col = NVL(
  (SELECT val FROM t2 WHERE t2.id = t1.id),
  0
);

解決策② WHERE EXISTS

UPDATE t1 SET col = (
  SELECT val FROM t2 WHERE t2.id = t1.id
)
WHERE EXISTS (
  SELECT 1 FROM t2 WHERE t2.id = t1.id
);
-- 対応行がある t1 の行のみ UPDATE

解決策③ COALESCE（複数候補）

UPDATE t SET col = COALESCE(
  (SELECT val FROM t2 WHERE t2.id = t.id),
  (SELECT val FROM t3 WHERE t3.id = t.id),
  0
);
-- 順に NULL でなければ採用

解決策④ DEFAULT 値定義

-- テーブル定義時
CREATE TABLE orders (
  id NUMBER NOT NULL,
  amount NUMBER DEFAULT 0 NOT NULL   -- DEFAULT + NOT NULL
);

-- ALTER で追加
ALTER TABLE orders MODIFY (amount DEFAULT 0);

注意: DEFAULT は明示的な NULL 指定では効かない（19c+ で DEFAULT ON NULL 可能）:

-- 19c+
ALTER TABLE orders MODIFY (
  amount NUMBER DEFAULT ON NULL 0 NOT NULL
);
-- INSERT ... VALUES (NULL) でも 0 になる

解決策⑤ MERGE 文（UPSERT）

MERGE INTO orders o
USING (
  SELECT id, calculate_amount(id) AS new_amount 
  FROM items
) src
ON (o.item_id = src.id)
WHEN MATCHED THEN UPDATE SET o.amount = src.new_amount
  WHERE src.new_amount IS NOT NULL;

解決策⑥ NULLIF（特殊値変換）

-- 空文字を NULL 扱いにしない工夫
UPDATE emp SET name = NULLIF(name, '') 
WHERE ...;
-- ORA-01407 の逆パターン、あえて NULL にしたい時

Rails / Java / Python 対応

Rails ActiveRecord

バリデーション:

class Order < ApplicationRecord
  validates :amount, presence: true, numericality: true
  
  before_save :ensure_amount_not_null
  
  private
  
  def ensure_amount_not_null
    self.amount ||= 0   # NULL 防止
  end
end

# UPDATE 時
begin
  order.update!(amount: calculated_value)
rescue ActiveRecord::StatementInvalid => e
  if e.message.include?("ORA-01407")
    Rails.logger.error "Attempted NULL update: #{e.message}"
    # デフォルト値で再試行
    order.update!(amount: 0)
  end
end

バッチ UPDATE:

# 相関サブクエリ相当を Rails で
Order.where(id: order_ids).find_each do |order|
  item = Item.find_by(id: order.item_id)
  new_amount = item ? item.qty * item.price : order.amount
  order.update!(amount: new_amount)
end

Rails 8 系の詳細は Rails 8 アップグレードガイドの記事、find/find_by/where の記事も参照してください。

Java (JDBC)

String sql = "UPDATE orders SET amount = ? WHERE id = ?";
try (PreparedStatement ps = conn.prepareStatement(sql)) {
    BigDecimal amount = calculateAmount(orderId);
    // NULL 防止
    if (amount == null) {
        amount = BigDecimal.ZERO;
    }
    ps.setBigDecimal(1, amount);
    ps.setLong(2, orderId);
    ps.executeUpdate();
} catch (SQLException e) {
    if (e.getErrorCode() == 1407) {
        logger.error("Cannot update to NULL: " + e.getMessage());
    }
}

Python (oracledb)

import oracledb

def update_amount(cursor, order_id, amount):
    # NULL 防止
    if amount is None:
        amount = 0
    
    try:
        cursor.execute(
            "UPDATE orders SET amount = :1 WHERE id = :2",

[amount, order_id]

) except oracledb.DatabaseError as e: error_obj, = e.args if error_obj.code == 1407: print(f”Cannot update to NULL: {error_obj.message}”)

実践シナリオ

シナリオ1：本番緊急対応

-- エラー発生
UPDATE orders o SET o.amount = (SELECT ... FROM items ...);
-- ORA-01407

-- 1. NOT NULL 列確認
SELECT column_name FROM user_tab_columns 
WHERE table_name = 'ORDERS' AND nullable = 'N';

-- 2. サブクエリで NULL 返す行を特定
SELECT o.id FROM orders o
WHERE NOT EXISTS (SELECT 1 FROM items b WHERE b.item_id = o.item_id);

-- 3. NVL 外側 or WHERE EXISTS で修正
UPDATE orders o SET o.amount = NVL(
  (SELECT b.qty * b.price FROM items b WHERE b.item_id = o.item_id),
  o.amount   -- 既存値保持
);

-- 4. 検証
SELECT COUNT(*) FROM orders WHERE amount IS NULL;

シナリオ2：バッチ処理での DBMS_ERRLOG 活用

-- 1. エラーログテーブル作成
BEGIN
  DBMS_ERRLOG.CREATE_ERROR_LOG('ORDERS', 'ORDERS_ERR');
END;
/

-- 2. LOG ERRORS 付き UPDATE
UPDATE orders o SET o.amount = (
  SELECT b.qty * b.price FROM items b WHERE b.item_id = o.item_id
)
LOG ERRORS INTO orders_err ('BATCH_2026-06') REJECT LIMIT UNLIMITED;

COMMIT;

-- 3. エラー行確認
SELECT id, ora_err_mesg$
FROM orders_err
WHERE ora_err_tag$ = 'BATCH_2026-06';

-- 4. 失敗行のみ対処
UPDATE orders SET amount = 0
WHERE id IN (SELECT id FROM orders_err);

シナリオ3：MERGE 文への移行

-- Before: サブクエリ UPDATE（ORA-01407 の危険）
UPDATE orders o SET o.amount = (
  SELECT b.qty * b.price FROM items b WHERE b.id = o.item_id
);

-- After: MERGE（安全）
MERGE INTO orders o
USING items b ON (b.id = o.item_id)
WHEN MATCHED THEN UPDATE SET o.amount = b.qty * b.price
  WHERE b.qty IS NOT NULL AND b.price IS NOT NULL;

シナリオ4：Rails マイグレーション

class AddAmountDefaultToOrders < ActiveRecord::Migration[8.0]
  def up
    # DEFAULT 値追加（既存 NULL 行を先に更新）
    execute "UPDATE orders SET amount = 0 WHERE amount IS NULL"
    
    # DEFAULT + NOT NULL
    change_column_default :orders, :amount, from: nil, to: 0
    change_column_null :orders, :amount, false
  end
  
  def down
    change_column_null :orders, :amount, true
    change_column_default :orders, :amount, from: 0, to: nil
  end
end

シナリオ5：Docker Oracle でのテスト

docker exec -it oracle-xe sqlplus scott/tiger <<EOF
CREATE TABLE t1 (id NUMBER, val VARCHAR2(50) NOT NULL);
CREATE TABLE t2 (id NUMBER, val VARCHAR2(50));

INSERT INTO t1 VALUES (1, 'AAA');
INSERT INTO t1 VALUES (2, 'BBB');
INSERT INTO t2 VALUES (1, 'XXX');
COMMIT;

-- ❌ 失敗
UPDATE t1 SET val = (SELECT val FROM t2 WHERE t2.id = t1.id);
-- ORA-01407（id=2 に対応する t2 行なし）

-- ✅ 成功
UPDATE t1 SET val = NVL(
  (SELECT val FROM t2 WHERE t2.id = t1.id),
  t1.val
);
SELECT * FROM t1;
-- id=1: XXX, id=2: BBB
EOF

Docker 関連は docker daemon 接続エラーの記事、Docker no space left on device の記事も参照してください。

シナリオ6：19c+ DEFAULT ON NULL

-- 19c+ の便利機能
CREATE TABLE orders (
  id NUMBER PRIMARY KEY,
  amount NUMBER DEFAULT ON NULL 0 NOT NULL
);

-- 明示的 NULL でも DEFAULT が効く
INSERT INTO orders VALUES (1, NULL);
-- amount = 0

UPDATE orders SET amount = NULL WHERE id = 1;
-- amount = 0（NULL にならない）

シナリオ7：Python バッチ処理

import oracledb
import logging

def batch_update_amounts(conn, batch_size=1000):
    cursor = conn.cursor()
    
    # 対象取得
    cursor.execute("""
        SELECT o.id, o.item_id
        FROM orders o
        WHERE o.amount IS NULL OR o.amount = 0
    """)
    orders = cursor.fetchall()
    
    updated = 0
    skipped = 0
    
    for order_id, item_id in orders:
        # サブクエリ相当
        cursor.execute("""
            SELECT qty * price FROM items WHERE id = :1
        """, [item_id])
        result = cursor.fetchone()
        
        if result and result[0] is not None:
            cursor.execute("""
                UPDATE orders SET amount = :1 WHERE id = :2
            """, [result[0], order_id])
            updated += 1
        else:
            skipped += 1
            logging.info(f"Skipped order {order_id}: no matching item")
    
    conn.commit()
    logging.info(f"Updated: {updated}, Skipped: {skipped}")

シナリオ8：CI/CD 検証

- name: Validate no NOT NULL columns get NULL
  run: |
    sqlplus -s $DB_USER/$DB_PW <<EOF
    WHENEVER SQLERROR EXIT SQL.SQLCODE
    DECLARE
      v_count NUMBER;
    BEGIN
      -- テスト UPDATE
      UPDATE orders SET amount = NVL(
        (SELECT qty*price FROM items WHERE items.id = orders.item_id),
        orders.amount
      );
      
      SELECT COUNT(*) INTO v_count FROM orders WHERE amount IS NULL;
      IF v_count > 0 THEN
        RAISE_APPLICATION_ERROR(-20001, 'NULL amount detected');
      END IF;
      ROLLBACK;
    END;
    /
    EOF

Kamal 2 デプロイの詳細は Kamal 2 デプロイの記事を参照してください。

シナリオ9：Java Spring での対応

@Service
public class OrderService {
    @Autowired
    private JdbcTemplate jdbcTemplate;
    
    public void updateAmounts() {
        String sql = """
            UPDATE orders o SET o.amount = NVL(
              (SELECT b.qty * b.price FROM items b WHERE b.id = o.item_id),
              o.amount
            )
            """;
        
        try {
            int updated = jdbcTemplate.update(sql);
            logger.info("Updated: " + updated);
        } catch (DataIntegrityViolationException e) {
            if (e.getMessage().contains("ORA-01407")) {
                logger.error("NOT NULL violation on UPDATE");
                // 対処
            }
        }
    }
}

シナリオ10：Autonomous DB

Autonomous DB でも同じ挙動
- 19c+ なら DEFAULT ON NULL 使用可
- MERGE 推奨
- LOG ERRORS で行単位エラーハンドル

トラブルシューティング

NVL 使ってるのに ORA-01407

NVL の位置確認、内側ではなく外側に配置。

MERGE でも発生

WHERE 条件追加、WHEN MATCHED THEN UPDATE ... WHERE NOT NULL。

部分更新したい

LOG ERRORS INTO で行単位エラー処理。

制約変更したいが影響大

DBA と協議、既存 NULL 値の対処後に変更。

バッチで大量発生

エラーログテーブルを活用、後で個別対処。

PostgreSQL からの移行

PG も同じ NOT NULL 制約、COALESCE 使用可（Oracle も対応）。

よくある質問（FAQ）

Q1. ORA-01407 と ORA-01400 の違い

• 01407: UPDATE で NULL
• 01400: INSERT で NULL

Q2. NVL の位置が重要

サブクエリの外側に置く、内側だと 0 行返しに効かない。

Q3. WHERE EXISTS パターンの意味

対応データがある行のみ UPDATE、他は変更なし。

Q4. MERGE 推奨か

複雑な UPDATE は MERGE 推奨、UPSERT 対応、条件 UPDATE 可能。

Q5. DEFAULT ON NULL

19c+ 新機能、明示的 NULL でもデフォルト効く。

Q6. DBMS_ERRLOG の使い所

バッチ処理で全体停止避けたい時、行単位エラーログ。

Q7. Rails での対応

アプリバリデーション + NVL SQL、二重防御。

Q8. Java での対応

null チェック+ SQLState 検出。

Q9. Python での対応

None チェック+ oracledb.DatabaseError。

Q10. パフォーマンス影響

1 行失敗で全体 ROLLBACK、大量データ時要注意。

Q11. Autonomous DB

19c+ 相当、DEFAULT ON NULL 使える。

Q12. 予防策

• アプリバリデーション
• NVL 外側パターン
• MERGE 使用
• DBMS_ERRLOG
• DEFAULT ON NULL (19c+)

参考リンク

Oracle 公式

• Oracle Database Error Messages: ORA-01407
• Oracle Database SQL Language Reference: UPDATE
• Oracle Database SQL Language Reference: MERGE
• DBMS_ERRLOG Package

まとめ

ORA-01407: cannot update ... to NULL の要点を再整理します。

エラーの本質

UPDATE で NOT NULL 列を NULL にしようとした
→ 多くは相関サブクエリが空を返した
→ 既存の値も破壊しようとする
→ 1 行失敗で全体ロールバック
→ NVL 外側 or WHERE EXISTS で解決

エラーメッセージの読み方

ORA-01407: cannot update ("SCHEMA"."TABLE"."COLUMN") to NULL
                            ↑
                    問題の列名（NOT NULL）

ORA-01407 vs ORA-01400

NVL の重要な違い

-- ❌ 内側：0 行返しに効かない
UPDATE t1 SET val = (SELECT NVL(val, 'X') FROM t2 WHERE t2.id = t1.id);

-- ✅ 外側：0 行返しにも効く
UPDATE t1 SET val = NVL((SELECT val FROM t2 WHERE t2.id = t1.id), 'X');

10大原因

6つの解決策

-- ① NVL 外側配置
UPDATE t SET col = NVL((SELECT ... FROM ...), t.col);

-- ② WHERE EXISTS
UPDATE t SET col = (SELECT ...) WHERE EXISTS (SELECT 1 FROM ...);

-- ③ COALESCE
UPDATE t SET col = COALESCE(val1, val2, 0);

-- ④ DEFAULT 値
CREATE TABLE t (col NUMBER DEFAULT 0 NOT NULL);
-- 19c+: DEFAULT ON NULL 0

-- ⑤ MERGE 文
MERGE INTO t USING src ON (...)
WHEN MATCHED THEN UPDATE SET col = src.val WHERE src.val IS NOT NULL;

-- ⑥ NULLIF
UPDATE t SET col = NULLIF(col, '');

診断クエリ Top 3

-- ① NOT NULL 列
SELECT column_name FROM user_tab_columns 
WHERE table_name = 'T' AND nullable = 'N';

-- ② サブクエリ NULL の行
SELECT id FROM t WHERE NOT EXISTS (SELECT 1 FROM t2 WHERE ...);

-- ③ DBMS_ERRLOG
BEGIN DBMS_ERRLOG.CREATE_ERROR_LOG('T'); END;
UPDATE t SET ... LOG ERRORS INTO err_t REJECT LIMIT UNLIMITED;

各言語での対応

Rails:  presence: true validation + NVL SQL
Java:   null チェック + errorCode 1407
Python: None チェック + oracledb
共通:   NVL 外側配置、WHERE EXISTS、MERGE 推奨

予防のポイント

1. サブクエリ UPDATE は NVL 外側デフォルト
2. WHERE EXISTS で対象絞り込み
3. MERGE 文推奨
4. 19c+ なら DEFAULT ON NULL
5. アプリ側でも NULL 防止
6. DBMS_ERRLOG で行単位エラー
7. Rails validates presence
8. Java/Python は null チェック
9. CI/CD で NOT NULL 検証
10. Autonomous DB でも同じ挙動

これらの知識は、Oracle での DML 開発・バッチ処理・データマイグレーション・Rails / Java / Python アプリ運用・CI/CD パイプライン・データ整合性維持・エラー処理設計など、あらゆる場面で活用できます。本記事をブックマークしておけば、ORA-01407 に出会っても冷静に的確に対処できるようになります。

本記事は2026年6月時点の情報をもとに、Oracle Database 19c〜23ai での動作確認・公式ドキュメントに基づき作成しています。Oracle のバージョンにより挙動が異なる場合があるため、最新の情報は Oracle 公式ドキュメント（docs.oracle.com）もあわせてご確認ください。