README.md

环境搭建

环境的部署主要分为两部分，Superset部分和数据复制部分。使用Docker部署，所以在部署前需要一定的Docker知识，并确保你已经安装了docker,可以参考这篇文章。

BI (使用amancevice/superset)

{% file src="../../.gitbook/assets/superset (1).tar" %} superset and clickhouse {% endfile %}

BI报表部分将ClickHouse与Superset放在了一起布置，在这里superset使用的是amancevice/superset，之所以使用该版本的superset是因为官方版本总是会在初始化这部分发生错误，初始不完全导致部署失败。废话不多说，准备开始！

tar -xvf superset.tar解压并进入到superset目录

-rwxr-xr-x 1 root root   66 May  4 08:27 create_image.sh*
-rw-r--r-- 1 root root 1132 May  4 08:28 docker-compose.yml
-rw-r--r-- 1 root root  134 May  4 08:27 Dockerfile
-rw-r--r-- 1 root root  907 May  4 08:27 superset_config.py
-rw-r--r-- 1 root root 6207 May  4 08:27 users.xml

Dockerfile : 这个文件主要用来构建自己的superset镜像，这个文件里面只有一条构建命令，RUN pip install clickhouse-connect -i https://pypi.tuna.tsinghua.edu.cn/simple，主要用来下载clickhouse的连接器，使superset能够连接到clickhouse。

create_image.sh : 这个文件里面只有一条命令docker build -t "tongxin/superset-clickhouse:4.0.0" . 这条命令是docker 创建镜像的命令，也可以直接在控制台输入这条命令。

superset_config.py: 它是superset的配置文件，可以通过该文件配置superset的行为；可以看到这个文件加了一些翻译、开启Jinja模板的配置。

users.xml : 它是clickhouse的配置文件，包含clickhouse的用户账户行为配置。

启动容器

在superset目录中使用以下命令

docker compose up

在浏览器访问 http://yourhost:8088 ,账号密码：admin/admin

数据复制

{% file src="../../.gitbook/assets/clickhouse-sink-connect.tar" %} clickhouse-sink-connect {% endfile %}

解压文件

数据复制部分主要是debezium、kafka、clickhouse-sink-connect的部署。下载上面的文件，在你的Linux系统中使用命令tar -xvf clickhouse-sink-connect.tar解压.在目录中你会看到以下文件：

drwxr-xr-x  4 root root   45 Apr 12 05:42 docker/
-rw-r--r--  1 root root 3491 Apr 12 14:29 docker-compose.yaml
-rw-r--r--  1 root root 1613 Apr 12 05:42 README.md
drwxr-xr-x  2 root root  139 Apr 15 10:15 scripts/

docker 目录: 主要包含一些Dockerfile，用来构建自己的镜像，在Dockerfile中添加了一些额外的东西到官方镜像中，可以不用管它。

docker-compose.yaml : docker通过这个配置文件快速编排启动多个容器，容器的启动配置都包含在里面。

scripts 目录： 这个目录中包含了一些脚本，是用来快速注册连接器。注册连接器也可以在web页面中注册。

启动容器

在clickhouse-sink-connect目录中使用以下命令

docker compose up

注意查看命令行中是否输出报错信息

注册连接器

在注册连接器之前查看你的数据库中是否启动了Debizium所需的CDC相关配置，这里主要介绍postgres的配置。其他的可以查看官方文档，如Mysql设置。