blob: 676d4779f9930bde189b6fc950e6d37c13ada60d [file] [view]
---
{
"title": "UNSET VARIABLE",
"language": "en",
"description": "This statement is used to restore Doris system variables. These system variables can be modified at global or session level."
}
---
## Description
This statement is used to restore Doris system variables. These system variables can be modified at global or session level.
## Syntax
```sql
UNSET [<effective_scope>] VARIABLE (<variable_name>)
```
## Required Parameters
**1. `<variable_name>`**
> Specifies the variable name, or if you want to unset all variables, this parameter you can give a keyword `ALL`.
## Optional Parameters
**1. `<effective_scope>`**
> Effective scope is one of `GLOBAL` or `SESSION` or `LOCAL`. If there is no effective scope, default value is `SESSION`. `LOCAL` is an alias of `SESSION`.
## Access Control Requirements
Users executing this SQL command must have at least the following privileges:
| Privilege | Object | Notes |
| :--------- | :----- | :------------------------------------------- |
| ADMIN_PRIV | Session | unset global variables need admin privilege |
## Usage Notes
- Only ADMIN users can unset variables to take effect globally
- When restore a variable with `GLOBAL`, it only affects your current using session and new open sessions. It does not affect other current open sessions.
## Example
- Restore value of the time zone
```
UNSET VARIABLE time_zone;
```
- Restore the global execution memory size
```
UNSET GLOBAL VARIABLE exec_mem_limit;
```
- Restore all variables globally
```
UNSET GLOBAL VARIABLE ALL;
```