2.7 KiB
| toc_priority | toc_title |
|---|---|
| 42 | Квота |
CREATE QUOTA
Создает квоту, которая может быть присвоена пользователю или роли.
Синтаксис:
CREATE QUOTA [IF NOT EXISTS | OR REPLACE] name [ON CLUSTER cluster_name]
[KEYED BY {NONE | USER_NAME | IP_ADDRESS | CLIENT_KEY | CLIENT_KEY, USER_NAME | CLIENT_KEY, IP_ADDRESS} | NOT KEYED]
[FOR [RANDOMIZED] INTERVAL number {SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR}
{MAX { {QUERIES | ERRORS | RESULT_ROWS | RESULT_BYTES | READ_ROWS | READ_BYTES | EXECUTION_TIME} = number } [,...] |
NO LIMITS | TRACKING ONLY} [,...]]
[TO {role [,...] | ALL | ALL EXCEPT role [,...]}]
В секции ON CLUSTER можно указать кластеры, на которых создается квота, см. Распределенные DDL запросы.
Поддерживаются два варианта написания составных типов ключей: с подчеркиванием (CLIENT_KEY) или через пробел и в одинарных кавычках ('client key'). Также можно использовать ключ 'client key or user name' вместо CLIENT_KEY, USER_NAME, и ключ 'client key or ip address' вместо CLIENT_KEY, IP_ADDRESS.
Поддерживаются также два варианта написания составных типов ресурсов: с подчеркиванием (RESULT_ROWS) или без подчеркивания, через пробел (RESULT ROWS).
Примеры
Ограничить максимальное количество запросов для текущего пользователя — не более 123 запросов за каждые 15 месяцев:
CREATE QUOTA qA FOR INTERVAL 15 MONTH MAX QUERIES 123 TO CURRENT_USER;
Ограничить по умолчанию максимальное время выполнения запроса — не более полсекунды за каждые 30 минут, а также максимальное число запросов — не более 321 и максимальное число ошибок — не более 10 за каждые 5 кварталов:
CREATE QUOTA qB FOR INTERVAL 30 MINUTE MAX EXECUTION_TIME = 0.5, FOR INTERVAL 5 QUATER MAX QUERIES = 321, ERRORS = 10 TO default;