ClickHouse

Kết nối ClickHouse (ClickHouse Cloud hoặc máy chủ tự vận hành) với Fresco BI. Fresco BI gọi tới cổng HTTPS của ClickHouse, đọc bảng và view bằng truy vấn chỉ đọc, rồi nạp vào Data Table (Import).

Tính năng	Hỗ trợ
Import	Có
DirectQuery	Không
SSL/TLS	Luôn bật (verify-full)
SSH tunnel	Không
Cloud	Có
On-premises (qua Gateway)	Có

Điều kiện cần

• Cổng HTTPS của ClickHouse đã bật với chứng chỉ hợp lệ. Cổng mặc định là 8443 (ClickHouse Cloud dùng cổng này; máy chủ tự vận hành cần cấu hình https_port). Không dùng cổng native TCP (9000 / 9440) hay HTTP thường (8123).
• Một tài khoản quản trị chạy được CREATE USER và GRANT.
• Tên database cần đọc.

Bước 1: Tạo tài khoản chỉ đọc

CREATE USER fresco_reader IDENTIFIED WITH sha256_password BY '<strong-password>';
GRANT SELECT ON <database>.* TO fresco_reader;

Quyền trên <database>.* áp dụng luôn cho các bảng tạo sau này trong database đó. Lặp lại GRANT cho từng database cần đọc. Nếu được, giới hạn nơi tài khoản đăng nhập bằng HOST IP '<address>' trong CREATE USER.

Fresco BI gửi mọi truy vấn với readonly = 2 cùng giới hạn thời gian và bộ nhớ riêng (4 GiB mỗi truy vấn). Nếu settings profile của tài khoản là readonly = 1, máy chủ từ chối các setting đó nên Fresco BI không gửi: giới hạn của máy chủ được áp dụng và lần kiểm tra hiện một cảnh báo. Cả hai cách đều dùng được.

Bước 2: Cho phép truy cập mạng

Chọn một trong các cách:

• Cloud (máy chủ mở ra internet). Cho phép kết nối vào từ các địa chỉ IP đi ra của Fresco BI (hướng dẫn bên cạnh form nguồn dữ liệu có liệt kê) ở cổng 8443. Với ClickHouse Cloud, thêm các địa chỉ này vào IP access list của service. Với máy chủ tự vận hành, mở cổng trong security group hoặc firewall.
• On-premises (qua Gateway). Nếu máy chủ nằm trong mạng nội bộ, chọn On-premises (qua Gateway) trong form. Khi chọn, khung này chuyển sang hướng dẫn Gateway.

ClickHouse không hỗ trợ SSH tunnel.

Bước 3: Điền form

• Kiểu kết nối: Cloud hoặc On-premises (qua Gateway). Với On-premises, chọn Cụm gateway.
• Tên hiển thị: tên nguồn hiện trong Fresco BI.
• Máy chủ: tên DNS của máy chủ, ví dụ abc123.eu-west-1.aws.clickhouse.cloud. Tên này phải khớp tên trong chứng chỉ máy chủ.
• Cổng: điền sẵn 8443.
• Database: database cần đọc. Chỉ database này được liệt kê.
• Tài khoản: fresco_reader.
• Mật khẩu: mật khẩu ở Bước 1. Được lưu mã hóa và không hiện lại.
• Chế độ SSL: cố định verify-full.
• Chứng chỉ CA (PEM): để trống nếu máy chủ dùng chứng chỉ public (ClickHouse Cloud). Với chứng chỉ nội bộ hoặc tự ký, dán CA (hoặc chứng chỉ của máy chủ).

Bấm Kiểm tra kết nối, rồi Lưu.

Chế độ SSL

Kết nối ClickHouse luôn được mã hóa và kiểm tra (verify-full): kiểm tra cả chuỗi chứng chỉ lẫn tên máy chủ. Mật khẩu đi trong HTTP Basic auth nên không bao giờ dùng HTTP thường.

Xử lý sự cố

• Máy chủ từ chối tài khoản hoặc mật khẩu. Kiểm tra tài khoản, mật khẩu và giới hạn HOST của tài khoản.
• Tài khoản không có quyền đọc đối tượng này. Chạy lệnh GRANT SELECT ở Bước 1 cho database đó.
• Không tìm thấy database hoặc đối tượng này trên máy chủ. Kiểm tra ô Database; tên phân biệt hoa thường.
• Nguồn trả về kiểu dữ liệu trình kết nối chưa hỗ trợ. Cột kiểu Array, Map, Tuple, Nested, JSON, Variant, Dynamic và aggregate state chưa được hỗ trợ; bỏ chúng khỏi lần nạp. Bảng dùng streaming engine (Kafka, RabbitMQ, NATS, FileLog, S3Queue, AzureQueue) được liệt kê nhưng không bao giờ được đọc.
• Không thiết lập được kết nối SSL với chế độ đã chọn. Kiểm tra chế độ SSL và chứng chỉ CA. Kiểm tra cổng là cổng HTTPS (không phải 8123 hay 9000), host khớp chứng chỉ, và với CA nội bộ thì dán CA vào Chứng chỉ CA (PEM).
• Không mở được kết nối tới máy chủ và cổng này. Kiểm tra máy chủ, cổng, và firewall đã cho phép IP của Fresco BI chưa. Thêm các địa chỉ IP đi ra của Fresco BI (hướng dẫn bên cạnh form nguồn dữ liệu có liệt kê) vào IP access list hoặc firewall.
• Máy chủ không phản hồi kịp. Thường do firewall chặn im lặng hoặc sai máy chủ, cổng. Kiểm tra firewall rule và cổng.
• Địa chỉ máy chủ thuộc dải bị chặn (nội bộ, loopback hoặc metadata). Database trong mạng nội bộ cần kết nối On-premises qua Gateway. Dùng tên máy chủ public, hoặc On-premises (qua Gateway).
• Vượt giới hạn kích thước hoặc số kết nối đồng thời. Một truy vấn chạm giới hạn bộ nhớ 4 GiB hoặc quota của máy chủ; nạp ít bảng hơn hoặc ít cột hơn, hoặc nâng quota của tài khoản.