CREATE RESOURCE POOL

CREATE RESOURCE POOL создаёт пул ресурсов.

Синтаксис

CREATE RESOURCE POOL <name>
WITH ( <parameter_name> [= <parameter_value>] [, ... ] )

• name - имя создаваемого пула ресурсов. Должно быть уникально. Не допускается запись в виде пути (т.е. не должно содержать /).
• WITH ( <parameter_name> [= <parameter_value>] [, ... ] ) позволяет задать значения параметров, определяющих поведение пула ресурсов.

Параметры

• CONCURRENT_QUERY_LIMIT (Int32) — опциональное поле, задающее количество параллельно выполняющихся запросов в пуле ресурсов. Если значение -1, то ограничений нет. Значение по умолчанию: -1. Допустимые значения: $-1, [0, 2^{31}-1]$.

• QUEUE_SIZE (Int32) — опциональное поле, определяющее размер очереди ожидания. Всего в системе может находиться не более чем $CONCURRENT\_QUERY\_LIMIT + QUEUE\_SIZE$ запросов одновременно. Если значение -1, ограничений нет. Значение по умолчанию: -1. Допустимые значения: $-1, [0, 2^{31}-1]$.

• DATABASE_LOAD_CPU_THRESHOLD (Int32) — опциональное поле, задающее порог загрузки CPU всей базы данных, после которого запросы не отправляются на выполнение и остаются в очереди. Если значение -1, ограничений нет. Значение по умолчанию: -1. Допустимые значения: $-1, [0, 100]$.

• TOTAL_MEMORY_LIMIT_PERCENT_PER_NODE (Double) — опциональное поле, определяющее процент доступной памяти на узле, которую могут использовать все запросы в данном пуле ресурсов. Если значение -1, ограничений нет. Значение по умолчанию: -1. Допустимые значения: $-1, [0, 100]$.

  Если лимит задан и суммарное потребление памяти запросами в пуле достигает этого лимита:

  • Новые запросы, которым требуется память, завершатся с ошибкой OVERLOADED.
  • Уже выполняющиеся запросы, которым потребуется дополнительная память, также завершатся с ошибкой OVERLOADED.

• TOTAL_CPU_LIMIT_PERCENT_PER_NODE (Double) — опциональное поле, задающее процент доступного CPU, который могут использовать все запросы на узле в данном пуле ресурсов. Если значение -1, ограничений нет. Значение по умолчанию: -1. Допустимые значения: $-1, [0, 100]$.

• QUERY_CPU_LIMIT_PERCENT_PER_NODE (Double) — опциональное поле, определяющее процент доступного CPU на узле для одного запроса в пуле ресурсов. Если значение -1, ограничений нет. Значение по умолчанию: -1. Допустимые значения: $-1, [0, 100]$.

• RESOURCE_WEIGHT (Int32) — опциональное поле, задающее веса для распределения ресурсов между пулами. Если значение -1, веса не используются. Значение по умолчанию: -1. Допустимые значения: $-1, [0, 2^{31}-1]$.

Замечания

Запросы всегда выполняются в каком-либо пуле ресурсов. По умолчанию все запросы отправляются в пул ресурсов default, который создаётся автоматически и не может быть удалён — он всегда присутствует в системе.

Если для параметра CONCURRENT_QUERY_LIMIT установить значение 0, то все запросы, отправленные в этот пул, будут немедленно завершены со статусом PRECONDITION_FAILED.

Разрешения

Требуется разрешение CREATE TABLE на директорию .metadata/workload_manager/pools, пример выдачи такого разрешения:

GRANT 'CREATE TABLE' ON `.metadata/workload_manager/pools` TO `user1@domain`;

CREATE RESOURCE POOL olap WITH (
    CONCURRENT_QUERY_LIMIT=20,
    QUEUE_SIZE=1000,
    DATABASE_LOAD_CPU_THRESHOLD=80,
    RESOURCE_WEIGHT=100,
    TOTAL_MEMORY_LIMIT_PERCENT_PER_NODE=80,
    TOTAL_CPU_LIMIT_PERCENT_PER_NODE=70
)

В примере выше создаётся пул ресурсов со следующими ограничениями:

• Максимальное число параллельных запросов — 20.
• Максимальный размер очереди ожидания — 1000.
• При достижении загрузки базы данных в 80%, запросы перестают запускаться параллельно.
• Все запросы в пуле суммарно могут потребить не более 80% доступной памяти на узле.
• Общее ограничение на доступный CPU для всех запросов в пуле на узле составляет 70%.
• Пул ресурсов имеет вес 100, который начинает работать только в случае переподписки.

См. также

• Workload Manager — управление потреблением ресурсов
• ALTER RESOURCE POOL
• DROP RESOURCE POOL