---
title: "SET_CONSUMER_GROUP_MAPPING - OceanBase 数据库 V4.3.1 | OceanBase 文档中心"
description: SET_CONSUMER_GROUP_MAPPING 基于会话的登录和运行时的属性， SET_CONSUMER_GROUP_MAPPING 过程用于添加、删除或修改将会话映射到资源组的条目。 功能适用性 该内容仅适用于 OceanBase 数据库企业版。OceanBase 数据库社区版仅提供 MySQL 模式。 语法…
---
切换语言

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

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

# SET_CONSUMER_GROUP_MAPPING

更新时间：2026-04-10 11:58:01

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.1/zh-CN/700.reference/500.sql-reference/300.pl-reference/300.pl-oracle/1400.pl-system-package-oracle/13300.dbms-resource-manager-oracle/800.set-consumer-group-mappingn-directive-oracle.md)  

基于会话的登录和运行时的属性，`SET_CONSUMER_GROUP_MAPPING` 过程用于添加、删除或修改将会话映射到资源组的条目。

#### 功能适用性

该内容仅适用于 OceanBase 数据库企业版。OceanBase 数据库社区版仅提供 MySQL 模式。

## 语法

```sql
DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING(
    attribute        IN VARCHAR2,
    value            IN VARCHAR2,
    consumer_group   IN VARCHAR2 DEFAULT NULL);

```

## 参数说明

| 参数 | 说明 |
| --- | --- |
| attribute | 要添加或修改的映射属性。当前版本仅支持 `USER`（即数据库的用户名）、`COLUMN` 属性值和 `FUNCTION`。由于 OceanBase 数据库后台执行的诸如合并转储、备份恢复和数据补全等任务，由于其宏观上不属于 User 范畴而且在执行任务的时候很可能挤占其他用户和任务的 CPU、IO 资源。因此，针对 OceanBase 数据库不同后台任务可以指定 `FUNCTION` 映射关系，后台任务的资源可以被限制在其对应的资源组内。 |
| value | 要匹配的属性值，包括绝对映射和正则表达式。 |
| consumer_group | 映射的使用组的名称，如果为 `NULL` 则删除映射。 |

## 使用说明

如果指定属性和值不存在映射，则将创建指定使用组的映射。如果指定属性和值的映射已经存在，则映射的使用组将更新为指定的使用组。如果 `consumer_group` 参数为 `NULL`，则来自指定属性和值的任何映射都将被删除。

下表为 OceanBase 数据库中预定义的 `FUNCTION` 资源组映射规则，您可以使用 `DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING` 过程来修改或删除这些映射规则。

| 属性名称 | 取值 | 说明 |
| --- | --- | --- |
| FUNCTION | COMPACTION_HIGH | 对应 `MINI_MERGE` 和 DDL KV Merge 任务。 |
| FUNCTION | COMPACTION_MID | 对应 `MINOR_MERGE` 任务。 |
| FUNCTION | COMPACTION_LOW | 对应 `MAJOR_MERGE` 任务。 |
| FUNCTION | HA_HIGH | 对应复制、Rebuild、恢复任务。 |
| FUNCTION | HA_MID | 对应迁移任务。 |
| FUNCTION | HA_LOW | 对应备份、备份清理等任务。 |
| FUNCTION | DDL | 对应唯一索引校验，删列补数据操作。 |
| FUNCTION | DDL_HIGH | 对应 DDL MemTable 的转储操作。 |

## 示例

```sql
obclient> CALL DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING(
      attribute        => 'COLUMN' ,
      value            => 't2.c3 = 3 for user1',
      consumer_group   => 'group1');
Query OK, 0 rows affected

```

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