Databricks

Databricks SQL cho phép truy vấn bảng lakehouse qua một SQL warehouse. Fresco BI kết nối tới SQL warehouse bằng personal access token, liệt kê catalog, schema, bảng và view trong Unity Catalog, rồi import các bảng bạn chọn vào một Data Table.

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

Chuẩn bị

• Một workspace Databricks trên AWS (*.cloud.databricks.com), Azure (*.azuredatabricks.net) hoặc Google Cloud (*.gcp.databricks.com).
• Một SQL warehouse. Fresco BI chỉ kết nối tới SQL warehouse, không kết nối tới all-purpose cluster.
• Một workspace admin có thể thêm user hoặc service principal và cấp quyền Unity Catalog.

Bước 1: Tạo danh tính chỉ đọc

Dùng một service principal riêng (khuyến nghị) hoặc user, ở đây gọi là fresco-reader.

1. Thêm fresco-reader vào workspace với entitlement Databricks SQL access.
2. Trên SQL warehouse, mở Permissions và cấp cho fresco-reader quyền Can use.
3. Cấp quyền chỉ đọc Unity Catalog trong SQL editor:

GRANT USE CATALOG ON CATALOG <catalog> TO `fresco-reader`;
GRANT USE SCHEMA ON CATALOG <catalog> TO `fresco-reader`;
GRANT SELECT ON CATALOG <catalog> TO `fresco-reader`;

Quyền cấp trên catalog cũng áp dụng cho schema và bảng tạo sau này trong catalog đó. Nếu chỉ muốn cho đọc một schema:

GRANT USE CATALOG ON CATALOG <catalog> TO `fresco-reader`;
GRANT USE SCHEMA ON SCHEMA <catalog>.<schema> TO `fresco-reader`;
GRANT SELECT ON SCHEMA <catalog>.<schema> TO `fresco-reader`;

4. Tạo personal access token cho fresco-reader và sao chép lại. Đặt ngày hết hạn và nhắc lịch xoay vòng token.

Đừng dùng token của admin. Fresco BI chỉ đọc, nên danh tính này không cần gì ngoài các quyền ở trên.

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

Fresco BI kết nối tới host của workspace qua internet ở cổng 443. Nếu workspace bật IP access list, hãy thêm IP đi ra của Fresco BI vào danh sách cho phép: 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ê). Databricks không có lựa chọn On-premises (qua Gateway) hay SSH tunnel.

Bước 3: Điền form

Sao chép Server hostname và HTTP path từ tab Connection details của SQL warehouse.

Ô	Nhập gì
Server hostname	Chỉ host của workspace, ví dụ dbc-a1b2c3d4-e5f6.cloud.databricks.com. Không có https://, cổng hay đường dẫn
HTTP path	/sql/1.0/warehouses/<warehouse-id>
Catalog	Một catalog cần liệt kê, hoặc để trống để liệt kê mọi catalog danh tính thấy được
Schema	Một schema cần liệt kê, hoặc để trống để liệt kê mọi schema trong catalog
Access token	Token ở Bước 1

Bấm Kiểm tra kết nối: bước này chạy SELECT current_version() trên warehouse. Warehouse đang dừng sẽ được khởi động trước, có thể mất vài phút. Sau đó bấm Lưu.

Fresco BI đọc kết quả trực tiếp từ host của workspace (Cloud Fetch tắt), nên không cần quyền truy cập cloud storage.

Chế độ SSL

Kết nối tới Databricks luôn được mã hóa và chứng chỉ máy chủ luôn được xác minh theo kho chứng chỉ của hệ thống. Không có chế độ SSL để chọn.

Xử lý sự cố

• Máy chủ từ chối tài khoản hoặc mật khẩu. Access token sai, đã hết hạn hoặc bị thu hồi. Tạo token mới và dán lại.
• Tài khoản không có quyền đọc đối tượng này. IP access list của workspace đang chặn Fresco BI (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ê)), danh tính thiếu quyền Can use trên SQL warehouse, hoặc thiếu USE CATALOG, USE SCHEMA, SELECT trên đối tượng đó. Xem lại Bước 1 và 2.
• Thông tin kết nối chưa hợp lệ: kiểm tra lại các ô được đánh dấu. HTTP path không trỏ tới SQL warehouse nào đang tồn tại, hoặc server hostname không phải host workspace Databricks. Sao chép lại cả hai từ Connection details.
• Không tìm thấy database hoặc đối tượng này trên máy chủ. Catalog, schema hoặc bảng đã bị đổi tên, bị xóa, hoặc danh tính không thấy được.
• Không phân giải được tên máy chủ (DNS). Kiểm tra lại ô Máy chủ. Kiểm tra lại chính tả host của workspace.
• 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. Không tới được workspace, hoặc kết nối bị ngắt khi đang đọc. Kiểm tra host và thử lại.
• 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. Warehouse khởi động quá 5 phút, hoặc câu lệnh chạy quá lâu. Khởi động warehouse trước hoặc dùng cỡ lớn hơn.
• 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. Có proxy đang chặn bắt TLS tới workspace. Để Fresco BI đi thẳng tới Databricks.
• Nguồn trả về kiểu dữ liệu trình kết nối chưa hỗ trợ. Cột BINARY, INTERVAL, GEOGRAPHY, GEOMETRY và VOID không import được; bỏ chúng ra khỏi Data Table. Cột STRUCT, ARRAY, MAP và VARIANT được import dưới dạng văn bản JSON.