ClickHouse の user.xml ファイルは、ユーザーレベルのパラメーター設定、ユーザー情報、および権限を管理します。このトピックでは、ApsaraDB for ClickHouse クラスターの user.xml 構成ファイルを変更する方法について説明します。
背景情報
ApsaraDB for ClickHouse クラスターには複数のパラメーターがあり、そのデフォルト値は config.xml ファイルと user.xml ファイルで設定されています。これらのファイルのパラメーターを変更することで、クラスターのパフォーマンスを最適化できます。
config.xml ファイルのパラメーターは、ApsaraDB for ClickHouse コンソールで変更し、クラスターを再起動することで変更を適用できます。詳細については、「config.xml パラメーターの設定」をご参照ください。
user.xml ファイルのパラメーターを変更するには、クライアントを使用して ApsaraDB for ClickHouse クラスターに接続し、必要なコマンドを実行する必要があります。これらのパラメーターは clickhouse-client を使用して変更することはできません。
前提条件
クラスターが 実行中 の状態であること。
手順
user.xml ファイルの変更方法は、クラスターのエディションによって異なります。
Community-compatible Edition
このセクションでは、Community-compatible Edition クラスターの user.xml ファイルを変更するための構文と例について説明します。
構文
SET GLOBAL ON cluster default <setting_name> = <setting_value>;パラメーターの説明
サポートされているパラメーターのリストについては、「ClickHouse パラメーターリスト」をご参照ください。
setting_value の値がブール値または文字列の場合は、単一引用符 (') で囲みます。
例
例 1：テーブルからデータをロードする際の単一ブロックの最大行数を設定します。
SET GLOBAL ON cluster default max_block_size = 10000;例 2：データ形式に対して、順序を維持した並列解析を有効にします。
SET GLOBAL ON cluster default input_format_parallel_parsing = 'True';パラメーターを表示する
現在のクラスターの user.xml ファイルに設定されているパラメーターを表示できます。
SELECT * FROM system.settings;Enterprise Edition
Enterprise Edition クラスターの user.xml ファイルのパラメーター設定は、Community-compatible Edition クラスターとは異なります。ビジネス要件に合ったステートメントを実行してください。
以下の構文における setting_name、setting_value、および profile_name の値の詳細については、「Core Settings | ClickHouse Docs」および「Restrictions on Query Complexity | ClickHouse Docs」をご参照ください。
一時的に有効なパラメーターの設定
現在のログインセッションのパラメーター設定を変更できます。
これらのパラメーター設定はクラスターに永続化されません。クラスターから切断して再接続すると、設定は無効になります。
構文
SET <setting_name> = <setting_value>;例
現在のセッションのライブビュー機能を有効にします。
SET allow_experimental_live_view = 1;単一アカウントのパラメーターの永続化
クラスター内の単一アカウントに対して、パラメーター、アカウント情報、および権限を設定できます。
以下の SQL 文を実行するには、特権アカウントまたは ACCESS MANAGEMENT 権限を持つアカウントを使用する必要があります。
ALTER USER 文はユーザー構成をリセットします。
これらのパラメーター設定はクラスターに永続化されます。ただし、現在のセッションでは有効になりません。設定を有効にするには、クラスターに再接続する必要があります。
構文
ALTER USER <user_name> SETTINGS <setting_name> = <setting_value>;例
ユーザー Nancy のメモリ使用量を 4 GB に制限します。
ALTER USER Nancy SETTINGS max_memory_usage_for_user = 4294967296;すべてのアカウントのパラメーターの永続化
クラスター内のすべてのアカウントに対して、パラメーター、ユーザー情報、および権限を設定できます。
以下の SQL 文を実行するには、特権アカウントまたは ACCESS MANAGEMENT 権限を持つアカウントを使用する必要があります。
これらのパラメーター設定はクラスターに永続化されます。ただし、現在のセッションでは有効になりません。設定を有効にするには、クラスターに再接続する必要があります。
構文
CREATE SETTINGS PROFILE profile_name SETTINGS <setting_name> = <setting_value> TO ALL;例
すべてのユーザーのクエリ実行時間を 10 秒に制限します。
CREATE SETTINGS PROFILE max_execution_time_profile SETTINGS max_execution_time = 10 TO ALL; パラメーター設定の永続化の確認
構文
SHOW SETTINGS LIKE '%<settings_name>%';例
allow_experimental_live_view パラメーター設定が永続化されているか確認します。
SHOW SETTINGS LIKE '%allow_experimental_live_view%';