SHUTDOWN Privilege
This page is part of MariaDB's Documentation.
The parent of this page is: Privileges for MariaDB Xpand
Topics on this page:
Overview
Grants ability to shut down the server by executing SHUTDOWN, but MariaDB recommends using "clx dbstop" instead.
DETAILS
Scope: Global
Privilege name for
GRANT:SHUTDOWNPrivilege name for
REVOKE:SHUTDOWNPrivilege shown by
SHOW GRANTS:SHUTDOWN
EXAMPLES
GRANT
The following examples demonstrate grant of a single privilege. A single GRANT statement can grant multiple privileges at the same scope by providing a comma-separated list of the privileges.
To grant the SHUTDOWN privilege at global scope, replace the user specification ('USERNAME'@'HOSTNAME') in the following query to align to your requirements:
GRANT SHUTDOWN
ON *.*
TO 'USERNAME'@'HOSTNAME';
REVOKE
The following examples demonstrate revoke of a single previously-granted privilege. A single REVOKE statement can revoke multiple privileges at the same scope by providing a comma-separated list of the privileges.
To revoke the SHUTDOWN privilege at global scope, replace the user specification ('USERNAME'@'HOSTNAME') in the following query to align to your requirements:
REVOKE SHUTDOWN
ON *.*
FROM 'USERNAME'@'HOSTNAME';
SHOW Output
A user's privileges can be displayed using the SHOW GRANTS statement.
If the SHUTDOWN privilege is present, it will be shown as SHUTDOWN in the output. For example:
SHOW GRANTS FOR 'app_user'@'192.0.2.%';
+-------------------------------------------------+
| Grants for app_user@192.0.2.% |
+-------------------------------------------------+
| GRANT SHUTDOWN ON *.* TO 'app_user'@'192.0.2.%' |
+-------------------------------------------------+
Privilege Failure
An error message is raised if an operation fails due to insufficient privileges. For example:
SHUTDOWN ALL;
ERROR 1045 (HY000): [11281] Permission denied: User 'USERNAME'@'HOSTNAME' is missing SHUTDOWN on *.*; transaction aborted
Instead of using the SHUTDOWN privilege, MariaDB recommends using clx dbstop to shutdown MariaDB Xpand.