Google Sheets

Kết nối một bảng tính Google Sheets với Fresco BI. Mỗi trang tính (tab) trong bảng tính được liệt kê như một bảng, và Fresco BI import các trang tính bạn chọn vào bảng dữ liệu. Fresco BI chỉ đọc.

Tính năng	Hỗ trợ
Import	Có
DirectQuery	Không
SSL/TLS	Luôn bật và kiểm tra chứng chỉ
SSH tunnel	Không
Cloud	Có
On-premises (qua Gateway)	Không

Điều kiện cần

• Một tài khoản Google mở được bảng tính (chủ sở hữu, người chỉnh sửa hoặc người xem).
• ID của bảng tính.
• Máy chủ Fresco BI đã được cấu hình đăng nhập Google. Nếu chưa, trình kết nối này không dùng được; hãy hỏi quản trị viên Fresco BI.

Bước 1: Cấp quyền đọc cho Fresco BI

Google Sheets không dùng user database. Thay vào đó bạn đăng nhập Google, và Fresco BI đọc bảng tính dưới danh nghĩa tài khoản Google đó:

1. Khi thêm nguồn, Fresco BI chuyển bạn tới trang đăng nhập của Google.
2. Chọn tài khoản Google mở được bảng tính.
3. Cho phép quyền đọc Google Sheets. Fresco BI chỉ xin một quyền: đọc bảng tính (spreadsheets.readonly). Fresco BI không sửa, tạo hay xóa được bảng tính nào.

Nếu bạn không cho phép quyền đó, đăng nhập bị từ chối với thông báo “Allow read access to Google Sheets.” và không có gì được lưu.

Để giới hạn quyền, bạn có thể dùng một tài khoản Google riêng chỉ có quyền Người xem (Viewer) trên bảng tính: chia sẻ bảng tính cho tài khoản đó (Share trong Google Sheets, vai trò Viewer) rồi đăng nhập bằng tài khoản đó.

Muốn thu hồi quyền sau này, gỡ Fresco BI khỏi danh sách ứng dụng bên thứ ba có quyền truy cập trong phần cài đặt Tài khoản Google.

Bước 2: Mở quyền truy cập mạng

Không cần mở gì. Fresco BI chỉ gọi tới máy chủ API của Google (sheets.googleapis.com và oauth2.googleapis.com) qua TLS có kiểm tra chứng chỉ. Google Sheets không có SSH tunnel và không có kiểu On-premises (Gateway).

Bước 3: Điền thông tin

Form web cho Google Sheets chưa có. Nguồn này nhận các thiết lập sau:

1. Spreadsheet ID: phần nằm giữa /d/ và /edit trong URL bảng tính. Với https://docs.google.com/spreadsheets/d/1AbC.../edit, ID là 1AbC.... ID dài 25 đến 128 ký tự gồm chữ, số, - hoặc _. Fresco BI không nhận URL đầy đủ.
2. Dòng tiêu đề: dòng chứa tên cột, từ 0 đến 100 (mặc định 1). Dữ liệu bắt đầu từ dòng ngay dưới; các dòng phía trên bị bỏ qua. Đặt 0 nghĩa là không có dòng tiêu đề, cột được đặt tên Column 1, Column 2…
3. Số dòng mẫu: số dòng được đọc để đoán kiểu của từng cột, từ 100 đến 1.000 (mặc định 1.000).

Sau khi đăng nhập, nguồn hiển thị tài khoản Google đang kết nối. Token đăng nhập được lưu mã hóa trên máy chủ và không bao giờ hiển thị.

Cách dữ liệu được đọc

• Ô tiêu đề trống thành Column N; tên trùng được thêm _2, _3.
• Kiểu cột (số nguyên, số thực, đúng/sai, ngày, ngày giờ, giờ, văn bản) được đoán từ các dòng mẫu và định dạng số của ô.
• Ô lỗi như #N/A hay #REF! được đọc thành ô trống.
• Mỗi trang tính tối đa 1.000 cột và 5.000.000 ô (dòng × cột).
• Fresco BI gửi tối đa một request mỗi giây cho mỗi nguồn và thử lại khi Google báo hết quota.

Khắc phục sự cố

• Máy chủ từ chối tài khoản hoặc mật khẩu. Google từ chối token đăng nhập, ví dụ vì quyền đã bị gỡ trong cài đặt Tài khoản Google. Đăng nhập Google lại.
• Tài khoản không có quyền đọc đối tượng này. Tài khoản Google đã đăng nhập không mở được bảng tính này. Chia sẻ bảng tính cho tài khoản đó, hoặc đăng nhập bằng tài khoản có quyền.
• Không tìm thấy database hoặc đối tượng này trên máy chủ. Kiểm tra Spreadsheet ID, và trang tính (tab) chưa bị đổi tên hoặc xóa.
• Vượt giới hạn kích thước hoặc số kết nối đồng thời. Trang tính có hơn 1.000 cột hoặc 5.000.000 ô, hoặc đã hết quota request của Google. Tách trang tính, hoặc thử lại sau.
• Cấu trúc bảng nguồn đã thay đổi so với bảng dữ liệu. Một cột mà bảng dữ liệu đang đọc không còn trong dòng tiêu đề (bị đổi tên hoặc xóa). Đặt lại tên cột, hoặc kiểm tra thiết lập dòng tiêu đề.
• 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. Google trả lỗi máy chủ. Thử lại sau.
• 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. Google phản hồi chậm; thử lại.