GRANT語法用于給授予指定權限,例如表的讀寫權限、數據庫的所有權限等。
適用引擎
GRANT語法適用于寬表引擎和時序引擎。無版本限制。
語法
grant_permission_statement ::= GRANT privilege_definition ON resource_definition TO user_identifier
privilege_definition ::= ALL | READ | WRITE | ADMIN | TRASH | SYSTEM
resource_definition ::= GLOBAL | DATABASE identifier | SCHEMA identifier | TABLE identifier
使用說明
GRANT語句是否可以執行成功,還取決于執行者自身擁有的權限。
權限(privilege_definition)
共以下幾種權限:
權限 | 說明 |
ALL或ALL PRIVILEGE | 為用戶授予所有權限,包括下述四種權限。 |
READ | 為用戶授予“讀”權限。 |
WRITE | 為用戶授予“寫”權限。 |
ADMIN | 為用戶授予“管理員”權限。 重要 ADMIN權限與READ、WRITE權限是獨立的,授予了某個Database的ADMIN權限并不意味著就能夠讀寫該Database下所有的表,需單獨添加表的讀寫權限。 |
TRASH | 為用戶授予“刪除”權限。 |
SYSTEM | 為用戶授予集群層面的管理權限。包含GLOBAL ADMIN權限。 重要 不支持授予DATABASE粒度的SYSTEM權限。 |
權限范圍(resource_definition)
寬表引擎和時序引擎對GRANT
語句可授權的資源范圍的支持情況如下:
權限 | 寬表引擎 | 時序引擎 | 說明 |
GLOBAL | 〇 | 〇 | 授予全局所有資源的特定權限。 重要 建議不要輕易賦予GLOBAL權限,特別是GLOBAL ALL PRIVILEGES。 |
DATABASE | 〇 | 〇 | 授予指定Database的某個權限。作用等同于SCHEMA。 說明 寬表引擎2.5.3.3及以上版本支持 |
TABLE | 〇 | ?? | 授予指定表的某個權限。 |
權限資源范圍的優先級:GLOBAL > DATABASE(SCHEMA)> TABLE。即如果擁有了GLOBAL的READ權限,則能讀取任意Database中的表。
在使用DATABASE、SCHEMA或TABLE關鍵字時,需添加對應級別的對象名稱(identifier)。例如DATABASE default
、SCHEMA default
、TABLE test
分別表示數據庫default和表test。
授權對象(user_identifier)
user_identifier為需要授權的用戶名。
示例
授予全部權限
為用戶user1授予數據庫db1的全部權限。
GRANT ALL ON DATABASE db1 TO user1;
-- 或者
GRANT ALL ON SCHEMA db1 TO user1;
授予指定權限
為用戶user2授予數據庫db2中的表table2的管理員權限。
GRANT ADMIN ON TABLE db2.table2 TO user2;
為用戶user3授予當前數據庫中表table3的寫權限。
GRANT WRITE ON TABLE table3 TO user3;
為用戶user4授予全局讀權限。
GRANT READ ON GLOBAL TO user4;