Real-Time Market AnalyticsClickHouse Workshops

07 用你的数据搭一个实时看板

在你的笔记本上运行一个容器化看板,连到你自己的 ClickHouse Cloud 服务,并在筛选时观察查询耗时和扫描行数的变化。

想亲身感受一下这个速度?在你自己的笔记本上跑一个小看板,让它查询你的 ClickHouse Cloud 服务里的 forex 表。它会画出可交互的 K 线图和成交量图, 每次你改动筛选条件,它都会显示 ClickHouse 查询耗时以及扫描了多少行, 通常只有几毫秒。这正是重点所在:换个货币对、拖一下日期范围,数据立刻就回来了。

为什么用 Docker?

这个应用跑在一个 Docker 容器里,自带固定版本的 Python,所以你本机装的是哪个 Python 版本,甚至有没有装,都不重要。你只需要 Docker。

第 1 步:安装 Docker

如果你还没有,安装 Docker Desktop 并启动它。它包含了下面要用的 docker compose 命令。确认它在运行:

docker --version

第 2 步:克隆仓库

克隆实训仓库并进入看板目录:

git clone https://github.com/ClickHouse/ClickHouse_Demos.git
cd ClickHouse_Demos
cd "$(git rev-parse --show-toplevel)/workshop_public/RTA-mini-workshop/dashboard"

第 3 步:填入你的连接信息

把模板复制成一个真正的 .env 文件,然后用任意文本编辑器打开它,填入你自己的服务信息:

cp .env.example .env
# now edit .env and fill in the values below

这些值可以在 Cloud 控制台的 Connect(左侧菜单)→ HTTPS 里找到:

变量填什么
CLICKHOUSE_HOST例如 abc123.ap-southeast-1.aws.clickhouse.cloud,不要带 https://,不要带端口
CLICKHOUSE_PORT8443
CLICKHOUSE_USERdefault
CLICKHOUSE_PASSWORD你创建服务时设置的密码
CLICKHOUSE_DATABASE存放 forex 的数据库(通常是 default)
CLICKHOUSE_SECUREtrue

第 4 步:运行

构建并启动容器。第一次运行会下载基础镜像并安装依赖(一两分钟);之后就是瞬间启动。

docker compose up --build

当你看到它开始监听 8000 端口时,在浏览器里打开 http://localhost:8000。之后用 Ctrl-C 停止它。

可以试试这些

切换货币对、拖动日期范围,或者点一个快捷范围按钮,每次改动都会重新查询 ClickHouse,右上角的角标会闪出新的查询耗时和扫描行数。把范围收窄到单个货币对, 看它掉到几千行和几毫秒,这就是 sort key 在起作用,和 模块 4.7 里完全一样。

看不到数据?

出现红色横幅说明应用连不上 ClickHouse。重新检查 .env 里的值,host 不带 https://、不带端口,端口填 8443,并确认你的 forex 表已经加载好数据。 完整的配置说明和排错指引在看板目录的 README.md 里。

本页内容

Track your progress?

Optional. We email a link to confirm your address; progress records once you open it.

Please use your work email address, not a personal one.

Progress tracking also requires accepting the current Terms of Service in Privacy settings.

ZH