CREATE QUOTA

Creates a quota that can be assigned to a user or a role.

Syntax:

  1. CREATE QUOTA [IF NOT EXISTS | OR REPLACE] name [ON CLUSTER cluster_name]
  2. [KEYED BY {'none' | 'user name' | 'ip address' | 'client key' | 'client key or user name' | 'client key or ip address'}]
  3. [FOR [RANDOMIZED] INTERVAL number {SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR}
  4. {MAX { {QUERIES | ERRORS | RESULT ROWS | RESULT BYTES | READ ROWS | READ BYTES | EXECUTION TIME} = number } [,...] |
  5. NO LIMITS | TRACKING ONLY} [,...]]
  6. [TO {role [,...] | ALL | ALL EXCEPT role [,...]}]

ON CLUSTER clause allows creating quotas on a cluster, see Distributed DDL.

Example

Limit the maximum number of queries for the current user with 123 queries in 15 months constraint:

  1. CREATE QUOTA qA FOR INTERVAL 15 MONTH MAX QUERIES 123 TO CURRENT_USER