Skip to main content
Создаёт QUOTA, которую можно назначить пользователю или роли. Синтаксис:
Ключи user_name, ip_address, forwarded_ip_address, client_key, client_key, user_name, client_key, ip_address и normalized_query_hash соответствуют полям таблицы system.quotas. Параметры IPV4_PREFIX_BITS и IPV6_PREFIX_BITS можно использовать только когда KEYED BY имеет значение ip_address или forwarded_ip_address. Они соответствуют полю таблицы system.quotas. Параметры queries, query_selects, query_inserts, errors, result_rows, result_bytes, read_rows, read_bytes, written_bytes, execution_time, failed_sequential_authentications, queries_per_normalized_hash соответствуют полям таблицы system.quotas_usage. Предложение ON CLUSTER позволяет создавать QUOTA в кластере, см. распределённый DDL. Для CREATE QUOTA требуется привилегия CREATE QUOTA. OR REPLACE удаляет существующую QUOTA с тем же именем, включая список ролей, к которым она применяется, поэтому дополнительно требуется привилегия DROP QUOTA. Привилегия DROP QUOTA требуется независимо от того, существует ли уже такая QUOTA, поэтому этот оператор нельзя использовать для выяснения того, какие QUOTA существуют. Примеры Ограничьте максимальное количество запросов для текущего пользователя условием: 123 запроса за 15 месяцев:
Для пользователя по умолчанию установите максимальное время выполнения в полсекунды на интервал в 30 минут, а также ограничьте максимальное число запросов до 321 и максимальное число ошибок до 10 за 5 кварталов:
Создайте QUOTA, в которой для каждого отдельного нормализованного шаблона запроса выделяется собственный бакет с ограничением в 100 выполнений в час:
Ограничьте число выполнений любого отдельного нормализованного шаблона запроса до 50 в час (независимо от типа ключа QUOTA):
Дополнительные примеры с использованием XML-конфигурации (не поддерживается в ClickHouse Cloud) можно найти в руководстве по QUOTA.

См. также

Последнее изменение 26 сентября 2026 г.