---
title: "SET ROLE - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: "SET ROLE 描述 该语句用于激活当前登录用户在当前会话（Session）中已被授予的角色。 说明 通过 SET ROLE 语句激活的角色，仅影响当前 Session，不影响之后的 Session。 语法 SET ROLE { DEFAULT | NONE | ALL | ALL EXCEPT role_name…"
---
切换语言

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

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

# SET ROLE

更新时间：2026-07-15 20:42:46

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

## 描述

该语句用于激活当前登录用户在当前会话（Session）中已被授予的角色。

#### 说明

通过 `SET ROLE` 语句激活的角色，仅影响当前 Session，不影响之后的 Session。

## 语法

```sql
SET ROLE {
    DEFAULT
    | NONE
    | ALL
    | ALL EXCEPT role_name [, role_name ...]
    | role_name [, role_name ...]
};

```

## 参数解释

| **参数** | **描述** |
| --- | --- |
| DEFAULT | 指定保持默认角色的设置。系统会根据变量 `activate_all_roles_on_login` 的值以及 `SET DEFAULT ROLE` 语句或 `ALTER USER` 语句设置的默认激活的角色来激活角色：   - 如果变量 `activate_all_roles_on_login` 的值为 `on`，则在会话中激活用户授予的所有角色。 - 如果变量 `activate_all_roles_on_login` 的值为 `off`，则在会话中激活 `SET DEFAULT ROLE` 语句或 `ALTER USER` 语句指定的默认激活的角色。 |
| NONE | 指定停用用户被授予的所有角色。 |
| ALL | 指定激活用户被授予的所有角色。 |
| ALL EXCEPT | 指定不激活用户被授予的角色中的角色。 |
| role_name | 指定角色的名称，激活多个角色时，角色名用英文逗号（`,`）隔开。 |

## 示例

- 指定在当前会话中，激活用户被授予的角色中除了角色 `role001` 以外的其他所有角色。

  ```shell
  obclient [(none)]> SET ROLE ALL EXCEPT role001;

  ```
 - 指定在当前会话中，激活用户的 `role001` 和 `role002` 角色。

  ```shell
  obclient [(none)]> SET ROLE role001, role002;

  ```

## 相关文档

- [激活角色](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002017133)
 - [查看角色](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002017128)
 - [CURRENT_ROLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002017624)

 上一篇 下一篇 ![有帮助](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) 咨询热线