Chuyển đến nội dung chính

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
TablePro trên Mac kết nối tới ClickHouse, với một query phân tích và kết quả của nó.

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 đề SETTINGS củ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âu SET riê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 /ping trên port đó sẽ trả về Ok.

Tải TablePro

Mọi tính năng trên trang này đều miễn phí.