INSERT 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 execute INSERT.
DETAILS
Scope: Global, Database, Table
Privilege name for
GRANT:INSERTPrivilege name for
REVOKE:INSERTPrivilege shown by
SHOW GRANTS:INSERT
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 INSERT privilege at global scope, replace the user specification ('USERNAME'@'HOSTNAME') in the following query to align to your requirements:
GRANT INSERT
ON *.*
TO 'USERNAME'@'HOSTNAME';
To grant the INSERT privilege at database scope, replace the user specification ('USERNAME'@'HOSTNAME') and database name (DATABASE_NAME) in the following query to align to your requirements:
GRANT INSERT
ON DATABASE_NAME.*
TO 'USERNAME'@'HOSTNAME';
To grant the INSERT privilege at table scope, replace the user specification ('USERNAME'@'HOSTNAME'), database name (DATABASE_NAME), and table name (TABLE_NAME) in the following query to align to your requirements:
GRANT INSERT
ON DATABASE_NAME.TABLE_NAME
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 INSERT privilege at global scope, replace the user specification ('USERNAME'@'HOSTNAME') in the following query to align to your requirements:
REVOKE INSERT
ON *.*
FROM 'USERNAME'@'HOSTNAME';
To revoke the INSERT privilege at database scope, replace the user specification ('USERNAME'@'HOSTNAME') and database name (DATABASE_NAME) in the following query to align to your requirements:
REVOKE INSERT
ON DATABASE_NAME.*
FROM 'USERNAME'@'HOSTNAME';
To revoke the INSERT privilege at table scope, replace the user specification ('USERNAME'@'HOSTNAME'), database name (DATABASE_NAME), and table name (TABLE_NAME) in the following query to align to your requirements:
REVOKE INSERT
ON DATABASE_NAME.TABLE_NAME
FROM 'USERNAME'@'HOSTNAME';
SHOW Output
A user's privileges can be displayed using the SHOW GRANTS statement.
If the INSERT privilege is present, it will be shown as INSERT in the output. For example:
SHOW GRANTS FOR 'app_user'@'192.0.2.%';
+------------------------------------------------------+
| Grants for app_user@192.0.2.% |
+------------------------------------------------------+
| GRANT INSERT ON `app_db`.* TO 'app_user'@'192.0.2.%' |
+------------------------------------------------------+
Privilege Failure
An error message is raised if an operation fails due to insufficient privileges. For example:
INSERT INTO hq_sales.invoices(invoice_id, branch_id, customer_id , invoice_date, invoice_total, payment_method)
VALUES (1, 3, 6, 010221, 25, 'CREDIT_CARD');
ERROR 1045 (HY000): [11281] Permission denied: User 'USERNAME'@'HOSTNAME' is missing INSERT on `hq_sales`.`invoices`; transaction aborted
