Documentation Index
Fetch the complete documentation index at: https://private-7c7dfe99-page-updates.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
How to install and test ClickHouse on Microsoft Windows
When ClickHouse installing on Windows 10 you may receive errors when inserting data, for example:
DB::Exception: std::__1::__fs::filesystem::filesystem_error: filesystem error: in rename: Permission denied ["./store/711/71144174-d098-4056-8976-6ad1204205ec/tmp_insert_all_1_1_0/"] ["./store/711/71144174-d098-4056-8976-6ad1204205ec/all_1_1_0/"]. Stack trace:
On Windows 10, WSL needs to be upgraded to WSL 2.
- For testing follow these instructions, you should have similar output:
Since this is for testing, I logged in as root to avoid permissions issues:
- Create a ClickHouse directory:
root@marspc2:~# mkdir /clickhouse
- From the new directory, download clickhouse:
root@marspc2:/# cd clickhouse
root@marspc2:/clickhouse# curl https://clickhouse.com | sh
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 2739 0 2739 0 0 5515 0 --:--:-- --:--:-- --:--:-- 5511
Will download https://builds.clickhouse.com/master/amd64/clickhouse into clickhouse
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 530M 100 530M 0 0 8859k 0 0:01:01 0:01:01 --:--:-- 8549k
Successfully downloaded the ClickHouse binary, you can run it as:
./clickhouse
You can also install it:
sudo ./clickhouse install
- Start the clickhouse server:
root@marspc2:/clickhouse# ./clickhouse server
Processing configuration file 'config.xml'.
There is no file 'config.xml', will use embedded config.
Cannot set max size of core file to 1073741824
2023.04.17 19:19:23.155323 [ 500 ] {} <Information> SentryWriter: Sending crash reports is disabled
2023.04.17 19:19:23.165447 [ 500 ] {} <Trace> Pipe: Pipe capacity is 1.00 MiB
2023.04.17 19:19:23.271147 [ 500 ] {} <Information> Application: Starting ClickHouse 23.4.1.1222 (revision: 54473, git hash: 3993aef8e281815ac4269d44e27bb1dcdcff21cb, build id: AF16AA59B689841860F39ACDBED30AC8F9AB70FA), PID 500
2023.04.17 19:19:23.271208 [ 500 ] {} <Information> Application: starting up
2023.04.17 19:19:23.271237 [ 500 ] {} <Information> Application: OS name: Linux, version: 5.15.90.1-microsoft-standard-WSL2, architecture: x86_64
...
- In another WSL window, start the client:
root@marspc2:/clickhouse# ./clickhouse client
ClickHouse client version 23.4.1.1222 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 23.4.1 revision 54462.
Warnings:
* Linux transparent hugepages are set to "always". Check /sys/kernel/mm/transparent_hugepage/enabled
marspc2. :)
- Create the database and table:
marspc2. :) create database db1;
CREATE DATABASE db1
Query id: 688f79e2-8132-44ed-98d6-0581abe9903a
Ok.
0 rows in set. Elapsed: 0.007 sec.
marspc2. :) create table db1.table1 (id Int64, string_column String) engine = MergeTree() order by id;
CREATE TABLE db1.table1
(
`id` Int64,
`string_column` String
)
ENGINE = MergeTree
ORDER BY id
Query id: d91a93b4-e13f-4e17-8201-f329223287d0
Ok.
0 rows in set. Elapsed: 0.010 sec.
marspc2. :) insert into db1.table1 (id, string_column) values (1, 'a'), (2,'b');
INSERT INTO db1.table1 (id, string_column) FORMAT Values
Query id: 2b274eef-09af-434b-88e0-c25799649910
Ok.
2 rows in set. Elapsed: 0.003 sec.
marspc2. :) select * from db1.table1;
SELECT *
FROM db1.table1
Query id: 74c76bf1-d944-4b21-a384-cc0b5e6aa579
┌─id─┬─string_column─┐
│ 1 │ a │
│ 2 │ b │
└────┴───────────────┘
2 rows in set. Elapsed: 0.002 sec.