CREATE QUOTA

Documentation de QUOTA

Crée un quota pouvant être attribué à un utilisateur ou à un rôle.

Syntaxe :

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 [,...]}]

Les clés user_name, ip_address, forwarded_ip_address, client_key, client_key, user_name, client_key, ip_address et normalized_query_hash correspondent aux champs de la table system.quotas.

Les options IPV4_PREFIX_BITS et IPV6_PREFIX_BITS ne peuvent être utilisées que lorsque KEYED BY vaut ip_address ou forwarded_ip_address. Elles correspondent au champ de la table system.quotas.

Les paramètres 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 correspondent aux champs de la table system.quotas_usage.

La clause ON CLUSTER permet de créer des quotas sur un cluster, voir Distributed DDL.

CREATE QUOTA nécessite le privilège CREATE QUOTA. OR REPLACE supprime un quota existant portant le même nom, y compris les rôles auxquels il s’applique ; il nécessite donc en plus le privilège DROP QUOTA. Le privilège DROP QUOTA est requis que le quota existe déjà ou non, de sorte que cette instruction ne permet pas de déterminer quels quotas existent.

Exemples

Limitez à 123 le nombre maximal de requêtes pour l’utilisateur actuel, avec une contrainte de 15 mois :

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

Pour l’utilisateur default, limitez le temps d’exécution maximal à une demi-seconde sur une période de 30 minutes, et limitez le nombre maximal de requêtes à 321 ainsi que le nombre maximal d’erreurs à 10 sur 5 quarts d’heure :

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

Créez un quota dans lequel chaque modèle de requête normalisé distinct se voit attribuer son propre compteur, limité à 100 exécutions par heure :

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

Limitez chaque modèle de requête normalisé à 50 exécutions maximum par heure (quel que soit le type de clé de quota) :

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

D’autres exemples utilisant la configuration XML (non prise en charge dans ClickHouse Cloud) sont disponibles dans le guide des quotas.

​

Articles connexes

• Blog : Créer des applications monopage avec ClickHouse