CREATE QUOTA

Documentación de QUOTA

Crea una cuota que se puede asignar a un usuario o a un rol.

Sintaxis:

CREATE QUOTA [IF NOT EXISTS | OR REPLACE] name [ON CLUSTER cluster_name]
    [IN access_storage_type]
    [KEYED BY {user_name | ip_address | forwarded_ip_address | client_key | client_key,user_name | client_key,ip_address | normalized_query_hash} | NOT KEYED]
    [IPV4_PREFIX_BITS number]
    [IPV6_PREFIX_BITS number]
    [FOR [RANDOMIZED] INTERVAL number {second | minute | hour | day | week | month | quarter | year}
        {MAX { {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} = number } [,...] |
         NO LIMITS | TRACKING ONLY} [,...]]
    [TO {role [,...] | ALL | ALL EXCEPT role [,...]}]

Las claves user_name, ip_address, forwarded_ip_address, client_key, client_key, user_name, client_key, ip_address y normalized_query_hash se corresponden con los campos de la tabla system.quotas.

Las opciones IPV4_PREFIX_BITS y IPV6_PREFIX_BITS solo se pueden usar cuando KEYED BY es ip_address o forwarded_ip_address. Se corresponden con el campo de la tabla system.quotas.

Los parámetros 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 se corresponden con los campos de la tabla system.quotas_usage.

La cláusula ON CLUSTER permite crear cuotas en un clúster; consulte Distributed DDL.

CREATE QUOTA requiere el privilegio CREATE QUOTA. OR REPLACE descarta una QUOTA existente con el mismo nombre, incluidos los roles a los que se aplica, por lo que además requiere el privilegio DROP QUOTA. El privilegio DROP QUOTA es necesario tanto si la QUOTA ya existe como si no, de modo que la sentencia no se puede usar para averiguar qué cuotas existen.

Ejemplos

Limite el número máximo de consultas del usuario actual a 123 consultas en un período de 15 meses:

CREATE QUOTA qA FOR INTERVAL 15 month MAX queries = 123 TO CURRENT_USER;

Para el usuario predeterminado, limite el tiempo máximo de ejecución a medio segundo en un período de 30 minutos, y limite el número máximo de consultas a 321 y el número máximo de errores a 10 en 5 trimestres:

CREATE QUOTA qB FOR INTERVAL 30 minute MAX execution_time = 0.5, FOR INTERVAL 5 quarter MAX queries = 321, errors = 10 TO default;

Cree una QUOTA en la que cada patrón de consulta normalizado distinto tenga su propio bucket, con un límite de 100 ejecuciones por hora:

CREATE QUOTA qC KEYED BY normalized_query_hash FOR INTERVAL 1 hour MAX queries = 100 TO default;

Limite cada patrón de consulta normalizado a un máximo de 50 ejecuciones por hora (independientemente del tipo de clave de QUOTA):

CREATE QUOTA qD FOR INTERVAL 1 hour MAX queries_per_normalized_hash = 50 TO default;

Puedes encontrar más ejemplos con la configuración XML (no compatible con ClickHouse Cloud) en la guía de cuotas.

​

Contenido relacionado

• Blog: Cómo crear aplicaciones de una sola página con ClickHouse