v.25.10Improvement

Store clickhouse-client files

Official CH changelog text
Store clickhouse-client files (e.g. query history) in places described by XDG Base Directories specification instead of root of home directory. ~/.clickhouse-client-history will still be used if it is already present. #88538 (Konstantin Bogdanov).
ClickHouse client now stores files such as query history according to the XDG Base Directories specification instead of the home directory root.

Why it matters

This feature organizes ClickHouse client files in a standardized directory structure compliant with the XDG Base Directories specification, helping users keep their home directory clean and better manage application data. It also maintains backward compatibility by continuing to use the existing ~/.clickhouse-client-history file if it is already present.

How to use it

Users do not need to manually enable this feature. When using the ClickHouse client, files like query history will automatically be stored in appropriate XDG Base Directory locations (e.g., $XDG_DATA_HOME/clickhouse-client/). Existing history files in ~/.clickhouse-client-history will still be recognized and used.

Related resources

PreviousNext