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. Допустимые значения: .
  • QUEUE_SIZE (Int32) — опциональное поле, определяющее размер очереди ожидания. Всего в системе может находиться не более чем запросов одновременно. Если значение -1, ограничений нет. Значение по умолчанию: -1. Допустимые значения: .
  • DATABASE_LOAD_CPU_THRESHOLD (Int32) — опциональное поле, задающее порог загрузки CPU всей базы данных, после которого запросы не отправляются на выполнение и остаются в очереди. Если значение -1, ограничений нет. Значение по умолчанию: -1. Допустимые значения: .
  • TOTAL_CPU_LIMIT_PERCENT_PER_NODE (Double) — опциональное поле, задающее процент доступного CPU, который могут использовать все запросы на узле в данном пуле ресурсов. Если значение -1, ограничений нет. Значение по умолчанию: -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,
    TOTAL_CPU_LIMIT_PERCENT_PER_NODE=70
)

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

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

См. также

Предыдущая
CREATE VIEW
Следующая
CREATE RESOURCE POOL CLASSIFIER