在线DDL
enable_online_ddl
参数说明:该参数与ONLINE/OFFLINE关键字(关键字详情请参考《开发指南》中的“SQL参考 -> SQL语法 -> A -> ALTER TABLE”章节,“SQL参考 -> SQL语法 -> V -> VACUUM”章节)结合使用,控制是否开启在线DDL或在线VACUUM。
参数类型:布尔型
参数单位:无
取值范围:
- on:当开启该参数时,结合ONLINE/OFFLINE关键字,有以下三种情况:
- ALTER TABLE或VACUUM语句不使用ONLINE或OFFLINE关键字时,DDL或VACUUM以在线方式执行;此时,若ALTER TABLE或VACUUM语句中包含当前特性不支持的场景时,DDL或VACUUM以离线方式执行。
- ALTER TABLE或VACUUM语句使用ONLINE关键字时,DDL或VACUUM以在线方式执行;此时,若ALTER TABLE或VACUUM语句中包含当前特性不支持的场景时,DDL或VACUUM以离线方式执行,并通过NOTICE提示忽略ONLINE关键字。
- ALTER TABLE或VACUUM语句使用OFFLINE关键字时,DDL或VACUUM以离线方式执行。
- off:当关闭该参数时,结合ONLINE/OFFLINE关键字,有以下三种情况:
- ALTER TABLE或VACUUM不使用ONLINE或OFFLINE关键字时,DDL或VACUUM以离线方式执行。
- ALTER TABLE或VACUUM语句使用ONLINE关键字时,DDL或VACUUM以在线方式执行;此时,若ALTER TABLE或VACUUM语句中包含当前特性不支持的场景时,DDL或VACUUM以离线方式执行,并通过NOTICE提示忽略ONLINE关键字。
- ALTER TABLE或VACUUM语句使用OFFLINE关键字时,DDL或VACUUM以离线方式执行。
默认值:off
设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
设置建议:
- 此参数用于支持在线DDL 505.2新增特性,设置此参数开启数据库操作遵循相应约束(请参见《特性描述》中“高可用性 > 在线DDL”章节)。请根据相应约束判断是否打开此参数。
- 建议保持此参数关闭,需要使用在线DDL 505.2新增特性可在语法里加ONLINE关键字。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。