ClickHouse client
Chạy query phân tích qua HTTP, xem plan và pipeline, và quản lý part và partition của MergeTree.
Tóm tắt
- Ngôn ngữ query
- SQL
- Driver
- Có sẵn trong ứng dụng Mac
- Cách kết nối
- Host và port, SSH tunnel, SSL/TLS
- Port mặc định
- 8123
- Phiên bản tối thiểu
- Không yêu cầu


Kết nối
Nhập host, HTTP port, user và cơ sở dữ liệu tùy chọn, rồi chuyển cơ sở dữ liệu mà không cần kết nối lại; các tab đang mở giữ cơ sở dữ liệu ban đầu của chúng.
Chọn bất kỳ chế độ SSL nào thì connection sẽ chuyển sang HTTPS. Port 443 hoặc 8443, port mà ClickHouse Cloud dùng, sẽ bật Xác minh danh tính (Verify Identity), tức kiểm tra chứng chỉ theo file CA của bạn hoặc kho chứng chỉ tin cậy của hệ thống. Xác minh CA (Verify CA) cần một file CA, còn chứng chỉ và key của client dùng cho server yêu cầu mutual TLS.
Khi không dùng TLS, hãy kết nối tới server từ xa qua SSH tunnel thay vì gửi HTTP không mã hóa qua mạng.
Query và chỉnh sửa
Menu Giải thích (Explain) có Plan, Pipeline, AST, Syntax và Estimate. Kết quả dạng thụt lề được vẽ thành sơ đồ hoặc cây, còn Estimate cho biết số dòng, mark và part mà query sẽ đọc. Query đang chạy hiện số dòng đã đọc, Dừng (Stop) gửi KILL QUERY, và query timeout của connection được chuyển tới server.
Thêm dòng, cùng mutation UPDATE và DELETE, đều chạy từ data grid. Lưu thành công nghĩa là đã được nhận, chưa phải đã áp dụng: hãy theo dõi tiến độ trong system.mutations. Materialized view chỉ đọc. Tuple point và ring mở được trên Map view, còn query có mệnh đề FORMAT riêng sẽ hiện nguyên output của server trong một cột, nên hãy bỏ mệnh đề đó để có data grid.
Table, part và theo dõi
Mỗi table mở với các tab Structure, Indexes, DDL và Parts. Indexes hiển thị sorting key và các data-skipping index, DDL hiển thị đầy đủ câu CREATE TABLE kèm engine và settings, còn Parts đọc system.parts, với Optimize, Drop Partition và Detach Partition. Tab Structure sửa cột và xóa data-skipping index. Sorting key và khóa chính được cố định khi tạo table, nên hãy thêm data-skipping index bằng ALTER TABLE … ADD INDEX, và tạo lại table cho các thay đổi khác.
Server Dashboard hiển thị query đang chạy, merge, part mutation và dung lượng đĩa, kết thúc các session khác, và liệt kê từ system.query_log các query đã xong mà chạy lâu hơn một giây.
Trang này chỉ nói về những gì riêng của ClickHouse. Safe Mode, trợ lý AI, MCP server và phần còn lại của TablePro nằm ở các trang tính năng.
Ngoài ra
Di chuyển dữ liệu
Import file CSV, TSV, JSON, JSONL, XLSX và SQL, và export table hoặc kết quả ra CSV, JSON, SQL, XLSX, Markdown, HTML và XML. Cột chỉ cần có một giá trị không phải UTF-8 hợp lệ là hiển thị dạng hex; hãy select
toValidUTF8(column)để đọc nó dưới dạng văn bản.Giới hạn
- Connection dùng giao diện HTTP của ClickHouse. Không dùng giao thức native (TCP).
- TLS tắt theo mặc định. Hãy chọn một chế độ SSL trong form connection để dùng HTTPS.
- Không có khóa ngoại và không có transaction.
- Câu lệnh SET không được giữ sang query tiếp theo.
Làm sao để đổi một setting cho riêng một query?
Hãy đặt nó trong mệnh đề
SETTINGScủa query, nhưSELECT … SETTINGS max_threads = 4. Mỗi câu lệnh là một request HTTP riêng, nên một câuSETriêng lẻ sẽ mất tác dụng ở câu tiếp theo.Vì sao không kết nối được qua port 9000?
Port 9000 là port TCP native của ClickHouse, mà TablePro không dùng. Hãy kết nối tới port HTTP, hoặc 8443 cho HTTPS trên ClickHouse Cloud; khi giao diện HTTP đang bật, một request tới
/pingtrên port đó sẽ trả vềOk.
Tải TablePro
Mọi tính năng trên trang này đều miễn phí.