Help wanted!

The following content of this documentation page has been machine-translated. But unlike other websites, it is not done on the fly. This translated text lives on GitHub repository alongside main ClickHouse codebase and waits for fellow native speakers to make it more human-readable. You can also use the original English version as a reference.

Help ClickHouse documentation by editing this page

设置配置文件

设置配置文件是以相同名称分组的设置的集合。

信息

ClickHouse还支持 SQL驱动的工作流 用于管理设置配置文件。 我们建议使用它。

配置文件可以有任何名称。 配置文件可以有任何名称。 您可以为不同的用户指定相同的配置文件。 您可以在设置配置文件中编写的最重要的事情是 readonly=1，这确保只读访问。

设置配置文件可以彼此继承。 要使用继承，请指示一个或多个 profile 配置文件中列出的其他设置之前的设置。 如果在不同的配置文件中定义了一个设置，则使用最新定义。

要应用配置文件中的所有设置，请设置 profile 设置。

示例:

安装 web 侧写

  1. SET profile = 'web'

设置配置文件在用户配置文件中声明。 这通常是 users.xml.

示例:

  1. <!-- Settings profiles -->
  2. <profiles>
  3.     <!-- Default settings -->
  4.     <default>
  5.         <!-- The maximum number of threads when running a single query. -->
  6.         <max_threads>8</max_threads>
  7.     </default>
  9.     <!-- Settings for quries from the user interface -->
  10.     <web>
  11.         <max_rows_to_read>1000000000</max_rows_to_read>
  12.         <max_bytes_to_read>100000000000</max_bytes_to_read>
  14.         <max_rows_to_group_by>1000000</max_rows_to_group_by>
  15.         <group_by_overflow_mode>any</group_by_overflow_mode>
  17.         <max_rows_to_sort>1000000</max_rows_to_sort>
  18.         <max_bytes_to_sort>1000000000</max_bytes_to_sort>
  20.         <max_result_rows>100000</max_result_rows>
  21.         <max_result_bytes>100000000</max_result_bytes>
  22.         <result_overflow_mode>break</result_overflow_mode>
  24.         <max_execution_time>600</max_execution_time>
  25.         <min_execution_speed>1000000</min_execution_speed>
  26.         <timeout_before_checking_execution_speed>15</timeout_before_checking_execution_speed>
  28.         <max_columns_to_read>25</max_columns_to_read>
  29.         <max_temporary_columns>100</max_temporary_columns>
  30.         <max_temporary_non_const_columns>50</max_temporary_non_const_columns>
  32.         <max_subquery_depth>2</max_subquery_depth>
  33.         <max_pipeline_depth>25</max_pipeline_depth>
  34.         <max_ast_depth>50</max_ast_depth>
  35.         <max_ast_elements>100</max_ast_elements>
  37.         <readonly>1</readonly>
  38.     </web>
  39. </profiles>

该示例指定了两个配置文件: default 和 web.

该 default 配置文件有一个特殊用途：它必须始终存在并在启动服务器时应用。 换句话说， default 配置文件包含默认设置。

该 web 配置文件是一个常规的配置文件，可以使用设置 SET 查询或在HTTP查询中使用URL参数。