15.7.2.2 CREATE RESOURCE GROUP Statement — MySQL 8.4

15.7.2.2 Оператор CREATE RESOURCE GROUP

CREATE RESOURCE GROUP group_name
    TYPE = {SYSTEM|USER}
    [VCPU [=] vcpu_spec [, vcpu_spec] ...]
    [THREAD_PRIORITY [=] N]
    [ENABLE|DISABLE]

vcpu_spec: {N | M - N}

CREATE RESOURCE GROUP используется для управления группами ресурсов (см. Раздел 7.1.16, «Группы ресурсов»). Этот оператор создаёт новую группу ресурсов и назначает её начальные значения атрибутов. Он требует привилегии RESOURCE_GROUP_ADMIN.

group_name определяет, какую группу ресурсов создать. Если группа уже существует, возникает ошибка.

Атрибут TYPE обязателен. Он должен быть SYSTEM для системной группы ресурсов и USER для пользовательской группы ресурсов. Тип группы влияет на разрешённые THREAD_PRIORITY значения, как описано ниже.

Атрибут VCPU указывает сродство с процессорами; то есть, набор виртуальных процессоров, которые может использовать группа:

Если VCPU не указано, группа ресурсов не имеет сродства с процессорами и может использовать все доступные процессоры.
Если VCPU указано, значение атрибута представляет собой список номеров или диапазонов процессоров, разделённых запятыми:
- Каждый номер должен быть целым числом в диапазоне от 0 до числа процессоров − 1. Например, на системе с 64 процессорами, число может быть от 0 до 63.
- Диапазон задаётся в форме M − N, где M меньше или равно N, и оба числа находятся в диапазоне процессоров.
- Если номер процессора — целое число вне допустимого диапазона или не целое число, возникает ошибка.

Примеры VCPU спецификаторов (они все эквивалентны):

VCPU = 0,1,2,3,9,10
VCPU = 0-3,9-10
VCPU = 9,10,0-3
VCPU = 0,10,1,9,3,2

Атрибут THREAD_PRIORITY указывает приоритет для потоков, назначенных группе:

Если THREAD_PRIORITY не указано, по умолчанию приоритет равен 0.
Если THREAD_PRIORITY указано, значение атрибута должно быть в диапазоне от -20 (наивысший приоритет) до 19 (наименьший приоритет). Приоритет для системных групп ресурсов должен быть в диапазоне от -20 до 0. Приоритет для пользовательских групп ресурсов должен быть в диапазоне от 0 до 19. Использование разных диапазонов для системных и пользовательских групп гарантирует, что приоритет пользовательских потоков никогда не будет выше, чем приоритет системных потоков.

ENABLE и DISABLE указывают, что группа ресурсов изначально включена или выключена. Если ни один из них не указан, по умолчанию группа включена. К выключенной группе нельзя назначать потоки.

Примеры:

Создать включённую пользовательскую группу с одним процессором и наименьшим приоритетом:
```
CREATE RESOURCE GROUP rg1
  TYPE = USER
  VCPU = 0
  THREAD_PRIORITY = 19;
```
Создать выключенную системную группу без сродства с процессорами (может использовать все процессоры) и наивысшим приоритетом:
```
CREATE RESOURCE GROUP rg2
  TYPE = SYSTEM
  THREAD_PRIORITY = -20
  DISABLE;
```

Управление группами ресурсов локально для сервера, на котором оно выполняется. CREATE RESOURCE GROUP операторы не записываются в бинарный журнал и не реплицируются.