UNSET

将一个或多个系统设置恢复为其全局或默认级别及值。有关设置级别的更多信息，请参阅 设置级别。要显示所有当前设置，请使用 SHOW SETTINGS。

另请参阅：SET

语法

-- Unset one setting
UNSET [ SESSION | GLOBAL ] <setting_name>

-- Unset multiple settings
UNSET [ SESSION | GLOBAL ] ( <setting_name>, <setting_name> ... )

示例

以下示例使用 UNSET GLOBAL 移除 timezone 的全局级别设置，使其恢复为默认值和默认级别：

SHOW SETTINGS LIKE 'timezone';

┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │  value │ default │                                range                                │  level  │     description    │  type  │
├──────────┼────────┼─────────┼─────────────────────────────────────────────────────────────────────┼─────────┼────────────────────┼────────┤
│ timezone │ UTC    │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ DEFAULT │ Sets the timezone. │ String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

-- Sets timezone to 'Asia/Shanghai' at global level
SET GLOBAL timezone = 'Asia/Shanghai';
SHOW SETTINGS LIKE 'timezone';

┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │     value     │ default │                                range                                │  level │     description    │  type  │
├──────────┼───────────────┼─────────┼─────────────────────────────────────────────────────────────────────┼────────┼────────────────────┼────────┤
│ timezone │ Asia/Shanghai │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ GLOBAL │ Sets the timezone. │ String │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

-- Removes the global-level setting for timezone
UNSET GLOBAL timezone;
SHOW SETTINGS LIKE 'timezone';

┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │  value │ default │                                range                                │  level  │     description    │  type  │
├──────────┼────────┼─────────┼─────────────────────────────────────────────────────────────────────┼─────────┼────────────────────┼────────┤
│ timezone │ UTC    │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ DEFAULT │ Sets the timezone. │ String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

以下示例使用 UNSET SESSION 移除 timezone 的会话级别设置，使其恢复为全局级别设置：

SHOW SETTINGS LIKE 'timezone';

┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │  value │ default │                                range                                │  level  │     description    │  type  │
├──────────┼────────┼─────────┼─────────────────────────────────────────────────────────────────────┼─────────┼────────────────────┼────────┤
│ timezone │ UTC    │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ DEFAULT │ Sets the timezone. │ String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

-- Sets timezone to 'Asia/Shanghai' at global level
SET GLOBAL timezone = 'Asia/Shanghai';
SHOW SETTINGS LIKE 'timezone';
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │     value     │ default │                                range                                │  level │     description    │  type  │
├──────────┼───────────────┼─────────┼─────────────────────────────────────────────────────────────────────┼────────┼────────────────────┼────────┤
│ timezone │ Asia/Shanghai │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ GLOBAL │ Sets the timezone. │ String │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

-- Set timezone to 'America/Santiago' in current session
SET timezone = 'America/Santiago';
SHOW SETTINGS LIKE 'timezone';
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │       value      │ default │                                range                                │  level  │     description    │  type  │
├──────────┼──────────────────┼─────────┼─────────────────────────────────────────────────────────────────────┼─────────┼────────────────────┼────────┤
│ timezone │ America/Santiago │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ SESSION │ Sets the timezone. │ String │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

UNSET SESSION timezone;
SHOW SETTINGS LIKE 'timezone';

┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │     value     │ default │                                range                                │  level │     description    │  type  │
├──────────┼───────────────┼─────────┼─────────────────────────────────────────────────────────────────────┼────────┼────────────────────┼────────┤
│ timezone │ Asia/Shanghai │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ GLOBAL │ Sets the timezone. │ String │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

以下示例使用 UNSET SESSION 移除 timezone 的会话级别设置，使其恢复为会话级别设置：

SHOW SETTINGS LIKE 'timezone';

┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │     value     │ default │                                range                                │  level │     description    │  type  │
├──────────┼───────────────┼─────────┼─────────────────────────────────────────────────────────────────────┼────────┼────────────────────┼────────┤
│ timezone │ Asia/Shanghai │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ GLOBAL │ Sets the timezone. │ String │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

UNSET timezone;

SHOW SETTINGS LIKE 'timezone';

┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│   name   │  value │ default │                                range                                │  level  │     description    │  type  │
├──────────┼────────┼─────────┼─────────────────────────────────────────────────────────────────────┼─────────┼────────────────────┼────────┤
│ timezone │ UTC    │ UTC     │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ DEFAULT │ Sets the timezone. │ String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘