セッションベースのログインと実行時のプロパティに基づき、SET_CONSUMER_GROUP_MAPPING プロシージャは、セッションをリソースグループにマッピングするエントリを追加、削除、または変更します。
構文
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やI/Oリソースを占有する可能性が高いため、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のダンプ操作に対応します。 |
| FUNCTION | CLOG_HIGH | clogログコミットタスクに対応します。 |
| FUNCTION | OPT_STATS | 統計情報収集タスクに対応します。 |
| FUNCTION | MVIEW | マテリアライズドビューの増分更新、MLOG PurgeのI/O、CPUリソース使用操作に対応します。 |
例
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