123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787 |
- <?xml version="1.0"?>
- <!--
- NOTE: User and query level settings are set up in "users.xml" file.
- If you have accidentally specified user-level settings here, server won't start.
- You can either move the settings to the right place inside "users.xml" file
- or add <skip_check_for_incorrect_settings>1</skip_check_for_incorrect_settings> here.
- -->
- <clickhouse><logger><!-- Possible levels [1]:
- - none (turns off logging)
- - fatal
- - critical
- - error
- - warning
- - notice
- - information
- - debug
- - trace
- - test (not for production usage)
- [1]: https://github.com/pocoproject/poco/blob/poco-1.9.4-release/Foundation/include/Poco/Logger.h#L105-L114
- --><level>trace</level><!-- Rotation policy
- See https://github.com/pocoproject/poco/blob/poco-1.9.4-release/Foundation/include/Poco/FileChannel.h#L54-L85
- --><size>1000M</size><count>10</count><!-- <console>1</console> --><!-- Default behavior is autodetection (log to console if not daemon mode and is tty) --><!-- Per level overrides (legacy):
- For example to suppress logging of the ConfigReloader you can use:
- NOTE: levels.logger is reserved, see below.
- --><!--
- <levels>
- <ConfigReloader>none</ConfigReloader>
- </levels>
- --><!-- Per level overrides:
- For example to suppress logging of the RBAC for default user you can use:
- (But please note that the logger name maybe changed from version to version, even after minor upgrade)
- --><!--
- <levels>
- <logger>
- <name>ContextAccess (default)</name>
- <level>none</level>
- </logger>
- <logger>
- <name>DatabaseOrdinary (test)</name>
- <level>none</level>
- </logger>
- </levels>
- --><!-- Structured log formatting:
- You can specify log format(for now, JSON only). In that case, the console log will be printed
- in specified format like JSON.
- For example, as below:
- {"date_time":"1650918987.180175","thread_name":"#1","thread_id":"254545","level":"Trace","query_id":"","logger_name":"BaseDaemon","message":"Received signal 2","source_file":"../base/daemon/BaseDaemon.cpp; virtual void SignalListener::run()","source_line":"192"}
- To enable JSON logging support, please uncomment the entire <formatting> tag below.
- a) You can modify key names by changing values under tag values inside <names> tag.
- For example, to change DATE_TIME to MY_DATE_TIME, you can do like:
- <date_time>MY_DATE_TIME</date_time>
- b) You can stop unwanted log properties to appear in logs. To do so, you can simply comment out (recommended)
- that property from this file.
- For example, if you do not want your log to print query_id, you can comment out only <query_id> tag.
- However, if you comment out all the tags under <names>, the program will print default values for as
- below.
- --><!-- <formatting>
- <type>json</type>
- <names>
- <date_time>date_time</date_time>
- <thread_name>thread_name</thread_name>
- <thread_id>thread_id</thread_id>
- <level>level</level>
- <query_id>query_id</query_id>
- <logger_name>logger_name</logger_name>
- <message>message</message>
- <source_file>source_file</source_file>
- <source_line>source_line</source_line>
- </names>
- </formatting> --><console>1</console></logger><!-- Add headers to response in options request. OPTIONS method is used in CORS preflight requests. --><!-- It is off by default. Next headers are obligate for CORS.--><!-- http_options_response>
- <header>
- <name>Access-Control-Allow-Origin</name>
- <value>*</value>
- </header>
- <header>
- <name>Access-Control-Allow-Headers</name>
- <value>origin, x-requested-with</value>
- </header>
- <header>
- <name>Access-Control-Allow-Methods</name>
- <value>POST, GET, OPTIONS</value>
- </header>
- <header>
- <name>Access-Control-Max-Age</name>
- <value>86400</value>
- </header>
- </http_options_response --><!-- It is the name that will be shown in the clickhouse-client.
- By default, anything with "production" will be highlighted in red in query prompt.
- --><!--display_name>production</display_name--><!-- Port for HTTP API. See also 'https_port' for secure connections.
- This interface is also used by ODBC and JDBC drivers (DataGrip, Dbeaver, ...)
- and by most of web interfaces (embedded UI, Grafana, Redash, ...).
- --><!-- Port for interaction by native protocol with:
- - clickhouse-client and other native ClickHouse tools (clickhouse-benchmark, clickhouse-copier);
- - clickhouse-server with other clickhouse-servers for distributed query processing;
- - ClickHouse drivers and applications supporting native protocol
- (this protocol is also informally called as "the TCP protocol");
- See also 'tcp_port_secure' for secure connections.
- --><!-- Compatibility with MySQL protocol.
- ClickHouse will pretend to be MySQL for applications connecting to this port.
- --><!-- Compatibility with PostgreSQL protocol.
- ClickHouse will pretend to be PostgreSQL for applications connecting to this port.
- --><!-- HTTP API with TLS (HTTPS).
- You have to configure certificate to enable this interface.
- See the openSSL section below.
- --><!-- <https_port>8443</https_port> --><!-- Native interface with TLS.
- You have to configure certificate to enable this interface.
- See the openSSL section below.
- --><!-- <tcp_port_secure>9440</tcp_port_secure> --><!-- Native interface wrapped with PROXYv1 protocol
- PROXYv1 header sent for every connection.
- ClickHouse will extract information about proxy-forwarded client address from the header.
- --><!-- <tcp_with_proxy_port>9011</tcp_with_proxy_port> --><!-- Port for communication between replicas. Used for data exchange.
- It provides low-level data access between servers.
- This port should not be accessible from untrusted networks.
- See also 'interserver_http_credentials'.
- Data transferred over connections to this port should not go through untrusted networks.
- See also 'interserver_https_port'.
- --><!-- Port for communication between replicas with TLS.
- You have to configure certificate to enable this interface.
- See the openSSL section below.
- See also 'interserver_http_credentials'.
- --><!-- <interserver_https_port>9010</interserver_https_port> --><!-- Hostname that is used by other replicas to request this server.
- If not specified, then it is determined analogous to 'hostname -f' command.
- This setting could be used to switch replication to another network interface
- (the server may be connected to multiple networks via multiple addresses)
- --><!--
- <interserver_http_host>example.clickhouse.com</interserver_http_host>
- --><!-- You can specify credentials for authenthication between replicas.
- This is required when interserver_https_port is accessible from untrusted networks,
- and also recommended to avoid SSRF attacks from possibly compromised services in your network.
- --><!--<interserver_http_credentials>
- <user>interserver</user>
- <password></password>
- </interserver_http_credentials>--><!-- Listen specified address.
- Use :: (wildcard IPv6 address), if you want to accept connections both with IPv4 and IPv6 from everywhere.
- Notes:
- If you open connections from wildcard address, make sure that at least one of the following measures applied:
- - server is protected by firewall and not accessible from untrusted networks;
- - all users are restricted to subset of network addresses (see users.xml);
- - all users have strong passwords, only secure (TLS) interfaces are accessible, or connections are only made via TLS interfaces.
- - users without password have readonly access.
- See also: https://www.shodan.io/search?query=clickhouse
- --><!-- <listen_host>::</listen_host> --><!-- Same for hosts without support for IPv6: --><!-- <listen_host>0.0.0.0</listen_host> --><!-- Default values - try listen localhost on IPv4 and IPv6. --><!--
- <listen_host>::1</listen_host>
- <listen_host>127.0.0.1</listen_host>
- --><!-- <interserver_listen_host>::</interserver_listen_host> --><!-- Listen host for communication between replicas. Used for data exchange --><!-- Default values - equal to listen_host --><!-- Don't exit if IPv6 or IPv4 networks are unavailable while trying to listen. --><!-- <listen_try>0</listen_try> --><!-- Allow multiple servers to listen on the same address:port. This is not recommended.
- --><!-- <listen_reuse_port>0</listen_reuse_port> --><!-- <listen_backlog>4096</listen_backlog> --><max_connections>4096</max_connections><!-- For 'Connection: keep-alive' in HTTP 1.1 --><keep_alive_timeout>3</keep_alive_timeout><!-- gRPC protocol (see src/Server/grpc_protos/clickhouse_grpc.proto for the API) --><!-- <grpc_port>9100</grpc_port> --><grpc><enable_ssl>false</enable_ssl><!-- The following two files are used only if enable_ssl=1 --><ssl_cert_file>/path/to/ssl_cert_file</ssl_cert_file><ssl_key_file>/path/to/ssl_key_file</ssl_key_file><!-- Whether server will request client for a certificate --><ssl_require_client_auth>false</ssl_require_client_auth><!-- The following file is used only if ssl_require_client_auth=1 --><ssl_ca_cert_file>/path/to/ssl_ca_cert_file</ssl_ca_cert_file><!-- Default transport compression type (can be overridden by client, see the transport_compression_type field in QueryInfo).
- Supported algorithms: none, deflate, gzip, stream_gzip --><transport_compression_type>none</transport_compression_type><!-- Default transport compression level. Supported levels: 0..3 --><transport_compression_level>0</transport_compression_level><!-- Send/receive message size limits in bytes. -1 means unlimited --><max_send_message_size>-1</max_send_message_size><max_receive_message_size>-1</max_receive_message_size><!-- Enable if you want very detailed logs --><verbose_logs>false</verbose_logs></grpc><!-- Used with https_port and tcp_port_secure. Full ssl options list: https://github.com/ClickHouse-Extras/poco/blob/master/NetSSL_OpenSSL/include/Poco/Net/SSLManager.h#L71 --><openSSL><server><!-- Used for https server AND secure tcp port --><!-- openssl req -subj "/CN=localhost" -new -newkey rsa:2048 -days 365 -nodes -x509 -keyout /etc/clickhouse-server/server.key -out /etc/clickhouse-server/server.crt --><!-- <certificateFile>/etc/clickhouse-server/server.crt</certificateFile>
- <privateKeyFile>/etc/clickhouse-server/server.key</privateKeyFile> --><!-- dhparams are optional. You can delete the <dhParamsFile> element.
- To generate dhparams, use the following command:
- openssl dhparam -out /etc/clickhouse-server/dhparam.pem 4096
- Only file format with BEGIN DH PARAMETERS is supported.
- --><!-- <dhParamsFile>/etc/clickhouse-server/dhparam.pem</dhParamsFile>--><verificationMode>none</verificationMode><loadDefaultCAFile>true</loadDefaultCAFile><cacheSessions>true</cacheSessions><disableProtocols>sslv2,sslv3</disableProtocols><preferServerCiphers>true</preferServerCiphers></server><client><!-- Used for connecting to https dictionary source and secured Zookeeper communication --><loadDefaultCAFile>true</loadDefaultCAFile><cacheSessions>true</cacheSessions><disableProtocols>sslv2,sslv3</disableProtocols><preferServerCiphers>true</preferServerCiphers><!-- Use for self-signed: <verificationMode>none</verificationMode> --><invalidCertificateHandler><!-- Use for self-signed: <name>AcceptCertificateHandler</name> --><name>RejectCertificateHandler</name></invalidCertificateHandler></client></openSSL><!-- Default root page on http[s] server. For example load UI from https://tabix.io/ when opening http://localhost:8123 --><!--
- <http_server_default_response><![CDATA[<html ng-app="SMI2"><head><base href="http://ui.tabix.io/"></head><body><div ui-view="" class="content-ui"></div><script src="http://loader.tabix.io/master.js"></script></body></html>]]></http_server_default_response>
- --><!-- The maximum number of query processing threads, excluding threads for retrieving data from remote servers, allowed to run all queries.
- This is not a hard limit. In case if the limit is reached the query will still get at least one thread to run.
- Query can upscale to desired number of threads during execution if more threads become available.
- --><concurrent_threads_soft_limit_num>0</concurrent_threads_soft_limit_num><concurrent_threads_soft_limit_ratio_to_cores>0</concurrent_threads_soft_limit_ratio_to_cores><!-- Maximum number of concurrent queries. --><max_concurrent_queries>100</max_concurrent_queries><!-- Maximum memory usage (resident set size) for server process.
- Zero value or unset means default. Default is "max_server_memory_usage_to_ram_ratio" of available physical RAM.
- If the value is larger than "max_server_memory_usage_to_ram_ratio" of available physical RAM, it will be cut down.
- The constraint is checked on query execution time.
- If a query tries to allocate memory and the current memory usage plus allocation is greater
- than specified threshold, exception will be thrown.
- It is not practical to set this constraint to small values like just a few gigabytes,
- because memory allocator will keep this amount of memory in caches and the server will deny service of queries.
- --><max_server_memory_usage>0</max_server_memory_usage><!-- Maximum number of threads in the Global thread pool.
- This will default to a maximum of 10000 threads if not specified.
- This setting will be useful in scenarios where there are a large number
- of distributed queries that are running concurrently but are idling most
- of the time, in which case a higher number of threads might be required.
- --><max_thread_pool_size>10000</max_thread_pool_size><!-- Configure other thread pools: --><!--
- <background_buffer_flush_schedule_pool_size>16</background_buffer_flush_schedule_pool_size>
- <background_pool_size>16</background_pool_size>
- <background_merges_mutations_concurrency_ratio>2</background_merges_mutations_concurrency_ratio>
- <background_merges_mutations_scheduling_policy>round_robin</background_merges_mutations_scheduling_policy>
- <background_move_pool_size>8</background_move_pool_size>
- <background_fetches_pool_size>8</background_fetches_pool_size>
- <background_common_pool_size>8</background_common_pool_size>
- <background_schedule_pool_size>128</background_schedule_pool_size>
- <background_message_broker_schedule_pool_size>16</background_message_broker_schedule_pool_size>
- <background_distributed_schedule_pool_size>16</background_distributed_schedule_pool_size>
- --><!-- On memory constrained environments you may have to set this to value larger than 1.
- --><max_server_memory_usage_to_ram_ratio>0.9</max_server_memory_usage_to_ram_ratio><!-- Simple server-wide memory profiler. Collect a stack trace at every peak allocation step (in bytes).
- Data will be stored in system.trace_log table with query_id = empty string.
- Zero means disabled.
- --><total_memory_profiler_step>4194304</total_memory_profiler_step><!-- Collect random allocations and deallocations and write them into system.trace_log with 'MemorySample' trace_type.
- The probability is for every alloc/free regardless to the size of the allocation.
- Note that sampling happens only when the amount of untracked memory exceeds the untracked memory limit,
- which is 4 MiB by default but can be lowered if 'total_memory_profiler_step' is lowered.
- You may want to set 'total_memory_profiler_step' to 1 for extra fine grained sampling.
- --><total_memory_tracker_sample_probability>0</total_memory_tracker_sample_probability><!-- Set limit on number of open files (default: maximum). This setting makes sense on Mac OS X because getrlimit() fails to retrieve
- correct maximum value. --><!-- <max_open_files>262144</max_open_files> --><!-- Size of cache of uncompressed blocks of data, used in tables of MergeTree family.
- In bytes. Cache is single for server. Memory is allocated only on demand.
- Cache is used when 'use_uncompressed_cache' user setting turned on (off by default).
- Uncompressed cache is advantageous only for very short queries and in rare cases.
- Note: uncompressed cache can be pointless for lz4, because memory bandwidth
- is slower than multi-core decompression on some server configurations.
- Enabling it can sometimes paradoxically make queries slower.
- --><uncompressed_cache_size>8589934592</uncompressed_cache_size><!-- Approximate size of mark cache, used in tables of MergeTree family.
- In bytes. Cache is single for server. Memory is allocated only on demand.
- You should not lower this value.
- --><mark_cache_size>5368709120</mark_cache_size><!-- If you enable the `min_bytes_to_use_mmap_io` setting,
- the data in MergeTree tables can be read with mmap to avoid copying from kernel to userspace.
- It makes sense only for large files and helps only if data reside in page cache.
- To avoid frequent open/mmap/munmap/close calls (which are very expensive due to consequent page faults)
- and to reuse mappings from several threads and queries,
- the cache of mapped files is maintained. Its size is the number of mapped regions (usually equal to the number of mapped files).
- The amount of data in mapped files can be monitored
- in system.metrics, system.metric_log by the MMappedFiles, MMappedFileBytes metrics
- and in system.asynchronous_metrics, system.asynchronous_metrics_log by the MMapCacheCells metric,
- and also in system.events, system.processes, system.query_log, system.query_thread_log, system.query_views_log by the
- CreatedReadBufferMMap, CreatedReadBufferMMapFailed, MMappedFileCacheHits, MMappedFileCacheMisses events.
- Note that the amount of data in mapped files does not consume memory directly and is not accounted
- in query or server memory usage - because this memory can be discarded similar to OS page cache.
- The cache is dropped (the files are closed) automatically on removal of old parts in MergeTree,
- also it can be dropped manually by the SYSTEM DROP MMAP CACHE query.
- --><mmap_cache_size>1000</mmap_cache_size><!-- Cache size in bytes for compiled expressions.--><compiled_expression_cache_size>134217728</compiled_expression_cache_size><!-- Cache size in elements for compiled expressions.--><compiled_expression_cache_elements_size>10000</compiled_expression_cache_elements_size><!-- Path to data directory, with trailing slash. --><path>/bitnami/clickhouse/data</path><!-- Multi-disk configuration example: --><!--
- <storage_configuration>
- <disks>
- <default>
- <keep_free_space_bytes>0</keep_free_space_bytes>
- </default>
- <data>
- <path>/data/</path>
- <keep_free_space_bytes>0</keep_free_space_bytes>
- </data>
- <s3>
- <type>s3</type>
- <endpoint>http://path/to/endpoint</endpoint>
- <access_key_id>your_access_key_id</access_key_id>
- <secret_access_key>your_secret_access_key</secret_access_key>
- </s3>
- <blob_storage_disk>
- <type>azure_blob_storage</type>
- <storage_account_url>http://account.blob.core.windows.net</storage_account_url>
- <container_name>container</container_name>
- <account_name>account</account_name>
- <account_key>pass123</account_key>
- <metadata_path>/var/lib/clickhouse/disks/blob_storage_disk/</metadata_path>
- <cache_enabled>true</cache_enabled>
- <cache_path>/var/lib/clickhouse/disks/blob_storage_disk/cache/</cache_path>
- <skip_access_check>false</skip_access_check>
- </blob_storage_disk>
- </disks>
- <policies>
- <all>
- <volumes>
- <main>
- <disk>default</disk>
- <disk>data</disk>
- <disk>s3</disk>
- <disk>blob_storage_disk</disk>
- <max_data_part_size_bytes></max_data_part_size_bytes>
- <max_data_part_size_ratio></max_data_part_size_ratio>
- <perform_ttl_move_on_insert>true</perform_ttl_move_on_insert>
- <prefer_not_to_merge>false</prefer_not_to_merge>
- <load_balancing>round_robin</load_balancing>
- </main>
- </volumes>
- <move_factor>0.2</move_factor>
- </all>
- </policies>
- </storage_configuration>
- --><!-- Path to temporary data for processing hard queries. --><tmp_path>/var/lib/clickhouse/tmp/</tmp_path><!-- Disable AuthType plaintext_password and no_password for ACL. --><allow_plaintext_password>1</allow_plaintext_password><allow_no_password>1</allow_no_password><allow_implicit_no_password>1</allow_implicit_no_password><!-- Complexity requirements for user passwords. --><!-- <password_complexity>
- <rule>
- <pattern>.{12}</pattern>
- <message>be at least 12 characters long</message>
- </rule>
- <rule>
- <pattern>\p{N}</pattern>
- <message>contain at least 1 numeric character</message>
- </rule>
- <rule>
- <pattern>\p{Ll}</pattern>
- <message>contain at least 1 lowercase character</message>
- </rule>
- <rule>
- <pattern>\p{Lu}</pattern>
- <message>contain at least 1 uppercase character</message>
- </rule>
- <rule>
- <pattern>[^\p{L}\p{N}]</pattern>
- <message>contain at least 1 special character</message>
- </rule>
- </password_complexity> --><!-- Policy from the <storage_configuration> for the temporary files.
- If not set <tmp_path> is used, otherwise <tmp_path> is ignored.
- Notes:
- - move_factor is ignored
- - keep_free_space_bytes is ignored
- - max_data_part_size_bytes is ignored
- - you must have exactly one volume in that policy
- --><!-- <tmp_policy>tmp</tmp_policy> --><!-- Directory with user provided files that are accessible by 'file' table function. --><user_files_path>/var/lib/clickhouse/user_files/</user_files_path><!-- LDAP server definitions. --><ldap_servers><!-- List LDAP servers with their connection parameters here to later 1) use them as authenticators for dedicated local users,
- who have 'ldap' authentication mechanism specified instead of 'password', or to 2) use them as remote user directories.
- Parameters:
- host - LDAP server hostname or IP, this parameter is mandatory and cannot be empty.
- port - LDAP server port, default is 636 if enable_tls is set to true, 389 otherwise.
- bind_dn - template used to construct the DN to bind to.
- The resulting DN will be constructed by replacing all '{user_name}' substrings of the template with the actual
- user name during each authentication attempt.
- user_dn_detection - section with LDAP search parameters for detecting the actual user DN of the bound user.
- This is mainly used in search filters for further role mapping when the server is Active Directory. The
- resulting user DN will be used when replacing '{user_dn}' substrings wherever they are allowed. By default,
- user DN is set equal to bind DN, but once search is performed, it will be updated with to the actual detected
- user DN value.
- base_dn - template used to construct the base DN for the LDAP search.
- The resulting DN will be constructed by replacing all '{user_name}' and '{bind_dn}' substrings
- of the template with the actual user name and bind DN during the LDAP search.
- scope - scope of the LDAP search.
- Accepted values are: 'base', 'one_level', 'children', 'subtree' (the default).
- search_filter - template used to construct the search filter for the LDAP search.
- The resulting filter will be constructed by replacing all '{user_name}', '{bind_dn}', and '{base_dn}'
- substrings of the template with the actual user name, bind DN, and base DN during the LDAP search.
- Note, that the special characters must be escaped properly in XML.
- verification_cooldown - a period of time, in seconds, after a successful bind attempt, during which a user will be assumed
- to be successfully authenticated for all consecutive requests without contacting the LDAP server.
- Specify 0 (the default) to disable caching and force contacting the LDAP server for each authentication request.
- enable_tls - flag to trigger use of secure connection to the LDAP server.
- Specify 'no' for plain text (ldap://) protocol (not recommended).
- Specify 'yes' for LDAP over SSL/TLS (ldaps://) protocol (recommended, the default).
- Specify 'starttls' for legacy StartTLS protocol (plain text (ldap://) protocol, upgraded to TLS).
- tls_minimum_protocol_version - the minimum protocol version of SSL/TLS.
- Accepted values are: 'ssl2', 'ssl3', 'tls1.0', 'tls1.1', 'tls1.2' (the default).
- tls_require_cert - SSL/TLS peer certificate verification behavior.
- Accepted values are: 'never', 'allow', 'try', 'demand' (the default).
- tls_cert_file - path to certificate file.
- tls_key_file - path to certificate key file.
- tls_ca_cert_file - path to CA certificate file.
- tls_ca_cert_dir - path to the directory containing CA certificates.
- tls_cipher_suite - allowed cipher suite (in OpenSSL notation).
- Example:
- <my_ldap_server>
- <host>localhost</host>
- <port>636</port>
- <bind_dn>uid={user_name},ou=users,dc=example,dc=com</bind_dn>
- <verification_cooldown>300</verification_cooldown>
- <enable_tls>yes</enable_tls>
- <tls_minimum_protocol_version>tls1.2</tls_minimum_protocol_version>
- <tls_require_cert>demand</tls_require_cert>
- <tls_cert_file>/path/to/tls_cert_file</tls_cert_file>
- <tls_key_file>/path/to/tls_key_file</tls_key_file>
- <tls_ca_cert_file>/path/to/tls_ca_cert_file</tls_ca_cert_file>
- <tls_ca_cert_dir>/path/to/tls_ca_cert_dir</tls_ca_cert_dir>
- <tls_cipher_suite>ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:AES256-GCM-SHA384</tls_cipher_suite>
- </my_ldap_server>
- Example (typical Active Directory with configured user DN detection for further role mapping):
- <my_ad_server>
- <host>localhost</host>
- <port>389</port>
- <bind_dn>EXAMPLE\{user_name}</bind_dn>
- <user_dn_detection>
- <base_dn>CN=Users,DC=example,DC=com</base_dn>
- <search_filter>(&(objectClass=user)(sAMAccountName={user_name}))</search_filter>
- </user_dn_detection>
- <enable_tls>no</enable_tls>
- </my_ad_server>
- --></ldap_servers><!-- To enable Kerberos authentication support for HTTP requests (GSS-SPNEGO), for those users who are explicitly configured
- to authenticate via Kerberos, define a single 'kerberos' section here.
- Parameters:
- principal - canonical service principal name, that will be acquired and used when accepting security contexts.
- This parameter is optional, if omitted, the default principal will be used.
- This parameter cannot be specified together with 'realm' parameter.
- realm - a realm, that will be used to restrict authentication to only those requests whose initiator's realm matches it.
- This parameter is optional, if omitted, no additional filtering by realm will be applied.
- This parameter cannot be specified together with 'principal' parameter.
- Example:
- <kerberos />
- Example:
- <kerberos>
- <principal>HTTP/clickhouse.example.com@EXAMPLE.COM</principal>
- </kerberos>
- Example:
- <kerberos>
- <realm>EXAMPLE.COM</realm>
- </kerberos>
- --><!-- Sources to read users, roles, access rights, profiles of settings, quotas. --><user_directories><users_xml><!-- Path to configuration file with predefined users. --><path>users.xml</path></users_xml><local_directory><!-- Path to folder where users created by SQL commands are stored. --><path>/var/lib/clickhouse/access/</path></local_directory><!-- To add an LDAP server as a remote user directory of users that are not defined locally, define a single 'ldap' section
- with the following parameters:
- server - one of LDAP server names defined in 'ldap_servers' config section above.
- This parameter is mandatory and cannot be empty.
- roles - section with a list of locally defined roles that will be assigned to each user retrieved from the LDAP server.
- If no roles are specified here or assigned during role mapping (below), user will not be able to perform any
- actions after authentication.
- role_mapping - section with LDAP search parameters and mapping rules.
- When a user authenticates, while still bound to LDAP, an LDAP search is performed using search_filter and the
- name of the logged in user. For each entry found during that search, the value of the specified attribute is
- extracted. For each attribute value that has the specified prefix, the prefix is removed, and the rest of the
- value becomes the name of a local role defined in ClickHouse, which is expected to be created beforehand by
- CREATE ROLE command.
- There can be multiple 'role_mapping' sections defined inside the same 'ldap' section. All of them will be
- applied.
- base_dn - template used to construct the base DN for the LDAP search.
- The resulting DN will be constructed by replacing all '{user_name}', '{bind_dn}', and '{user_dn}'
- substrings of the template with the actual user name, bind DN, and user DN during each LDAP search.
- scope - scope of the LDAP search.
- Accepted values are: 'base', 'one_level', 'children', 'subtree' (the default).
- search_filter - template used to construct the search filter for the LDAP search.
- The resulting filter will be constructed by replacing all '{user_name}', '{bind_dn}', '{user_dn}', and
- '{base_dn}' substrings of the template with the actual user name, bind DN, user DN, and base DN during
- each LDAP search.
- Note, that the special characters must be escaped properly in XML.
- attribute - attribute name whose values will be returned by the LDAP search. 'cn', by default.
- prefix - prefix, that will be expected to be in front of each string in the original list of strings returned by
- the LDAP search. Prefix will be removed from the original strings and resulting strings will be treated
- as local role names. Empty, by default.
- Example:
- <ldap>
- <server>my_ldap_server</server>
- <roles>
- <my_local_role1 />
- <my_local_role2 />
- </roles>
- <role_mapping>
- <base_dn>ou=groups,dc=example,dc=com</base_dn>
- <scope>subtree</scope>
- <search_filter>(&(objectClass=groupOfNames)(member={bind_dn}))</search_filter>
- <attribute>cn</attribute>
- <prefix>clickhouse_</prefix>
- </role_mapping>
- </ldap>
- Example (typical Active Directory with role mapping that relies on the detected user DN):
- <ldap>
- <server>my_ad_server</server>
- <role_mapping>
- <base_dn>CN=Users,DC=example,DC=com</base_dn>
- <attribute>CN</attribute>
- <scope>subtree</scope>
- <search_filter>(&(objectClass=group)(member={user_dn}))</search_filter>
- <prefix>clickhouse_</prefix>
- </role_mapping>
- </ldap>
- --></user_directories><access_control_improvements><!-- Enables logic that users without permissive row policies can still read rows using a SELECT query.
- For example, if there two users A, B and a row policy is defined only for A, then
- if this setting is true the user B will see all rows, and if this setting is false the user B will see no rows.
- By default this setting is false for compatibility with earlier access configurations. --><users_without_row_policies_can_read_rows>false</users_without_row_policies_can_read_rows><!-- By default, for backward compatibility ON CLUSTER queries ignore CLUSTER grant,
- however you can change this behaviour by setting this to true --><on_cluster_queries_require_cluster_grant>false</on_cluster_queries_require_cluster_grant><!-- By default, for backward compatibility "SELECT * FROM system.<table>" doesn't require any grants and can be executed
- by any user. You can change this behaviour by setting this to true.
- If it's set to true then this query requires "GRANT SELECT ON system.<table>" just like as for non-system tables.
- Exceptions: a few system tables ("tables", "columns", "databases", and some constant tables like "one", "contributors")
- are still accessible for everyone; and if there is a SHOW privilege (e.g. "SHOW USERS") granted the corresponding system
- table (i.e. "system.users") will be accessible. --><select_from_system_db_requires_grant>false</select_from_system_db_requires_grant><!-- By default, for backward compatibility "SELECT * FROM information_schema.<table>" doesn't require any grants and can be
- executed by any user. You can change this behaviour by setting this to true.
- If it's set to true then this query requires "GRANT SELECT ON information_schema.<table>" just like as for ordinary tables. --><select_from_information_schema_requires_grant>false</select_from_information_schema_requires_grant><!-- By default, for backward compatibility a settings profile constraint for a specific setting inherit every not set field from
- previous profile. You can change this behaviour by setting this to true.
- If it's set to true then if settings profile has a constraint for a specific setting, then this constraint completely cancels all
- actions of previous constraint (defined in other profiles) for the same specific setting, including fields that are not set by new constraint.
- It also enables 'changeable_in_readonly' constraint type --><settings_constraints_replace_previous>false</settings_constraints_replace_previous><!-- Number of seconds since last access a role is stored in the Role Cache --><role_cache_expiration_time_seconds>600</role_cache_expiration_time_seconds></access_control_improvements><!-- Default profile of settings. --><default_profile>default</default_profile><!-- Comma-separated list of prefixes for user-defined settings. --><custom_settings_prefixes/><!-- System profile of settings. This settings are used by internal processes (Distributed DDL worker and so on). --><!-- <system_profile>default</system_profile> --><!-- Buffer profile of settings.
- This settings are used by Buffer storage to flush data to the underlying table.
- Default: used from system_profile directive.
- --><!-- <buffer_profile>default</buffer_profile> --><!-- Default database. --><default_database>default</default_database><!-- Server time zone could be set here.
- Time zone is used when converting between String and DateTime types,
- when printing DateTime in text formats and parsing DateTime from text,
- it is used in date and time related functions, if specific time zone was not passed as an argument.
- Time zone is specified as identifier from IANA time zone database, like UTC or Africa/Abidjan.
- If not specified, system time zone at server startup is used.
- Please note, that server could display time zone alias instead of specified name.
- Example: Zulu is an alias for UTC.
- --><!-- <timezone>UTC</timezone> --><!-- You can specify umask here (see "man umask"). Server will apply it on startup.
- Number is always parsed as octal. Default umask is 027 (other users cannot read logs, data files, etc; group can only read).
- --><!-- <umask>022</umask> --><!-- Perform mlockall after startup to lower first queries latency
- and to prevent clickhouse executable from being paged out under high IO load.
- Enabling this option is recommended but will lead to increased startup time for up to a few seconds.
- --><mlock_executable>true</mlock_executable><!-- Reallocate memory for machine code ("text") using huge pages. Highly experimental. --><remap_executable>false</remap_executable><![CDATA[
- Uncomment below in order to use JDBC table engine and function.
- To install and run JDBC bridge in background:
- * [Debian/Ubuntu]
- export MVN_URL=https://repo1.maven.org/maven2/com/clickhouse/clickhouse-jdbc-bridge/
- export PKG_VER=$(curl -sL $MVN_URL/maven-metadata.xml | grep '<release>' | sed -e 's|.*>\(.*\)<.*|\1|')
- wget https://github.com/ClickHouse/clickhouse-jdbc-bridge/releases/download/v$PKG_VER/clickhouse-jdbc-bridge_$PKG_VER-1_all.deb
- apt install --no-install-recommends -f ./clickhouse-jdbc-bridge_$PKG_VER-1_all.deb
- clickhouse-jdbc-bridge &
- * [CentOS/RHEL]
- export MVN_URL=https://repo1.maven.org/maven2/com/clickhouse/clickhouse-jdbc-bridge/
- export PKG_VER=$(curl -sL $MVN_URL/maven-metadata.xml | grep '<release>' | sed -e 's|.*>\(.*\)<.*|\1|')
- wget https://github.com/ClickHouse/clickhouse-jdbc-bridge/releases/download/v$PKG_VER/clickhouse-jdbc-bridge-$PKG_VER-1.noarch.rpm
- yum localinstall -y clickhouse-jdbc-bridge-$PKG_VER-1.noarch.rpm
- clickhouse-jdbc-bridge &
- Please refer to https://github.com/ClickHouse/clickhouse-jdbc-bridge#usage for more information.
- ]]><!--
- <jdbc_bridge>
- <host>127.0.0.1</host>
- <port>9019</port>
- </jdbc_bridge>
- --><!-- Configuration of clusters that could be used in Distributed tables.
- https://clickhouse.com/docs/en/operations/table_engines/distributed/
- --><!-- The list of hosts allowed to use in URL-related storage engines and table functions.
- If this section is not present in configuration, all hosts are allowed.
- --><!--<remote_url_allow_hosts>--><!-- Host should be specified exactly as in URL. The name is checked before DNS resolution.
- Example: "clickhouse.com", "clickhouse.com." and "www.clickhouse.com" are different hosts.
- If port is explicitly specified in URL, the host:port is checked as a whole.
- If host specified here without port, any port with this host allowed.
- "clickhouse.com" -> "clickhouse.com:443", "clickhouse.com:80" etc. is allowed, but "clickhouse.com:80" -> only "clickhouse.com:80" is allowed.
- If the host is specified as IP address, it is checked as specified in URL. Example: "[2a02:6b8:a::a]".
- If there are redirects and support for redirects is enabled, every redirect (the Location field) is checked.
- Host should be specified using the host xml tag:
- <host>clickhouse.com</host>
- --><!-- Regular expression can be specified. RE2 engine is used for regexps.
- Regexps are not aligned: don't forget to add ^ and $. Also don't forget to escape dot (.) metacharacter
- (forgetting to do so is a common source of error).
- --><!--</remote_url_allow_hosts>--><!-- If element has 'incl' attribute, then for it's value will be used corresponding substitution from another file.
- By default, path to file with substitutions is /etc/metrika.xml. It could be changed in config in 'include_from' element.
- Values for substitutions are specified in /clickhouse/name_of_substitution elements in that file.
- --><!-- ZooKeeper is used to store metadata about replicas, when using Replicated tables.
- Optional. If you don't use replicated tables, you could omit that.
- See https://clickhouse.com/docs/en/engines/table-engines/mergetree-family/replication/
- --><!--
- <zookeeper>
- <node>
- <host>example1</host>
- <port>2181</port>
- </node>
- <node>
- <host>example2</host>
- <port>2181</port>
- </node>
- <node>
- <host>example3</host>
- <port>2181</port>
- </node>
- </zookeeper>
- --><!-- Substitutions for parameters of replicated tables.
- Optional. If you don't use replicated tables, you could omit that.
- See https://clickhouse.com/docs/en/engines/table-engines/mergetree-family/replication/#creating-replicated-tables
- --><!--
- <macros>
- <shard>01</shard>
- <replica>example01-01-1</replica>
- </macros>
- --><!-- Reloading interval for embedded dictionaries, in seconds. Default: 3600. --><builtin_dictionaries_reload_interval>3600</builtin_dictionaries_reload_interval><!-- Maximum session timeout, in seconds. Default: 3600. --><max_session_timeout>3600</max_session_timeout><!-- Default session timeout, in seconds. Default: 60. --><default_session_timeout>60</default_session_timeout><!-- Sending data to Graphite for monitoring. Several sections can be defined. --><!--
- interval - send every X second
- root_path - prefix for keys
- hostname_in_path - append hostname to root_path (default = true)
- metrics - send data from table system.metrics
- events - send data from table system.events
- asynchronous_metrics - send data from table system.asynchronous_metrics
- --><!--
- <graphite>
- <host>localhost</host>
- <port>42000</port>
- <timeout>0.1</timeout>
- <interval>60</interval>
- <root_path>one_min</root_path>
- <hostname_in_path>true</hostname_in_path>
- <metrics>true</metrics>
- <events>true</events>
- <events_cumulative>false</events_cumulative>
- <asynchronous_metrics>true</asynchronous_metrics>
- </graphite>
- <graphite>
- <host>localhost</host>
- <port>42000</port>
- <timeout>0.1</timeout>
- <interval>1</interval>
- <root_path>one_sec</root_path>
- <metrics>true</metrics>
- <events>true</events>
- <events_cumulative>false</events_cumulative>
- <asynchronous_metrics>false</asynchronous_metrics>
- </graphite>
- --><!-- Serve endpoint for Prometheus monitoring. --><!--
- endpoint - mertics path (relative to root, statring with "/")
- port - port to setup server. If not defined or 0 than http_port used
- metrics - send data from table system.metrics
- events - send data from table system.events
- asynchronous_metrics - send data from table system.asynchronous_metrics
- status_info - send data from different component from CH, ex: Dictionaries status
- --><!--
- <prometheus>
- <endpoint>/metrics</endpoint>
- <port>9363</port>
- <metrics>true</metrics>
- <events>true</events>
- <asynchronous_metrics>true</asynchronous_metrics>
- <status_info>true</status_info>
- </prometheus>
- --><!-- Query log. Used only for queries with setting log_queries = 1. --><query_log><!-- What table to insert data. If table is not exist, it will be created.
- When query log structure is changed after system update,
- then old table will be renamed and new table will be created automatically.
- --><database>system</database><table>query_log</table><!--
- PARTITION BY expr: https://clickhouse.com/docs/en/table_engines/mergetree-family/custom_partitioning_key/
- Example:
- event_date
- toMonday(event_date)
- toYYYYMM(event_date)
- toStartOfHour(event_time)
- --><partition_by>toYYYYMM(event_date)</partition_by><!--
- Table TTL specification: https://clickhouse.com/docs/en/engines/table-engines/mergetree-family/mergetree/#mergetree-table-ttl
- Example:
- event_date + INTERVAL 1 WEEK
- event_date + INTERVAL 7 DAY DELETE
- event_date + INTERVAL 2 WEEK TO DISK 'bbb'
- <ttl>event_date + INTERVAL 30 DAY DELETE</ttl>
- --><!-- Instead of partition_by, you can provide full engine expression (starting with ENGINE = ) with parameters,
- Example: <engine>ENGINE = MergeTree PARTITION BY toYYYYMM(event_date) ORDER BY (event_date, event_time) SETTINGS index_granularity = 1024</engine>
- --><!-- Interval of flushing data. --><flush_interval_milliseconds>7500</flush_interval_milliseconds><!-- example of using a different storage policy for a system table --><!-- storage_policy>local_ssd</storage_policy --></query_log><!-- Trace log. Stores stack traces collected by query profilers.
- See query_profiler_real_time_period_ns and query_profiler_cpu_time_period_ns settings. --><trace_log><database>system</database><table>trace_log</table><partition_by>toYYYYMM(event_date)</partition_by><flush_interval_milliseconds>7500</flush_interval_milliseconds></trace_log><!-- Query thread log. Has information about all threads participated in query execution.
- Used only for queries with setting log_query_threads = 1. --><query_thread_log><database>system</database><table>query_thread_log</table><partition_by>toYYYYMM(event_date)</partition_by><flush_interval_milliseconds>7500</flush_interval_milliseconds></query_thread_log><!-- Query views log. Has information about all dependent views associated with a query.
- Used only for queries with setting log_query_views = 1. --><query_views_log><database>system</database><table>query_views_log</table><partition_by>toYYYYMM(event_date)</partition_by><flush_interval_milliseconds>7500</flush_interval_milliseconds></query_views_log><!-- Uncomment if use part log.
- Part log contains information about all actions with parts in MergeTree tables (creation, deletion, merges, downloads).--><part_log><database>system</database><table>part_log</table><partition_by>toYYYYMM(event_date)</partition_by><flush_interval_milliseconds>7500</flush_interval_milliseconds></part_log><!-- Uncomment to write text log into table.
- Text log contains all information from usual server log but stores it in structured and efficient way.
- The level of the messages that goes to the table can be limited (<level>), if not specified all messages will go to the table.
- <text_log>
- <database>system</database>
- <table>text_log</table>
- <flush_interval_milliseconds>7500</flush_interval_milliseconds>
- <level></level>
- </text_log>
- --><!-- Metric log contains rows with current values of ProfileEvents, CurrentMetrics collected with "collect_interval_milliseconds" interval. --><metric_log><database>system</database><table>metric_log</table><flush_interval_milliseconds>7500</flush_interval_milliseconds><collect_interval_milliseconds>1000</collect_interval_milliseconds></metric_log><!--
- Asynchronous metric log contains values of metrics from
- system.asynchronous_metrics.
- --><asynchronous_metric_log><database>system</database><table>asynchronous_metric_log</table><flush_interval_milliseconds>7000</flush_interval_milliseconds></asynchronous_metric_log><!--
- OpenTelemetry log contains OpenTelemetry trace spans.
- --><opentelemetry_span_log><!--
- The default table creation code is insufficient, this <engine> spec
- is a workaround. There is no 'event_time' for this log, but two times,
- start and finish. It is sorted by finish time, to avoid inserting
- data too far away in the past (probably we can sometimes insert a span
- that is seconds earlier than the last span in the table, due to a race
- between several spans inserted in parallel). This gives the spans a
- global order that we can use to e.g. retry insertion into some external
- system.
- --><engine>
- engine MergeTree
- partition by toYYYYMM(finish_date)
- order by (finish_date, finish_time_us, trace_id)
- </engine><database>system</database><table>opentelemetry_span_log</table><flush_interval_milliseconds>7500</flush_interval_milliseconds></opentelemetry_span_log><!-- Crash log. Stores stack traces for fatal errors.
- This table is normally empty. --><crash_log><database>system</database><table>crash_log</table><partition_by/><flush_interval_milliseconds>1000</flush_interval_milliseconds></crash_log><!-- Session log. Stores user log in (successful or not) and log out events.
- Note: session log has known security issues and should not be used in production.
- --><!-- <session_log>
- <database>system</database>
- <table>session_log</table>
- <partition_by>toYYYYMM(event_date)</partition_by>
- <flush_interval_milliseconds>7500</flush_interval_milliseconds>
- </session_log> --><!-- Profiling on Processors level. --><processors_profile_log><database>system</database><table>processors_profile_log</table><partition_by>toYYYYMM(event_date)</partition_by><flush_interval_milliseconds>7500</flush_interval_milliseconds></processors_profile_log><!-- Log of asynchronous inserts. It allows to check status
- of insert query in fire-and-forget mode.
- --><asynchronous_insert_log><database>system</database><table>asynchronous_insert_log</table><flush_interval_milliseconds>7500</flush_interval_milliseconds><partition_by>event_date</partition_by><ttl>event_date + INTERVAL 3 DAY</ttl></asynchronous_insert_log><!-- <top_level_domains_path>/var/lib/clickhouse/top_level_domains/</top_level_domains_path> --><!-- Custom TLD lists.
- Format: <name>/path/to/file</name>
- Changes will not be applied w/o server restart.
- Path to the list is under top_level_domains_path (see above).
- --><top_level_domains_lists><!--
- <public_suffix_list>/path/to/public_suffix_list.dat</public_suffix_list>
- --></top_level_domains_lists><!-- Configuration of external dictionaries. See:
- https://clickhouse.com/docs/en/sql-reference/dictionaries/external-dictionaries/external-dicts
- --><dictionaries_config>*_dictionary.xml</dictionaries_config><!-- Configuration of user defined executable functions --><user_defined_executable_functions_config>*_function.xml</user_defined_executable_functions_config><!-- Path in ZooKeeper to store user-defined SQL functions created by the command CREATE FUNCTION.
- If not specified they will be stored locally. --><!-- <user_defined_zookeeper_path>/clickhouse/user_defined<user_defined_zookeeper_path> --><!-- Uncomment if you want data to be compressed 30-100% better.
- Don't do that if you just started using ClickHouse.
- --><!--
- <compression>
- <!- - Set of variants. Checked in order. Last matching case wins. If nothing matches, lz4 will be used. - ->
- <case>
- <!- - Conditions. All must be satisfied. Some conditions may be omitted. - ->
- <min_part_size>10000000000</min_part_size> <!- - Min part size in bytes. - ->
- <min_part_size_ratio>0.01</min_part_size_ratio> <!- - Min size of part relative to whole table size. - ->
- <!- - What compression method to use. - ->
- <method>zstd</method>
- </case>
- </compression>
- --><!-- Configuration of encryption. The server executes a command to
- obtain an encryption key at startup if such a command is
- defined, or encryption codecs will be disabled otherwise. The
- command is executed through /bin/sh and is expected to write
- a Base64-encoded key to the stdout. --><encryption_codecs><!-- aes_128_gcm_siv --><!-- Example of getting hex key from env --><!-- the code should use this key and throw an exception if its length is not 16 bytes --><!--key_hex from_env="..."></key_hex --><!-- Example of multiple hex keys. They can be imported from env or be written down in config--><!-- the code should use these keys and throw an exception if their length is not 16 bytes --><!-- key_hex id="0">...</key_hex --><!-- key_hex id="1" from_env=".."></key_hex --><!-- key_hex id="2">...</key_hex --><!-- current_key_id>2</current_key_id --><!-- Example of getting hex key from config --><!-- the code should use this key and throw an exception if its length is not 16 bytes --><!-- key>...</key --><!-- example of adding nonce --><!-- nonce>...</nonce --><!-- /aes_128_gcm_siv --></encryption_codecs><!-- Allow to execute distributed DDL queries (CREATE, DROP, ALTER, RENAME) on cluster.
- Works only if ZooKeeper is enabled. Comment it if such functionality isn't required. --><distributed_ddl><!-- Path in ZooKeeper to queue with DDL queries --><path>/clickhouse/task_queue/ddl</path><!-- Settings from this profile will be used to execute DDL queries --><!-- <profile>default</profile> --><!-- Controls how much ON CLUSTER queries can be run simultaneously. --><!-- <pool_size>1</pool_size> --><!--
- Cleanup settings (active tasks will not be removed)
- --><!-- Controls task TTL (default 1 week) --><!-- <task_max_lifetime>604800</task_max_lifetime> --><!-- Controls how often cleanup should be performed (in seconds) --><!-- <cleanup_delay_period>60</cleanup_delay_period> --><!-- Controls how many tasks could be in the queue --><!-- <max_tasks_in_queue>1000</max_tasks_in_queue> --></distributed_ddl><!-- Settings to fine tune MergeTree tables. See documentation in source code, in MergeTreeSettings.h --><!--
- <merge_tree>
- <max_suspicious_broken_parts>5</max_suspicious_broken_parts>
- </merge_tree>
- --><!-- Protection from accidental DROP.
- If size of a MergeTree table is greater than max_table_size_to_drop (in bytes) than table could not be dropped with any DROP query.
- If you want do delete one table and don't want to change clickhouse-server config, you could create special file <clickhouse-path>/flags/force_drop_table and make DROP once.
- By default max_table_size_to_drop is 50GB; max_table_size_to_drop=0 allows to DROP any tables.
- The same for max_partition_size_to_drop.
- Uncomment to disable protection.
- --><!-- <max_table_size_to_drop>0</max_table_size_to_drop> --><!-- <max_partition_size_to_drop>0</max_partition_size_to_drop> --><!-- Example of parameters for GraphiteMergeTree table engine --><graphite_rollup_example><pattern><regexp>click_cost</regexp><function>any</function><retention><age>0</age><precision>3600</precision></retention><retention><age>86400</age><precision>60</precision></retention></pattern><default><function>max</function><retention><age>0</age><precision>60</precision></retention><retention><age>3600</age><precision>300</precision></retention><retention><age>86400</age><precision>3600</precision></retention></default></graphite_rollup_example><!-- Directory in <clickhouse-path> containing schema files for various input formats.
- The directory will be created if it doesn't exist.
- --><format_schema_path>/var/lib/clickhouse/format_schemas/</format_schema_path><!-- Default query masking rules, matching lines would be replaced with something else in the logs
- (both text logs and system.query_log).
- name - name for the rule (optional)
- regexp - RE2 compatible regular expression (mandatory)
- replace - substitution string for sensitive data (optional, by default - six asterisks)
- <query_masking_rules>
- <rule>
- <name>hide encrypt/decrypt arguments</name>
- <regexp>((?:aes_)?(?:encrypt|decrypt)(?:_mysql)?)\s*\(\s*(?:'(?:\\'|.)+'|.*?)\s*\)</regexp>
- <replace>\1(???)</replace>
- </rule>
- </query_masking_rules> --><!-- Uncomment to use custom http handlers.
- rules are checked from top to bottom, first match runs the handler
- url - to match request URL, you can use 'regex:' prefix to use regex match(optional)
- methods - to match request method, you can use commas to separate multiple method matches(optional)
- headers - to match request headers, match each child element(child element name is header name), you can use 'regex:' prefix to use regex match(optional)
- handler is request handler
- type - supported types: static, dynamic_query_handler, predefined_query_handler
- query - use with predefined_query_handler type, executes query when the handler is called
- query_param_name - use with dynamic_query_handler type, extracts and executes the value corresponding to the <query_param_name> value in HTTP request params
- status - use with static type, response status code
- content_type - use with static type, response content-type
- response_content - use with static type, Response content sent to client, when using the prefix 'file://' or 'config://', find the content from the file or configuration send to client.
- <http_handlers>
- <rule>
- <url>/</url>
- <methods>POST,GET</methods>
- <headers><pragma>no-cache</pragma></headers>
- <handler>
- <type>dynamic_query_handler</type>
- <query_param_name>query</query_param_name>
- </handler>
- </rule>
- <rule>
- <url>/predefined_query</url>
- <methods>POST,GET</methods>
- <handler>
- <type>predefined_query_handler</type>
- <query>SELECT * FROM system.settings</query>
- </handler>
- </rule>
- <rule>
- <handler>
- <type>static</type>
- <status>200</status>
- <content_type>text/plain; charset=UTF-8</content_type>
- <response_content>config://http_server_default_response</response_content>
- </handler>
- </rule>
- </http_handlers>
- --><send_crash_reports><!-- Changing <enabled> to true allows sending crash reports to --><!-- the ClickHouse core developers team via Sentry https://sentry.io --><!-- Doing so at least in pre-production environments is highly appreciated --><enabled>false</enabled><!-- Change <anonymize> to true if you don't feel comfortable attaching the server hostname to the crash report --><anonymize>false</anonymize><!-- Default endpoint should be changed to different Sentry DSN only if you have --><!-- some in-house engineers or hired consultants who're going to debug ClickHouse issues for you --><endpoint>https://6f33034cfe684dd7a3ab9875e57b1c8d@o388870.ingest.sentry.io/5226277</endpoint></send_crash_reports><!-- Uncomment to disable ClickHouse internal DNS caching. --><!-- <disable_internal_dns_cache>1</disable_internal_dns_cache> --><!-- You can also configure rocksdb like this: --><!--
- <rocksdb>
- <options>
- <max_background_jobs>8</max_background_jobs>
- </options>
- <column_family_options>
- <num_levels>2</num_levels>
- </column_family_options>
- <tables>
- <table>
- <name>TABLE</name>
- <options>
- <max_background_jobs>8</max_background_jobs>
- </options>
- <column_family_options>
- <num_levels>2</num_levels>
- </column_family_options>
- </table>
- </tables>
- </rocksdb>
- --><!-- Configuration for the query cache --><!-- <query_cache> --><!-- <max_size>1073741824</max_size> --><!-- <max_entries>1024</max_entries> --><!-- <max_entry_size>1048576</max_entry_size> --><!-- <max_entry_rows>30000000</max_entry_rows> --><!-- </query_cache> --><!-- Uncomment if enable merge tree metadata cache --><!--merge_tree_metadata_cache>
- <lru_cache_size>268435456</lru_cache_size>
- <continue_if_corrupted>true</continue_if_corrupted>
- </merge_tree_metadata_cache--><!-- This allows to disable exposing addresses in stack traces for security reasons.
- Please be aware that it does not improve security much, but makes debugging much harder.
- The addresses that are small offsets from zero will be displayed nevertheless to show nullptr dereferences.
- Regardless of this configuration, the addresses are visible in the system.stack_trace and system.trace_log tables
- if the user has access to these tables.
- I don't recommend to change this setting.
- <show_addresses_in_stack_traces>false</show_addresses_in_stack_traces>
- --><!-- On Linux systems this can control the behavior of OOM killer.
- <oom_score>-1000</oom_score>
- --><http_port from_env="CLICKHOUSE_HTTP_PORT"/><tcp_port from_env="CLICKHOUSE_TCP_PORT"/><mysql_port from_env="CLICKHOUSE_MYSQL_PORT"/><postgresql_port from_env="CLICKHOUSE_POSTGRESQL_PORT"/><interserver_http_port from_env="CLICKHOUSE_INTERSERVER_HTTP_PORT"/></clickhouse>
|