CREATE QUOTA — クォータの作成

ユーザーまたはロールに割り当てることができるクォータを作成します。

構文:

CREATE QUOTA [IF NOT EXISTS | OR REPLACE] name [ON CLUSTER cluster_name]
    [IN access_storage_type]
    [KEYED BY {user_name | ip_address | client_key | client_key,user_name | client_key,ip_address | normalized_query_hash} | NOT KEYED]
    [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 [,...]}]

キー user_name、ip_address、client_key、client_key, user_name、client_key, ip_address、normalized_query_hash は、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 句を使用すると、クラスタ全体に対してクォータを作成できます。詳細は Distributed DDL を参照してください。

例

現在のユーザーのクエリ数を、15 か月間で最大 123 件に制限します。

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

デフォルトユーザーに対して、30分あたりの最大実行時間を0.5秒に制限し、さらに5四半期の期間に実行できるクエリ数の上限を321件、エラー数の上限を10件に設定します。

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

個々の正規化クエリパターンごとに個別の枠が設けられ、1時間あたり100回まで実行できるクォータを作成します:

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

単一の正規化クエリパターンごとに、実行回数を1時間あたり最大50回に制限します (クォータキーの型に関係なく) :

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

XML 設定 (ClickHouse Cloud ではサポートされていません) を使用したさらなる例は、Quotas ガイドを参照してください。

関連コンテンツ

• ブログ記事: ClickHouse を使用したシングルページアプリケーションの構築