UNSET
引入或更新于:v1.2.605
将一个或多个系统设置恢复到其全局或默认级别和值。有关设置级别的更多信息,请参阅设置级别。要显示所有当前设置,请使用SHOW SETTINGS。
另请参阅:SET
语法
-- 取消一个设置
UNSET [ SESSION | GLOBAL ] <setting_name>
-- 取消多个设置
UNSET [ SESSION | GLOBAL ] ( <setting_name>, <setting_name> ... )
参数 | 描述 |
---|---|
SESSION | 如果设置具有全局级别值,则移除会话级别覆盖并恢复到全局设置。如果设置仅具有会话级别值,则恢复到默认设置。 |
GLOBAL | 移除全局级别设置并将其恢复到默认级别值。 |
注意
Databend-Query 版本 | 描述 |
---|---|
[-∞, v1.2.605) | 默认情况下,UNSET <setting_name> 等同于 UNSET GLOBAL <setting_name> 。 |
[v1.2.605, +∞] | 默认情况下,UNSET <setting_name> 等同于 UNSET SESSION <setting_name> 。 |
示例
此示例使用 UNSET GLOBAL
移除时区的全局级别设置,将其恢复回默认值和级别:
SHOW SETTINGS LIKE 'timezone';
┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ name │ value │ default │ range │ level │ description │ type │
├──────────┼────────┼─────────┼─────────────────────────────────────────────────────────────────────┼─────────┼────────────────────┼────────┤
│ timezone │ UTC │ UTC │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ DEFAULT │ 设置时区。 │ String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-- 在全局级别将时区设置为 'Asia/Shanghai'
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 │ 设置时区。 │ String │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-- 移除时区的全局级别设置
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 │ 设置时区。 │ String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
此示例使用 UNSET SESSION
移除时区的会话级别设置,将其恢复回全局级别设置:
SHOW SETTINGS LIKE 'timezone';
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── ───────────┐
│ name │ value │ default │ range │ level │ description │ type │
├──────────┼────────┼─────────┼─────────────────────────────────────────────────────────────────────┼─────────┼────────────────────┼────────┤
│ timezone │ UTC │ UTC │ ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa... │ DEFAULT │ 设置时区。 │ String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-- 在全局级别将时区设置为 'Asia/Shanghai'
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 │ 设置时区。 │ String │
└──────────────────────────────────────────────────────────────────────────────────────────────────────── ─────────────────────────────────────────┘
-- 在当前会话中将时区设置为 'America/Santiago'
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 │ 设置时区。 │ String │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
UNSET SESSION timezone;
SHOW SETTINGS LIKE 'timezone';
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ name │ value │ default │ range │ level │ description │ type │