【clickhouse】clickhouse入门学习之环境搭建-windows下安装ClickHouse教程（详细版）_clickhouse windows

clickhouse入门学习之环境搭建-windows下安装ClickHouse教程（详细版）

---

---

一、启用虚拟化

打开任务管理器(CTRL+Shift+Esc), 选择性能,查看CPU虚拟化，确认是否已启用（一般是启用的）。

二、启用Hyper-v

1.按住键盘Win+R,输入control

2.选择程序

3.选择启动和关闭Windows功能

4.勾选Hyper-v

三、安装WSL

1.win+R，输入cmd，按回车键

2.终端中输入命令wsl，启动即可

wsl
1

3.不用时，减少内存占用,关闭wsl

wsl --shutdown
1

四、docker下载

1.docker安装包下载

方式一：
网盘下载链接：

https://pan.quark.cn/s/eba4fa833a15

方式二：
阿里云的下载地址：

https://mirrors.aliyun.com/docker-toolbox/windows/docker-for-windows/

2.docker安装

将下载下来的Docker Desktop Installer.exe文件双击进行安装即可，安装完成后，任务栏会出现一个蓝色的小鲸鱼图标（注意安装完成后可能会重启系统）

3.重启电脑后打开docker Desktop又出现下图报错

4.说明系统的WSL版本太旧，需要更新

• win+R，输入cmd，按回车键，在终端中输入下述代码等待更新即可。

wsl --update
1

• 如果wsl --update命令执行失败，说明电脑安装的wsl有问题，请按以下教程完成WSL/WSL2的安装，WSL2安装说明如下
  参考官网安装教程链接如下：

https://learn.microsoft.com/zh-cn/windows/wsl/install-manual

详细说明：
1、执行《旧版 WSL 的手动安装步骤》步骤1-5
2、步骤6请参照《下载发行版》章节，说明如下：
①　curl 命令行实用程序来下载
打开Windows控制台（Win+R -> 输入cmd -> 回车）-> 输入以下命令

curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004
1

②　安装ubuntu-2004.appx，有两种方式
第一种：
打开电脑PowerShell 程序（Win+R -> 输入PowerShell -> 回车）-> 输入以下命令（将命令中的\app_name.appx改为\ubuntu-2004.appx）“ubuntu-2004”指的是步骤1下载下来的文件名

Add-AppxPackage .\app_name.appx
1

第二种：搜索下载到自己本地ubuntu-2004.appx文件，双击即可，例如我电脑存放的目录：C:\Users\1

5.win+R，输入cmd回车，输入docker --version检测docker安装的版本，出现如下图说明已经安装docker。

6.继续输入docker run hello-world，出现下图说明docker安装成功，且可以执行docker命令。

7.打开桌面上的docker Desktop，就不会报错，如下图

五、docker配置

1.打开Docker配置中心：任务栏小鲸鱼右键 -> Settings

2.配置Docker国内镜像加速下载：“https://pi9dpp60.mirror.aliyuncs.com”，左侧菜单 Docker Engine -> 右侧输入框 -> Apply & Restart

{
  "registry-mirrors": [
    "https://pi9dpp60.mirror.aliyuncs.com"
  ],
  "insecure-registries": [],
  "debug": false,
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "builder": {
    "gc": {
      "enabled": true,
      "defaultKeepStorage": "20GB"
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

注意：windows安装docker后，电脑重启可能会使docker报错，我们只需要多试几次就可以正常打开了。

六、clickhouse安装

1.拉取镜像

打开Windows控制台（Win+R -> 输入cmd -> 回车）-> 输入

docker pull yandex/clickhouse-server
docker pull yandex/clickhouse-client
1
2

2.运行临时容器temp-clickhouse-server,Windows控制台继续执行命令

docker run --rm -d --name=temp-clickhouse-server yandex/clickhouse-server
1

3.config配置和users配置映射Windows硬盘目录

• (1) 在D盘根目录创建 D:/docker/conf 文件夹
• (2) Windows控制台继续执行命令

docker cp temp-clickhouse-server:/etc/clickhouse-server/config.xml D:/docker/conf/config.xml
docker cp temp-clickhouse-server:/etc/clickhouse-server/users.xml D:/docker/conf/users.xml
1
2

• (3) 查看文件是否生成
  

4.修改监听

进入D:\docker\conf修改本机的config.xml文件，去掉语句<listen_host>0.0.0.0</listen_host>的注释

5.销毁临时容器

docker stop temp-clickhouse-server
1

6.运行ClickHouse服务

docker run -d --name=single-clickhouse-server -p 8123:8123 -p 9000:9000 -p 9009:9009 --ulimit nofile=262144:262144 --volume D:/docker/data:/var/lib/clickhouse:rw --volume D:/docker/conf:/etc/clickhouse-server:rw --volume D:/docker/log:/var/log/clickhouse-server:rw yandex/clickhouse-server
1

如果上述命令运行失败，请打开Docker Desktop客户端，点击运行按钮即可；

七、测试是否安装成功

1.进入docker中的clickhouse bash，运行sql （Win+R -> 输入cmd -> 回车）

docker exec -it single-clickhouse-server bash
clickhouse-client
show databases;
1
2
3

2.登录命令补充说明

docker exec -it single-clickhouse-server bash
# 如果上面user.xml没有配置密码则默认用户名default进行登录，密码默认为空不做填入
clickhouse-client命令直接进入即可
# 如果user.xml进行了密码的配置，则登录命令如下：
clickhouse-client --host 127.0.0.1 --port 8123 --user default --password 你设置的密码
1
2
3
4
5

3.涉及到的常用命令

3.1 退出clickhouse-client/ 退出docker bash

exit
1

3.2 查看docker 进程

docker ps
1

八、测试连接

IDEA进行测试连接

1. 打开IDEA，点击database数据库标签按钮，再点击“+”
   
   2.在Dsta Source->找到clickhouse，点击进去
   
   3.在Dsta Source页面输入用户名和密码，默认用户defualt，密码如若没设置，可不填，如已修改user.xml文件的密码，填写配置好的密码
   

4.点击Test Connection，测试连接；Succeeded弹窗出来后表示连接成功；

---