Delete one or more user accounts. Understand how to remove users and their associated privileges from the database system safely.
DROP USER [IF EXISTS] user_name [, user_name] ... [FORCE]DROP USER [IF EXISTS] user_name [, user_name] ...The DROP USER statement removes one or more MariaDB accounts. It removes privilege rows for the account from all grant tables. To use this statement, you must have the global privilege or the privilege for the mysql database. Each account is named using the same format as for the CREATE USER statement; for example, 'jeffrey'@'localhost'. If you specify only the user name part of the account name, a host name part of '%' is used. For additional information about specifying account names, see .
If you specify an account that is currently connected, it is not deleted until the connection is closed. The connection is not automatically closed. The statement completes with a warning:
In , if a user is connected, the DROP USER statement fails with an error:
Use the FORCE clause to forcibly close connections of the users named in the DROP USER statement. This ends connections, and immediately deletes the users.
If you specify an account that is currently connected, it is not deleted until the connection is closed. The connection is not automatically closed.
However, a deleted user cannot initiate new connections any more.
If any of the specified user accounts do not exist, ERROR 1396 (HY000) results. If an error occurs, DROP USER still drops the accounts that do not result in an error. Only one error is produced for all users which have not been dropped:
Failed CREATE or DROP operations, for both users and roles, produce the same error.
If the IF EXISTS clause is used, MariaDB returns a note instead of an error if the user does not exist.
The CREATE USER statement creates new MariaDB accounts. To use it, you must have the global privilege or the privilege for the database.
If the IF EXISTS clause is used, MariaDB returns a note instead of an error if the user does not exist.
IF EXISTS:
This page is licensed: GPLv2, originally from
Dropped users 'user'@'host[,...]' have active connections. Use KILL CONNECTION if they should not be used anymore.Operation DROP USER failed for 'foo'@'localhost'.ERROR 1396 (HY000): Operation DROP USER failed for 'u1'@'%','u2'@'%'DROP USER bob;
DROP USER foo2@localhost,foo2@'127.%';DROP USER bob;
ERROR 1396 (HY000): Operation DROP USER failed for 'bob'@'%'
DROP USER IF EXISTS bob;
Query OK, 0 rows affected, 1 warning (0.00 sec)
SHOW WARNINGS;
+-------+------+---------------------------------------------+
| Level | Code | Message |
+-------+------+---------------------------------------------+
| Note | 1974 | Can't drop user 'bob'@'%'; it doesn't exist |
+-------+------+---------------------------------------------+