Real-Time Market AnalyticsClickHouse Workshops

07 Xây một dashboard trực tiếp trên dữ liệu của bạn

Chạy một dashboard đóng gói container ngay trên laptop của bạn, trỏ vào service ClickHouse Cloud của chính bạn, và xem thời gian truy vấn cùng số dòng được quét thay đổi khi bạn lọc.

Muốn cảm nhận độ nhanh? Hãy chạy một dashboard nhỏ trên laptop của bạn, truy vấn bảng forex trong service ClickHouse Cloud của chính bạn. Nó vẽ biểu đồ nến và biểu đồ khối lượng có tương tác, và mỗi lần bạn đổi một bộ lọc, nó hiển thị thời gian truy vấn của ClickHouse cùng số dòng đã quét — thường là vài millisecond. Đó chính là điểm mấu chốt: đổi cặp tiền, kéo khoảng ngày, và dữ liệu trả về tức thì.

Vì sao lại dùng Docker?

Ứng dụng chạy trong một Docker container với bản Python được ghim riêng, nên không quan trọng bạn đang cài Python nào — hay có cài hay không. Bạn chỉ cần Docker.

Bước 1 — Cài Docker

Nếu bạn chưa có, hãy cài Docker Desktop và khởi động nó. Nó bao gồm lệnh docker compose mà bạn sẽ dùng bên dưới. Kiểm tra xem nó đang chạy:

docker --version

Bước 2 — Clone repo

Clone repository của workshop và chuyển vào thư mục dashboard:

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

Bước 3 — Thêm thông tin kết nối của bạn

Copy file mẫu thành một file .env thật, rồi mở nó bằng bất kỳ trình soạn thảo văn bản nào và điền thông tin của service của chính bạn:

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

Tìm những giá trị này trong console của Cloud tại Connect (menu bên trái) → HTTPS:

BiếnĐiền gì
CLICKHOUSE_HOSTví dụ abc123.ap-southeast-1.aws.clickhouse.cloud — không có https://, không có port
CLICKHOUSE_PORT8443
CLICKHOUSE_USERdefault
CLICKHOUSE_PASSWORDmật khẩu bạn đặt khi tạo service
CLICKHOUSE_DATABASEdatabase chứa forex (thường là default)
CLICKHOUSE_SECUREtrue

Bước 4 — Chạy nó

Build và khởi động container. Lần chạy đầu tiên sẽ tải base image và cài các phụ thuộc (mất một hai phút); sau đó thì tức thì.

docker compose up --build

Khi bạn thấy nó lắng nghe ở port 8000, hãy mở http://localhost:8000 trong trình duyệt. Dừng lại sau đó bằng Ctrl-C.

Hãy thử những điều này

Đổi cặp tiền tệ, kéo khoảng ngày, hoặc nhấn một nút quick range — mỗi thay đổi đều truy vấn lại ClickHouse và cái badge ở góc trên bên phải nháy lên thời gian truy vấn và số dòng đã quét mới. Thu hẹp khoảng thời gian về một cặp duy nhất và xem nó giảm xuống còn vài nghìn dòng và vài millisecond — sort key đang phát huy tác dụng, đúng như module 4.7.

Không thấy dữ liệu?

Một dải màu đỏ nghĩa là ứng dụng không kết nối được tới ClickHouse. Hãy kiểm tra lại các giá trị trong .env — host không có https:// và không có port, port 8443 — và đảm bảo bảng forex của bạn đã được nạp. Hướng dẫn thiết lập đầy đủ và cách xử lý sự cố nằm trong README.md của dashboard.

Trên trang này

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.

VI