OceanBase中如何为已有列添加NOT NULL约束？

环境 #

OceanBase社区版4.2.1（MySQL模式）

问题描述 #

在OceanBase中尝试为已有列添加NOT NULL约束时，发现与原生MySQL行为存在差异。以下是最小复现场景：

CREATE TABLE test_alter 
(
    id BIGINT PRIMARY KEY,
    nullable_col VARCHAR(50) 
) PARTITION BY HASH(id) PARTITIONS 3;

INSERT INTO test_alter 
VALUES (1, NULL), (2, 'not_null');

在MySQL 5.7中可正常执行的语句，在OceanBase中执行会报错：

ALTER TABLE test_alter 
MODIFY COLUMN nullable_col VARCHAR(50) NOT NULL DEFAULT '';

报错信息：

ERROR 1235 (0A000): Not supported feature or function

使用CHANGE COLUMN语法执行同样操作，也会触发相同错误：

ALTER TABLE test_alter 
CHANGE COLUMN nullable_col nullable_col VARCHAR(50) NOT NULL;

解决方案 #

OceanBase对直接通过MODIFY/CHANGE COLUMN为含已有数据的列添加NOT NULL约束存在兼容性限制，尤其是分区表场景。可通过以下步骤实现需求：

1. 先清理列中的NULL值
   由于表中存在NULL数据，必须先将这些值替换为符合NOT NULL要求的内容（比如空字符串）：

   UPDATE test_alter SET nullable_col = '' WHERE nullable_col IS NULL;
   

2. 分步骤执行DDL操作
   OceanBase支持分阶段完成约束添加，推荐两种方式：

   • 方式一：先设置默认值，再添加NOT NULL约束

     -- 为列设置默认值
     ALTER TABLE test_alter ALTER COLUMN nullable_col SET DEFAULT '';
     -- 修改列属性为NOT NULL
     ALTER TABLE test_alter MODIFY COLUMN nullable_col VARCHAR(50) NOT NULL;
     

   • 方式二：确认无NULL数据后直接修改列属性（部分版本支持）

     ALTER TABLE test_alter MODIFY COLUMN nullable_col VARCHAR(50) NOT NULL;
     

   注：分区表的DDL操作在OceanBase中有特定限制，分步骤执行可规避直接修改引发的兼容性问题。

验证 #

完成操作后，可通过以下语句验证约束是否生效：

-- 查看表结构，确认nullable_col的NOT NULL约束已添加
DESC test_alter;
-- 尝试插入NULL值，应触发报错
INSERT INTO test_alter(id, nullable_col) VALUES(3, NULL);

内容的提问来源于stack exchange，提问作者user30195804