---
title: "CREATE ROLE - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: CREATE ROLE 描述 该语句用于创建角色。您可以通过角色来管理权限。 权限要求 新建角色需要当前用户具备 CREATE USER 权限或 CREATE ROLE 权限。有关 OceanBase 数据库权限的详细介绍，请参见 MySQL 模式下的权限分类 。 如果当前租户下系统变量 read_only 的值为 …
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# CREATE ROLE

更新时间：2026-02-23 14:26:37

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/600.sql-statement-of-mysql-mode/2450.create-role-of-mysql-mode.md)  

## 描述

该语句用于创建角色。您可以通过角色来管理权限。

## 权限要求

- 新建角色需要当前用户具备 `CREATE USER` 权限或 `CREATE ROLE` 权限。有关 OceanBase 数据库权限的详细介绍，请参见 [MySQL 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004479241)。
 - 如果当前租户下系统变量 `read_only` 的值为 `1`，即租户为只读模式，则当前用户还需要额外具备 `SUPER` 权限，才能执行 `CREATE ROLE` 语句。

  系统变量 `read_only` 用于设置租户是否为只读模式。默认为 `0`，表示租户为读写模式。有关系统变量 `read_only` 的更多说明，请参见 [read_only](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004478633)。

## 语法

```sql
CREATE ROLE [IF NOT EXISTS] role_name [, role_name ...];

```

## 参数解释

| **参数** | **描述** |
| --- | --- |
| IF NOT EXISTS | 可选项，如果指定该子句，即使要创建的角色在当前租户中已存在，也不会报错，系统会提示一条 Warning 信息；如果不指定，则会报错。 |
| role_name | 指定要创建的角色的名称，同时创建多个角色时，角色名称用英文逗号（`,`）隔开。 |

## 示例

- 创建角色 `role001`。

  ```sql
  obclient [test]> CREATE ROLE role001;

  ```
 - 同时创建角色 `role001` 和 `role002`。

  ```sql
  obclient [test]> CREATE ROLE IF NOT EXISTS role001, role002;

  ```

  返回结果如下：

  ```shell
  Query OK, 0 rows affected, 1 warning

  ```

  使用 `SHOW WARNINGS;` 语句查询 Warning 信息，返回结果如下：

  ```shell
  +-------+------+-----------------------------------------------+
  | Level | Code | Message                                       |
  +-------+------+-----------------------------------------------+
  | Note  | 3163 | Authorization ID 'role001'@'%' already exists |
  +-------+------+-----------------------------------------------+
  1 row in set

  ```

## 相关文档

- [新建角色](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004480427)
 - [向角色中添加权限](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004480424)
 - [将角色授予用户或角色](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004480430)
 - [查看角色](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004480426)
 - [间接授权](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004479238)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
