设置配置文件
设置配置文件是一组以相同名称分组的设置。
注意
ClickHouse 还支持使用SQL 驱动的流程来管理设置配置文件。我们建议使用它。
配置文件可以具有任何名称。您可以为不同的用户指定相同的配置文件。您可以在设置配置文件中编写的最重要内容是readonly=1
,它可确保只读访问。
设置配置文件可以相互继承。要使用继承,请在配置文件中列出的其他设置之前指示一个或多个profile
设置。当在一个设置在不同的配置文件中定义时,使用最后定义的设置。
要应用配置文件中的所有设置,请设置profile
设置。
示例
安装web
配置文件。
SET profile = 'web'
设置配置文件在用户配置文件中声明。这通常是users.xml
。
示例
<!-- Settings profiles -->
<profiles>
<!-- Default settings -->
<default>
<!-- The maximum number of threads when running a single query. -->
<max_threads>8</max_threads>
</default>
<!-- Settings for queries from the user interface -->
<web>
<max_rows_to_read>1000000000</max_rows_to_read>
<max_bytes_to_read>100000000000</max_bytes_to_read>
<max_rows_to_group_by>1000000</max_rows_to_group_by>
<group_by_overflow_mode>any</group_by_overflow_mode>
<max_rows_to_sort>1000000</max_rows_to_sort>
<max_bytes_to_sort>1000000000</max_bytes_to_sort>
<max_result_rows>100000</max_result_rows>
<max_result_bytes>100000000</max_result_bytes>
<result_overflow_mode>break</result_overflow_mode>
<max_execution_time>600</max_execution_time>
<min_execution_speed>1000000</min_execution_speed>
<timeout_before_checking_execution_speed>15</timeout_before_checking_execution_speed>
<max_columns_to_read>25</max_columns_to_read>
<max_temporary_columns>100</max_temporary_columns>
<max_temporary_non_const_columns>50</max_temporary_non_const_columns>
<max_subquery_depth>2</max_subquery_depth>
<max_pipeline_depth>25</max_pipeline_depth>
<max_ast_depth>50</max_ast_depth>
<max_ast_elements>100</max_ast_elements>
<max_sessions_for_user>4</max_sessions_for_user>
<readonly>1</readonly>
</web>
</profiles>
此示例指定了两个配置文件:default
和web
。
default
配置文件具有特殊用途:它必须始终存在,并在启动服务器时应用。换句话说,default
配置文件包含默认设置。
web
配置文件是一个常规配置文件,可以使用SET
查询或使用 HTTP 查询中的 URL 参数来设置。