セッションのログインおよびランタイムのプロパティに基づき、SET_CONSUMER_GROUP_MAPPING プロシージャは、セッションをリソースグループにマッピングするエントリを追加、削除、または変更します。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING(
attribute IN VARCHAR2,
value IN VARCHAR2,
consumer_group IN VARCHAR2 DEFAULT NULL);
パラメータ説明
パラメータ |
説明 |
|---|---|
| attribute | 追加または変更するマッピングプロパティ。現在のバージョンでは、USER(データベースのユーザー名)、COLUMN プロパティ値、および FUNCTION のみがサポートされています。OceanBaseデータベースのバックグラウンドで実行されるマージ・ダンプ、バックアップ・リカバリ、データ補完などのタスクは、マクロレベルではユーザー範囲に属さず、タスク実行時に他のユーザーやタスクの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